{"id":23211,"library":"aiohttp-swagger3","title":"aiohttp-swagger3","description":"OpenAPI 3.x validation and Swagger UI for aiohttp web apps. Automatically validates requests and responses, generates OpenAPI docs, and serves Swagger UI, Redoc, and RapiDoc. Current release 0.10.1 (released 2025-02-15). Active development with monthly or quarterly releases.","status":"active","version":"0.10.1","language":"python","source_language":"en","source_url":"https://github.com/hh-h/aiohttp-swagger3","tags":["swagger","openapi","aiohttp","validation","documentation"],"install":[{"cmd":"pip install aiohttp-swagger3","lang":"bash","label":"Install from PyPI"}],"dependencies":[],"imports":[{"note":"Main class to set up Swagger documentation","symbol":"SwaggerDocs","correct":"from aiohttp_swagger3 import SwaggerDocs"},{"note":"Decorator for adding YAML docs; note singular 'doc' not plural","wrong":"from aiohttp_swagger3 import swagger_docs","symbol":"swagger_doc","correct":"from aiohttp_swagger3 import swagger_doc"}],"quickstart":{"code":"from aiohttp import web\nfrom aiohttp_swagger3 import SwaggerDocs\n\napp = web.Application()\nswagger = SwaggerDocs(app, swagger_url=\"/api/doc\", title=\"My API\")\n\nasync def hello(request):\n    return web.json_response({\"hello\": \"world\"})\n\nswagger.add_get(\"/hello\", hello, summary=\"Hello endpoint\")\n\nweb.run_app(app)","lang":"python","description":"Minimal setup with aiohttp application and SwaggerDocs."},"warnings":[{"fix":"Upgrade Python to 3.9+.","message":"Python 3.8 dropped in v0.10.0; requires Python >=3.9.","severity":"breaking","affected_versions":">=0.10.0"},{"fix":"Upgrade Python to 3.8+ (or 3.9+ for >=0.10.0).","message":"Python 3.7 dropped in v0.8.0.","severity":"breaking","affected_versions":">=0.8.0"},{"fix":"Pin aiohttp to supported version range.","message":"aiohttp version support changes: v0.9.0 adds aiohttp 3.10.x; v0.8.0 adds 3.9.x and drops 3.6.x and 3.7.x.","severity":"breaking","affected_versions":">=0.8.0"},{"fix":"Upgrade aiohttp to 3.8+.","message":"aiohttp 3.6 and 3.7 are not supported after v0.8.0; use aiohttp >=3.8.","severity":"gotcha","affected_versions":">=0.8.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Ensure you have installed aiohttp-swagger3 (pip install aiohttp-swagger3) and use 'from aiohttp_swagger3 import SwaggerDocs'.","cause":"Using an outdated version or wrong import path.","error":"AttributeError: module 'aiohttp_swagger3' has no attribute 'SwaggerDocs'"},{"fix":"Check your OpenAPI spec and request payload against the schema.","cause":"Request validation failed (e.g., missing required field, wrong type).","error":"aiohttp_swagger3.exceptions.RequestValidationError"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}