semandjic 0.1.0

A Django app for semantic model relationships and nested forms

Semandjic

A Django app for handling nested forms and object trees with automatic relationship discovery.

Features

• Automatic form generation for related models
• Handles nested relationships recursively
• Prevents circular references
• Configurable depth and relationship handling
• Support for forward and backward relations
• Customizable field exclusion
• Tree visualization of model relationships

Installation

pip install semandjic

Quick Start

1. Add to INSTALLED_APPS:

INSTALLED_APPS = [
    ...,
    'semandjic',
]

2. Configure settings (optional):

SEMANDJIC = {
    'APP_LABEL': 'myapp',
    'FIELDS_TO_EXCLUDE': {'id', 'modified_at'},
    'MAX_DEPTH': 5,
    'MAX_RELATED_OBJECTS': 10,
}

3. Use in your views:

from django.urls import path
from semandjic.forms import NestedForms
from semandjic.views import ObjectTreeView

# Generate forms
classmap = NestedForms.build_classmap_from_prefix_and_model_class(
    prefix='person',
    model_class='myapp.Person'
)
forms = NestedForms.get_nested_forms_from_classmap(classmap)

# Or use the tree view
path('object/<str:model_class>/<int:pk>/', 
     ObjectTreeView.as_view(), 
     name='object-tree'),

Documentation

For more detailed documentation, visit our GitHub repository.

Development

To contribute:

# Clone the repository
git clone https://github.com/iSeeCI/semandjic.git
cd semandjic

# Create virtual environment
python -m venv venv
source venv/bin/activate  # or `venv\Scripts\activate` on Windows

# Install development dependencies
pip install -e ".[dev]"

# Run tests
python runtests.py

License

MIT License