Metadata-Version: 2.1
Name: feincms3_forms
Version: 0.0.19
Summary: UNKNOWN
Home-page: https://github.com/matthiask/feincms3-forms/
Author: Matthias Kestenholz
Author-email: mk@feinheit.ch
License: BSD-3-Clause
Platform: OS Independent
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Requires-Python: >=3.9
Description-Content-Type: text/x-rst
Provides-Extra: tests
License-File: LICENSE

==============
feincms3-forms
==============

.. image:: https://github.com/matthiask/feincms3-forms/actions/workflows/tests.yml/badge.svg
    :target: https://github.com/matthiask/feincms3-forms/
    :alt: CI Status


No documentation yet, sorry. You have to look at the testsuite.

Design decisions
================

This is a list of things which should be explained but are not at the moment.

- Form fields have to inherit ``FormFieldBase``. ``FormFieldBase`` only has a
  ``name`` field. This field can be checked for clashes etc. The base class is
  used instead of duck typing in various places where the code may encounter
  not only form field plugins but also other django-content-editor plugins. The
  latter are useful e.g. to add blocks of text or other content between form
  fields.
- The ``FormField`` offers a basic set of attributes for standard fields such
  as a label, a help text and whether the field should be required or not.
- The ``SimpleFieldBase`` should be instantiated in your project and can be
  used to cheaply generate standard form field plugin proxies for HTML5 input
  fields. (Sorry for the jargon.) Those proxies are standard Django model
  proxies.


