Metadata-Version: 2.1
Name: django-pony-forms
Version: 0.7.1
Summary: Django-pony-forms helps you to write better html for your Django forms
Home-page: https://github.com/mbraak/django_pony_forms
Author: Marco Braak
Author-email: mbraak@ridethepony.nl
License: Apache License, Version 2.0
Download-URL: https://github.com/mbraak/django_pony_forms/zipball/master
Description: [![Build Status](https://travis-ci.org/mbraak/django_pony_forms.svg?branch=master)](https://travis-ci.org/mbraak/django_pony_forms) [![Version](https://badge.fury.io/py/django_pony_forms.svg)](https://pypi.python.org/pypi/django_pony_forms/)
        
        [![Coverage Status](https://img.shields.io/coveralls/mbraak/django_pony_forms.svg)](https://coveralls.io/r/mbraak/django_pony_forms?branch=master)
        [![Requirements Status](https://requires.io/github/mbraak/django_pony_forms/requirements.svg?branch=master)](https://requires.io/github/mbraak/django_pony_forms/requirements/?branch=master)
        
        [![License](https://img.shields.io/pypi/l/django_pony_forms.svg)](https://pypi.python.org/pypi/django_pony_forms/)
        
        Django pony forms
        =================
        
        *Django-pony-forms* helps you to write better html for your Django forms.
        
        Read the documentation on [readthedocs](http://django_pony_forms.readthedocs.io/en/latest/index.html)
        
        **1: Better form html by default**
        
        The form html that Django produces is not very nice or useful. For example, the default output of a Django form is a table.
        
        Just mixin **PonyFormMixin** to produce better html:
        
        ```python
        class ExampleForm(PonyFormMixin, forms.Form):
            name = forms.CharField()
        ```
        
        This produces the following html:
        
        ```html
        <div class="form-row row-name">
            <label for="id_name">Name</label>
            <input type="text" id="id_name" name="name" />
        </div>
        ```
        
        **2: Write your own form templates**
        
        You can also write your own form templates:
        
        ```python
        class ExampleForm(PonyFormMixin, forms.Form):
            name = forms.CharField()
        
            form_template = 'my_form.html'
            row_template = 'my_row.html'
        ```
        
        my_form.html:
        
        ```html
        <div class="my_form">
            {{ hidden_fields }}
            {{ top_errors }}
            {{ rows }}
        </div>
        ```
        
        Requirements
        ------------
        
        The package is tested with Django 1.11 - 2.2 and Python 2.7, 3.5-3.7.
        
        Installation
        ------------
        
        Install the package:
        
        ```
        $ pip install django_pony_forms
        ```
        
        Add **django_pony_forms** to your installed apps in **settings.py**.
        
        ```python
        INSTALLED_APPS = (
            ..
            'django_pony_forms',
        )
        ```
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Framework :: Django
Classifier: Framework :: Django :: 1.11
Classifier: Framework :: Django :: 2.0
Classifier: Framework :: Django :: 2.1
Classifier: Framework :: Django :: 2.2
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Description-Content-Type: text/markdown
