Metadata-Version: 2.1
Name: django-formset
Version: 0.1
Summary: Prevalidate Django Forms in the browser
Home-page: https://github.com/jrief/django-formset
Author: Jacob Rief
Author-email: jacob.rief@gmail.com
License: MIT
Description: # django-formset – Better UX for Django Forms 
        
        `<django-formset>` is a [Webcomponent](https://developer.mozilla.org/en-US/docs/Web/Web_Components)
        used to wrap one or more Django Forms and/or ModelForms.
        
        ## Example
        
        Say, we have a standard Django Form:
        
        ```python
        from django.forms import forms, fields
        
        class SubscribeForm(forms.Form):
            last_name = fields.CharField(
                label="Last name",
                min_length=2,
                max_length=50,
            )
        
            # ... more fields
        ```
        
        then we rendering to HTML, we shall wrap that form into our special Webcomponent:
        
        ```html
        {% load django_formset %}
        
        <django-formset endpoint="{{ request.path }}">
          <form name="subscribe">
            {% csrf_token %}
            {% render_groups form %}
          </form>
        </django-formset>
        ```
        
        this gives our Subscribe Form a much better **User eXperience**.
        
        
        ## Features
        
        * Before submitting, our Form is prevalidated by the browser using the constraints we defined for
          each field.
        * Multiple FormData objects are submitted to an endpoint.
        * Server side validation errors are injected back to do form.
        * Much better user experience, since form data is sent using Ajax, rather than rerendering everything.
        
        
        ## Documentation
        
        Not deployed on RTD, but some documentation can be found in the `docs` folder.
        
        
        ## Motivation
        
        This library shall replace the form-validation framework in django-angular. In many aspects it already
        is far superior than the latter. Currently I am working on the `Selectize`-widget, which shall be used on
        Django's `forms.models.ModelChoiceField` and hence be used for `db.models.ForeignKey`.
        
        
        [![Build Status](https://github.com/jrief/django-formset/actions/workflows/pythonpackage.yml/badge.svg)]()
        [![PyPI](https://img.shields.io/pypi/pyversions/django-entangled.svg)]()
        [![PyPI version](https://img.shields.io/pypi/v/django-entangled.svg)](https://https://pypi.python.org/pypi/django-entangled)
        [![PyPI](https://img.shields.io/pypi/l/django-entangled.svg)]()
        
Keywords: Django Forms,webcomponent
Platform: OS Independent
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Framework :: Django :: 3.1
Description-Content-Type: text/markdown
