3 Version: 0.1.26.1

     3 Version: 0.1.27

     9 Description: 

     9 Description: ==================

    10         PyAMS_form package

    11         ==================

    12         

    13         .. contents::

    14         

    15         

    16         What is PyAMS?

    17         ==============

    18         

    19         PyAMS (Pyramid Application Management Suite) is a small suite of packages written for applications

    20         and content management with the Pyramid framework.

    21         

    22         **PyAMS** is actually mainly used to manage web sites through content management applications (CMS,

    23         see PyAMS_content package), but many features are generic and can be used inside any kind of web

    24         application.

    25         

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

    27         

    28         

    29         What is PyAMS_form?

    30         ===================

    31         

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

    33         

    34         PyAMS_form allows to use z3c.forms forms inside Pyramid applications, providing a bridge between

    35         initial Pyramid request and Zope publisher request used by z3c.form, with the help of the

    36         "pyramid_zope_request" package.

    37         

    38         PyAMS_form also provides custom templates for forms and for z3c.form widgets, to use them with the

    39         MyAMS framework used by PyAMS_skin and PyAMS_zmi packages, and provides a small set of additional

    40         widgets.

    41         

    42         This package also provides additional features, like form groups (which allows to group a set of

    43         form's widgets inside a fieldset), and a set of viewlet managers which can be used to extend a

    44         form's content using viewlets adapters; you can also extend a form by defining sub-forms and

    45         tab-forms adapters.

    46         

    47         

    48         Note about PyAMS_form API

    49         =========================

    50         

    51         PyAMS_form naming convention is actually a mix between z3c.form API, which is using camelCase

    52         naming convention, and Pyramid which is using standard Python's snake_case convention. A complete

    53         rewrite of PyAMS_form package, which will integrate all z3c.form features with a uniform API

    54         compliant with Pyramid's standards, is actually planned...

    55