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.dev28469738

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.dev28469738
File Size Uploaded
aiohug-0.3.1.dev28469738.tar.gz 9.2 kB Details

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

Download URL aiohug-0.3.1.dev28469738.tar.gz
Size 9.2 kB
Tags Source
SHA-256 checksum
How to use checksums
c31c835f5a54c34aa1faee3ffd8829631310985406866efc3fc56f9665d8e0d1
BLAKE2b-256 checksum
How to use checksums
9feebbfad1c25d77d5a84fed1532b6996f3a1e47acaef0a54a255a70d9d8e0a1
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