cadwyn 2.3.0rc0__py3-none-any.whl → 2.3.1__py3-none-any.whl

cadwyn/__init__.py

@@ -1,11 +1,13 @@
 import importlib.metadata
 
 from .codegen import generate_code_for_versioned_packages
+from .main import Cadwyn
 from .routing import VersionedAPIRouter, generate_versioned_routers
 from .structure import VersionBundle, internal_body_representation_of
 
 __version__ = importlib.metadata.version("cadwyn")
 __all__ = [
+    "Cadwyn",
     "VersionedAPIRouter",
     "generate_code_for_versioned_packages",
     "VersionBundle",

cadwyn/main.py

@@ -18,7 +18,7 @@ from cadwyn.routing import generate_versioned_routers
 from cadwyn.structure import VersionBundle
 
 
-class _Cadwyn(HeaderRoutingFastAPI):
+class Cadwyn(HeaderRoutingFastAPI):
     def __init__(
         self,
         *,
@@ -37,7 +37,7 @@ class _Cadwyn(HeaderRoutingFastAPI):
         default_response_class: type[Response] = Default(JSONResponse),  # noqa: B008
         redirect_slashes: bool = True,
         docs_url: str | None = "/docs",
-        redoc_url: str | None = "/redoc",
+        redoc_url: None = None,
         swagger_ui_oauth2_redirect_url: str | None = "/docs/oauth2-redirect",
         swagger_ui_init_oauth: dict[str, Any] | None = None,
         middleware: Sequence[Middleware] | None = None,
@@ -77,7 +77,6 @@ class _Cadwyn(HeaderRoutingFastAPI):
             default_response_class=default_response_class,
             redirect_slashes=redirect_slashes,
             docs_url=docs_url,
-            redoc_url=redoc_url,
             swagger_ui_oauth2_redirect_url=swagger_ui_oauth2_redirect_url,
             swagger_ui_init_oauth=swagger_ui_init_oauth,
             middleware=middleware,

cadwyn/routing.py

@@ -41,6 +41,7 @@ from starlette.routing import (
     request_response,
 )
 from typing_extensions import assert_never
+from verselect.routing import VERSION_HEADER_FORMAT
 
 from cadwyn._utils import Sentinel, UnionType, get_another_version_of_module
 from cadwyn.codegen import _get_package_path_from_module, _get_version_dir_path
@@ -55,12 +56,18 @@ from cadwyn.structure.endpoints import (
 )
 from cadwyn.structure.versions import _CADWYN_REQUEST_PARAM_NAME, _CADWYN_RESPONSE_PARAM_NAME, VersionChange
 
+__all__ = [
+    "generate_versioned_routers",
+    "VersionedAPIRouter",
+    "VERSION_HEADER_FORMAT",
+]
+
 _T = TypeVar("_T", bound=Callable[..., Any])
 _R = TypeVar("_R", bound=fastapi.routing.APIRouter)
 # This is a hack we do because we can't guarantee how the user will use the router.
 _DELETED_ROUTE_TAG = "_CADWYN_DELETED_ROUTE"
-EndpointPath: TypeAlias = str
-EndpointMethod: TypeAlias = str
+_EndpointPath: TypeAlias = str
+_EndpointMethod: TypeAlias = str
 
 
 @dataclass(slots=True, frozen=True, eq=True)
@@ -72,7 +79,7 @@ class _EndpointInfo:
 @dataclass(slots=True)
 class _RouterInfo(Generic[_R]):
     router: _R
-    routes_with_migrated_requests: dict[EndpointPath, set[EndpointMethod]]
+    routes_with_migrated_requests: dict[_EndpointPath, set[_EndpointMethod]]
     route_bodies_with_migrated_requests: set[type[BaseModel]]
 
 
@@ -447,41 +454,23 @@ class _AnnotationTransformer:
             return self._change_version_of_type(annotation, version_dir)
         elif callable(annotation):
             # TASK: https://github.com/zmievsa/cadwyn/issues/48
-            if inspect.iscoroutinefunction(annotation):
-
-                @functools.wraps(annotation)
-                async def new_callable(  # pyright: ignore[reportGeneralTypeIssues]
-                    *args: Any,
-                    **kwargs: Any,
-                ) -> Any:
-                    return await annotation(*args, **kwargs)
-
-            else:
-
-                @functools.wraps(annotation)
-                def new_callable(  # pyright: ignore[reportGeneralTypeIssues]
-                    *args: Any,
-                    **kwargs: Any,
-                ) -> Any:
-                    return annotation(*args, **kwargs)
-
-            # Otherwise it will have the same signature as __wrapped__
-            new_callable.__alt_wrapped__ = new_callable.__wrapped__  # pyright: ignore[reportGeneralTypeIssues]
-            del new_callable.__wrapped__
+            annotation_modifying_decorator = _copy_function(annotation)
             old_params = inspect.signature(annotation).parameters
-            callable_annotations = new_callable.__annotations__
+            callable_annotations = annotation_modifying_decorator.__annotations__
 
-            new_callable: Any = cast(Any, new_callable)
-            new_callable.__annotations__ = self._change_version_of_annotations(
+            annotation_modifying_decorator.__annotations__ = self._change_version_of_annotations(
                 callable_annotations,
                 version_dir,
             )
-            new_callable.__defaults__ = self._change_version_of_annotations(
+            annotation_modifying_decorator.__defaults__ = self._change_version_of_annotations(
                 tuple(p.default for p in old_params.values() if p.default is not inspect.Signature.empty),
                 version_dir,
             )
-            new_callable.__signature__ = _generate_signature(new_callable, old_params)
-            return new_callable
+            annotation_modifying_decorator.__signature__ = _generate_signature(
+                annotation_modifying_decorator,
+                old_params,
+            )
+            return annotation_modifying_decorator
         else:
             return annotation
 
@@ -673,7 +662,7 @@ def _get_route_from_func(
     return None
 
 
-def _get_migrated_routes_by_path(version: Version) -> dict[EndpointPath, set[EndpointMethod]]:
+def _get_migrated_routes_by_path(version: Version) -> dict[_EndpointPath, set[_EndpointMethod]]:
     request_by_path_migration_instructions = [
         version_change.alter_request_by_path_instructions for version_change in version.version_changes
     ]
@@ -683,3 +672,34 @@ def _get_migrated_routes_by_path(version: Version) -> dict[EndpointPath, set[End
             for instruction in instruction_list:
                 migrated_routes[path] |= instruction.methods
     return migrated_routes
+
+
+def _copy_function(function: _T) -> _T:
+    while hasattr(function, "__alt_wrapped__"):
+        function = function.__alt_wrapped__
+
+    if inspect.iscoroutinefunction(function):
+
+        @functools.wraps(function)
+        async def annotation_modifying_decorator(  # pyright: ignore[reportGeneralTypeIssues]
+            *args: Any,
+            **kwargs: Any,
+        ) -> Any:
+            return await function(*args, **kwargs)
+
+    else:
+
+        @functools.wraps(function)
+        def annotation_modifying_decorator(
+            *args: Any,
+            **kwargs: Any,
+        ) -> Any:
+            return function(*args, **kwargs)
+
+    # Otherwise it will have the same signature as __wrapped__ due to how inspect module works
+    annotation_modifying_decorator.__alt_wrapped__ = (  # pyright: ignore[reportGeneralTypeIssues]
+        annotation_modifying_decorator.__wrapped__
+    )
+    del annotation_modifying_decorator.__wrapped__
+
+    return cast(_T, annotation_modifying_decorator)

cadwyn/structure/versions.py

@@ -207,25 +207,27 @@ class Version:
 class VersionBundle:
     def __init__(
         self,
-        *versions: Version,
+        latest_version: Version,
+        /,
+        *other_versions: Version,
         api_version_var: APIVersionVarType,
     ) -> None:
         super().__init__()
 
-        self.versions = versions
+        self.versions = (latest_version, *other_versions)
         self.api_version_var = api_version_var
-        if sorted(versions, key=lambda v: v.value, reverse=True) != list(versions):
-            raise ValueError(
+        if sorted(self.versions, key=lambda v: v.value, reverse=True) != list(self.versions):
+            raise CadwynStructureError(
                 "Versions are not sorted correctly. Please sort them in descending order.",
             )
-        if versions[-1].version_changes:
+        if self.versions[-1].version_changes:
             raise CadwynStructureError(
-                f'The first version "{versions[-1].value}" cannot have any version changes. '
+                f'The first version "{self.versions[-1].value}" cannot have any version changes. '
                 "Version changes are defined to migrate to/from a previous version so you "
                 "cannot define one for the very first version.",
             )
         version_values = set()
-        for version in versions:
+        for version in self.versions:
             if version.value not in version_values:
                 version_values.add(version.value)
             else:

{cadwyn-2.3.0rc0.dist-info → cadwyn-2.3.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: cadwyn
-Version: 2.3.0rc0
+Version: 2.3.1
 Summary: Modern Stripe-like API versioning in FastAPI
 Home-page: https://github.com/zmievsa/cadwyn
 License: MIT
@@ -35,7 +35,7 @@ Requires-Dist: fastapi (>=0.96.1)
 Requires-Dist: pydantic (>=1.10.0,<2.0.0)
 Requires-Dist: typer (>=0.7.0); extra == "cli"
 Requires-Dist: typing-extensions
-Requires-Dist: verselect-zmievsa (>=0.0.4,<0.0.5)
+Requires-Dist: verselect (>=0.0.6)
 Project-URL: Repository, https://github.com/zmievsa/cadwyn
 Description-Content-Type: text/markdown
 
@@ -73,10 +73,10 @@ Its [approach](./docs/theory.md#ii-migration-based-response-building) will be us
 
 The [documentation](https://docs.cadwyn.dev) has everything you need to get started. It is recommended to read it in the following order:
 
-1. [Tutorial](https://docs.cadwyn.dev/tutorial/)
-2. [Recipes](https://docs.cadwyn.dev/recipes/)
-3. [Reference](https://docs.cadwyn.dev/reference/)
-4. [Theory](https://docs.cadwyn.dev/theory/)
+1. [Tutorial](./tutorial.md)
+2. [Recipes](./recipes.md)
+3. [Reference](./reference.md)
+4. [Theory](./theory.md) <!-- TODO: Move section about cadwyn's approach to the beginning and move other approaches and "how we got here" to another article  -->
 
 ## Similar projects
 

{cadwyn-2.3.0rc0.dist-info → cadwyn-2.3.1.dist-info}/RECORD

@@ -1,20 +1,20 @@
-cadwyn/__init__.py,sha256=u7VCcoKnq2ETd5tO-JNtOB6ZnC4_T_M6UfkMdFT4iY0,453
+cadwyn/__init__.py,sha256=95dxX1XyN-i4pPn1Ji1E5TMnWe6olqm1MYutMiWTtWw,492
 cadwyn/__main__.py,sha256=aKAwxVnhqi3ATd1UsifoLA1t3udTzz56t0BRTlktX1A,2845
 cadwyn/_utils.py,sha256=Uh6No0FNY1AR2Z2E19fMPIU9_J4lbuG8XOQU2AlDIZw,3600
 cadwyn/codegen.py,sha256=oSivxLD_DmWbO179a9n4gHIoxuBJqDhP1OapjXv9DmE,38212
 cadwyn/exceptions.py,sha256=Utb6anOzrh97nOUgqCMmZHkQg8SFafLKSKO0EUPQ0yU,624
-cadwyn/main.py,sha256=KOWbpufWS6q2wSNsB7SR0D2kAqlUl4lqK5xZUychhfI,4938
+cadwyn/main.py,sha256=ofTKT8LvOkFh5M19UgPNWLxf-3_yVOGNTVPnoADc3Q4,4894
 cadwyn/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-cadwyn/routing.py,sha256=ukleVy52PEFTxw49zWw7p7oWGxRcKgyQV3J3P-K9jaI,32614
+cadwyn/routing.py,sha256=wk60HazI0CPEjNQ1cd0D0le1nzb1tkT4eKkuIP3ImeA,33083
 cadwyn/structure/__init__.py,sha256=2c6ivh7A-MQhhvovpsgiTsuk_ovYVVMWsqMqNC5QtuE,695
 cadwyn/structure/common.py,sha256=Nc0IP4L6z_HNVFrLaeepG2NY0en2ycZndXllpgoloNg,291
 cadwyn/structure/data.py,sha256=kzm3uf7VktH8nwShUk2hdfuuz0uYt9jzkRKMbWy0NtU,6564
 cadwyn/structure/endpoints.py,sha256=VngfAydGBwekhV2tBOtNDPVgl3X1IgYxUCw--VZ5cQY,5627
 cadwyn/structure/enums.py,sha256=iMokxA2QYJ61SzyB-Pmuq3y7KL7-e6TsnjLVUaVZQnw,954
 cadwyn/structure/schemas.py,sha256=wpGFXzoq6qrOulEk7I_69UslapG5iD5crFLQp-kXEFQ,5241
-cadwyn/structure/versions.py,sha256=HUk-o7n6CLdaHGmrsb4xw8CF-a-uaYBEIe4Ofo4xEoA,24064
-cadwyn-2.3.0rc0.dist-info/entry_points.txt,sha256=eO05hLn9GoRzzpwT9GONPmXKsonjuMNssM2D2WHWKGk,46
-cadwyn-2.3.0rc0.dist-info/LICENSE,sha256=KeCWewiDQYpmSnzF-p_0YpoWiyDcUPaCuG8OWQs4ig4,1072
-cadwyn-2.3.0rc0.dist-info/WHEEL,sha256=vxFmldFsRN_Hx10GDvsdv1wroKq8r5Lzvjp6GZ4OO8c,88
-cadwyn-2.3.0rc0.dist-info/METADATA,sha256=pdxTG-7_SMaLfQnbowVBgi3LzS-Q4GgH9bk2WDrJCvI,3806
-cadwyn-2.3.0rc0.dist-info/RECORD,,
+cadwyn/structure/versions.py,sha256=8HNKFVoYXgHgWmvuFVBNkk5gghxWbWlLNC40e00Ba2k,24174
+cadwyn-2.3.1.dist-info/entry_points.txt,sha256=eO05hLn9GoRzzpwT9GONPmXKsonjuMNssM2D2WHWKGk,46
+cadwyn-2.3.1.dist-info/LICENSE,sha256=KeCWewiDQYpmSnzF-p_0YpoWiyDcUPaCuG8OWQs4ig4,1072
+cadwyn-2.3.1.dist-info/WHEEL,sha256=vxFmldFsRN_Hx10GDvsdv1wroKq8r5Lzvjp6GZ4OO8c,88
+cadwyn-2.3.1.dist-info/METADATA,sha256=ggtZVFietBQ_X3eLREzDgRNav3RBrYaCPZY6-gLLVqE,3845
+cadwyn-2.3.1.dist-info/RECORD,,