Metadata-Version: 2.1
Name: pyams_form
Version: 0.1.41
Summary: PyAMS base form interfaces and classes
Home-page: http://hg.ztfy.org/pyams/pyams_form
Author: Thierry Florac
Author-email: tflorac@ulthar.net
License: ZPL
Keywords: Pyramid PyAMS form
Classifier: License :: OSI Approved :: Zope Public License
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python
Classifier: Framework :: Pyramid
Classifier: Topic :: Software Development :: Libraries :: Python Modules
License-File: LICENSE
Requires-Dist: setuptools
Requires-Dist: persistent
Requires-Dist: pyams-i18n
Requires-Dist: pyams-pagelet
Requires-Dist: pyams-skin
Requires-Dist: pyams-template
Requires-Dist: pyams-utils
Requires-Dist: pyams-viewlet
Requires-Dist: pyramid
Requires-Dist: pyramid-chameleon
Requires-Dist: pyramid-zope-request
Requires-Dist: transaction
Requires-Dist: venusian
Requires-Dist: z3c.form (>=4.1.0)
Requires-Dist: z3c.table
Requires-Dist: zope.component
Requires-Dist: zope.interface
Requires-Dist: zope.lifecycleevent
Requires-Dist: zope.location
Requires-Dist: zope.pagetemplate
Requires-Dist: zope.publisher
Requires-Dist: zope.schema
Provides-Extra: test

==================
PyAMS_form package
==================

.. contents::


What is PyAMS?
==============

PyAMS (Pyramid Application Management Suite) is a small suite of packages written for applications
and content management with the Pyramid framework.

**PyAMS** is actually mainly used to manage web sites through content management applications (CMS,
see PyAMS_content package), but many features are generic and can be used inside any kind of web
application.

All PyAMS documentation is available on `ReadTheDocs <https://pyams.readthedocs.io>`_


What is PyAMS_form?
===================

This package is an update of z3c.form package for use with Pyramid.

PyAMS_form allows to use z3c.forms forms inside Pyramid applications, providing a bridge between
initial Pyramid request and Zope publisher request used by z3c.form, with the help of the
"pyramid_zope_request" package.

PyAMS_form also provides custom templates for forms and for z3c.form widgets, to use them with the
MyAMS framework used by PyAMS_skin and PyAMS_zmi packages, and provides a small set of additional
widgets.

