Import www/py-formalchemy version 1.3.3_1
[dports.git] / www / py-formalchemy / pkg-descr
1 [ from the website ]
2
3 Introduction
4 ============
5
6 FormAlchemy greatly speeds development with SQLAlchemy mapped classes
7 (models) in a HTML forms environment.
8
9 FormAlchemy eliminates boilerplate by autogenerating HTML input fields
10 from a given model. FormAlchemy will try to figure out what kind of
11 HTML code should be returned by introspecting the model's properties
12 and generate ready-to-use HTML code that will fit the developer's
13 application.
14
15 Of course, FormAlchemy can't figure out everything, i.e, the developer
16 might want to display only a few columns from the given model. Thus,
17 FormAlchemy is also highly customizable.
18
19 Features
20 ========
21
22 - Generates HTML form fields and tables from SQLAlchemy mapped classes
23   or manually added Fields
24 - Works with declarative or classic mapper definitions
25 - Render and edits single objects or collections (grids)
26 - Handles object relationships (including many-to-many), not just
27   simple data types
28 - Synonym support
29 - Composite and custom type support
30 - Supports all composite primary keys and most CFKs
31 - Pre-fills input fields with current or default value
32 - Highly customizable HTML output
33 - Validates input and displays errors in-line
34 - Syncs model instances with input data
35 - Easy-to-use, extensible API
36 - SQLAlchemy 0.4 (0.4.5 or later) and 0.5 compatible
37
38
39 Limitations
40 ===========
41
42 - Currently, only handles composite foreign keys of primitive Python
43   types
44
45 WWW: http://code.google.com/p/formalchemy/