Add everything

Author: zmievsa

CHANGELOG.md

@@ -5,13 +5,16 @@ Please follow [the Keep a Changelog standard](https://keepachangelog.com/en/1.0.
 
 ## [Unreleased]
 
-### Removed
-
-* `regex`, `include`, `min_items`, `max_items`, and `unique_items` arguments were removed from `schema(...).field(...).had`. Notice that it's not a breaking change for most cases because passing these arguments caused exceptions
+## [4.2.0]
 
 ### Added
 
-* Automatic creation of versioned_routers based on the `VersionBundle` passed to `Cadwyn` 
+* Automatic changelog generation from version changes using `Cadwyn.generate_changelog` method and `GET /changelog` endpoint.
+* Automatic creation of versioned_routers based on the `VersionBundle` passed to `Cadwyn` which means that all versions mentioned in the version bundle will already be available for routing even without the use of `generate_and_include_versioned_routers`
+
+### Removed
+
+* `regex`, `include`, `min_items`, `max_items`, and `unique_items` arguments were removed from `schema(...).field(...).had`. Notice that it's not a breaking change for most cases because passing these arguments caused exceptions
 
 ## [4.1.0]
 

Makefile

@@ -8,7 +8,7 @@ lint:
 	pre-commit run --all-files
 
 format:
-	poetry run ruff . --fix && poetry run ruff format .;
+	poetry run ruff check . --fix && poetry run ruff format .;
 
 test:
 	rm -f .coverage coverage.xml; \

cadwyn/__init__.py

@@ -1,6 +1,7 @@
 import importlib.metadata
 
 from .applications import Cadwyn
+from .changelogs import hidden
 from .route_generation import VersionedAPIRouter, generate_versioned_routers
 from .schema_generation import generate_versioned_models, migrate_response_body
 from .structure import (
@@ -37,4 +38,5 @@
     "RequestInfo",
     "ResponseInfo",
     "generate_versioned_models",
+    "hidden",
 ]

cadwyn/applications.py

@@ -25,6 +25,7 @@
 from starlette.types import Lifespan
 from typing_extensions import Self
 
+from cadwyn.changelogs import CadwynChangelogResource, _generate_changelog
 from cadwyn.middleware import HeaderVersioningMiddleware, _get_api_version_dependency
 from cadwyn.route_generation import generate_versioned_routers
 from cadwyn.routing import _RootHeaderAPIRouter
@@ -47,6 +48,8 @@ def __init__(
         *,
         versions: VersionBundle,
         api_version_header_name: str = "x-api-version",
+        changelog_url: str | None = "/changelog",
+        include_changelog_url_in_schema: bool = True,
         debug: bool = False,
         title: str = "FastAPI",
         summary: str | None = None,
@@ -154,13 +157,16 @@ def __init__(
             api_version_var=self.versions.api_version_var,
         )
 
+        self.changelog_url = changelog_url
+        self.include_changelog_url_in_schema = include_changelog_url_in_schema
+
         self.docs_url = docs_url
         self.redoc_url = redoc_url
         self.openapi_url = openapi_url
         self.redoc_url = redoc_url
 
         unversioned_router = APIRouter(**self._kwargs_to_router)
-        self._add_openapi_endpoints(unversioned_router)
+        self._add_utility_endpoints(unversioned_router)
         self._add_default_versioned_routers()
         self.include_router(unversioned_router)
         self.add_middleware(
@@ -189,7 +195,19 @@ def dependency_overrides(  # pyright: ignore[reportIncompatibleVariableOverride]
     ) -> None:
         self._dependency_overrides_provider.dependency_overrides = value
 
-    def _add_openapi_endpoints(self, unversioned_router: APIRouter):
+    def generate_changelog(self) -> CadwynChangelogResource:
+        return _generate_changelog(self.versions, self.router)
+
+    def _add_utility_endpoints(self, unversioned_router: APIRouter):
+        if self.changelog_url is not None:
+            unversioned_router.add_api_route(
+                path=self.changelog_url,
+                endpoint=self.generate_changelog,
+                response_model=CadwynChangelogResource,
+                methods=["GET"],
+                include_in_schema=self.include_changelog_url_in_schema,
+            )
+
         if self.openapi_url is not None:
             unversioned_router.add_route(
                 path=self.openapi_url,