GeneralManager 0.15.1__tar.gz → 0.16.1__tar.gz

{generalmanager-0.15.1/src/GeneralManager.egg-info → generalmanager-0.16.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: GeneralManager
-Version: 0.15.1
+Version: 0.16.1
 Summary: Modular Django-based data management framework with ORM, GraphQL, fine-grained permissions, rule validation, calculations and caching.
 Author-email: Tim Kleindick <tkleindick@yahoo.de>
 License: MIT License
@@ -24,6 +24,12 @@ License: MIT License
         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.
+Project-URL: Homepage, https://github.com/TimKleindick/general_manager
+Project-URL: Documentation, https://timkleindick.github.io/general_manager/
+Project-URL: Repository, https://github.com/TimKleindick/general_manager
+Project-URL: Issues, https://github.com/TimKleindick/general_manager/issues
+Project-URL: Changelog, https://github.com/TimKleindick/general_manager/releases
+Keywords: django,orm,graphql,permissions,validation,caching,framework
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
@@ -32,6 +38,7 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Framework :: Django
 Classifier: Intended Audience :: Developers
 Classifier: Operating System :: OS Independent
+Classifier: Typing :: Typed
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
@@ -54,7 +61,6 @@ Requires-Dist: Pint>=0.24.4
 Requires-Dist: platformdirs>=4.3.7
 Requires-Dist: promise>=2.3
 Requires-Dist: python-dateutil>=2.9.0.post0
-Requires-Dist: setuptools==80.0.0
 Requires-Dist: six>=1.17.0
 Requires-Dist: smmap>=5.0.2
 Requires-Dist: sqlparse>=0.5.3
@@ -73,135 +79,95 @@ Dynamic: license-file
 
 ## Overview
 
-GeneralManager is a powerful and flexible framework designed for managing and processing data. It provides a modular structure that enables developers to implement complex business logic efficiently. The module is written entirely in Python and uses Django as the backend framework.
+GeneralManager helps teams ship complex, data-driven products on top of Django without rewriting the same plumbing for every project. It combines domain modelling, GraphQL APIs, calculations, and permission logic in one toolkit so that you can focus on business rules instead of infrastructure.
 
-## Key Features
-
-### 1. **Data Management**
-- **Flexibility**: Supports managing all kinds of data, not just projects and derivatives.
-- **Database Integration**: Seamless integration with the Django ORM for database operations.
-- **External Interfaces**: Support for interfaces to other programs, such as Excel.
-
-### 2. **Data Modeling**
-- **Django Models**: The data structure is based on Django models, extended by custom fields like `MeasurementField`.
-- **Rules and Validations**: Define rules for data validation, e.g., ensuring that a project's start date is before its end date.
+## Documentation
 
-### 3. **GraphQL Integration**
-- Automatic generation of GraphQL interfaces for all models.
-- Support for custom queries and mutations.
+The full documentation is published on GitHub Pages: [GeneralManager Documentation](https://timkleindick.github.io/general_manager/). It covers tutorials, concept guides, API reference, and examples.
 
-### 4. **Permission System**
-- **ManagerBasedPermission**: A flexible permission system based on user roles and attributes.
-- Attribute-level CRUD permissions.
-
-### 5. **Interfaces**
-- **CalculationInterface**: Allows the implementation of calculation logic.
-- **DatabaseInterface**: Provides a standardized interface for database operations.
-- **ReadOnlyInterface**: For read-only data access.
+## Key Features
 
-### 6. **Data Distribution and Calculations**
-- **Volume Distribution**: Automatically calculates and distributes volume over multiple years.
-- **Commercial Calculations**: Calculates total volume, shipping costs, and revenue for projects.
+- **Domain-first modelling**: Describe rich business entities in plain Python and let GeneralManager project them onto the Django ORM.
+- **GraphQL without boilerplate**: Generate a complete API, then extend it with custom queries and mutations when needed.
+- **Attribute-based access control**: Enforce permissions with `ManagerBasedPermission` down to single fields and operations.
+- **Deterministic calculations**: Ship reusable interfaces e.g. for volume distributions, KPI calculations, and derived data.
+- **Factory-powered testing**: Create large, realistic datasets quickly for demos, QA, and load tests.
+- **Composable interfaces**: Connect to databases, spreadsheets, or computed sources with the same consistent abstractions.
 
-## Usage
+## Quick Start
 
 ### Installation
 
-Install the module via `pip`:
+Install the package from PyPI:
 
 ```bash
 pip install GeneralManager
 ```
 
-### Example Code
-
-The following example demonstrates how to create a GeneralManager and generate sample data (in this case 10 projects):
+### Minimal example
 
 ```python
+from datetime import date
+from typing import Optional
+
+from django.db.models import CharField, DateField
+
 from general_manager import GeneralManager
 from general_manager.interface.database import DatabaseInterface
-from general_manager.measurement import MeasurementField, Measurement
+from general_manager.measurement import Measurement, MeasurementField
 from general_manager.permission import ManagerBasedPermission
 
+
 class Project(GeneralManager):
     name: str
     start_date: Optional[date]
     end_date: Optional[date]
     total_capex: Optional[Measurement]
-    derivative_list: DatabaseBucket[Derivative]
 
     class Interface(DatabaseInterface):
         name = CharField(max_length=50)
-        number = CharField(max_length=7, validators=[RegexValidator(r"^AP\d{4,5}$")])
-        description = TextField(null=True, blank=True)
         start_date = DateField(null=True, blank=True)
         end_date = DateField(null=True, blank=True)
         total_capex = MeasurementField(base_unit="EUR", null=True, blank=True)
 
-        class Meta:
-            constraints = [
-                constraints.UniqueConstraint(
-                    fields=["name", "number"], name="unique_booking"
-                )
-            ]
-
-            rules = [
-                Rule["Project"](
-                    lambda x: cast(date, x.start_date) < cast(date, x.end_date)
-                ),
-                Rule["Project"](lambda x: cast(Measurement, x.total_capex) >= "0 EUR"),
-            ]
-
-        class Factory:
-            name = LazyProjectName()
-            end_date = LazyDeltaDate(365 * 6, "start_date")
-            total_capex = LazyMeasurement(75_000, 1_000_000, "EUR")
-
     class Permission(ManagerBasedPermission):
-        __read__ = ["ends_with:name:X-771", "public"]
-        __create__ = ["admin", "isMatchingKeyAccount"]
-        __update__ = ["admin", "isMatchingKeyAccount", "isProjectTeamMember"]
-        __delete__ = ["admin", "isMatchingKeyAccount", "isProjectTeamMember"]
+        __read__ = ["public"]
+        __create__ = ["isAdmin"]
+        __update__ = ["isAdmin"]
 
-        total_capex = {"update": ["isSalesResponsible", "isProjectManager"]}
 
 Project.Factory.createBatch(10)
 ```
 
-### GraphQL Integration
+The example above defines a project model, exposes it through the auto-generated GraphQL schema, and produces ten sample records with a single call. The full documentation walks through extending this setup with custom rules, interfaces, and queries.
 
-The module automatically generates GraphQL endpoints for all models. You can run queries and mutations through the GraphQL URL defined in your Django settings.
+## Core Building Blocks
 
-Example of a GraphQL query:
+- **Entities & interfaces**: Compose domain entities with database-backed or computed interfaces to control persistence and data flows.
+- **Rules & validation**: Protect your data with declarative constraints and business rules that run automatically.
+- **Permissions**: Implement attribute-based access control with reusable policies that match your organisation’s roles.
+- **GraphQL layer**: Serve a typed schema that mirrors your models and stays in sync as you iterate.
+- **Caching & calculations**: Use the built-in caching decorator and calculation helpers to keep derived data fast and reliable.
 
-```graphql
-query {
-  projectList {
-    name
-    startDate
-    endDate
-    totalCapex {
-      value
-      unit
-    }
-  }
-}
-```
+## Production-Ready Extras
+
+- Works with Postgres, SQLite, and any database supported by Django.
+- Plays nicely with CI thanks to deterministic factories, typing, and code coverage.
+- Ships with MkDocs documentation, auto-generated API reference, and a growing cookbook of recipes.
+- Designed for teams: opinionated defaults without blocking custom extensions or overrides.
 
-## Benefits
+## Use Cases
 
-- **Modularity**: Easy to extend and adapt.
-- **Flexibility**: Supports complex business logic and calculations.
-- **Integration**: Seamless integration with Django and GraphQL.
-- **Permissions**: Fine-grained permissions for users and attributes.
-- **Data Validation**: Automatic validation of data through rules and constraints.
-- **Caching**: Automatic cache generation with the `@cached` decorator to improve performance.
+- Internal tooling that mirrors real-world workflows, pricing models, or asset hierarchies.
+- Customer-facing platforms that combine transactional data with live calculations.
+- Analytics products that need controlled data sharing between teams or clients.
+- Proof-of-concept projects that must scale into production without a rewrite.
 
 ## Requirements
 
 - Python >= 3.12
 - Django >= 5.2
-- Additional dependencies (see `requirements.txt`):
+- Additional dependencies (see `requirements/base.txt`):
   - `graphene`
   - `numpy`
   - `Pint`

generalmanager-0.16.1/README.md

@@ -0,0 +1,108 @@
+# GeneralManager
+
+[![PyPI](https://img.shields.io/pypi/v/GeneralManager.svg)](https://pypi.org/project/GeneralManager/)
+[![Python](https://img.shields.io/pypi/pyversions/GeneralManager.svg)](https://pypi.org/project/GeneralManager/)
+[![Build](https://github.com/TimKleindick/general_manager/actions/workflows/test.yml/badge.svg?branch=main)](https://github.com/TimKleindick/general_manager/actions/workflows/test.yml)
+[![Coverage](https://img.shields.io/codecov/c/github/TimKleindick/general_manager)](https://app.codecov.io/gh/TimKleindick/general_manager)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
+## Overview
+
+GeneralManager helps teams ship complex, data-driven products on top of Django without rewriting the same plumbing for every project. It combines domain modelling, GraphQL APIs, calculations, and permission logic in one toolkit so that you can focus on business rules instead of infrastructure.
+
+## Documentation
+
+The full documentation is published on GitHub Pages: [GeneralManager Documentation](https://timkleindick.github.io/general_manager/). It covers tutorials, concept guides, API reference, and examples.
+
+## Key Features
+
+- **Domain-first modelling**: Describe rich business entities in plain Python and let GeneralManager project them onto the Django ORM.
+- **GraphQL without boilerplate**: Generate a complete API, then extend it with custom queries and mutations when needed.
+- **Attribute-based access control**: Enforce permissions with `ManagerBasedPermission` down to single fields and operations.
+- **Deterministic calculations**: Ship reusable interfaces e.g. for volume distributions, KPI calculations, and derived data.
+- **Factory-powered testing**: Create large, realistic datasets quickly for demos, QA, and load tests.
+- **Composable interfaces**: Connect to databases, spreadsheets, or computed sources with the same consistent abstractions.
+
+## Quick Start
+
+### Installation
+
+Install the package from PyPI:
+
+```bash
+pip install GeneralManager
+```
+
+### Minimal example
+
+```python
+from datetime import date
+from typing import Optional
+
+from django.db.models import CharField, DateField
+
+from general_manager import GeneralManager
+from general_manager.interface.database import DatabaseInterface
+from general_manager.measurement import Measurement, MeasurementField
+from general_manager.permission import ManagerBasedPermission
+
+
+class Project(GeneralManager):
+    name: str
+    start_date: Optional[date]
+    end_date: Optional[date]
+    total_capex: Optional[Measurement]
+
+    class Interface(DatabaseInterface):
+        name = CharField(max_length=50)
+        start_date = DateField(null=True, blank=True)
+        end_date = DateField(null=True, blank=True)
+        total_capex = MeasurementField(base_unit="EUR", null=True, blank=True)
+
+    class Permission(ManagerBasedPermission):
+        __read__ = ["public"]
+        __create__ = ["isAdmin"]
+        __update__ = ["isAdmin"]
+
+
+Project.Factory.createBatch(10)
+```
+
+The example above defines a project model, exposes it through the auto-generated GraphQL schema, and produces ten sample records with a single call. The full documentation walks through extending this setup with custom rules, interfaces, and queries.
+
+## Core Building Blocks
+
+- **Entities & interfaces**: Compose domain entities with database-backed or computed interfaces to control persistence and data flows.
+- **Rules & validation**: Protect your data with declarative constraints and business rules that run automatically.
+- **Permissions**: Implement attribute-based access control with reusable policies that match your organisation’s roles.
+- **GraphQL layer**: Serve a typed schema that mirrors your models and stays in sync as you iterate.
+- **Caching & calculations**: Use the built-in caching decorator and calculation helpers to keep derived data fast and reliable.
+
+## Production-Ready Extras
+
+- Works with Postgres, SQLite, and any database supported by Django.
+- Plays nicely with CI thanks to deterministic factories, typing, and code coverage.
+- Ships with MkDocs documentation, auto-generated API reference, and a growing cookbook of recipes.
+- Designed for teams: opinionated defaults without blocking custom extensions or overrides.
+
+## Use Cases
+
+- Internal tooling that mirrors real-world workflows, pricing models, or asset hierarchies.
+- Customer-facing platforms that combine transactional data with live calculations.
+- Analytics products that need controlled data sharing between teams or clients.
+- Proof-of-concept projects that must scale into production without a rewrite.
+
+## Requirements
+
+- Python >= 3.12
+- Django >= 5.2
+- Additional dependencies (see `requirements/base.txt`):
+  - `graphene`
+  - `numpy`
+  - `Pint`
+  - `factory_boy`
+  - and more.
+
+## License
+
+This project is distributed under the **MIT License**. For further details see the [LICENSE](./LICENSE) file.

{generalmanager-0.15.1 → generalmanager-0.16.1}/pyproject.toml

@@ -1,14 +1,24 @@
 [build-system]
-requires = ["setuptools>=42", "wheel"]
+requires = ["setuptools>=68", "wheel"]
 build-backend = "setuptools.build_meta"
 
 [project]
 name = "GeneralManager"
-version = "0.15.1"
+version = "0.16.1"
 description = "Modular Django-based data management framework with ORM, GraphQL, fine-grained permissions, rule validation, calculations and caching."
 readme = "README.md"
 authors = [{ name = "Tim Kleindick", email = "tkleindick@yahoo.de" }]
 license = { file = "LICENSE" }
+requires-python = ">=3.12"
+keywords = [
+    "django",
+    "orm",
+    "graphql",
+    "permissions",
+    "validation",
+    "caching",
+    "framework",
+]
 classifiers = [
     "License :: OSI Approved :: MIT License",
     "Programming Language :: Python :: 3",
@@ -18,8 +28,8 @@ classifiers = [
     "Framework :: Django",
     "Intended Audience :: Developers",
     "Operating System :: OS Independent",
+    "Typing :: Typed",
 ]
-requires-python = ">=3.12"
 dependencies = [
     "asgiref>=3.8.1",
     "Django>=5.2.7",
@@ -40,7 +50,6 @@ dependencies = [
     "platformdirs>=4.3.7",
     "promise>=2.3",
     "python-dateutil>=2.9.0.post0",
-    "setuptools==80.0.0",
     "six>=1.17.0",
     "smmap>=5.0.2",
     "sqlparse>=0.5.3",
@@ -49,9 +58,22 @@ dependencies = [
     "tzdata>=2025.2",
 ]
 
+[project.urls]
+Homepage = "https://github.com/TimKleindick/general_manager"
+Documentation = "https://timkleindick.github.io/general_manager/"
+Repository = "https://github.com/TimKleindick/general_manager"
+Issues = "https://github.com/TimKleindick/general_manager/issues"
+Changelog = "https://github.com/TimKleindick/general_manager/releases"
+
+[tool.setuptools]
+include-package-data = true
+
 [tool.setuptools.packages.find]
 where = ["src"]
 
+[tool.setuptools.package-data]
+"general_manager" = ["py.typed"]
+
 [tool.semantic_release]
 allow_zero_version = true
 major_on_zero = false

{generalmanager-0.15.1 → generalmanager-0.16.1/src/GeneralManager.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: GeneralManager
-Version: 0.15.1
+Version: 0.16.1
 Summary: Modular Django-based data management framework with ORM, GraphQL, fine-grained permissions, rule validation, calculations and caching.
 Author-email: Tim Kleindick <tkleindick@yahoo.de>
 License: MIT License
@@ -24,6 +24,12 @@ License: MIT License
         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.
+Project-URL: Homepage, https://github.com/TimKleindick/general_manager
+Project-URL: Documentation, https://timkleindick.github.io/general_manager/
+Project-URL: Repository, https://github.com/TimKleindick/general_manager
+Project-URL: Issues, https://github.com/TimKleindick/general_manager/issues
+Project-URL: Changelog, https://github.com/TimKleindick/general_manager/releases
+Keywords: django,orm,graphql,permissions,validation,caching,framework
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
@@ -32,6 +38,7 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Framework :: Django
 Classifier: Intended Audience :: Developers
 Classifier: Operating System :: OS Independent
+Classifier: Typing :: Typed
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
@@ -54,7 +61,6 @@ Requires-Dist: Pint>=0.24.4
 Requires-Dist: platformdirs>=4.3.7
 Requires-Dist: promise>=2.3
 Requires-Dist: python-dateutil>=2.9.0.post0
-Requires-Dist: setuptools==80.0.0
 Requires-Dist: six>=1.17.0
 Requires-Dist: smmap>=5.0.2
 Requires-Dist: sqlparse>=0.5.3
@@ -73,135 +79,95 @@ Dynamic: license-file
 
 ## Overview
 
-GeneralManager is a powerful and flexible framework designed for managing and processing data. It provides a modular structure that enables developers to implement complex business logic efficiently. The module is written entirely in Python and uses Django as the backend framework.
+GeneralManager helps teams ship complex, data-driven products on top of Django without rewriting the same plumbing for every project. It combines domain modelling, GraphQL APIs, calculations, and permission logic in one toolkit so that you can focus on business rules instead of infrastructure.
 
-## Key Features
-
-### 1. **Data Management**
-- **Flexibility**: Supports managing all kinds of data, not just projects and derivatives.
-- **Database Integration**: Seamless integration with the Django ORM for database operations.
-- **External Interfaces**: Support for interfaces to other programs, such as Excel.
-
-### 2. **Data Modeling**
-- **Django Models**: The data structure is based on Django models, extended by custom fields like `MeasurementField`.
-- **Rules and Validations**: Define rules for data validation, e.g., ensuring that a project's start date is before its end date.
+## Documentation
 
-### 3. **GraphQL Integration**
-- Automatic generation of GraphQL interfaces for all models.
-- Support for custom queries and mutations.
+The full documentation is published on GitHub Pages: [GeneralManager Documentation](https://timkleindick.github.io/general_manager/). It covers tutorials, concept guides, API reference, and examples.
 
-### 4. **Permission System**
-- **ManagerBasedPermission**: A flexible permission system based on user roles and attributes.
-- Attribute-level CRUD permissions.
-
-### 5. **Interfaces**
-- **CalculationInterface**: Allows the implementation of calculation logic.
-- **DatabaseInterface**: Provides a standardized interface for database operations.
-- **ReadOnlyInterface**: For read-only data access.
+## Key Features
 
-### 6. **Data Distribution and Calculations**
-- **Volume Distribution**: Automatically calculates and distributes volume over multiple years.
-- **Commercial Calculations**: Calculates total volume, shipping costs, and revenue for projects.
+- **Domain-first modelling**: Describe rich business entities in plain Python and let GeneralManager project them onto the Django ORM.
+- **GraphQL without boilerplate**: Generate a complete API, then extend it with custom queries and mutations when needed.
+- **Attribute-based access control**: Enforce permissions with `ManagerBasedPermission` down to single fields and operations.
+- **Deterministic calculations**: Ship reusable interfaces e.g. for volume distributions, KPI calculations, and derived data.
+- **Factory-powered testing**: Create large, realistic datasets quickly for demos, QA, and load tests.
+- **Composable interfaces**: Connect to databases, spreadsheets, or computed sources with the same consistent abstractions.
 
-## Usage
+## Quick Start
 
 ### Installation
 
-Install the module via `pip`:
+Install the package from PyPI:
 
 ```bash
 pip install GeneralManager
 ```
 
-### Example Code
-
-The following example demonstrates how to create a GeneralManager and generate sample data (in this case 10 projects):
+### Minimal example
 
 ```python
+from datetime import date
+from typing import Optional
+
+from django.db.models import CharField, DateField
+
 from general_manager import GeneralManager
 from general_manager.interface.database import DatabaseInterface
-from general_manager.measurement import MeasurementField, Measurement
+from general_manager.measurement import Measurement, MeasurementField
 from general_manager.permission import ManagerBasedPermission
 
+
 class Project(GeneralManager):
     name: str
     start_date: Optional[date]
     end_date: Optional[date]
     total_capex: Optional[Measurement]
-    derivative_list: DatabaseBucket[Derivative]
 
     class Interface(DatabaseInterface):
         name = CharField(max_length=50)
-        number = CharField(max_length=7, validators=[RegexValidator(r"^AP\d{4,5}$")])
-        description = TextField(null=True, blank=True)
         start_date = DateField(null=True, blank=True)
         end_date = DateField(null=True, blank=True)
         total_capex = MeasurementField(base_unit="EUR", null=True, blank=True)
 
-        class Meta:
-            constraints = [
-                constraints.UniqueConstraint(
-                    fields=["name", "number"], name="unique_booking"
-                )
-            ]
-
-            rules = [
-                Rule["Project"](
-                    lambda x: cast(date, x.start_date) < cast(date, x.end_date)
-                ),
-                Rule["Project"](lambda x: cast(Measurement, x.total_capex) >= "0 EUR"),
-            ]
-
-        class Factory:
-            name = LazyProjectName()
-            end_date = LazyDeltaDate(365 * 6, "start_date")
-            total_capex = LazyMeasurement(75_000, 1_000_000, "EUR")
-
     class Permission(ManagerBasedPermission):
-        __read__ = ["ends_with:name:X-771", "public"]
-        __create__ = ["admin", "isMatchingKeyAccount"]
-        __update__ = ["admin", "isMatchingKeyAccount", "isProjectTeamMember"]
-        __delete__ = ["admin", "isMatchingKeyAccount", "isProjectTeamMember"]
+        __read__ = ["public"]
+        __create__ = ["isAdmin"]
+        __update__ = ["isAdmin"]
 
-        total_capex = {"update": ["isSalesResponsible", "isProjectManager"]}
 
 Project.Factory.createBatch(10)
 ```
 
-### GraphQL Integration
+The example above defines a project model, exposes it through the auto-generated GraphQL schema, and produces ten sample records with a single call. The full documentation walks through extending this setup with custom rules, interfaces, and queries.
 
-The module automatically generates GraphQL endpoints for all models. You can run queries and mutations through the GraphQL URL defined in your Django settings.
+## Core Building Blocks
 
-Example of a GraphQL query:
+- **Entities & interfaces**: Compose domain entities with database-backed or computed interfaces to control persistence and data flows.
+- **Rules & validation**: Protect your data with declarative constraints and business rules that run automatically.
+- **Permissions**: Implement attribute-based access control with reusable policies that match your organisation’s roles.
+- **GraphQL layer**: Serve a typed schema that mirrors your models and stays in sync as you iterate.
+- **Caching & calculations**: Use the built-in caching decorator and calculation helpers to keep derived data fast and reliable.
 
-```graphql
-query {
-  projectList {
-    name
-    startDate
-    endDate
-    totalCapex {
-      value
-      unit
-    }
-  }
-}
-```
+## Production-Ready Extras
+
+- Works with Postgres, SQLite, and any database supported by Django.
+- Plays nicely with CI thanks to deterministic factories, typing, and code coverage.
+- Ships with MkDocs documentation, auto-generated API reference, and a growing cookbook of recipes.
+- Designed for teams: opinionated defaults without blocking custom extensions or overrides.
 
-## Benefits
+## Use Cases
 
-- **Modularity**: Easy to extend and adapt.
-- **Flexibility**: Supports complex business logic and calculations.
-- **Integration**: Seamless integration with Django and GraphQL.
-- **Permissions**: Fine-grained permissions for users and attributes.
-- **Data Validation**: Automatic validation of data through rules and constraints.
-- **Caching**: Automatic cache generation with the `@cached` decorator to improve performance.
+- Internal tooling that mirrors real-world workflows, pricing models, or asset hierarchies.
+- Customer-facing platforms that combine transactional data with live calculations.
+- Analytics products that need controlled data sharing between teams or clients.
+- Proof-of-concept projects that must scale into production without a rewrite.
 
 ## Requirements
 
 - Python >= 3.12
 - Django >= 5.2
-- Additional dependencies (see `requirements.txt`):
+- Additional dependencies (see `requirements/base.txt`):
   - `graphene`
   - `numpy`
   - `Pint`

{generalmanager-0.15.1 → generalmanager-0.16.1}/src/GeneralManager.egg-info/SOURCES.txt

@@ -8,6 +8,20 @@ src/GeneralManager.egg-info/requires.txt
 src/GeneralManager.egg-info/top_level.txt
 src/general_manager/__init__.py
 src/general_manager/apps.py
+src/general_manager/public_api_registry.py
+src/general_manager/py.typed
+src/general_manager/_types/__init__.py
+src/general_manager/_types/api.py
+src/general_manager/_types/bucket.py
+src/general_manager/_types/cache.py
+src/general_manager/_types/factory.py
+src/general_manager/_types/general_manager.py
+src/general_manager/_types/interface.py
+src/general_manager/_types/manager.py
+src/general_manager/_types/measurement.py
+src/general_manager/_types/permission.py
+src/general_manager/_types/rule.py
+src/general_manager/_types/utils.py
 src/general_manager/api/__init__.py
 src/general_manager/api/graphql.py
 src/general_manager/api/mutation.py

{generalmanager-0.15.1 → generalmanager-0.16.1}/src/GeneralManager.egg-info/requires.txt

@@ -17,7 +17,6 @@ Pint>=0.24.4
 platformdirs>=4.3.7
 promise>=2.3
 python-dateutil>=2.9.0.post0
-setuptools==80.0.0
 six>=1.17.0
 smmap>=5.0.2
 sqlparse>=0.5.3

generalmanager-0.16.1/src/general_manager/__init__.py

@@ -0,0 +1,27 @@
+"""Convenience access to GeneralManager core components."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any
+
+from general_manager.public_api_registry import GENERAL_MANAGER_EXPORTS
+from general_manager.utils.public_api import build_module_dir, resolve_export
+
+__all__ = list(GENERAL_MANAGER_EXPORTS)
+
+_MODULE_MAP = GENERAL_MANAGER_EXPORTS
+
+if TYPE_CHECKING:
+    from general_manager._types.general_manager import *  # noqa: F401,F403
+
+def __getattr__(name: str) -> Any:
+    return resolve_export(
+        name,
+        module_all=__all__,
+        module_map=_MODULE_MAP,
+        module_globals=globals(),
+    )
+
+
+def __dir__() -> list[str]:
+    return build_module_dir(module_all=__all__, module_globals=globals())