Metadata-Version: 2.1
Name: pyams_form
Version: 1.7.4
Summary: PyAMS forms management package
Home-page: https://pyams.readthedocs.io
Author: Thierry Florac
Author-email: tflorac@ulthar.net
License: ZPL
Keywords: Pyramid PyAMS
Platform: UNKNOWN
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
Provides-Extra: test
License-File: LICENSE

==================
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>`_; source code
is available on `Gitlab <https://gitlab.com/pyams>`_ and pushed to `Github
<https://github.com/py-ams>`_. Complete doctests are available in the *doctests* folder.


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

PyAMS_form is a fork of `z3c.form <https///github.com/zopefoundation/z3c.form>`_ package;
it provides the same features to generate HTML forms based on schema interfaces, but adapted to
the Pyramid framework for use with Chameleon templates.

It is also adding a few features, with custom form-related viewlets managers and AJAX forms.

** Package API is also converted to common Python standards, using snake_case for variables and
methods.


Changelog
=========

1.7.4
-----
 - reverted doctest

1.7.3
-----
 - added support for Python 3.10 and 3.11
 - updated doctests

1.7.2
-----
 - cancelled doctest update

1.7.1
-----
 - updated get_forms method to only get inner forms which are really implementing inner forms
   interfaces; this can be useful to include inner viewlets which are not forms into a parent
   form

1.7.0
-----
 - added interfaces support for form content and form fields adapters
 - added form update events
 - added support for Python 3.10

1.6.5
-----
 - cancelled doctest update

1.6.4
-----
 - small updates in default AJAX form renderer
 - reified form edit permission getter

1.6.3
-----
 - changed test in AJAX add form to check changes against *None* instead of boolean *false*
   value to handle use case where created object is an empty container

1.6.2
-----
 - updated doctests for *zope.schema* package >= 6.1.1, where boolean schema fields are
   automatically set as required

1.6.1
-----
 - updated doctests

1.6.0
-----
 - added optional *ajax_require_csrf* argument to *ajax_form_config* decorator

1.5.0
-----
 - updated sequence widget behaviour to be able to extract data from single
   value using a separator
 - updated default AJAX renderer to merge outputs of inner forms renderers

1.4.3
-----
 - version mismatch

1.4.2
-----
 - added missing "context" argument to permission check
 - added missing widget factory for text lines list field
 - removed unused interface

1.4.1
-----
 - Gitlab-CI pylint test update

1.4.0
-----
 - removed support for Python < 3.7
 - updated Bytes schema field to FileWidget data converter

1.3.1
-----
 - updated Gitlab-CI configuration

1.3.0
-----
 - look for actions in finished state to get AJAX renderers
 - updated Gitlab-CI configuration
 - removed Travis-CI configuration

1.2.1
-----
 - interfaces description updates
 - code cleanup

1.2.0
-----
 - added support for inner sub-forms and tab-forms in groups manager

1.1.0
-----
 - small updates in forms API
 - use form's "finished_state" attribute to store executed action and changes
 - automatically use objects factories in add forms
 - updated "adapter_config" decorator arguments names
 - updated access to Pyramid's global registry
 - updated doctests

1.0.4
-----
 - included edge case fix to handle missing values which are not None but that work as None
   (merged from z3c.form)

1.0.3
-----
 - updated doctests using ZCA hook

1.0.2
-----
 - code refactoring to reduce duplications

1.0.1
-----
 - updated doctests

1.0.0
-----
 - initial release


