Installation¶
Install Flask-Jeroboam¶
I publish Flask-Jeroboam to PyPI, the Python Package Index, and as such, it is easily installable using one of the following commands, depending and your tooling for dependency management:
$ poetry add flask-jeroboam
$ pip install flask-jeroboam
With that command, you have installed Flask-Jeroboam with its two direct dependencies, Flask and Pydantic and their own dependencies tree (check it out here).
Note
We highly recommend installing Flask-Jeroboam in a virtual environment. If you need directions on how to do that check out the Setting Things Up section of our tutorial for more information.
Dependencies¶
Installing Flask-Jeroboam will automatically install these packages along with their dependencies:
Flask the web framework heavy lifting is still performed by Flask.
Pydantic to provide data validation using Python type annotations.
These two direct dependencies come with their own dependencies tree. In total, you will have up to 9 new packages installed. There is a nice poetry command to explore that tree. It goes like this:
$ poetry show flask-jeroboam --tree
flask-jeroboam 0.1.0b0 A Flask extension, inspired by FastAPI that uses Pydantic to provide easy-to-configure data validation for request parsing and response serialization.
├── flask >=2.1.3,<3.0.0
│ ├── click >=8.0
│ │ └── colorama *
│ ├── itsdangerous >=2.0
│ ├── jinja2 >=3.0
│ │ └── markupsafe >=2.0
│ └── werkzeug >=2.2.2
│ └── markupsafe >=2.1.1 (circular dependency aborted here)
└── pydantic >=1.10.2,<2.0.0
└── typing-extensions >=4.2.0
Testing your installation¶
Let’s make sure you set up everything correctly. Create and open a simple file at the root of your project: app.py
.
1from flask_jeroboam import Jeroboam
2
3
4app = Jeroboam(__name__)
5
6
7@app.get("/ping")
8def ping():
9 return "pong"
10
11
12if __name__ == "__main__":
13 app.run(port=5000)
Running this file should start a server on localhost:5000
. You can hit that endpoint with the command curl 'http://localhost:5000/ping'
or directly in your browser by going to http://localhost:5000/ping. If either answer with “pong”, your installation is functional, and you are ready to jump to our Getting Started Guide.
Uninstall Flask-Jeroboam¶
Removing Flask-Jeroboam from your project’s dependencies is as straightforward as adding it to your project:
$ poetry remove flask-jeroboam
$ pip uninstall flask-jeroboam