chore(release): update to v0.33.0

Author: cofin

.pre-commit-config.yaml

@@ -22,7 +22,7 @@ repos:
       - id: unasyncd
         additional_dependencies: ["ruff"]
   - repo: https://github.com/charliermarsh/ruff-pre-commit
-    rev: "v0.9.9"
+    rev: "v0.9.10"
     hooks:
       # Run the linter.
     - id: ruff

advanced_alchemy/repository/_util.py

@@ -185,25 +185,17 @@ class FilterableRepositoryProtocol(Protocol[ModelT]):
 
     This protocol defines the required attributes and methods that any
     filterable repository implementation must provide.
-
-    Type Parameters:
-        ModelT: :class:`~advanced_alchemy.base.ModelProtocol` The SQLAlchemy model type this repository handles.
-
-    Attributes:
-        model_type: :class:`~advanced_alchemy.base.ModelProtocol` The SQLAlchemy model class this repository manages.
     """
 
     model_type: type[ModelT]
+    """The SQLAlchemy model class this repository manages."""
 
 
 class FilterableRepository(FilterableRepositoryProtocol[ModelT]):
     """Default implementation of a filterable repository.
 
     Provides core filtering, ordering and pagination functionality for
     SQLAlchemy models.
-
-    Type Parameters:
-        ModelT: :class:`~advanced_alchemy.base.ModelProtocol` The SQLAlchemy model type this repository handles.
     """
 
     model_type: type[ModelT]

docs/changelog.rst

@@ -3,6 +3,22 @@
 0.x Changelog
 =============
 
+.. changelog:: 0.33.0
+    :date: 2025-03-07
+
+    .. change:: Add dependency factory utilities
+        :type: feature
+        :pr: 405
+
+        Introduces a new module `advanced_alchemy.extensions.litestar.providers` with comprehensive dependency injection utilities for SQLAlchemy services in Litestar. The module provides:
+
+        - Dynamic filter configuration generation
+        - Dependency caching mechanism
+        - Flexible filter and pagination support
+        - Singleton metaclass for dependency management
+        - Configurable filter and search dependencies
+
+
 .. changelog:: 0.32.2
     :date: 2025-02-26
 

docs/usage/database_seeding.rst

@@ -502,8 +502,8 @@ Best Practices
 Tips for Efficient Seeding
 --------------------------
 
-- Use :func:`add_many (async) <advanced_alchemy.repository.SQLAlchemyAsyncRepositoryProtocol.add_many>` / :func:`add_many (sync) <advanced_alchemy.repository.SQLAlchemySyncRepositoryProtocol.add_many>` instead of adding objects one by one for better performance.
-- Use :func:`upsert_many (async) <advanced_alchemy.repository.SQLAlchemyAsyncRepositoryProtocol.upsert_many>` / :func:`upsert_many (sync) <advanced_alchemy.repository.SQLAlchemySyncRepositoryProtocol.upsert_many>` to update your data if you are updating prices for example.
+- Use :func:`add_many (async) <advanced_alchemy.repository.SQLAlchemyAsyncRepository.add_many>` / :func:`add_many (sync) <advanced_alchemy.repository.SQLAlchemySyncRepository.add_many>` instead of adding objects one by one for better performance.
+- Use :func:`upsert_many (async) <advanced_alchemy.repository.SQLAlchemyAsyncRepository.upsert_many>` / :func:`upsert_many (sync) <advanced_alchemy.repository.SQLAlchemySyncRepository.upsert_many>` to update your data if you are updating prices for example.
 - You can use the database seeding from your cli, app startup or any route.
 - For large datasets, consider chunking the data into smaller batches.
 - When dealing with relationships, seed parent records before child records.

pyproject.toml

@@ -44,7 +44,7 @@ maintainers = [
 name = "advanced_alchemy"
 readme = "README.md"
 requires-python = ">=3.9"
-version = "0.32.2"
+version = "0.33.0"
 
 [project.urls]
 Changelog = "https://docs.advanced-alchemy.litestar.dev/latest/changelog"
@@ -157,9 +157,9 @@ test = [
 
 [tool.bumpversion]
 allow_dirty = true
-commit = true
+commit = false
 commit_args = "--no-verify"
-current_version = "0.32.0"
+current_version = "0.33.0"
 ignore_missing_files = false
 ignore_missing_version = false
 message = "chore(release): bump to v{new_version}"

tools/sphinx_ext/missing_references.py

@@ -180,6 +180,8 @@ def _resolve_advanced_alchemy_reference(target: str, module: str) -> bool:
         "GenericAlembicConfig",
     }
 
+    func_references = {"repository.SQLAlchemyAsyncRepositoryProtocol.add_many"}
+
     # Handle type module references
     type_classes = {"DateTimeUTC", "ORA_JSONB", "GUID", "EncryptedString", "EncryptedText"}
 
@@ -189,7 +191,7 @@ def _resolve_advanced_alchemy_reference(target: str, module: str) -> bool:
     # Handle fully qualified references
     if target.startswith("advanced_alchemy."):
         parts = target.split(".")
-        if parts[-1] in base_classes | config_classes | type_classes:
+        if parts[-1] in base_classes | config_classes | type_classes | func_references:
             return True
 
     # Handle module-relative references
@@ -240,7 +242,6 @@ def on_warn_missing_reference(app: Sphinx, domain: str, node: Node) -> bool | No
     target = attributes["reftarget"]
     ref_type = attributes.get("reftype")
     module = attributes.get("py:module", "")
-
     # Handle TypeVar references
     if hasattr(target, "__class__") and target.__class__.__name__ == "TypeVar":
         return True