{"id":23714,"library":"fastapi-versioning","title":"fastapi-versioning","description":"API versioning for FastAPI web applications. The current version is 0.10.0, with no recent releases; the library appears to be in maintenance mode. Supports header, hostname, URL prefix, and query parameter versioning schemes. Requires Python >=3.6 and FastAPI.","status":"maintenance","version":"0.10.0","language":"python","source_language":"en","source_url":"https://github.com/DeanWay/fastapi-versioning","tags":["fastapi","api-versioning"],"install":[{"cmd":"pip install fastapi-versioning","lang":"bash","label":"PyPi install"}],"dependencies":[{"reason":"Core dependency for API versioning.","package":"fastapi","optional":false}],"imports":[{"note":"Old import path no longer works.","wrong":"from fastapi_versioning.versioned_fastapi import VersionedFastAPI","symbol":"VersionedFastAPI","correct":"from fastapi_versioning import VersionedFastAPI"},{"note":"Direct import from top-level package.","wrong":"","symbol":"version","correct":"from fastapi_versioning import version"}],"quickstart":{"code":"from fastapi import FastAPI\nfrom fastapi_versioning import VersionedFastAPI, version\n\napp = FastAPI()\n\n@version(1, 0)\n@app.get(\"/\")\ndef read_root():\n    return {\"Hello\": \"v1\"}\n\napp = VersionedFastAPI(app, version_format=\"{major}.{minor}\", prefix_format=\"/v{major}.{minor}\")\n","lang":"python","description":"Minimal example using decorator-based versioning with URL prefix."},"warnings":[{"fix":"Migrate to a maintained library.","message":"Version 0.10.0 is likely the last release; the library is in maintenance mode. Consider migrating to alternatives like 'fastapi-versionize' or 'fastapi-versioning-lite'.","severity":"deprecated","affected_versions":">=0.10.0"},{"fix":"Ensure @version is placed above the route decorator.","message":"The decorator order matters: apply @version before @app.get, otherwise versioning may not work correctly.","severity":"gotcha","affected_versions":"All"},{"fix":"Design distinct paths per version or use header-based versioning.","message":"Using the same endpoint path for multiple versions can cause conflicts; fastapi-versioning does not deduplicate automatically.","severity":"gotcha","affected_versions":"All"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Use: from fastapi_versioning import VersionedFastAPI","cause":"Using an old import path (e.g., from fastapi_versioning.versioned_fastapi import VersionedFastAPI).","error":"ImportError: cannot import name 'VersionedFastAPI' from 'fastapi_versioning'"},{"fix":"Set versioning_scheme to one of 'header', 'hostname', 'url', 'query'.","cause":"Using an unsupported versioning scheme or misconfigured parameters.","error":"AssertionError: Versioning scheme not supported"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}