django-dict-form 0.1.0__tar.gz

django_dict_form-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Gleb Uvarov
+
+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_dict_form-0.1.0/PKG-INFO

@@ -0,0 +1,148 @@
+Metadata-Version: 2.4
+Name: django-dict-form
+Version: 0.1.0
+Summary: Is a lightweight extension for Django Forms that adds serialization
+Author-email: Gleb Uvarov <ugs1996@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Dradisen/django_dict_form
+Project-URL: Repository, https://github.com/Dradisen/django_dict_form
+Project-URL: Issues, https://github.com/Dradisen/django_dict_form/issues
+Project-URL: Documentation, https://github.com/Dradisen/django_dict_form#readme
+Keywords: django,django-forms
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: django>=3.2
+Dynamic: license-file
+
+# django-dict-form
+
+Lightweight Django Forms extension. Adds `as_dict()` — serializes form definitions to Python dicts / JSON, making forms easier to integrate with REST APIs, SPA frontends (React/Vue), dynamic UI generators, and low-code systems.
+
+Extends standard Django form rendering (`as_p`, `as_table`, `as_ul`) with machine-readable field metadata, validation rules, and widget configuration.
+
+## When is this convenient?
+
+Write adapters to UI/UX components once — forms auto-generate on frontend. Backend edits propagate automatically. No manual frontend form duplication.
+
+## Features
+
+- Serialize Django forms to Python dictionaries
+- Useful for dynamic frontend rendering
+- Simplifies API-driven form generation
+- Lightweight and framework-friendly
+- Compatible with standard Django Forms
+
+## Install
+
+```bash
+pip install django-dict-form
+```
+
+## Quick Start
+
+```python
+from django_dict_form.form import DictForm
+from django import forms
+
+class ContactForm(DictForm):
+    name = forms.CharField(max_length=100)
+    email = forms.EmailField()
+    message = forms.CharField(widget=forms.Textarea)
+
+form = ContactForm()
+data = form.as_dict()
+```
+
+Output:
+
+```json
+{
+  "name": {
+    "label": null,
+    "required": true,
+    "disabled": false,
+    "help_text": "",
+    "initial": null,
+    "show_hidden_initial": false,
+    "label_suffix": null,
+    "widget": {
+      "name": "TextInput",
+      "type": "text",
+      "is_hidden": false,
+      "required": true,
+      "choices": [],
+      "attrs": {"maxlength": "100"}
+    }
+  }
+}
+```
+
+## Mixin Usage
+
+Use `RenderableDictFormMixin` to add `as_dict()` to any existing form class:
+
+```python
+from django_dict_form.form import RenderableDictFormMixin
+from django import forms
+
+class MyForm(forms.Form, RenderableDictFormMixin):
+    field = forms.CharField()
+```
+
+## `as_dict()` Output Schema
+
+Each field produces:
+
+| Key | Type | Description |
+|-----|------|-------------|
+| `label` | `str \| null` | Field label |
+| `label_suffix` | `str \| null` | Label suffix |
+| `required` | `bool` | Whether field is required |
+| `disabled` | `bool` | Whether field is disabled |
+| `help_text` | `str` | Help text |
+| `initial` | `any` | Default value |
+| `show_hidden_initial` | `bool` | Show hidden initial widget |
+| `widget` | `dict` | Widget metadata (see below) |
+
+Widget dict:
+
+| Key | Type | Description |
+|-----|------|-------------|
+| `name` | `str` | Widget class name (e.g. `TextInput`) |
+| `type` | `str \| null` | HTML input type (e.g. `text`, `email`, `number`) |
+| `is_hidden` | `bool` | Whether widget is hidden |
+| `required` | `bool` | Widget-level required |
+| `choices` | `list[{value, name}]` | Options for select widgets |
+| `attrs` | `dict` | HTML attributes (e.g. `maxlength`, `min`, `max`) |
+
+## Supported Fields
+
+| Field | Widget | Notes |
+|-------|--------|-------|
+| `CharField` | `TextInput` | `maxlength`, `minlength` in attrs |
+| `IntegerField` | `NumberInput` | `min`, `max` in attrs |
+| `FloatField` | `NumberInput` | `step: any` in attrs |
+| `EmailField` | `EmailInput` | `maxlength: 320` default |
+| `URLField` | `URLInput` | |
+| `BooleanField` | `CheckboxInput` | |
+| `ChoiceField` | `Select` | choices serialized |
+| `DateField` | `DateInput` | |
+| `TimeField` | `TimeInput` | |
+| `DateTimeField` | `DateTimeInput` | |
+| `DurationField` | `TextInput` | |
+| `RegexField` | `TextInput` | |
+| `UUIDField` | `TextInput` | |
+
+Custom widgets supported — pass any widget instance, choices and attrs extracted automatically.
+
+## Requirements
+
+- Python >= 3.11.15
+- Django >= 3.2
+
+## License
+
+MIT — [Gleb Uvarov](https://github.com/Dradisen)

django_dict_form-0.1.0/README.md

@@ -0,0 +1,129 @@
+# django-dict-form
+
+Lightweight Django Forms extension. Adds `as_dict()` — serializes form definitions to Python dicts / JSON, making forms easier to integrate with REST APIs, SPA frontends (React/Vue), dynamic UI generators, and low-code systems.
+
+Extends standard Django form rendering (`as_p`, `as_table`, `as_ul`) with machine-readable field metadata, validation rules, and widget configuration.
+
+## When is this convenient?
+
+Write adapters to UI/UX components once — forms auto-generate on frontend. Backend edits propagate automatically. No manual frontend form duplication.
+
+## Features
+
+- Serialize Django forms to Python dictionaries
+- Useful for dynamic frontend rendering
+- Simplifies API-driven form generation
+- Lightweight and framework-friendly
+- Compatible with standard Django Forms
+
+## Install
+
+```bash
+pip install django-dict-form
+```
+
+## Quick Start
+
+```python
+from django_dict_form.form import DictForm
+from django import forms
+
+class ContactForm(DictForm):
+    name = forms.CharField(max_length=100)
+    email = forms.EmailField()
+    message = forms.CharField(widget=forms.Textarea)
+
+form = ContactForm()
+data = form.as_dict()
+```
+
+Output:
+
+```json
+{
+  "name": {
+    "label": null,
+    "required": true,
+    "disabled": false,
+    "help_text": "",
+    "initial": null,
+    "show_hidden_initial": false,
+    "label_suffix": null,
+    "widget": {
+      "name": "TextInput",
+      "type": "text",
+      "is_hidden": false,
+      "required": true,
+      "choices": [],
+      "attrs": {"maxlength": "100"}
+    }
+  }
+}
+```
+
+## Mixin Usage
+
+Use `RenderableDictFormMixin` to add `as_dict()` to any existing form class:
+
+```python
+from django_dict_form.form import RenderableDictFormMixin
+from django import forms
+
+class MyForm(forms.Form, RenderableDictFormMixin):
+    field = forms.CharField()
+```
+
+## `as_dict()` Output Schema
+
+Each field produces:
+
+| Key | Type | Description |
+|-----|------|-------------|
+| `label` | `str \| null` | Field label |
+| `label_suffix` | `str \| null` | Label suffix |
+| `required` | `bool` | Whether field is required |
+| `disabled` | `bool` | Whether field is disabled |
+| `help_text` | `str` | Help text |
+| `initial` | `any` | Default value |
+| `show_hidden_initial` | `bool` | Show hidden initial widget |
+| `widget` | `dict` | Widget metadata (see below) |
+
+Widget dict:
+
+| Key | Type | Description |
+|-----|------|-------------|
+| `name` | `str` | Widget class name (e.g. `TextInput`) |
+| `type` | `str \| null` | HTML input type (e.g. `text`, `email`, `number`) |
+| `is_hidden` | `bool` | Whether widget is hidden |
+| `required` | `bool` | Widget-level required |
+| `choices` | `list[{value, name}]` | Options for select widgets |
+| `attrs` | `dict` | HTML attributes (e.g. `maxlength`, `min`, `max`) |
+
+## Supported Fields
+
+| Field | Widget | Notes |
+|-------|--------|-------|
+| `CharField` | `TextInput` | `maxlength`, `minlength` in attrs |
+| `IntegerField` | `NumberInput` | `min`, `max` in attrs |
+| `FloatField` | `NumberInput` | `step: any` in attrs |
+| `EmailField` | `EmailInput` | `maxlength: 320` default |
+| `URLField` | `URLInput` | |
+| `BooleanField` | `CheckboxInput` | |
+| `ChoiceField` | `Select` | choices serialized |
+| `DateField` | `DateInput` | |
+| `TimeField` | `TimeInput` | |
+| `DateTimeField` | `DateTimeInput` | |
+| `DurationField` | `TextInput` | |
+| `RegexField` | `TextInput` | |
+| `UUIDField` | `TextInput` | |
+
+Custom widgets supported — pass any widget instance, choices and attrs extracted automatically.
+
+## Requirements
+
+- Python >= 3.11.15
+- Django >= 3.2
+
+## License
+
+MIT — [Gleb Uvarov](https://github.com/Dradisen)

django_dict_form-0.1.0/django_dict_form/__init__.py

@@ -0,0 +1,5 @@
+from .form import DictForm
+
+__all__ = (
+    "DictForm",
+)

django_dict_form-0.1.0/django_dict_form/apps.py

@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+
+class DjangoDictFormConfig(AppConfig):
+    default_auto_field = 'django.db.models.BigAutoField'
+    name = 'django_dict_form'

django_dict_form-0.1.0/django_dict_form/form.py

@@ -0,0 +1,40 @@
+from django import forms
+from django.forms import Widget
+from typing import Iterable
+
+
+def extract_choices(choices: Iterable[tuple]) -> list[dict]:
+    return [{"value": str(key), "name": value} for key, value in choices]
+
+
+def _widget_as_dict(widget: Widget) -> dict:
+    return {
+        "name": widget.__class__.__name__,
+        "is_hidden": widget.is_hidden,
+        "required": widget.is_required,
+        "type": getattr(widget, "input_type", None),
+        "choices": extract_choices(getattr(widget, "choices", [])),
+        "attrs": getattr(widget, "attrs", None),
+    }
+
+
+class RenderableDictFormMixin:
+    fields: dict
+
+    def as_dict(self) -> dict[str, dict]:
+        return {
+            field_name: {
+                "label": field.label,
+                "label_suffix": field.label_suffix,
+                "required": field.required,
+                "disabled": field.disabled,
+                "help_text": field.help_text,
+                "initial": field.initial,
+                "show_hidden_initial": field.show_hidden_initial,
+                "widget": _widget_as_dict(field.widget),
+            }
+            for field_name, field in self.fields.items()
+        }
+
+
+class DictForm(forms.Form, RenderableDictFormMixin): ...

django_dict_form-0.1.0/django_dict_form/models.py

@@ -0,0 +1,17 @@
+from django.forms import Widget
+
+from dataclasses import dataclass
+
+@dataclass
+class MetaFieldJson:
+    widget: Widget
+    required: bool
+    disabled: bool
+    help_text: str
+    max_length: int|None
+    min_length: int|None
+    choices: list[dict]
+    label: str
+    type: str
+    name: str
+    attrs: dict

django_dict_form-0.1.0/django_dict_form/urls.py

@@ -0,0 +1,5 @@
+
+
+urlpatterns = [
+    
+]

django_dict_form-0.1.0/django_dict_form.egg-info/PKG-INFO

@@ -0,0 +1,148 @@
+Metadata-Version: 2.4
+Name: django-dict-form
+Version: 0.1.0
+Summary: Is a lightweight extension for Django Forms that adds serialization
+Author-email: Gleb Uvarov <ugs1996@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Dradisen/django_dict_form
+Project-URL: Repository, https://github.com/Dradisen/django_dict_form
+Project-URL: Issues, https://github.com/Dradisen/django_dict_form/issues
+Project-URL: Documentation, https://github.com/Dradisen/django_dict_form#readme
+Keywords: django,django-forms
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: django>=3.2
+Dynamic: license-file
+
+# django-dict-form
+
+Lightweight Django Forms extension. Adds `as_dict()` — serializes form definitions to Python dicts / JSON, making forms easier to integrate with REST APIs, SPA frontends (React/Vue), dynamic UI generators, and low-code systems.
+
+Extends standard Django form rendering (`as_p`, `as_table`, `as_ul`) with machine-readable field metadata, validation rules, and widget configuration.
+
+## When is this convenient?
+
+Write adapters to UI/UX components once — forms auto-generate on frontend. Backend edits propagate automatically. No manual frontend form duplication.
+
+## Features
+
+- Serialize Django forms to Python dictionaries
+- Useful for dynamic frontend rendering
+- Simplifies API-driven form generation
+- Lightweight and framework-friendly
+- Compatible with standard Django Forms
+
+## Install
+
+```bash
+pip install django-dict-form
+```
+
+## Quick Start
+
+```python
+from django_dict_form.form import DictForm
+from django import forms
+
+class ContactForm(DictForm):
+    name = forms.CharField(max_length=100)
+    email = forms.EmailField()
+    message = forms.CharField(widget=forms.Textarea)
+
+form = ContactForm()
+data = form.as_dict()
+```
+
+Output:
+
+```json
+{
+  "name": {
+    "label": null,
+    "required": true,
+    "disabled": false,
+    "help_text": "",
+    "initial": null,
+    "show_hidden_initial": false,
+    "label_suffix": null,
+    "widget": {
+      "name": "TextInput",
+      "type": "text",
+      "is_hidden": false,
+      "required": true,
+      "choices": [],
+      "attrs": {"maxlength": "100"}
+    }
+  }
+}
+```
+
+## Mixin Usage
+
+Use `RenderableDictFormMixin` to add `as_dict()` to any existing form class:
+
+```python
+from django_dict_form.form import RenderableDictFormMixin
+from django import forms
+
+class MyForm(forms.Form, RenderableDictFormMixin):
+    field = forms.CharField()
+```
+
+## `as_dict()` Output Schema
+
+Each field produces:
+
+| Key | Type | Description |
+|-----|------|-------------|
+| `label` | `str \| null` | Field label |
+| `label_suffix` | `str \| null` | Label suffix |
+| `required` | `bool` | Whether field is required |
+| `disabled` | `bool` | Whether field is disabled |
+| `help_text` | `str` | Help text |
+| `initial` | `any` | Default value |
+| `show_hidden_initial` | `bool` | Show hidden initial widget |
+| `widget` | `dict` | Widget metadata (see below) |
+
+Widget dict:
+
+| Key | Type | Description |
+|-----|------|-------------|
+| `name` | `str` | Widget class name (e.g. `TextInput`) |
+| `type` | `str \| null` | HTML input type (e.g. `text`, `email`, `number`) |
+| `is_hidden` | `bool` | Whether widget is hidden |
+| `required` | `bool` | Widget-level required |
+| `choices` | `list[{value, name}]` | Options for select widgets |
+| `attrs` | `dict` | HTML attributes (e.g. `maxlength`, `min`, `max`) |
+
+## Supported Fields
+
+| Field | Widget | Notes |
+|-------|--------|-------|
+| `CharField` | `TextInput` | `maxlength`, `minlength` in attrs |
+| `IntegerField` | `NumberInput` | `min`, `max` in attrs |
+| `FloatField` | `NumberInput` | `step: any` in attrs |
+| `EmailField` | `EmailInput` | `maxlength: 320` default |
+| `URLField` | `URLInput` | |
+| `BooleanField` | `CheckboxInput` | |
+| `ChoiceField` | `Select` | choices serialized |
+| `DateField` | `DateInput` | |
+| `TimeField` | `TimeInput` | |
+| `DateTimeField` | `DateTimeInput` | |
+| `DurationField` | `TextInput` | |
+| `RegexField` | `TextInput` | |
+| `UUIDField` | `TextInput` | |
+
+Custom widgets supported — pass any widget instance, choices and attrs extracted automatically.
+
+## Requirements
+
+- Python >= 3.11.15
+- Django >= 3.2
+
+## License
+
+MIT — [Gleb Uvarov](https://github.com/Dradisen)

django_dict_form-0.1.0/django_dict_form.egg-info/SOURCES.txt

@@ -0,0 +1,15 @@
+LICENSE
+README.md
+pyproject.toml
+django_dict_form/__init__.py
+django_dict_form/apps.py
+django_dict_form/form.py
+django_dict_form/models.py
+django_dict_form/urls.py
+django_dict_form.egg-info/PKG-INFO
+django_dict_form.egg-info/SOURCES.txt
+django_dict_form.egg-info/dependency_links.txt
+django_dict_form.egg-info/requires.txt
+django_dict_form.egg-info/top_level.txt
+tests/test_dict_form_instance.py
+tests/tests.py

django_dict_form-0.1.0/django_dict_form.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

django_dict_form-0.1.0/django_dict_form.egg-info/requires.txt

@@ -0,0 +1 @@
+django>=3.2

django_dict_form-0.1.0/django_dict_form.egg-info/top_level.txt

@@ -0,0 +1 @@
+django_dict_form

django_dict_form-0.1.0/pyproject.toml

@@ -0,0 +1,47 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "django-dict-form"
+version = "0.1.0"
+description = "Is a lightweight extension for Django Forms that adds serialization"
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+    "django>=3.2",
+]
+license = "MIT"
+authors = [
+  { name = "Gleb Uvarov", email = "ugs1996@gmail.com" }
+]
+keywords = [
+    "django",
+    "django-forms"
+]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Operating System :: OS Independent"
+]
+
+[project.urls]
+Homepage = "https://github.com/Dradisen/django_dict_form"
+Repository = "https://github.com/Dradisen/django_dict_form"
+Issues = "https://github.com/Dradisen/django_dict_form/issues"
+Documentation = "https://github.com/Dradisen/django_dict_form#readme"
+
+[tool.ruff]
+line-length = 100
+target-version = "py39"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["django_dict_form*"]
+
+[tool.coverage.run]
+branch = true
+source = ["django_dict_form"]
+
+[tool.coverage.report]
+show_missing = true
+skip_covered = true

django_dict_form-0.1.0/setup.cfg

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