This package also provides additional features, like form groups (which allows to group a set of
form's widgets inside a fieldset), and a set of viewlet managers which can be used to extend a
form's content using viewlets adapters; you can also extend a form by defining sub-forms and
tab-forms adapters.


Note about PyAMS_form API
=========================

PyAMS_form naming convention is actually a mix between z3c.form API, which is using camelCase
naming convention, and Pyramid which is using standard Python's snake_case convention. A complete
rewrite of PyAMS_form package, which will integrate all z3c.form features with a uniform API
compliant with Pyramid's standards, is actually planned...


History
=======

0.1.41
------
 - added hint to TSV export button

0.1.40
------
 - added context argument to permission check

0.1.39
------
 - added object data to color widget template

0.1.38
------
 - added text display widget with clipboard copy

0.1.37
------
 - added "form_errors" content provider

0.1.36
------
 - use tuples instead of sets in hidden select widgets

0.1.35
------
 - updated widget form template

0.1.34
------
 - updated forms templates

0.1.33
------
 - added support for custom actions handlers

0.1.32
------
 - updated form context permission checker
 - updated form groups templates

0.1.31
------
 - add dialog_class attribute to form manager

0.1.30
------
 - updated hidden Select2 widget data extraction
 - updated Select2 widget templates
 - added base FormManager class

0.1.29
------
 - added events before and after widgets updates

0.1.28
------
 - added adapter lookup while creating search form

0.1.27
------
 - code cleanup
 - Gitlab-CI integration

0.1.26.2
--------
 - updated Select2 widget display template
 - updated object sub-form template for z3c.form > 4.1.0

0.1.26.1
--------
 - updated DottedDecimalFieldWidget template to add custom error message

0.1.26
------
 - don't show key in JSON dict display widget
 - added widget adapter for decimal fields
 - added optional "status" argument to Form.add_error() method

0.1.25.1
--------
 - don't check mode in display forms

0.1.25
------
 - corrected widget display templates
 - set status correctly in form's "add_error" method
 - added widget to display JSON dict field
 - updated radio and checkbox widget templates to correctly display translation strings

0.1.24
------
 - added widget selector subscriber predicate
 - updated Select2 widgets templates in display mode
 - added translation to radio buttons display template
 - added simple "add_error" method to IForm interface to be able to add an error easilly to
   an existing form

0.1.23.1
--------
 - updated checkbox widget display template

0.1.23
------
 - added Bytes to Textarea widget data converter
 - added missing object data attributes
 - updated search results table template to add TSV export action button

0.1.22.1
--------
 - corrected integer and float input widgets validation rules
 - updated translation domain of boolean terms

0.1.22
------
 - updated add forms so that subforms context is the newly created content instead of dynamic
   subform context

0.1.21
------
 - updated Integer and Float input widgets to use server's locale

0.1.20
------
 - added custom widgets with validation rules for integer and float fields
 - updated forms templates
 - added "override_widget_template" and "override_widget_layout" to be able to change a widget
   template without using ZCML

0.1.19
------
 - updated AJAX form decorator

0.1.18
------
 - update TinyMCE editor widget when searching for editor configuration

0.1.17
------
 - translate action button title

0.1.16
------
 - updated forms and subforms templates

0.1.15
------
 - updated Select2 widgets templates
 - updated text areas CSS class

0.1.14
------
 - updated "ajax_config" decorator to improve handling of overriden "get_ajax_output" method
 - added transaction savepoint after form update to finalize all components state before rendering

0.1.13
------
 - added optional "factory" argument to "NamedWidgetsGroups" function
 - added "ajax_config" class decorator to declare AJAX views
 - updated groups management

0.1.12
------
 - added clearfix in form templates between widgets prefix and groups
 - added helper to get edit permission for any object
 - updated base forms prefix and ID getter

0.1.11
------
 - updates in form management to avoid multiple updates on the same content when using sub-forms
 - updated input widgets templates to add primary color to inputs with icon(s)

0.1.10
------
 - added optional notice before and after widgets, and added CSS class to form groups
 - updated object subform template for z3c.form >= 3.4.0
 - reified "groups" form property

0.1.9
-----
 - added test in main form template to remove "<form>" tag when no action is defined
 - added "SEO-enabled" text input to display quality gauge based on input length (for use on content's title)

0.1.8
-----
 - updated form widgets group interface to add fieldset class
 - added ValidationError exception management "after-update" in AJAX forms; these exceptions can
   occur when forms contain "file" input fields of invalid content-type

0.1.7
-----
 - reify permission in protected form object mixin base class
 - updated TextLineList input widget to allow options sorting

0.1.6
-----
 - updated JSON responses management in AJAX forms
 - added 'id' attribute for inner forms containers
 - added 'legend_class' attribute for inner forms

0.1.5
-----
 - removed reference to 'subform' in object field widget template
 - added "unconditional" edit form's buttons interface
 - allow multiline help in form group

0.1.4
-----
 - changed widgets CSS class attribute
 - added custom widget template for display-mode ordered list
 - added ObjectWidget template
 - handle errors snippets with multiple errors (as used by ObjectWidget)
 - imports cleanup

0.1.3
-----
 - added form toolbar viewlet
 - added HTML widget display template

0.1.2
-----
 - updated form template to change dialog's close icon
 - added Select2 and TextLineList widgets

0.1.1
-----
 - added "widget_title" viewlet to form's header (if requested explicitly)
 - added CSS class for form's help block
 - updated checkbox translations
 - small changes in subforms and groups management (modified interface)

0.1.0
-----
 - first release
