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

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

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

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