A small and very opinionated framework to build flask based microservices.
You can check the official documentation here
Flask is an awesome web microframework that works great out of the box. Nevertheless, additional configuration and integration with complementary libraries are required in order to build complex applications.
There are multiple ways of building web application using Flask. For example, you can use simple functions for views or use Class Based Views. Flask provides multiple ways to bootstrap applications and is up to the user structure a web application properly.
This framework implmenents one and only one way to boostrap a web app, a unique way to structure a web application and so on. Feel free to use it and extend it. We are willing to hear about your suggestions and improvements.
-
REST out of the box.
-
Simple sqlalchemy orm customized for postgresql with multiple dabatases.
-
Simple Redis integration.
-
Simple Elastic Search integration.
-
Basic AWS integration.
Flask-Philo installation is pretty straightforward:
pip3 install Flask-Philo
We use docker and docker compose to run the tests as we need an environment with dependencies such as Redis, Postgres and Elastic Search:
The following command creates the docker images required for running the tests:
cd test
docker-compose up --build
If you get an error related with __pycache__ directories or pyc files,
you need to remove generated python bytecode by running the following command:
find . | grep -E "(__pycache__|\.pyc|\.pyo$)" | xargs sudo rm -rf
After building and running the docker images you will need to get the
container id for the maching labelled as test_python by running the following
command:
docker ps
Having the container id you can run the unit tests using the following command:
python3 run_tests.py --container_id container-id test --test tests/
Flask-Philo includes the flask-philo-admin command line tool.
To quickly generate a new Flask-Philo project, navigate to the directory in which you want to create
the project and run:
flask-philo-admin startproject <project_name>
This will create a folder called project_name which will contain the basic structure of a Flask-Philo application, basic unit tests and configuration.
The following folder structure is created for the new project:
- README.md
- documentation
- src
- app
- init.py
- models
- serializers
- urls.py
- views
- config
- development.py
- test.py
- console_commands
- init.py
- manage.py
- tests
- init.py
- test_views.py
- app
- tools
- requirements
- base.txt
- dev.txt
- requirements
To run the listening server for your new Flask-Philo project, navigate to the project's src/ directory and issue the runserver command :
$ cd <your-project-dir>/src
$ python3 manage.py runserver
The response from this command will be something like this:
* Running on http://0.0.0.0:8080/ (Press CTRL+C to quit)
* Restarting with stat
* Debugger is active!
* Debugger PIN: 147-416-135
If you haven't already done so, run the following terminal command to create your Flask-Philo application:
$ python3 manage.py runserver
Now, with the application running and with a route defined, the following URL address will be accessible in the browser of your choice, and will return a JSON response:
Note that the port number (in this case 8080) should match the port number displayed when you start the application:
# Port 8080 in this case
* Running on http://0.0.0.0:8080/ (Press CTRL+C to quit)
...
Your browser will display a JSON response, as defined in the ExampleView class :
{"some_data": "yes"}
Alternatively, you can test this example URL route with a direct HTTP request using the CURL command-line tool:
$ curl http://localhost:8080/example
{"some_data": "yes"}
All incoming request to your Flask-Philo application and their corresponding HTTP status codes may be viewed in the same console session you used to start the application:
* Running on http://0.0.0.0:8080/ (Press CTRL+C to quit)
* Restarting with stat
* Debugger is active!
* Debugger PIN: 147-416-135
127.0.0.1 - - [05/Dec/2017 00:06:01] "GET /example HTTP/1.1" 200 -
Flask-Philo simplifies Unit Test coverage by providing a single console command for running and managing all test. All test code should be written in the dedicated directory location : src/app/tests. Within this directory, all Python source files begining with test_ will be executed as part of a suite of Unit Tests.
To run all Unit Tests for your new Flask-Philo app, use the following console command:
$ python3 manage.py test
The return of the tests will be something like the print below:
===================================== test session starts ======================================
platform darwin -- Python 3.5.1, pytest-3.3.0, py-1.5.2, pluggy-0.6.0
rootdir: <where_your_project_is>/flask-philo-example/src, inifile:
collected 1 item
tests/test_views.py . [100%]
=================================== 1 passed in 0.02 seconds ===================================
In this example, the automatically-generated example Unit Test class TestExampleEndpoints is executed, as defined in src/tests/test_views.py