aiohttp-things

Modest utility collection for development with AIOHTTP framework.

Documentation

https://aiohttp-things.readthedocs.io

Installation

Installing aiohttp-things with pip:

pip install aiohttp-things

Simple example

Example of AIOHTTP application

import json
import uuid
import aiohttp_things as ahth
from aiohttp import web


def safe_json_value(value):
    try:
        json.dumps(value)
        return value
    except (TypeError, OverflowError):
        return str(value)


class Base(web.View, ahth.JSONMixin, ahth.PrimaryKeyMixin):
    async def get(self):
        self.context['Type of primary key'] = safe_json_value(type(self.pk))
        self.context['Value of primary key'] = safe_json_value(self.pk)
        return await self.finalize_response()


class IntegerExample(Base):
    pk_adapter = int


class UUIDExample(Base):
    pk_adapter = uuid.UUID


UUID = '[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}'
ROUTES = [
    web.view('/integer/{pk:[0-9]+}', IntegerExample),
    web.view(f'/uuid/{{pk:{UUID}}}', UUIDExample),
]


async def app_factory():
    app = web.Application()
    app.add_routes(ROUTES)
    return app


if __name__ == '__main__':
    web.run_app(app_factory())

Examples HTTP requests and response

http://0.0.0.0:8080/integer/1

{
  "Type of primary key": "<class 'int'>",
  "Value of primary key": 1
}

http://0.0.0.0:8080/integer/9999999999999

{
  "Type of primary key": "<class 'int'>",
  "Value of primary key": 9999999999999
}

http://0.0.0.0:8080/integer/a352da04-c1af-4a44-8a94-c37f8f37b2bc
```
404: Not Found
```
http://0.0.0.0:8080/integer/abc
```
404: Not Found
```

http://0.0.0.0:8080/uuid/a352da04-c1af-4a44-8a94-c37f8f37b2bc

{
  "Type of primary key": "<class 'uuid.UUID'>",
  "Value of primary key": "a352da04-c1af-4a44-8a94-c37f8f37b2bc"
}

http://0.0.0.0:8080/uuid/13d1d0e0-4787-4feb-8684-b3da32609743

{
  "Type of primary key": "<class 'uuid.UUID'>",
  "Value of primary key": "13d1d0e0-4787-4feb-8684-b3da32609743"
}

http://0.0.0.0:8080/uuid/1
```
404: Not Found
```
http://0.0.0.0:8080/uuid/abc
```
404: Not Found
```

Release files for aiohttp-things 1.2.post0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for aiohttp-things 1.2.post0
File	Size	Uploaded
aiohttp_things-1.2.post0.tar.gz	4.8 kB	Jan 5, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for aiohttp-things 1.2.post0
File	Interpreter	ABI	Platform	Reset
aiohttp_things-1.2.post0-py3-none-any.whl 5.7 kB Jan 5, 2026	Python 3	none	any	Details

Total release size: 10.5 kB

Release files / aiohttp_things-1.2.post0.tar.gz

Download URL	aiohttp_things-1.2.post0.tar.gz
Size	4.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`03461ab57be173a40d29051addae37274f99f82bb75fd54855b9b924a25c8a54`
BLAKE2b-256 checksum How to use checksums	`8a5029d6cf1ee65b2ee7524b4e95c69ecf2e8725f822ac2bdb21b79c3ed12fe4`
Upload date	Jan 5, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/2.1.1 CPython/3.12.3 Linux/6.8.0-90-generic`

Release files / aiohttp_things-1.2.post0-py3-none-any.whl

Download URL	aiohttp_things-1.2.post0-py3-none-any.whl
Size	5.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`f8732236115692a8d4399045ab3d754d2c05205d4d1c400366011fd63d26297c`
BLAKE2b-256 checksum How to use checksums	`d0ee08043a3b10d70831b8f68195c57d766f28f4a861e9b2a784e43123994b22`
Upload date	Jan 5, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/2.1.1 CPython/3.12.3 Linux/6.8.0-90-generic`