a D g/@sTddlmZddlmZddlmZddlmZmZddl m Z m Z ddl m Z ddlmZdd lmZGd d d e ZGd d d e ZGddde ZGddde ZGddde ZGdddejZGdddejZGdddejZGddde ZGddde ZGddde ZGd d!d!ejZGd"d#d#eZ d$d$efd%d&Z!d$S)') OrderedDict)NoReverseMatch)get_all_child_relations) relations serializers)Field SkipField)_TaggableManager)fields)get_object_detail_urlc@s eZdZdZddZddZdS) TypeFieldze Serializes the "type" field of each object. Example: "type": "wagtailimages.Image" cCs|SNselfinstancerrY/var/www/lab.imftr.de/x/nb_venv/lib/python3.9/site-packages/wagtail/api/v2/serializers.py get_attributeszTypeField.get_attributecCs2t|jjdt|j}t||jdj|<|SN.view)type_meta app_label__name__context seen_types)robjnamerrrto_representationszTypeField.to_representationNr __module__ __qualname____doc__rr rrrrr sr c@s eZdZdZddZddZdS)DetailUrlFieldz Serializes the "detail_url" field of each object. Example: "detail_url": "http://api.example.com/v1/images/1/" cCs0t|jd|jdt||j}|r(|StdS)NZrouterrequest)r rrpkr)rrurlrrrr's zDetailUrlField.get_attributecCs|Srr)rr(rrrr 2sz DetailUrlField.to_representationNr!rrrrr%s r%c@s eZdZdZddZddZdS)PageHtmlUrlFieldz{ Serializes the "html_url" field for pages. Example: "html_url": "http://www.example.com/blog/blog-post/" cCs|Srrrrrrr>szPageHtmlUrlField.get_attributecCs"z|jWStyYdS0dSr)full_urlrrpagerrrr As z"PageHtmlUrlField.to_representationNr!rrrrr)6sr)c@s eZdZdZddZddZdS) PageTypeFielda  Serializes the "type" field for pages. This takes into account the fact that we sometimes may not have the "specific" page object by calling "page.specific_class" instead of looking at the object's type. Example: "type": "blog.BlogPage" cCs|SrrrrrrrTszPageTypeField.get_attributecCs:|jdurdS|jjjd|jj}|j|jdj|<|Sr)Zspecific_classrrrrr)rr,rrrrr Ws  zPageTypeField.to_representationNr!rrrrr-Hs r-c@s eZdZdZddZddZdS)PageLocaleFieldz2 Serializes the "locale" field for pages. cCs|SrrrrrrrdszPageLocaleField.get_attributecCs|jjSr)localeZ language_coder+rrrr gsz!PageLocaleField.to_representationNr!rrrrr._sr.cs(eZdZdZfddZddZZS) RelatedFieldz Serializes related objects (eg, foreign keys). Example: "feed_image": { "id": 1, "meta": { "type": "wagtailimages.Image", "detail_url": "http://api.example.com/v1/images/1/" } } cs"|d|_tj|i|dSNserializer_classpopr2super__init__rargskwargs __class__rrr6zs zRelatedField.__init__cCs|j|jd}||S)Nr)r2rr )rvalue serializerrrrr ~szRelatedField.to_representationrr"r#r$r6r __classcell__rrr:rr0ks r0c@s eZdZdZddZddZdS)PageParentFielda Serializes the "parent" field on Page objects. Pages don't have a "parent" field so some extra logic is needed to find the parent page. That logic is implemented in this class. The representation is the same as the RelatedField class. cCs(|}|jdj|jdr$|SdS)NZ base_queryset)id)Z get_parentrfilterrBexists)rrparentrrrrszPageParentField.get_attributecCs0t|jgdgdtd}||jd}||SN)rBr detail_urlhtml_urltitle)rrGrH) meta_fieldsbaser<get_serializer_classr;PageSerializerrr rr=r2r>rrrr s z!PageParentField.to_representationNr!rrrrrAs rAc@s eZdZdZddZddZdS)PageAliasOfFieldz: Serializes the "alias_of" field on Page objects. cCs|jSr)alias_ofrrrrrszPageAliasOfField.get_attributecCs0t|jgdgdtd}||jd}||SrFrLrOrrrr s z"PageAliasOfField.to_representationNr!rrrrrPsrPcs(eZdZdZfddZddZZS)ChildRelationFielda Serializes child relations. Child relations are any model that is related to a Page using a ParentalKey. They are used for repeated fields on a page such as carousel items or related links. Child objects are part of the pages content so we nest them. The relation is represented as a list of objects. Example: "carousel_items": [ { "id": 1, "meta": { "type": "demo.MyCarouselItem" }, "title": "First carousel item", "image": { "id": 1, "meta": { "type": "wagtailimages.Image", "detail_url": "http://api.example.com/v1/images/1/" } } }, { "id": 2, "meta": { "type": "demo.MyCarouselItem" }, "title": "Second carousel item (no image)", "image": null } ] cs"|d|_tj|i|dSr1r3r7r:rrr6s zChildRelationField.__init__cs$|j|jdfdd|DS)Nr<csg|]}|qSr)r ).0Z child_objectr>rr sz8ChildRelationField.to_representation..)r2rallrr=rrTrr s z$ChildRelationField.to_representationr?rrr:rrRs& rRc@seZdZdZddZdS) StreamFielda Serializes StreamField values. Stream fields are stored in JSON format in the database. We reuse that in the API. Example: "body": [ { "type": "heading", "value": { "text": "Hello world!", "size": "h1" } }, { "type": "paragraph", "value": "Some content" } { "type": "image", "value": 1 } ] Where "heading" is a struct block containing "text" and "size" fields, and "paragraph" is a simple text block. Note that foreign keys are represented slightly differently in stream fields to other parts of the API. In stream fields, a foreign key is represented by an integer (the ID of the related object) but elsewhere in the API, foreign objects are nested objects with id and meta as attributes. cCs|j||jSr)Z stream_blockZget_api_representationrrWrrrr szStreamField.to_representationNrr"r#r$r rrrrrXs#rXc@seZdZdZddZdS) TagsFielda Serializes django-taggit TaggableManager fields. These fields are a common way to link tags to objects in Wagtail. The API serializes these as a list of strings taken from the name attribute of each tag. Example: "tags": ["bird", "wagtail"] cCst|djdddS)NrT)Zflat)listrVZorder_byZ values_listrWrrrr szTagsField.to_representationNrYrrrrrZ s rZcsdeZdZejjZeej e ie Z e ddZ eddZddZfddZfddZZS) BaseSerializerTZ read_onlyc s(t}ddjD}fdd|D}fdd|D}ddd|DvrXd|d<t}|D]N}z||}WntyYqbYn0|durd||j<qb||||j<qb|r||d<|D]`}z|jdkr|j}||}WntyYqYn0|durd||j<q||||j<q|S) NcSsg|]}|js|qSr)Z write_onlyrSfieldrrrrU/z4BaseSerializer.to_representation..csg|]}|jjvr|qSr field_namerJr^rrrrU2scsg|]}|jjvr|qSrrar^rcrrrU5r`rBcSsg|] }|jqSr)rbr^rrrrU8r`metaZadmin_display_title)rr valuesrrrbr Zspecific_deferred)rrdatar rJrdr_ attributerrcrr -s<         z BaseSerializer.to_representationcs*t||}t|trtifSt||Sr)getattr isinstancer rZr5build_property_field)rrbZ model_classr_r:rrrj`s  z#BaseSerializer.build_property_fieldcs(t||\}}|j||d<||fSr1)r5build_relational_fieldchild_serializer_classes)rrb relation_infoZ field_classZ field_kwargsr:rrrkhs z%BaseSerializer.build_relational_field)rr"r#rModelSerializerZserializer_field_mappingcopyupdatewagtailcore_fieldsrXr0Zserializer_related_fieldr rr%rGr rjrkr@rrr:rr\s   3 r\csNeZdZeddZeddZeddZe ddZ e ddZ fddZ ZS)rNTr]csV|jrHt|jd}ddt|D}||vrH||jvrHtd|j|ifSt||S)NmodelcSsi|]}|jjj|jqSr)r_Z remote_fieldZ related_nameZ related_model)rSZchild_relationrrr |sz9PageSerializer.build_relational_field..r2)Zto_manyrhMetarrlrRr5rk)rrbrmrrZchild_relationsr:rrrkws  z%PageSerializer.build_relational_field)rr"r#r-rr.r/r)rHrArErPrQrkr@rrr:rrNps      rNNcsR|Gfddd}|t||p&id}|r:||ttjd|f|S)NcseZdZZeZdS)z"get_serializer_class..MetaN)rr"r#rrr[r r field_namesZmodel_rrrtsrt)rtrJrl Serializer)r[rprstrr)rrrvrJZfield_serializer_overridesrlrKrtattrsrrurrMs rM)" collectionsrZdjango.urls.exceptionsrZmodelcluster.modelsrZrest_frameworkrrZrest_framework.fieldsrrZtaggit.managersr Zwagtailr rqutilsr r r%r)r-r.r0rArPrRrXrZrnr\rNrMrrrrs0       3(S