Skip to content
← Projects

Aiohttp-Swagger

Python 186 stars 2024

Aiohttp-Swagger generates API documentation for aiohttp servers, straight from the code itself.

Documenting APIs is a pain, I know. But the docs have to exist and be up to date, because outdated docs are worse than none.

Why I built it

I love aiohttp: it’s fast, simple and powerful. But it had no decent way to generate Swagger documentation, so I wrote one.

What it does

  • Generates the documentation from the code.
  • Ships Swagger UI to try the API from the browser.
  • Follows OpenAPI, the de facto standard for REST APIs.
  • Two lines of code to set up.

Who uses it

It has over 180 stars, and some APIs processing millions of requests a day run it.

Worth a look for anyone on aiohttp who needs to document an API.

The audio on why AI turns dumb

I send one email a day. Everyone who signs up gets, right then, a ten minute audio on what almost nobody knows about ChatGPT and Claude.

Daniel Alfocea