strawberry-alchemy 0.1.0__tar.gz

strawberry_alchemy-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alteian
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

strawberry_alchemy-0.1.0/PKG-INFO

@@ -0,0 +1,126 @@
+Metadata-Version: 2.4
+Name: strawberry-alchemy
+Version: 0.1.0
+Summary: Toolkit for fast and easy strawberry+sqlalchemy apis
+Keywords: graphql,strawberry,sqlalchemy,async,api,pagination,relay,filtering,permissions,crud,database
+Author: David Roučka
+Author-email: David Roučka <Alteian@proton.me>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: AsyncIO
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Dist: strawberry-graphql>=0.220
+Requires-Dist: sqlalchemy
+Requires-Dist: pydantic>=2.0
+Requires-Dist: python-dateutil>=2.7
+Requires-Python: >=3.13
+Project-URL: Homepage, https://github.com/Alteian/strawberry-alchemy
+Project-URL: Repository, https://github.com/Alteian/strawberry-alchemy
+Project-URL: Issues, https://github.com/Alteian/strawberry-alchemy/issues
+Project-URL: Changelog, https://github.com/Alteian/strawberry-alchemy/blob/master/CHANGELOG.md
+Description-Content-Type: text/markdown
+
+# strawberry-alchemy
+
+<p align="center">
+  <em>Batteries-included toolkit for building <strong>Strawberry GraphQL</strong> APIs backed by <strong>SQLAlchemy</strong></em>
+</p>
+
+<p align="center">
+  <a href="https://github.com/Alteian/strawberry-alchemy/actions/workflows/ci.yml"><img src="https://github.com/Alteian/strawberry-alchemy/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://pypi.org/project/strawberry-alchemy"><img src="https://img.shields.io/pypi/v/strawberry-alchemy?color=%2334D058&label=pypi" alt="PyPI version"></a>
+  <a href="https://pypi.org/project/strawberry-alchemy"><img src="https://img.shields.io/pypi/pyversions/strawberry-alchemy.svg?color=%2334D058" alt="Python versions"></a>
+  <a href="https://github.com/Alteian/strawberry-alchemy/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-MIT-yellow.svg" alt="License: MIT"></a>
+</p>
+
+---
+
+**Source Code**: [https://github.com/Alteian/strawberry-alchemy](https://github.com/Alteian/strawberry-alchemy)
+
+---
+
+## Features
+
+| Module | What it does |
+|---|---|
+| **QueryOptimizer** | Analyzes Strawberry selection sets and builds a single optimized SQLAlchemy query — automatic `joinedload` / `selectinload`, column deferral, annotation injection |
+| **FilterBuilder** | Translates Strawberry input types into SQLAlchemy `WHERE` clauses using a declarative operator system |
+| **Repository** | Generic async CRUD with delete, dependent-map cascading, and lifecycle hooks |
+| **Types** | Relay `Connection` / `Edge` / `PageInfo` pagination, `ListResult`, `BaseNodeType` |
+| **Mapping** | Async helpers to convert SQLAlchemy instances → Strawberry types respecting the selected field tree |
+| **Permissions** | Protocol-based permission primitives: `IsAuthenticated`, `RolePermission`, `OwnerPermission`, `ObjectAccessPermission`, plus resolver pattern and resource-bag |
+| **Models** | Tiny SQLAlchemy `DeclarativeBase` with UUID primary key, timestamps, and automatic table naming |
+| **Utilities** | `camel_to_snake`, `DateTimeProcessor`, `Ordering` enum, common exceptions |
+
+## Installation
+
+```bash
+pip install strawberry-alchemy
+# or with uv
+uv add strawberry-alchemy
+```
+
+## Quick Start
+
+```python
+import strawberry
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from strawberry_alchemy import (
+    BaseNodeType,
+    BaseRepository,
+    FilterBuilder,
+    OptimizedListConnection,
+    QueryOptimizer,
+)
+
+# 1. Define your SQLAlchemy model (or use the provided Base)
+from strawberry_alchemy.models import Base
+
+# 2. Define your Strawberry type
+@strawberry.type
+class BookType(BaseNodeType):
+    title: str
+    author: str
+
+# 3. Use QueryOptimizer in your resolver
+@strawberry.type
+class Query:
+    @strawberry.field
+    async def books(self, info: strawberry.Info) -> list[BookType]:
+        optimizer = QueryOptimizer(session=info.context.db, info=info)
+        result = await optimizer.optimize_query(model=Book)
+        return result.items
+```
+
+## Development
+
+```bash
+git clone https://github.com/Alteian/strawberry-alchemy.git
+cd strawberry-alchemy
+uv sync
+
+# Lint & test
+uv run ruff check .
+uv run pytest -v
+
+# Build
+uv build
+```
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+## License
+
+[MIT](LICENSE)

strawberry_alchemy-0.1.0/README.md

@@ -0,0 +1,95 @@
+# strawberry-alchemy
+
+<p align="center">
+  <em>Batteries-included toolkit for building <strong>Strawberry GraphQL</strong> APIs backed by <strong>SQLAlchemy</strong></em>
+</p>
+
+<p align="center">
+  <a href="https://github.com/Alteian/strawberry-alchemy/actions/workflows/ci.yml"><img src="https://github.com/Alteian/strawberry-alchemy/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://pypi.org/project/strawberry-alchemy"><img src="https://img.shields.io/pypi/v/strawberry-alchemy?color=%2334D058&label=pypi" alt="PyPI version"></a>
+  <a href="https://pypi.org/project/strawberry-alchemy"><img src="https://img.shields.io/pypi/pyversions/strawberry-alchemy.svg?color=%2334D058" alt="Python versions"></a>
+  <a href="https://github.com/Alteian/strawberry-alchemy/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-MIT-yellow.svg" alt="License: MIT"></a>
+</p>
+
+---
+
+**Source Code**: [https://github.com/Alteian/strawberry-alchemy](https://github.com/Alteian/strawberry-alchemy)
+
+---
+
+## Features
+
+| Module | What it does |
+|---|---|
+| **QueryOptimizer** | Analyzes Strawberry selection sets and builds a single optimized SQLAlchemy query — automatic `joinedload` / `selectinload`, column deferral, annotation injection |
+| **FilterBuilder** | Translates Strawberry input types into SQLAlchemy `WHERE` clauses using a declarative operator system |
+| **Repository** | Generic async CRUD with delete, dependent-map cascading, and lifecycle hooks |
+| **Types** | Relay `Connection` / `Edge` / `PageInfo` pagination, `ListResult`, `BaseNodeType` |
+| **Mapping** | Async helpers to convert SQLAlchemy instances → Strawberry types respecting the selected field tree |
+| **Permissions** | Protocol-based permission primitives: `IsAuthenticated`, `RolePermission`, `OwnerPermission`, `ObjectAccessPermission`, plus resolver pattern and resource-bag |
+| **Models** | Tiny SQLAlchemy `DeclarativeBase` with UUID primary key, timestamps, and automatic table naming |
+| **Utilities** | `camel_to_snake`, `DateTimeProcessor`, `Ordering` enum, common exceptions |
+
+## Installation
+
+```bash
+pip install strawberry-alchemy
+# or with uv
+uv add strawberry-alchemy
+```
+
+## Quick Start
+
+```python
+import strawberry
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from strawberry_alchemy import (
+    BaseNodeType,
+    BaseRepository,
+    FilterBuilder,
+    OptimizedListConnection,
+    QueryOptimizer,
+)
+
+# 1. Define your SQLAlchemy model (or use the provided Base)
+from strawberry_alchemy.models import Base
+
+# 2. Define your Strawberry type
+@strawberry.type
+class BookType(BaseNodeType):
+    title: str
+    author: str
+
+# 3. Use QueryOptimizer in your resolver
+@strawberry.type
+class Query:
+    @strawberry.field
+    async def books(self, info: strawberry.Info) -> list[BookType]:
+        optimizer = QueryOptimizer(session=info.context.db, info=info)
+        result = await optimizer.optimize_query(model=Book)
+        return result.items
+```
+
+## Development
+
+```bash
+git clone https://github.com/Alteian/strawberry-alchemy.git
+cd strawberry-alchemy
+uv sync
+
+# Lint & test
+uv run ruff check .
+uv run pytest -v
+
+# Build
+uv build
+```
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+## License
+
+[MIT](LICENSE)

strawberry_alchemy-0.1.0/pyproject.toml

@@ -0,0 +1,71 @@
+[project]
+name = "strawberry-alchemy"
+version = "0.1.0"
+description = "Toolkit for fast and easy strawberry+sqlalchemy apis"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+    { name = "David Roučka", email = "Alteian@proton.me" },
+]
+keywords = ["graphql", "strawberry", "sqlalchemy", "async", "api", "pagination", "relay", "filtering", "permissions", "crud", "database"]
+requires-python = ">=3.13"
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Framework :: AsyncIO",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
+]
+dependencies = [
+    "strawberry-graphql>=0.220",
+    "sqlalchemy",
+    "pydantic>=2.0",
+    "python-dateutil>=2.7",
+]
+
+[project.urls]
+Homepage = "https://github.com/Alteian/strawberry-alchemy"
+Repository = "https://github.com/Alteian/strawberry-alchemy"
+Issues = "https://github.com/Alteian/strawberry-alchemy/issues"
+Changelog = "https://github.com/Alteian/strawberry-alchemy/blob/master/CHANGELOG.md"
+
+[dependency-groups]
+dev = [
+    "pytest>=9.1",
+    "pytest-asyncio>=1.4",
+    "ruff>=0.15",
+    "mypy>=2.1",
+    "aiosqlite>=0.22",
+    "pre-commit>=4.6",
+]
+
+[build-system]
+requires = ["uv_build>=0.11.21"]
+build-backend = "uv_build"
+
+[tool.ruff]
+target-version = "py313"
+line-length = 120
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "N", "UP", "B", "A", "SIM", "TCH"]
+ignore = ["E501"]
+
+[tool.ruff.lint.per-file-ignores]
+"src/strawberry_alchemy/repository/base.py" = ["A002"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+
+[tool.mypy]
+python_version = "3.13"
+strict = true
+plugins = ["strawberry.ext.mypy_plugin"]

strawberry_alchemy-0.1.0/src/strawberry_alchemy/__init__.py

@@ -0,0 +1,124 @@
+from importlib.metadata import version as _version
+
+__version__ = _version("strawberry-alchemy")
+
+from strawberry_alchemy.enums import Ordering
+from strawberry_alchemy.exceptions import NotFoundError
+from strawberry_alchemy.filtering import (
+    AccessControlFilter,
+    BooleanFilter,
+    DateTimeFilter,
+    EnumFilter,
+    FilterBuilder,
+    FilterOperators,
+    IDFilter,
+    IntFilter,
+    StringFilter,
+)
+from strawberry_alchemy.mapping import (
+    map_sqlalchemy_list_to_types,
+    map_sqlalchemy_to_type,
+)
+from strawberry_alchemy.models import Base
+from strawberry_alchemy.optimizer import (
+    AnnotateAncestry,
+    AnnotateAnyExists,
+    AnnotateCount,
+    AnnotateCustom,
+    AnnotateExists,
+    PrefetchRelated,
+    QueryAnalyzer,
+    QueryOptimizer,
+    QueryResult,
+    build_recursive_dependency_tree,
+    merge_dependency_trees,
+    normalize_dependency_fields,
+    optimize_field,
+    source_path_to_dependency_tree,
+)
+from strawberry_alchemy.permissions import (
+    BasePermissionResolver,
+    HasId,
+    IsAuthenticated,
+    ModelRegistryLike,
+    ObjectAccessPermission,
+    OwnerPermission,
+    PermissionContextLike,
+    ResourceInstances,
+    RolePermission,
+    UserLike,
+    extract_global_ids_from_info,
+    fetch_and_check_permissions,
+    map_ids_to_models,
+)
+from strawberry_alchemy.repository import (
+    BaseDeletionHandler,
+    BaseRepository,
+)
+from strawberry_alchemy.schema import BaseSchema
+from strawberry_alchemy.types import (
+    BaseNodeType,
+    Edge,
+    ListResult,
+    OptimizedListConnection,
+    PageInfo,
+    SliceMetadata,
+)
+from strawberry_alchemy.utils import (
+    camel_to_snake,
+)
+
+__all__ = (
+    "__version__",
+    "AccessControlFilter",
+    "AnnotateAncestry",
+    "AnnotateAnyExists",
+    "AnnotateCount",
+    "AnnotateCustom",
+    "AnnotateExists",
+    "Base",
+    "BaseDeletionHandler",
+    "BaseNodeType",
+    "BasePermissionResolver",
+    "BaseRepository",
+    "BaseSchema",
+    "BooleanFilter",
+    "DateTimeFilter",
+    "Edge",
+    "EnumFilter",
+    "FilterBuilder",
+    "FilterOperators",
+    "HasId",
+    "IDFilter",
+    "IntFilter",
+    "IsAuthenticated",
+    "ListResult",
+    "ModelRegistryLike",
+    "NotFoundError",
+    "ObjectAccessPermission",
+    "OptimizedListConnection",
+    "Ordering",
+    "OwnerPermission",
+    "PageInfo",
+    "PermissionContextLike",
+    "PrefetchRelated",
+    "QueryAnalyzer",
+    "QueryOptimizer",
+    "QueryResult",
+    "ResourceInstances",
+    "RolePermission",
+    "SliceMetadata",
+    "StringFilter",
+    "UserLike",
+    "camel_to_snake",
+    "extract_global_ids_from_info",
+    "fetch_and_check_permissions",
+    "map_ids_to_models",
+    "map_sqlalchemy_list_to_types",
+    "map_sqlalchemy_to_type",
+    "optimize_field",
+    "build_recursive_dependency_tree",
+    "merge_dependency_trees",
+    "normalize_dependency_fields",
+    "source_path_to_dependency_tree",
+)

strawberry_alchemy-0.1.0/src/strawberry_alchemy/enums.py

@@ -0,0 +1,9 @@
+from enum import Enum
+
+import strawberry
+
+
+@strawberry.enum
+class Ordering(Enum):
+    ASC = "ASC"
+    DESC = "DESC"

strawberry_alchemy-0.1.0/src/strawberry_alchemy/exceptions.py

@@ -0,0 +1,2 @@
+class NotFoundError(Exception):
+    pass

strawberry_alchemy-0.1.0/src/strawberry_alchemy/filtering/__init__.py

@@ -0,0 +1,23 @@
+from .access_control import AccessControlFilter
+from .filter_builder import FilterBuilder
+from .inputs import (
+    BooleanFilter,
+    DateTimeFilter,
+    EnumFilter,
+    IDFilter,
+    IntFilter,
+    StringFilter,
+)
+from .operators import FilterOperators
+
+__all__ = (
+    "AccessControlFilter",
+    "BooleanFilter",
+    "DateTimeFilter",
+    "EnumFilter",
+    "FilterBuilder",
+    "FilterOperators",
+    "IDFilter",
+    "IntFilter",
+    "StringFilter",
+)

strawberry_alchemy-0.1.0/src/strawberry_alchemy/filtering/access_control.py

@@ -0,0 +1,19 @@
+from typing import Any
+
+
+class AccessControlMeta(type):
+    def __init__(
+        cls: "type[AccessControlFilter]",
+        name: str,
+        bases: tuple[type, ...],
+        dct: dict[str, Any],
+    ) -> None:
+        if name != "AccessControlFilter" and not name.endswith("AccessFilter"):
+            raise TypeError(f"Subclass {name} must end with 'AccessFilter'")
+        super().__init__(name, bases, dct)
+
+
+class AccessControlFilter(metaclass=AccessControlMeta):
+    @staticmethod
+    async def apply_filter(query: Any, model: type[Any], context_user: Any) -> Any:
+        raise NotImplementedError("Subclasses must implement the apply_filter method")