a D g@sddlZddlZddlZddlZddlZddlmZddlmZddl m Z ddl m Z ddl mZddlmZddlmZdd lmZdd lmZdd lmZdd lmZdd lmZddlmZddlm Z ddl!m"Z"ddl#m$Z$gdZ%Gddde&Z'Gddde'dZ(GdddZ)Gddde'Z*Gddde j+Z,Gddde j-Z.edd d!d"Z/d#d$Z0d%d&Z1e(d'iZ2dS)(N) lru_cache) import_module)forms)checks)ImproperlyConfiguredrender_to_string force_str)cached_property) format_html) mark_safe)capfirst)versioned_static) accepts_kwarg) JSContext)RemovedInWagtail70Warning)template_is_overridden) BaseBlockBlock BoundBlockDeclarativeSubBlocksMetaclass BlockWidget BlockFieldcseZdZfddZZS)rcsZ|dd}t||||}|gdd|D}ttt|}tt|d|i|_|S)NMetacSsg|]}t|ddqS) _meta_classN)getattr).0baserR/var/www/lab.imftr.de/x/nb_venv/lib/python3.9/site-packages/wagtail/blocks/base.py /sz%BaseBlock.__new__..) popsuper__new__tuplefilterbooltypestrr)mcsnamebasesattrsZ meta_classclsZmeta_class_bases __class__rr r$)s  zBaseBlock.__new__)__name__ __module__ __qualname__r$ __classcell__rrr/r r(srcseZdZdZdZiZdZdZGdddZgZ fddZ d d Z e d d Z d dZddZddZddZdRddZddZddZddZddZd d!Zd"d#Zd$d%ZdSd&d'ZdTd(d)ZdUd*d+ZdVd,d-ZdWd.d/Zd0d1Ze d2d3Z!e d4d5Z"d6d7Z#dXd8d9Z$dYd:d;Z%dd?Z'd@dAZ(dBdCZ)dDdEZ*dFdGZ+e,dHdIZ-e dJdKZ.dLdMZ/dNdOZ0dPdQZ1Z2S)Zrrvaluez%wagtailcore/shared/block_preview.htmlc@seZdZdZdZdZdZdS)z Block.MetaN placeholderr5)r1r2r3labelZicon classnamegrouprrrr r@srcst|}||f|_|SN)r#r$_constructor_args)r.argskwargsobjr/rr r$Ls  z Block.__new__cKsd|jdvr0|jdd}|jdd|||_|D]\}}t|j||qBtj|_tjd7_d|j|_ |tj |j <|jj pd|_ dS)Nr9Zform_classnamez blockdef-%dr5) r<r" setdefaultrmetaitemssetattrrcreation_counterZdefinition_prefixdefinition_registryr8)selfr>r9attrr6rrr __init__Ss   zBlock.__init__cOs||i|S)z See `wagtail.blocks.definition_lookup.BlockDefinitionLookup`. Construct a block instance from the provided arguments, using the given BlockDefinitionLookup object to perform any necessary lookups. r)r.lookupr=r>rrr construct_from_lookuphs zBlock.construct_from_lookupcCs(||_|jjs$tt|dd|_dS)N_ )r+rBr8rr replace)rGr+rrr set_namesszBlock.set_namecCs<|D].\}}||jvr*t|j||qtd|qdS)aX Update this block's meta options (out of the ones designated as mutable) from the given dict. Used by the StreamField constructor to pass on kwargs that are to be handled by the block, since the block object has already been created by that point, e.g.: body = StreamField(SomeStreamBlock(), max_num=5) z/set_meta_options received unexpected option: %rN)rCMUTABLE_META_ATTRIBUTESrDrB TypeError)rGoptsrHr6rrr set_meta_optionsxs  zBlock.set_meta_optionscCstd|jdS)Nz%s.value_from_datadict)NotImplementedErrorr0)rGdatafilesprefixrrr value_from_datadictszBlock.value_from_datadictcCs||vS)a Used only for top-level blocks wrapped by BlockWidget (i.e.: typically only StreamBlock) to inform ModelForm logic on Django >=1.10.2 whether the field is absent from the form submission (and should therefore revert to the field default). rrGrUrVr+rrr value_omitted_from_dataszBlock.value_omitted_from_dataNcCst||||dS)a Return a BoundBlock which represents the association of this block definition with a value and a prefix (and optionally, a ValidationError to be rendered). BoundBlock primarily exists as a convenience to allow rendering within templates: bound_block.render() rather than blockdef.render(value, prefix) which can't be called from within a template. )rWerrors)r)rGr6rWr[rrr bindsz Block.bindcCs|t|jddS)a Return this block's default value (conventionally found in self.meta.default), converted to the value type expected by this block. This caters for the case where that value type is not something that can be expressed statically at model definition time (e.g. something like StructValue which incorporates a pointer back to the block definition object). defaultN) normalizerrBrGrrr get_defaultszBlock.get_defaultcCs|S)ad Validate value and return a cleaned version of it, or throw a ValidationError if validation fails. The thrown ValidationError instance will subsequently be passed to render() to display the error message; the ValidationError must therefore include all detail necessary to perform that rendering, such as identifying the specific child block(s) with errors, in the case of nested blocks. (It is suggested that you use the 'params' attribute for this; using error_list / error_dict is unreliable because Django tends to hack around with these when nested.) rrGr6rrr cleans z Block.cleancCs|S)aT Given a value for any acceptable type for this block (e.g. string or RichText for a RichTextBlock; dict or StructValue for a StructBlock), return a value of the block's native type (e.g. RichText for RichTextBlock, StructValue for StructBlock). In simple cases this will return the value unchanged. rrarrr r^szBlock.normalizecCs|S)a& Convert 'value' from a simple (JSON-serialisable) value to a (possibly complex) Python value to be used in the rest of the block API and within front-end templates . In simple cases this might be the value itself; alternatively, it might be a 'smart' version of the value which behaves mostly like the original value but provides a native HTML rendering when inserted into a template; or it might be something totally different (e.g. an image chooser will use the image ID as the clean value, and turn this back into an actual image object here). For blocks that are usable at the top level of a StreamField, this must also accept any type accepted by normalize. (This is because Django calls `Field.to_python` from `Field.clean`.) rrarrr to_pythons zBlock.to_pythoncsfdd|DS)z Apply the to_python conversion to a list of values. The default implementation simply iterates over the list; subclasses may optimise this, e.g. by combining database lookups into a single query. csg|]}|qSr)rc)rr6r_rr r!z(Block.bulk_to_python..r)rGvaluesrr_r bulk_to_pythonszBlock.bulk_to_pythoncCs|S)za The reverse of to_python; convert the python value into JSON-serialisable form. rrarrr get_prep_valueszBlock.get_prep_valuecCs|S)a3 Convert a python value for this block into a JSON-serialisable representation containing all the data needed to present the value in a form field, to be received by the block's client-side component. Examples of where this conversion is not trivial include rich text (where it needs to be supplied in a format that the editor can process, e.g. ContentState for Draftail) and page / image / document choosers (where it needs to include all displayed data for the selected item, such as title or thumbnail). rrarrr get_form_states zBlock.get_form_statecCs |pi}|d||j|i|S)a* Return a dict of context variables (derived from the block ``value`` and combined with the ``parent_context``) to be used as the template context when rendering this value through a template. See :ref:`the usage example ` for more details. rG)update TEMPLATE_VAR)rGr6parent_contextcontextrrr get_contextszBlock.get_contextcCst|jddS)a Return the template to use for rendering the block if specified. This method allows for dynamic templates based on the block instance and a given ``value``. See :ref:`the usage example ` for more details. templateNrrBrGr6rlrrr get_templateszBlock.get_templatecCsd|i}t|jdr||d<nt|jjdt|jfi|}|sV|j||dS|durj||}n|j|t |d}t t ||S)a/ Return a text rendering of 'value', suitable for display on templates. By default, this will use a template (with the passed context, supplemented by the result of get_context) if a 'template' property is specified on the block, and fall back on render_basic otherwise. rlr6z@.get_template should accept a 'value' argument as first argumentrlN)rk) rrqwarningswarnr0r1r render_basicrmdictr r)rGr6rlr=rnZ new_contextrrr renders    z Block.rendercCs|piS)a Return a dict of context variables to be used as the template context when rendering the block's preview. The ``value`` argument is the value returned by :meth:`get_preview_value`. The ``parent_context`` argument contains the following variables: - ``request``: The current request object. - ``block_def``: The block instance. - ``block_class``: The block class. - ``bound_block``: A ``BoundBlock`` instance representing the block and its value. If :ref:`the global preview template ` is used, the block will be rendered as the main content using ``{% include_block %}``, which in turn uses :meth:`get_context`. As a result, the context returned by this method will be available as the ``parent_context`` for ``get_context()`` when the preview is rendered. r)rGr6rkrrr get_preview_contextszBlock.get_preview_contextcCst|jddp|jS)a Return the template to use for rendering the block's preview. The ``value`` argument is the value returned by :meth:`get_preview_value`. The ``context`` argument contains the variables listed for the ``parent_context`` argument of :meth:`get_preview_context` above (and not the context returned by that method itself). Note that the preview template is used to render a complete HTML page of the preview, not just an HTML fragment for the block. The method returns the ``preview_template`` attribute from the block's options if provided, and falls back to :ref:`the global preview template ` otherwise. If the global preview template is used, the block will be rendered as the main content using ``{% include_block %}``, which in turn uses :meth:`get_template`. preview_templateN)rrBDEFAULT_PREVIEW_TEMPLATErprrr get_preview_template)szBlock.get_preview_templatecCs"t|jdr||jjS|S)ad Return the placeholder value that will be used for rendering the block's preview. By default, the value is the ``preview_value`` from the block's options if provided, otherwise the ``default`` is used as fallback. This method can be overridden to provide a dynamic preview value, such as from the database. preview_value)hasattrrBr^r|r`r_rrr get_preview_valueAs zBlock.get_preview_valuecCst|jddduS)Nr]ror_rrr _has_defaultMszBlock._has_defaultcCs`t|jdp|jjtju}t|jdpF|jpF|jjtjupF|jjtju}t|j d}|p^|o^|S)Nryr|Z templates) r}rBr0r{rrrxr~rrz)rGZhas_specific_templateZhas_preview_valueZhas_global_templaterrr is_previewableQs     zBlock.is_previewablecCst|jddS)z Return the description of the block to be shown to editors as part of the preview. For :ref:`field block types `, it will fall back to ``help_text`` if not provided. descriptionr5ror_rrr get_descriptionkszBlock.get_descriptioncCs ||S)zq Can be used to customise the API response and defaults to the value returned by get_prep_value. )rgrprrr get_api_representationsszBlock.get_api_representationcCst|S)z Return a text rendering of 'value', suitable for display on templates. render() will fall back on this if the block does not define a 'template' property. r rprrr ruyszBlock.render_basiccCsgS)zt Returns a list of strings containing text content within this block to be used in a search engine. rrarrr get_searchable_contentszBlock.get_searchable_contentcCsgSr;rrarrr extract_referencesszBlock.extract_referencescCs|rdS||SdS)z Given a list of elements from a content path, retrieve the block at that path as a BoundBlock object, or None if the path does not correspond to a valid block. N)r\)rGr6Z path_elementsrrr get_block_by_content_pathszBlock.get_block_by_content_pathcKsgS)z Hook for the Django system checks framework - returns a list of django.core.checks.Error objects indicating validity errors in the block r)rGr>rrr checksz Block.checkc Ks g}|js0|tjd|jd|d|ddd|jvr`|tjd|jd|d|ddd|jvr|tjd|jd |d|dd |jr|jd r|tjd|jd |d|dd |std |js|tjd|jd|d|dd |S)z Helper method called by container blocks as part of the system checks framework, to validate that this block's name is a valid identifier. (Not called universally, because not all blocks need names) zBlock name %r is invalidzBlock name cannot be emptyfieldzwagtailcore.E001)hintr?idrMz!Block names cannot contain spaces-z!Block names cannot contain dashes)r?rrz%Block names cannot begin with a digitz^[_a-zA-Z][_a-zA-Z0-9]*$zBlock names should follow standard Python conventions for variable names: alphanumeric and underscores, and cannot begin with a digit)r+appendrErrorgetisdigitrematch)rGr>r[rrr _check_names^          zBlock._check_namecCsdS)z Return the ID to be used as the 'for' attribute of