mirror of
https://github.com/ets-labs/python-dependency-injector.git
synced 2024-12-04 23:44:05 +03:00
fe01ad41d9
* Update application-single-container example * Update application-multiple-containers example * Update decoupled-packages example * Update movie lister example * Update CLI tutorial * Update sanic example * Update sanic example with wiring_config * Update fastapi example * Update fastapi-simple example * Update fastapi-sqlalchemy example * Update flask-blueprints example * Update flask example and tutorial * Update aiohttp example and tutorial * Update asyncio-daemon example and tutorial
102 lines
2.9 KiB
ReStructuredText
102 lines
2.9 KiB
ReStructuredText
Flask Blueprints + Dependency Injector Example
|
|
==============================================
|
|
|
|
This is a `Flask <https://flask.palletsprojects.com/>`_ Blueprints +
|
|
`Dependency Injector <https://python-dependency-injector.ets-labs.org/>`_ example application.
|
|
|
|
The example application helps to search for repositories on the Github.
|
|
|
|
.. image:: screenshot.png
|
|
|
|
Run
|
|
---
|
|
|
|
Create virtual environment:
|
|
|
|
.. code-block:: bash
|
|
|
|
virtualenv venv
|
|
. venv/bin/activate
|
|
|
|
Install requirements:
|
|
|
|
.. code-block:: bash
|
|
|
|
pip install -r requirements.txt
|
|
|
|
To run the application do:
|
|
|
|
.. code-block:: bash
|
|
|
|
export FLASK_APP=githubnavigator.application
|
|
export FLASK_ENV=development
|
|
flask run
|
|
|
|
The output should be something like:
|
|
|
|
.. code-block::
|
|
|
|
* Serving Flask app "githubnavigator.application" (lazy loading)
|
|
* Environment: development
|
|
* Debug mode: on
|
|
* Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)
|
|
* Restarting with fsevents reloader
|
|
* Debugger is active!
|
|
* Debugger PIN: 473-587-859
|
|
|
|
After that visit http://127.0.0.1:5000/ in your browser.
|
|
|
|
.. note::
|
|
|
|
Github has a rate limit. When the rate limit is exceed you will see an exception
|
|
``github.GithubException.RateLimitExceededException``. For unauthenticated requests, the rate
|
|
limit allows for up to 60 requests per hour. To extend the limit to 5000 requests per hour you
|
|
need to set personal access token.
|
|
|
|
It's easy:
|
|
|
|
- Follow this `guide <https://docs.github.com/en/github/authenticating-to-github/creating-a-personal-access-token>`_ to create a token.
|
|
- Set a token to the environment variable:
|
|
|
|
.. code-block:: bash
|
|
|
|
export GITHUB_TOKEN=<your token>
|
|
|
|
- Restart the app with ``flask run``
|
|
|
|
`Read more on Github rate limit <https://developer.github.com/v3/#rate-limiting>`_
|
|
|
|
Test
|
|
----
|
|
|
|
This application comes with the unit tests.
|
|
|
|
To run the tests do:
|
|
|
|
.. code-block:: bash
|
|
|
|
py.test githubnavigator/tests.py --cov=githubnavigator
|
|
|
|
The output should be something like:
|
|
|
|
.. code-block::
|
|
|
|
platform darwin -- Python 3.10.0, pytest-6.2.5, py-1.10.0, pluggy-1.0.0
|
|
plugins: cov-3.0.0, flask-1.2.0
|
|
collected 2 items
|
|
|
|
githubnavigator/tests.py .. [100%]
|
|
|
|
---------- coverage: platform darwin, python 3.10.0-final-0 ----------
|
|
Name Stmts Miss Cover
|
|
------------------------------------------------------------
|
|
githubnavigator/__init__.py 0 0 100%
|
|
githubnavigator/application.py 13 0 100%
|
|
githubnavigator/blueprints/__init__.py 0 0 100%
|
|
githubnavigator/blueprints/example.py 12 0 100%
|
|
githubnavigator/containers.py 8 0 100%
|
|
githubnavigator/services.py 14 0 100%
|
|
githubnavigator/tests.py 34 0 100%
|
|
------------------------------------------------------------
|
|
TOTAL 81 0 100%
|