U PN^H@s6dZddlmZmZmZmZddlmZddl 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'd>d:d;Z(ed9d9d9d9fdcCs$|dtjdddtjf|S)z1Returns a form field for a ``db.RatingProperty``.rrdr)r rrrrrrrrconvert_RatingPropertysr@c@sdeZdZdZeeeeee e e e e eeeeeeeeeeeeedZedddgZd ddZd d ZdS) 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 LinkPropertyZ EmailPropertyZ GeoPtPropertyZ IMPropertyZPhoneNumberPropertyZPostalAddressPropertyZRatingPropertyrCrDrBNcCs|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)selfrFrrr__init__YszModelConverter.__init__cCst|j}|jdd|gd}|r6|||jrX||jkrX|d t |j rd|krzdd|j D|d<t j f|S|j|d}|dk r||||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|] }||fqSrr).0rrrr }sz*ModelConverter.convert..N)type__name__namereplacetitle default_valueupdater0NO_AUTO_REQUIREDr rrMrZ SelectFieldrFget)rGrr field_argsZprop_type_namer converterrrrconvertcs   zModelConverter.convert)N) rQ __module__ __qualname____doc__rr!r"r#r$r*r+r,r-r.r1r2r3r4r5r6r8r:r;r<r=r>r@rE frozensetrWrHr[rrrrrAs8> rANc s|pt}|pi}|}tt|ddd}tdd|D|r\tfdd|DnrvtfddDi}D],}||||||} | dk r~| ||<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)rrrrzmodel_fields..)keycss|]}|dVqdS)rNr)rNxrrr szmodel_fields..c3s|]}|kr|VqdSNrrNr) field_namesrrresc3s|]}|kr|VqdSrfrrg)excluderrresN)rAZ propertiessortedrlistr[rX) ronlyrirYrZpropsZ sorted_props field_dictrRfieldr)rirhr model_fieldss  rpcCs&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)rprPkind)rZ base_classrlrirYrZrnrrr model_formsrr)NNNN)*r^ZwtformsrrrrrZwtforms.compatrZwtforms.ext.appengine.fieldsrrr rrrr!r"r#r$r*r+r,r-r.r1r2r3r4r5r6r8r:r;r<r=r>r@objectrArprrrrrrsH]        -