django-form-renderers 0.1.1

Sometimes form.as_p doesn't cut it. This app adds more render methods to all forms.

Django Form Renderers

Sometimes form.as_p doesn’t cut it. This app adds more render methods to all forms.

Contents

• Django Form Renderers

  • Installation

  • What it does

  • Defining your own renderers

• Authors

• Changelog

  • 0.1.1

  • 0.1

Installation

1. Install or add django-form-renderers to your Python path.

2. Add form_renderers to your INSTALLED_APPS setting.

What it does

1. Every form receives a div-based render method called as_div.

2. If a field is required then an attribute required="required" is rendered for every widget.

Defining your own renderers

Create either form_renderers.py or form_renderers/__init__.py in your app. Each renderer must be a function:

def as_some_renderer(form):
    return form._html_output(
        ...
    )

def as_another_renderer(form):
    return form._html_output(
        ...
    )

You can override the default as_div by creating a renderer called as_div in your app. The same rules that apply for Django template overriding apply to renderer overriding.

Authors

Praekelt Consulting

• Hedley Roos

Changelog

0.1.1

1. Allow apps to specify custom renderers.

0.1

1. First release.