o [hH@s:dZddlmZmZmZmZddlmZddl m Z m Z m Z ddZ ddZd d Zd d Zd dZddZddZddZddZddZddZddZddZdd Zd!d"Zd#d$Zd%d&Zd'd(Zd)d*Zd+d,Z d-d.Z!d/d0Z"d1d2Z#d3d4Z$d5d6Z%Gd7d8d8e&Z' 9 9d>d:d;Z(ed9d9d9d9fdcCr$)z/Returns a form field for a ``db.BlobProperty``.Nr )rZ FileFieldrr r rconvert_BlobPropertyr&r?cCr$)z/Returns a form field for a ``db.TextProperty``.Nr )rrrr r rconvert_TextPropertyr&r@cCr )z3Returns a form field for a ``db.CategoryProperty``.r!rr r rconvert_CategoryPropertyr#rAcC|dtt|S)z/Returns a form field for a ``db.LinkProperty``.r)rrurlrrr r rconvert_LinkPropertyrDcCrB)z0Returns a form field for a ``db.EmailProperty``.r)rremailrrr r rconvert_EmailPropertyrErGcCr6)z0Returns a form field for a ``db.GeoPtProperty``.Nr )rrr r rconvert_GeoPtPropertyr8rHcCr3)z-Returns a form field for a ``db.IMProperty``.Nr rr r rconvert_IMPropertyr5rIcCr )z6Returns a form field for a ``db.PhoneNumberProperty``.r!rr r rconvert_PhoneNumberPropertyr#rJcCr )z8Returns a form field for a ``db.PostalAddressProperty``.r!rr r rconvert_PostalAddressPropertyr#rKcCs(|dtjdddtjdi|S)z1Returns a form field for a ``db.RatingProperty``.rrdrNr )rrrrrrr r rconvert_RatingPropertysrMc@seZdZdZidededededede de d e d e d e d ed edededededeeeeeeedZegdZdddZddZdS)ModelConvertera Converts properties from a ``db.Model`` class to form fields. Default conversions between properties and fields: +====================+===================+==============+==================+ | Property subclass | Field subclass | datatype | notes | +====================+===================+==============+==================+ | StringProperty | TextField | unicode | TextArea | | | | | if multiline | +--------------------+-------------------+--------------+------------------+ | ByteStringProperty | TextField | str | | +--------------------+-------------------+--------------+------------------+ | BooleanProperty | BooleanField | bool | | +--------------------+-------------------+--------------+------------------+ | IntegerProperty | IntegerField | int or long | | +--------------------+-------------------+--------------+------------------+ | FloatProperty | TextField | float | | +--------------------+-------------------+--------------+------------------+ | DateTimeProperty | DateTimeField | datetime | skipped if | | | | | auto_now[_add] | +--------------------+-------------------+--------------+------------------+ | DateProperty | DateField | date | skipped if | | | | | auto_now[_add] | +--------------------+-------------------+--------------+------------------+ | TimeProperty | DateTimeField | time | skipped if | | | | | auto_now[_add] | +--------------------+-------------------+--------------+------------------+ | ListProperty | None | list | always skipped | +--------------------+-------------------+--------------+------------------+ | StringListProperty | TextAreaField | list of str | | +--------------------+-------------------+--------------+------------------+ | ReferenceProperty | ReferencePropertyF| db.Model | | +--------------------+-------------------+--------------+------------------+ | SelfReferenceP. | ReferencePropertyF| db.Model | | +--------------------+-------------------+--------------+------------------+ | UserProperty | None | users.User | always skipped | +--------------------+-------------------+--------------+------------------+ | BlobProperty | FileField | str | | +--------------------+-------------------+--------------+------------------+ | TextProperty | TextAreaField | unicode | | +--------------------+-------------------+--------------+------------------+ | CategoryProperty | TextField | unicode | | +--------------------+-------------------+--------------+------------------+ | LinkProperty | TextField | unicode | | +--------------------+-------------------+--------------+------------------+ | EmailProperty | TextField | unicode | | +--------------------+-------------------+--------------+------------------+ | GeoPtProperty | TextField | db.GeoPt | | +--------------------+-------------------+--------------+------------------+ | IMProperty | None | db.IM | always skipped | +--------------------+-------------------+--------------+------------------+ | PhoneNumberProperty| TextField | unicode | | +--------------------+-------------------+--------------+------------------+ | PostalAddressP. | TextField | unicode | | +--------------------+-------------------+--------------+------------------+ | RatingProperty | IntegerField | int or long | | +--------------------+-------------------+--------------+------------------+ | _ReverseReferenceP.| None | | always skipped | +====================+===================+==============+==================+ ZStringPropertyZByteStringPropertyBooleanPropertyZIntegerPropertyZ FloatPropertyZDateTimePropertyZ DatePropertyZ TimeProperty ListPropertyStringListPropertyZReferencePropertyZSelfReferencePropertyZ UserPropertyZ BlobPropertyZ TextPropertyZCategoryPropertyZ LinkProperty)Z EmailPropertyZ GeoPtPropertyZ IMPropertyZPhoneNumberPropertyZPostalAddressPropertyZRatingProperty)rPrQrONcCs|p|j|_dS)z Constructs the converter, setting the converter callables. :param converters: A dictionary of converter callables for each property type. The callable must accept the arguments (model, prop, kwargs). N)default_converters converters)selfrSr r r__init__YszModelConverter.__init__cCst|j}|jdd|gd}|r|||jr,||jvr,|d t |j rEd|vr=dd|j D|d<t j d i|S|j|d}|durV||||SdS) aD Returns a form field for a single model property. :param model: The ``db.Model`` class that contains the property. :param prop: The model property: a ``db.Property`` instance. :param field_args: Optional keyword arguments to construct the field. _ )labeldefaultrrchoicescSsg|]}||fqSr r ).0rr r r }sz*ModelConverter.convert..Nr )type__name__namereplacetitle default_valueupdater;NO_AUTO_REQUIREDrrrZrZ SelectFieldrSget)rTrr field_argsZprop_type_namer converterr r rconvertcs"   zModelConverter.convertN) r^ __module__ __qualname____doc__rr"r%r'r(r/r1r2r4r7r<r=r>r?r@rArDrGrHrIrJrKrMrR frozensetrdrUrhr r r rrNs^=        rNNc s|pt}|pi}|}tt|ddd}tdd|D|r.tfdd|Dn r;tfddDi}D]}||||||} | durU| ||<q?|S) a Extracts and returns a dictionary of form fields for a given ``db.Model`` class. :param model: The ``db.Model`` class to extract fields from. :param only: An optional iterable with the property names that should be included in the form. Only these properties will have fields. :param exclude: An optional iterable with the property names that should be excluded from the form. All other properties will have fields. :param field_args: An optional dictionary of field names mapping to a keyword arguments used to construct each field object. :param converter: A converter to generate the fields based on the model properties. If not set, ``ModelConverter`` is used. cSs |djS)N)Zcreation_counter)rr r rs zmodel_fields..)keycss|]}|dVqdS)rNr )r[xr r r szmodel_fields..c3s|] }|vr|VqdSrir r[r) field_namesr rrrc3s|] }|vr|VqdSrir rs)excluder rrrruN)rN propertiessortedrlistrhre) ronlyrvrfrgpropsZ sorted_props field_dictr_fieldr )rvrtr model_fieldss r~cCs&t|||||}t|d|f|S)a, Creates and returns a dynamic ``wtforms.Form`` class for a given ``db.Model`` class. The form class can be used as it is or serve as a base for extended form classes, which can then mix non-model related fields, subforms with other model forms, among other possibilities. :param model: The ``db.Model`` class to generate a form for. :param base_class: Base form class to extend from. Must be a ``wtforms.Form`` subclass. :param only: An optional iterable with the property names that should be included in the form. Only these properties will have fields. :param exclude: An optional iterable with the property names that should be excluded from the form. All other properties will have fields. :param field_args: An optional dictionary of field names mapping to keyword arguments used to construct each field object. :param converter: A converter to generate the fields based on the model properties. If not set, ``ModelConverter`` is used. r)r~r]kind)rZ base_classrzrvrfrgr|r r r model_formsr)NNNN)*rlZwtformsrrrrrZwtforms.compatrZwtforms.ext.appengine.fieldsrrr rrrr"r%r'r(r/r1r2r4r7r<r=r>r?r@rArDrGrHrIrJrKrMobjectrNr~rr r r rsJ]        -