Aiohttp + Dependency Injector Example

This is an Aiohttp + Dependency Injector example application.

The example application is a REST API that searches for funny GIFs on the Giphy.

Run

Create virtual environment:

virtualenv venv
. venv/bin/activate

Install requirements:

pip install -r requirements.txt

To run the application do:

export GIPHY_API_KEY=wBJ2wZG7SRqfrU9nPgPiWvORmloDyuL0
python -m giphynavigator.application

The output should be something like:

======== Running on http://0.0.0.0:8080 ========
(Press CTRL+C to quit)

After that visit http://0.0.0.0:8080/ in your browser or use CLI command (curl, httpie, etc). You should see something like:

{
    "query": "Dependency Injector",
    "limit": 10,
    "gifs": [
        {
            "url": "https://giphy.com/gifs/boxes-dependent-swbf2-6Eo7KzABxgJMY"
        },
        {
            "url": "https://giphy.com/gifs/depends-J56qCcOhk6hKE"
        },
        {
            "url": "https://giphy.com/gifs/web-series-ccstudios-bro-dependent-1lhU8KAVwmVVu"
        },
        {
            "url": "https://giphy.com/gifs/TheBoysTV-friends-friend-weneedeachother-XxR9qcIwcf5Jq404Sx"
        },
        {
            "url": "https://giphy.com/gifs/netflix-a-series-of-unfortunate-events-asoue-9rgeQXbwoK53pcxn7f"
        },
        {
            "url": "https://giphy.com/gifs/black-and-white-sad-skins-Hs4YzLs2zJuLu"
        },
        {
            "url": "https://giphy.com/gifs/always-there-for-you-i-am-here-PlayjhCco9jHBYrd9w"
        },
        {
            "url": "https://giphy.com/gifs/stream-famous-dollar-YT2dvOByEwXCdoYiA1"
        },
        {
            "url": "https://giphy.com/gifs/i-love-you-there-for-am-1BhGzgpZXYWwWMAGB1"
        },
        {
            "url": "https://giphy.com/gifs/life-like-twerk-9hlnWxjHqmH28"
        }
    ]
}

Note

To create your own Giphy API key follow this guide.

Test

This application comes with the unit tests.

To run the tests do:

py.test giphynavigator/tests.py --cov=giphynavigator

The output should be something like:

platform linux -- Python 3.12.3, pytest-8.3.2, pluggy-1.5.0
plugins: cov-6.0.0, anyio-4.4.0, asyncio-0.24.0, aiohttp-1.0.5
asyncio: mode=Mode.STRICT, default_loop_scope=None
collected 3 items

giphynavigator/tests.py ...                                     [100%]

---------- coverage: platform darwin, python 3.10.0-final-0 ----------
Name                            Stmts   Miss  Cover
---------------------------------------------------
giphynavigator/__init__.py          0      0   100%
giphynavigator/application.py      13      2    85%
giphynavigator/containers.py        7      0   100%
giphynavigator/giphy.py            14      9    36%
giphynavigator/handlers.py         10      0   100%
giphynavigator/services.py          9      1    89%
giphynavigator/tests.py            37      0   100%
---------------------------------------------------
TOTAL                              90     12    87%