StringField only sets ``data = ‘’` when form data is empty and an initial value was not provided. This fixes an issue where the default value wasn’t rendered with the initial form. (#291, #355, #401)

Merged new and updated translations from the community.

Passing data_ args to render a field converts all the underscores to hyphens when rendering the HTML attribute, not just the first one. data_foo_bar becomes data-foo-bar. (#248)

The UUID validator uses the uuid.UUID class instead of a regex. (#251)

SelectField copies the list of choices passed to it so modifying an instance’s choices will not modify the global form definition. (#286)

Fields call process_formdata() even if the raw data is empty. (#280)

Added a MultipleFileField to handle a multi-file input. FileField continues to handle only one value. The underlying FileInput widget gained a multiple argument. (#281)

SelectField choices can contain HTML (MarkupSafe Markup object or equivalent API) and will be rendered properly. (#302)

TimeField and html5.TimeField were added. (#254)

Improved Email. Note that it is still unreasonable to validate all emails with a regex and you should prefer validating by actually sending an email. (#294)

Widgets render the required attribute when using a validator that provides the 'required' flag, such as DataRequired. (#361)

Fix a compatibility issue with SQLAlchemy 2.1 that caused QuerySelectField to fail with ValueError: too many values to unpack. (#391)

Added render_kw to allow default rendering time options.

Updated / added a number of localizations

Updated docs

Allow widgets to set flags

Added more localizations and updated some.

Validators for email and URL can validate IDNA-encoded domain names and new TLDs

Better DeprecationWarnings

Support localization files in /usr/share/locale (for distro packaging)

Update wheel install to conditionally install ordereddict for python 2.6.

Doc improvements

Add new class Meta paradigm for much more powerful customization of WTForms.

Move i18n into core. Deprecate wtforms.ext.i18n.

Move CSRF into core. Deprecate wtforms.ext.csrf.

Fix issue rendering SelectFields with value=True

Make DecimalField able to use babel locale-based number formatting.

Drop Python 3.2 support (Python3 support for 3.3+ only)

passing attr=False to WTForms widgets causes the value to be ignored.

Unique validator in wtforms.ext.sqlalchemy has been removed.

Fix a bug in validators which causes translations to happen once then clobber any future translations.

ext.sqlalchemy / ext.appengine: minor cleanups / deprecation.

Allow blank string and the string false to be considered false values for BooleanField (configurable). This is technically a breaking change, but it is not likey to affect the majority of users adversely.

ext.i18n form allows passing LANGUAGES to the constructor.

Add widgets and field implementations for HTML5 specialty input types.

ext.appengine: Add NDB support.

Add translations: Korean, Traditional Chinese

Tests complete in python 3.2/3.3.

Localization for ru, fr.

Minor fixes in documentation for clarity.

FieldList now can take validators on the entire FieldList.

ext.sqlalchemy model_form:

• Fix issue with QuerySelectField

• Fix issue in ColumnDefault conversion

• Support Enum type

Field class now allows traversal in Django 1.4 templates.

We now support Python 2.x and 3.x on the same codebase, thanks to a lot of hard work by Vinay Sajip.

Add in ability to convert relationships to ext.sqlalchemy model_form

Built-in localizations for more languages

Validator cleanup:

• Distinguish Required validator into InputRequired and DataRequired

• Better IP address validation, including IPv6 support.

• AnyOf / NoneOf now work properly formatting other datatypes than strings.

• Optional validator can optionally pass through whitespace.

Fixed issues related to building for python 3 and python pre-releases.

Add object_data to fields to get at the originally passed data.

Output HTML5 compact syntax by default.

Substantial code reorg, cleanup, and test improvements

Added ext.csrf for a way to implement CSRF protection

ext.sqlalchemy:

• Support PGInet, MACADDR, and UUID field conversion

• Support callable defaults

ext.appengine:

• model_form now supports generating forms with the same ordering as model.

• ReferencePropertyField now gets get_label like the other ORM fields

Add localization support for WTForms built-in messages

Python 3 support (via 2to3)

Minor changes/fixes:

• An empty label string can be specified on fields if desired

• Option widget can now take kwargs customization

• Field subclasses can provide default validators as a class property

• DateTimeField can take time in microseconds

• Numeric fields all set .data to None on coercion error for consistency.

Documentation: Substantial documentation improvements, including adding Crash Course as a sphinx document.

ext.django: QuerySetSelectField (and ModelSelectField) now accept get_label similar to sqlalchemy equivalents.

ext.appengine

• model_form fixes: FloatField (#50), TimeField, DateTimeField (#55)

• ReferencePropertyField: now properly stores model object, not key. (#48)

Bug Fixes:

• ext.appengine: various field fixes (#34, #48), model_form changes (#41)

• Fix issue in Optional with non-string input.

• Make numeric fields more consistent.

Tests: Improve test coverage substantially.

Bug Fixes:

• ext.appengine ReferencePropertyField (#36, #37)

• dateutil fields: render issue (r419), and consistency issue (#35)

• Optional validator failed when raw_data was absent (r418)

Documentation: docs now mention HTML escaping functionality (#38)

Add preliminary support for providing a translations object that can translate built-in validation and coercion errors (#32)

Widgets:

• HTML is now marked as safe (using __html__) so that compatible templating engines will not auto-escape it.

Fields:

• Field._default is now Field.default.

• All fields now have a raw_data property.

• Fields which are select fields (including those in .ext) can be iterated to produce options, and have an option_widget kwarg.

• Minor bugfixes and cleanup in FieldList, Select(Multiple)Field, QuerySelectField to address behavioral consistency.

• Added FloatField, based on IntegerField.

Extensions:

• ext.appengine now supports FloatProperty and GeoPtProperty.

• ext.sqlalchemy QueryMultipleSelectField changed to QuerySelectMultipleField.

Added a BaseForm class which provides the core processing and validation functionality of Form without requiring declarative subclassing.

Fields:

• Field labels now default to a humanized field name.

• Fields now have a short_name property which is the un-prefixed name.

• DecimalField now rounds values for display without float coercion. See docs for details on how to format decimals.

Extensions:

• ext.sqlalchemy.fields now has an additional QuerySelectMultipleField, and all fields can now support multiple-column primary keys.

• ext.sqlalchemy.orm contains tools for making forms from ORM models.

• Added ext.dateutil for flexible date-time parsing.

• Added ext.appengine contributed by Rodrigo Moraes.

Added AnyOf and NoneOf validators.

Fields have much greater control over input processing. Filters have been added to implement a simple way to transform input data.

Added fields that encapsulate advanced data structures such as dynamic lists or child forms for more powerful field composing.

Fields now use widgets for rendering.

All built-in validators have been converted to classes to clean up the code.

Form.auto_populate and Field.populate were renamed to populate_obj to clarify that they populate another object, not the Form or Field. This is an API breaking change.

Dropped support for Python 2.3.

Several fixes were made to the code and tests to make WTForms compatible with Python 2.3/2.4.

Form’s properties can now be accessed via dictionary-style access such as form['author']. This also has the intended effect of making variable lookups in Django templates more reliable.

Form and Field construction changes: Form now uses a metaclass to handle creating its _unbound_fields property, and Field construction now gives an instance of the new UnboundField class instead of using a partial function application. These are both internal changes and do not change the API.

We have documentation and unit tests!

Fields now have a flags property which contain boolean flags that are set either by the field itself or validators being specified on a field. The flags can then be used in checks in template or python code.

Changed the way fields take parameters, they are no longer quasi magic. This is a breaking change. Please see the documentation for the new syntax.

Added optional description argument to Field, accessible on the field as description. This provides an easy way to define e.g. help text in the same place as the form.

Added new semantics for validators which can stop the validation chain, with or without errors.

Added a regexp validator, and removed the not_empty validator in favour of two validators, optional and required. The new validators allow control over the validation chain in addition to checking emptiness.

Renamed wtforms.contrib to wtforms.ext and reorganised wtforms.ext.django. This is a breaking change if you were using the django extensions, but should only require changing your imports around a little.

Better support for other frameworks such as Pylons.

Initial release.