# Cadwyn
Production-ready community-driven modern [Stripe-like](https://stripe.com/blog/api-versioning) API versioning in FastAPI
---
<p align="center">
<a href="https://github.com/zmievsa/cadwyn/actions/workflows/ci.yaml?branch=main&event=push" target="_blank">
<img src="https://github.com/zmievsa/cadwyn/actions/workflows/ci.yaml/badge.svg?branch=main&event=push" alt="Test">
</a>
<a href="https://codecov.io/gh/zmievsa/cadwyn" target="_blank">
<img src="https://img.shields.io/codecov/c/github/zmievsa/cadwyn?color=%2334D058&logo=codecov" alt="Coverage">
</a>
<a href="https://pypi.org/project/cadwyn/" target="_blank">
<img alt="PyPI" src="https://img.shields.io/pypi/v/cadwyn?color=%2334D058&logo=pypi&label=PyPI package" alt="Package version">
</a>
<a href="https://pypi.org/project/cadwyn/" target="_blank">
<img src="https://img.shields.io/pypi/pyversions/cadwyn?color=%2334D058&logo=python" alt="Supported Python versions">
</a>
<a href="https://discord.gg/yRmcWF7rxE" target="_blank">
<img alt="Discord" src="https://img.shields.io/discord/1183145640407076864?color=%2334D058&logo=discord">
</a>
</p>
## Who is this for?
Cadwyn allows you to support a single version of your code while auto-generating the schemas and routes for older versions. You keep API versioning encapsulated in small and independent "version change" modules while your business logic stays simple and knows nothing about versioning.
Its [approach](https://docs.cadwyn.dev/theory/how_we_got_here/#ii-migration-based-response-building) will be useful if you want to:
1. Support many API versions for a long time
2. Effortlessly backport features and bugfixes to older API versions
Whether you are a newbie in API versioning, a pro looking for a sophisticated tool, an experimenter looking to build a similar framework, or even someone who just wants to learn about all approaches to API versioning -- Cadwyn has the functionality, theory, and documentation to cover all the mentioned use cases.
## Get started
The [documentation](https://docs.cadwyn.dev) has everything you need to succeed.
## Sponsors
These are our gorgeous sponsors. They are using Cadwyn and are sponsoring it through various means. Contact [me](https://github.com/zmievsa) if you would like to become one too!
[](https://docs.monite.com/)
Raw data
{
"_id": null,
"home_page": null,
"name": "cadwyn",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "api, api-versioning, code-generation, fastapi, hints, json-schema, pydantic, python, python310, python311, python312, python313, stripe, versioning",
"author": null,
"author_email": "Stanislav Zmiev <zmievsa@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/5b/5d/410cf1193640b388e21d8e592abbe5db73cc0cf8579b10578ada4e467283/cadwyn-4.4.3.tar.gz",
"platform": null,
"description": "# Cadwyn\n\nProduction-ready community-driven modern [Stripe-like](https://stripe.com/blog/api-versioning) API versioning in FastAPI\n\n---\n\n<p align=\"center\">\n<a href=\"https://github.com/zmievsa/cadwyn/actions/workflows/ci.yaml?branch=main&event=push\" target=\"_blank\">\n <img src=\"https://github.com/zmievsa/cadwyn/actions/workflows/ci.yaml/badge.svg?branch=main&event=push\" alt=\"Test\">\n</a>\n<a href=\"https://codecov.io/gh/zmievsa/cadwyn\" target=\"_blank\">\n <img src=\"https://img.shields.io/codecov/c/github/zmievsa/cadwyn?color=%2334D058&logo=codecov\" alt=\"Coverage\">\n</a>\n<a href=\"https://pypi.org/project/cadwyn/\" target=\"_blank\">\n <img alt=\"PyPI\" src=\"https://img.shields.io/pypi/v/cadwyn?color=%2334D058&logo=pypi&label=PyPI package\" alt=\"Package version\">\n</a>\n<a href=\"https://pypi.org/project/cadwyn/\" target=\"_blank\">\n <img src=\"https://img.shields.io/pypi/pyversions/cadwyn?color=%2334D058&logo=python\" alt=\"Supported Python versions\">\n</a>\n<a href=\"https://discord.gg/yRmcWF7rxE\" target=\"_blank\">\n <img alt=\"Discord\" src=\"https://img.shields.io/discord/1183145640407076864?color=%2334D058&logo=discord\">\n</a>\n</p>\n\n## Who is this for?\n\nCadwyn allows you to support a single version of your code while auto-generating the schemas and routes for older versions. You keep API versioning encapsulated in small and independent \"version change\" modules while your business logic stays simple and knows nothing about versioning.\n\nIts [approach](https://docs.cadwyn.dev/theory/how_we_got_here/#ii-migration-based-response-building) will be useful if you want to:\n\n1. Support many API versions for a long time\n2. Effortlessly backport features and bugfixes to older API versions\n\nWhether you are a newbie in API versioning, a pro looking for a sophisticated tool, an experimenter looking to build a similar framework, or even someone who just wants to learn about all approaches to API versioning -- Cadwyn has the functionality, theory, and documentation to cover all the mentioned use cases.\n\n## Get started\n\nThe [documentation](https://docs.cadwyn.dev) has everything you need to succeed.\n\n## Sponsors\n\nThese are our gorgeous sponsors. They are using Cadwyn and are sponsoring it through various means. Contact [me](https://github.com/zmievsa) if you would like to become one too!\n\n[](https://docs.monite.com/)\n",
"bugtrack_url": null,
"license": null,
"summary": "Production-ready community-driven modern Stripe-like API versioning in FastAPI",
"version": "4.4.3",
"project_urls": {
"Documentation": "https://docs.cadwyn.dev",
"Source code": "https://github.com/zmievsa/cadwyn"
},
"split_keywords": [
"api",
" api-versioning",
" code-generation",
" fastapi",
" hints",
" json-schema",
" pydantic",
" python",
" python310",
" python311",
" python312",
" python313",
" stripe",
" versioning"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "b0341dd05ce458ec9708fe10b387046df9d3ffd1471efea70bae6fb35ca6f63c",
"md5": "5043f68e4fef3bd26415d99138dfc637",
"sha256": "fb7d4a2411ee353913821b0bd0e9a20125c10471dbe16d090353efbae0184fe9"
},
"downloads": -1,
"filename": "cadwyn-4.4.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "5043f68e4fef3bd26415d99138dfc637",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 53647,
"upload_time": "2024-11-06T18:36:44",
"upload_time_iso_8601": "2024-11-06T18:36:44.854151Z",
"url": "https://files.pythonhosted.org/packages/b0/34/1dd05ce458ec9708fe10b387046df9d3ffd1471efea70bae6fb35ca6f63c/cadwyn-4.4.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "5b5d410cf1193640b388e21d8e592abbe5db73cc0cf8579b10578ada4e467283",
"md5": "16fd949f110a1ae3f52b03f14c07cab8",
"sha256": "094aa4335379f794868301b6f611e92b3e9f150b04997a361e36983fcc1b89db"
},
"downloads": -1,
"filename": "cadwyn-4.4.3.tar.gz",
"has_sig": false,
"md5_digest": "16fd949f110a1ae3f52b03f14c07cab8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 676204,
"upload_time": "2024-11-06T18:36:46",
"upload_time_iso_8601": "2024-11-06T18:36:46.625093Z",
"url": "https://files.pythonhosted.org/packages/5b/5d/410cf1193640b388e21d8e592abbe5db73cc0cf8579b10578ada4e467283/cadwyn-4.4.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-06 18:36:46",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "zmievsa",
"github_project": "cadwyn",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "cadwyn"
}
JSON
