django-structured-metaobjects 1.0.0__tar.gz

django_structured_metaobjects-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) Gabriele Baldi 2026
+
+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.

django_structured_metaobjects-1.0.0/MANIFEST.in

@@ -0,0 +1,6 @@
+include LICENSE
+include README.md
+recursive-include structured_metaobjects/static *
+recursive-include structured_metaobjects/templates *
+recursive-exclude * __pycache__
+recursive-exclude * *.py[co]

django_structured_metaobjects-1.0.0/PKG-INFO

@@ -0,0 +1,112 @@
+Metadata-Version: 2.4
+Name: django-structured-metaobjects
+Version: 1.0.0
+Summary: User-defined typed JSON objects for Django, powered by django-structured-json-field
+Author-email: Lotrèk <gabriele.baldi.01@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/bnznamco/django-structured-metaobjects
+Keywords: django,pydantic,django pydantic,json schema,meta models,dynamic models
+Classifier: Environment :: Web Environment
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 4.2
+Classifier: Framework :: Django :: 5.0
+Classifier: Framework :: Django :: 5.1
+Classifier: Framework :: Django :: 5.2
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Django>=4.2
+Requires-Dist: django-structured-json-field>=1.5.1
+Requires-Dist: djangorestframework<4.0.0,>=3.14.0
+Requires-Dist: pydantic>=2.12
+Dynamic: license-file
+
+[![Test](https://github.com/bnznamco/django-structured-metaobjects/actions/workflows/ci.yml/badge.svg)](https://github.com/bnznamco/django-structured-metaobjects/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/django-structured-metaobjects.svg)](https://pypi.org/project/django-structured-metaobjects/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+# django-structured-metaobjects
+
+User-defined, typed JSON objects for Django — built on top of
+[`django-structured-json-field`](https://github.com/bnznamco/django-structured-field).
+
+Editors define **meta types** in the admin (a list of typed field
+definitions). Each `MetaInstance` then picks one of those types and the
+admin form / REST API automatically adapts to the schema declared by the
+chosen type.
+
+## Features
+
+- Field kinds: primitives, `ref` (single FK), `queryset` (list of FKs),
+  `group` (nested object), `list` (repeating group), with optional
+  `translated=True` per-field.
+- Runtime Pydantic compiler with per-MetaType caching, invalidated on save.
+- Admin form rebuilds the `data` widget for the selected meta type.
+- DRF `MetaTypeViewSet` / `MetaInstanceViewSet` with `schema/` action.
+- Typed access on `instance.obj.<field>` returning the parsed Pydantic
+  model — FK / queryset fields lazily resolve to real Django objects
+  with structured-json-field's caching.
+
+## Install
+
+```bash
+pip install django-structured-metaobjects
+```
+
+Add to `INSTALLED_APPS`:
+
+```python
+INSTALLED_APPS = [
+    # ...
+    "structured",
+    "structured_metaobjects",
+]
+```
+
+Wire the REST endpoints into your router:
+
+```python
+from rest_framework import routers
+from structured_metaobjects.views import MetaTypeViewSet, MetaInstanceViewSet
+
+router = routers.DefaultRouter()
+router.register(r"meta-types", MetaTypeViewSet, "meta-types")
+router.register(r"meta-instances", MetaInstanceViewSet, "meta-instances")
+```
+
+## Field kinds
+
+| kind       | Python type built by the compiler          | Notes                                  |
+|------------|--------------------------------------------|----------------------------------------|
+| `string`   | `str`                                      |                                        |
+| `text`     | `str`                                      | Multi-line.                            |
+| `integer`  | `int`                                      |                                        |
+| `number`   | `float`                                    |                                        |
+| `boolean`  | `bool`                                     |                                        |
+| `date`     | `datetime.date`                            |                                        |
+| `datetime` | `datetime.datetime`                        |                                        |
+| `ref`      | `<TargetModel>`                            | Requires `target_model="app.Model"`.   |
+| `queryset` | `List[<TargetModel>]`                      | Requires `target_model="app.Model"`.   |
+| `group`    | nested Pydantic model from `children`      |                                        |
+| `list`     | `List[<group model>]` from `children`      |                                        |
+
+Setting `translated=True` wraps the field in `Dict[str, T]` so the value
+is a per-language map.
+
+## Typed access
+
+```python
+instance = MetaInstance.objects.get(pk=1)
+obj = instance.obj                # cached Pydantic instance
+obj.title                         # typed string
+obj.related_page                  # real Django model instance (lazy/cached)
+obj.gallery                       # list of real Django model instances
+```

django_structured_metaobjects-1.0.0/README.md

@@ -0,0 +1,81 @@
+[![Test](https://github.com/bnznamco/django-structured-metaobjects/actions/workflows/ci.yml/badge.svg)](https://github.com/bnznamco/django-structured-metaobjects/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/django-structured-metaobjects.svg)](https://pypi.org/project/django-structured-metaobjects/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+# django-structured-metaobjects
+
+User-defined, typed JSON objects for Django — built on top of
+[`django-structured-json-field`](https://github.com/bnznamco/django-structured-field).
+
+Editors define **meta types** in the admin (a list of typed field
+definitions). Each `MetaInstance` then picks one of those types and the
+admin form / REST API automatically adapts to the schema declared by the
+chosen type.
+
+## Features
+
+- Field kinds: primitives, `ref` (single FK), `queryset` (list of FKs),
+  `group` (nested object), `list` (repeating group), with optional
+  `translated=True` per-field.
+- Runtime Pydantic compiler with per-MetaType caching, invalidated on save.
+- Admin form rebuilds the `data` widget for the selected meta type.
+- DRF `MetaTypeViewSet` / `MetaInstanceViewSet` with `schema/` action.
+- Typed access on `instance.obj.<field>` returning the parsed Pydantic
+  model — FK / queryset fields lazily resolve to real Django objects
+  with structured-json-field's caching.
+
+## Install
+
+```bash
+pip install django-structured-metaobjects
+```
+
+Add to `INSTALLED_APPS`:
+
+```python
+INSTALLED_APPS = [
+    # ...
+    "structured",
+    "structured_metaobjects",
+]
+```
+
+Wire the REST endpoints into your router:
+
+```python
+from rest_framework import routers
+from structured_metaobjects.views import MetaTypeViewSet, MetaInstanceViewSet
+
+router = routers.DefaultRouter()
+router.register(r"meta-types", MetaTypeViewSet, "meta-types")
+router.register(r"meta-instances", MetaInstanceViewSet, "meta-instances")
+```
+
+## Field kinds
+
+| kind       | Python type built by the compiler          | Notes                                  |
+|------------|--------------------------------------------|----------------------------------------|
+| `string`   | `str`                                      |                                        |
+| `text`     | `str`                                      | Multi-line.                            |
+| `integer`  | `int`                                      |                                        |
+| `number`   | `float`                                    |                                        |
+| `boolean`  | `bool`                                     |                                        |
+| `date`     | `datetime.date`                            |                                        |
+| `datetime` | `datetime.datetime`                        |                                        |
+| `ref`      | `<TargetModel>`                            | Requires `target_model="app.Model"`.   |
+| `queryset` | `List[<TargetModel>]`                      | Requires `target_model="app.Model"`.   |
+| `group`    | nested Pydantic model from `children`      |                                        |
+| `list`     | `List[<group model>]` from `children`      |                                        |
+
+Setting `translated=True` wraps the field in `Dict[str, T]` so the value
+is a per-language map.
+
+## Typed access
+
+```python
+instance = MetaInstance.objects.get(pk=1)
+obj = instance.obj                # cached Pydantic instance
+obj.title                         # typed string
+obj.related_page                  # real Django model instance (lazy/cached)
+obj.gallery                       # list of real Django model instances
+```

django_structured_metaobjects-1.0.0/django_structured_metaobjects.egg-info/PKG-INFO

@@ -0,0 +1,112 @@
+Metadata-Version: 2.4
+Name: django-structured-metaobjects
+Version: 1.0.0
+Summary: User-defined typed JSON objects for Django, powered by django-structured-json-field
+Author-email: Lotrèk <gabriele.baldi.01@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/bnznamco/django-structured-metaobjects
+Keywords: django,pydantic,django pydantic,json schema,meta models,dynamic models
+Classifier: Environment :: Web Environment
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 4.2
+Classifier: Framework :: Django :: 5.0
+Classifier: Framework :: Django :: 5.1
+Classifier: Framework :: Django :: 5.2
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Django>=4.2
+Requires-Dist: django-structured-json-field>=1.5.1
+Requires-Dist: djangorestframework<4.0.0,>=3.14.0
+Requires-Dist: pydantic>=2.12
+Dynamic: license-file
+
+[![Test](https://github.com/bnznamco/django-structured-metaobjects/actions/workflows/ci.yml/badge.svg)](https://github.com/bnznamco/django-structured-metaobjects/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/django-structured-metaobjects.svg)](https://pypi.org/project/django-structured-metaobjects/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+# django-structured-metaobjects
+
+User-defined, typed JSON objects for Django — built on top of
+[`django-structured-json-field`](https://github.com/bnznamco/django-structured-field).
+
+Editors define **meta types** in the admin (a list of typed field
+definitions). Each `MetaInstance` then picks one of those types and the
+admin form / REST API automatically adapts to the schema declared by the
+chosen type.
+
+## Features
+
+- Field kinds: primitives, `ref` (single FK), `queryset` (list of FKs),
+  `group` (nested object), `list` (repeating group), with optional
+  `translated=True` per-field.
+- Runtime Pydantic compiler with per-MetaType caching, invalidated on save.
+- Admin form rebuilds the `data` widget for the selected meta type.
+- DRF `MetaTypeViewSet` / `MetaInstanceViewSet` with `schema/` action.
+- Typed access on `instance.obj.<field>` returning the parsed Pydantic
+  model — FK / queryset fields lazily resolve to real Django objects
+  with structured-json-field's caching.
+
+## Install
+
+```bash
+pip install django-structured-metaobjects
+```
+
+Add to `INSTALLED_APPS`:
+
+```python
+INSTALLED_APPS = [
+    # ...
+    "structured",
+    "structured_metaobjects",
+]
+```
+
+Wire the REST endpoints into your router:
+
+```python
+from rest_framework import routers
+from structured_metaobjects.views import MetaTypeViewSet, MetaInstanceViewSet
+
+router = routers.DefaultRouter()
+router.register(r"meta-types", MetaTypeViewSet, "meta-types")
+router.register(r"meta-instances", MetaInstanceViewSet, "meta-instances")
+```
+
+## Field kinds
+
+| kind       | Python type built by the compiler          | Notes                                  |
+|------------|--------------------------------------------|----------------------------------------|
+| `string`   | `str`                                      |                                        |
+| `text`     | `str`                                      | Multi-line.                            |
+| `integer`  | `int`                                      |                                        |
+| `number`   | `float`                                    |                                        |
+| `boolean`  | `bool`                                     |                                        |
+| `date`     | `datetime.date`                            |                                        |
+| `datetime` | `datetime.datetime`                        |                                        |
+| `ref`      | `<TargetModel>`                            | Requires `target_model="app.Model"`.   |
+| `queryset` | `List[<TargetModel>]`                      | Requires `target_model="app.Model"`.   |
+| `group`    | nested Pydantic model from `children`      |                                        |
+| `list`     | `List[<group model>]` from `children`      |                                        |
+
+Setting `translated=True` wraps the field in `Dict[str, T]` so the value
+is a per-language map.
+
+## Typed access
+
+```python
+instance = MetaInstance.objects.get(pk=1)
+obj = instance.obj                # cached Pydantic instance
+obj.title                         # typed string
+obj.related_page                  # real Django model instance (lazy/cached)
+obj.gallery                       # list of real Django model instances
+```

django_structured_metaobjects-1.0.0/django_structured_metaobjects.egg-info/SOURCES.txt

@@ -0,0 +1,45 @@
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+setup.py
+django_structured_metaobjects.egg-info/PKG-INFO
+django_structured_metaobjects.egg-info/SOURCES.txt
+django_structured_metaobjects.egg-info/dependency_links.txt
+django_structured_metaobjects.egg-info/requires.txt
+django_structured_metaobjects.egg-info/top_level.txt
+structured_metaobjects/__init__.py
+structured_metaobjects/admin.py
+structured_metaobjects/apps.py
+structured_metaobjects/compiler.py
+structured_metaobjects/forms.py
+structured_metaobjects/models.py
+structured_metaobjects/schema_builder.py
+structured_metaobjects/serializers.py
+structured_metaobjects/urls.py
+structured_metaobjects/views.py
+structured_metaobjects/migrations/0001_initial.py
+structured_metaobjects/migrations/__init__.py
+structured_metaobjects/static/structured_metaobjects/admin/meta_instance.js
+tests/__init__.py
+tests/test_admin.py
+tests/test_compiler.py
+tests/test_forms.py
+tests/test_models.py
+tests/test_schema_builder.py
+tests/test_serializers.py
+tests/test_views.py
+tests/app/__init__.py
+tests/app/app/__init__.py
+tests/app/app/asgi.py
+tests/app/app/settings.py
+tests/app/app/urls.py
+tests/app/app/wsgi.py
+tests/app/test_module/__init__.py
+tests/app/test_module/admin.py
+tests/app/test_module/apps.py
+tests/app/test_module/models.py
+tests/app/test_module/serializers.py
+tests/app/test_module/views.py
+tests/app/test_module/migrations/0001_initial.py
+tests/app/test_module/migrations/__init__.py

django_structured_metaobjects-1.0.0/django_structured_metaobjects.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

django_structured_metaobjects-1.0.0/django_structured_metaobjects.egg-info/requires.txt

@@ -0,0 +1,4 @@
+Django>=4.2
+django-structured-json-field>=1.5.1
+djangorestframework<4.0.0,>=3.14.0
+pydantic>=2.12

django_structured_metaobjects-1.0.0/django_structured_metaobjects.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+structured_metaobjects
+tests

django_structured_metaobjects-1.0.0/pyproject.toml

@@ -0,0 +1,69 @@
+[build-system]
+build-backend = "setuptools.build_meta"
+requires = ["setuptools>=61.2"]
+
+[project]
+authors = [{name = "Lotrèk", email = "gabriele.baldi.01@gmail.com"}]
+classifiers = [
+  "Environment :: Web Environment",
+  "Framework :: Django",
+  "Framework :: Django :: 4.2",
+  "Framework :: Django :: 5.0",
+  "Framework :: Django :: 5.1",
+  "Framework :: Django :: 5.2",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
+]
+dependencies = [
+  "Django>=4.2",
+  "django-structured-json-field>=1.5.1",
+  "djangorestframework>=3.14.0,<4.0.0",
+  "pydantic>=2.12",
+]
+description = "User-defined typed JSON objects for Django, powered by django-structured-json-field"
+dynamic = ["version"]
+keywords = ["django", "pydantic", "django pydantic", "json schema", "meta models", "dynamic models"]
+license = {text = "MIT"}
+name = "django-structured-metaobjects"
+requires-python = ">= 3.10"
+
+[project.readme]
+content-type = "text/markdown"
+file = "README.md"
+
+[project.urls]
+Homepage = "https://github.com/bnznamco/django-structured-metaobjects"
+
+[tool.setuptools]
+include-package-data = true
+
+[tool.setuptools.packages]
+find = {namespaces = false}
+
+[tool.distutils.bdist_wheel]
+universal = true
+
+[tool.semantic_release]
+version_variables = ["setup.py:__version__", "structured_metaobjects/__init__.py:__version__"]
+
+[tool.semantic_release.branches.master]
+match = "master"
+prerelease = false
+
+[tool.semantic_release.branches."next"]
+match = "next"
+prerelease = true
+prerelease_token = "beta"
+
+[tool.semantic_release.changelog]
+mode = "update"
+
+[tool.semantic_release.changelog.default_templates]
+changelog_file = "CHANGELOG.md"
+output_format = "md"

django_structured_metaobjects-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

django_structured_metaobjects-1.0.0/setup.py

@@ -0,0 +1,5 @@
+from setuptools import setup
+
+__version__ = "1.0.0"
+
+setup(version=__version__)

django_structured_metaobjects-1.0.0/structured_metaobjects/__init__.py

@@ -0,0 +1,14 @@
+from .schema_builder import MetaFieldKind, MetaTypeFieldDef
+from .compiler import build_pydantic_model, clear_cache, get_json_schema
+
+__version__ = "1.0.0"
+
+default_app_config = "structured_metaobjects.apps.StructuredMetaobjectsConfig"
+
+__all__ = [
+    "MetaFieldKind",
+    "MetaTypeFieldDef",
+    "build_pydantic_model",
+    "clear_cache",
+    "get_json_schema",
+]

django_structured_metaobjects-1.0.0/structured_metaobjects/admin.py

@@ -0,0 +1,20 @@
+from django.contrib import admin
+
+from .forms import MetaInstanceForm
+from .models import MetaInstance, MetaType
+
+
+@admin.register(MetaType)
+class MetaTypeAdmin(admin.ModelAdmin):
+    list_display = ("name",)
+
+
+@admin.register(MetaInstance)
+class MetaInstanceAdmin(admin.ModelAdmin):
+    form = MetaInstanceForm
+    list_display = ("__str__", "meta_type", "updated_at")
+    list_filter = ("meta_type",)
+    search_fields = ()
+
+    class Media:
+        js = ("structured_metaobjects/admin/meta_instance.js",)

django_structured_metaobjects-1.0.0/structured_metaobjects/apps.py

@@ -0,0 +1,8 @@
+from django.apps import AppConfig
+
+
+class StructuredMetaobjectsConfig(AppConfig):
+    name = "structured_metaobjects"
+    label = "structured_metaobjects"
+    verbose_name = "Structured Meta Objects"
+    default_auto_field = "django.db.models.AutoField"