Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

aiohug

pipeline status coverage report

Tasks:

  • Unpack aiohttp request to arguments with annotations

  • Validate handlers arguments

  • Generate swagger specification

Examples

Run ping pong application

from aiohttp import web
from aiohug import RouteTableDef

routes = RouteTableDef()


@routes.get("/ping/")
async def ping():
  return "pong"


app = web.Application()
app.add_routes(routes)


if __name__ == "__main__":
    web.run_app(app)

There is no more request object in handler.

Arguments from path and query

@routes.get("/hello/{name}/")
async def hello(name: fields.String(), greeting: fields.String() = "Hello"):
    return {"msg": f"{greeting}, {name}"}

Body with schema

from aiohttp import web
from aiohug import RouteTableDef

routes = RouteTableDef()

class PayloadSchema(Schema):
    count = fields.Int()

@routes.get("/")
async def with_body(body: PayloadSchema()):
    return body

app = create_app()
app.add_routes(routes)

client = await test_client(app)
resp = await client.get("/", json={"count": "5", "another": 7})

assert await resp.json() == {"count": 5}

Another shortcuts

@routes.post("/ping/")
async def ping():
  return 201, "pong"

Why aiohug?

It’s just hug API implementation for aiohttp

TODO:

  • don’t pass default arguments

  • default websocket handler with ping/pong and schemas support

ws = aiohug.WSHandler()


@ws("hello")  # match message by `type` field
async def hello(name: str, greeting: str="Hi"):
    """ Just send {"type": "hello", "name": "Lucy", "greeting": "Hi"} """
    return {"text", f"{greeting}, {name}"}


app = create_app()
app.add_routes([web.get('/ws', ws)])

Release files for aiohug 0.3.1.dev28473004

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

Source distribution (sdist)

Source distribution for aiohug 0.3.1.dev28473004
File Size Uploaded
aiohug-0.3.1.dev28473004.tar.gz 9.3 kB Details

Release files / aiohug-0.3.1.dev28473004.tar.gz

Download URL aiohug-0.3.1.dev28473004.tar.gz
Size 9.3 kB
Tags Source
SHA-256 checksum
How to use checksums
a4d9669aaed302906d2783b001d927ab5b4e6fa1f319747a024d1b2b1b0a2a81
BLAKE2b-256 checksum
How to use checksums
522b406440f186ed2e2fe7a7dcafb61a5bae85ebc072491d64c03c7f355d054f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.11.0 pkginfo/1.4.2 requests/2.19.1 setuptools/40.0.0 requests-toolbelt/0.8.0 tqdm/4.25.0 CPython/3.7.0

Release history Release notifications | RSS feed

0.7.1

1 release file

0.7

1 release file

0.6.4

1 release file

0.6.1

1 release file

0.5

1 release file

0.4.2

1 release file

0.4.0

1 release file

0.3.3

1 release file

0.3.2

1 release file

0.3.1

1 release file

This release

0.3

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page