a D g! @sddlmZddlZddlZddlZddlZddlZddl Z ddl Z ddl m Z m Z mZddlmZddlmZddlmZddlmZddlmZddlZdd lmZdd lmZdd lmZdd l m!Z!m"Z"m#Z#dd l$m%Z%ddl&m'Z'ddl(m)Z)ddl*m+Z+m,Z,m-Z-ddl.m/Z/ddl0m1Z1ddl2m3Z3ddl4m5Z5ddl6m7Z7m8Z8ddl9m:Z:ddl;mZ?ddl@mAZAddlBmCZCddlDmEZEddlFmGZGmHZHddlImJZJmKZKmLZLmMZMddlNmOZOddlPmQZQmRZRdd lSmTZTdd!lUmVZVdd"lWmXZXeYd#ZZd$d%d&d'd(d)d*d+d,Z[Gd-d.d.e\Z]Gd/d0d0eVe/j^Z_d1d2Z`d3d4Zad5d6ZbGd7d8d8ZcGd9d:d:e/jdjejfZgGd;d<dd>eceQeTjje/jkZlGd?d@d@elZmGdAdBdBZnGdCdDdDZoedEdFdGgZpGdHdIdIeoZqGdJdKdKece/jkZrGdLdMdMerZsdS)N) annotationsN) OrderedDict defaultdict namedtuple)Iterable)contextmanager)BytesIO)SpooledTemporaryFile)Any)apps)settings)checks)DEFAULT_CACHE_ALIASInvalidCacheBackendErrorcaches) BaseCache)ImproperlyConfigured)File)InvalidStorageErrordefault_storagestorages)models)Q)flatatt)reverse)cached_property classproperty) import_string) mark_safe) gettext_lazy)TaggableManager)hooks)string_to_ascii)InvalidFilterSpecErrorUnknownOutputImageFormatError)FilterOperationFormatOperationImageTransformTransformOperation)Rect)CollectionMemberReferenceIndex)index)SearchableQuerySetMixin) hash_filelikezwagtail.imagesz.avifz.jpgz.pngz.gifz.webp.svgz.icoz.heic)avifjpegpnggifwebpsvgicoheicc@seZdZdZdS)SourceImageIOErrorzb Custom exception to distinguish IOErrors that were thrown while opening the source image N)__name__ __module__ __qualname____doc__r=r=T/var/www/lab.imftr.de/x/nb_venv/lib/python3.9/site-packages/wagtail/images/models.pyr8Esr8c@seZdZddZdS) ImageQuerySetcGsH|j}|j}|r2dd|D}|j|d}|tjd|ddS)z Prefetches generated renditions for the given filters. Returns all renditions when no filters are provided. cSs g|]}t|tr|jn|qSr=) isinstanceFilterspec.0filterr=r=r> Xsz5ImageQuerySet.prefetch_renditions..)Zfilter_spec__in renditionsprefetched_renditions)querysetZto_attr)modelget_rendition_modelobjectsallrEZprefetch_relatedrZPrefetch)selffiltersZrendition_modelrIZ filter_specsr=r=r>prefetch_renditionsNs   z!ImageQuerySet.prefetch_renditionsN)r9r:r;rPr=r=r=r>r?Msr?cCs ||S)a Obtain a valid upload path for an image file. This needs to be a module-level function so that it can be referenced within migrations, but simply delegates to the `get_upload_to` method of the instance, so that AbstractImage subclasses can override it.  get_upload_toinstancefilenamer=r=r>rRgsrRcCs ||S)a! Obtain a valid upload path for an image rendition file. This needs to be a module-level function so that it can be referenced within migrations, but simply delegates to the `get_upload_to` method of the instance, so that AbstractRendition subclasses can override it. rQrSr=r=r>get_rendition_upload_torsrVc Cshttdt}t|trdz t|}Wn@tybzt|}|}Wnty\t dYn0Yn0|S)z Obtain the storage object for an image rendition file. Returns custom storage (if defined), or the default storage. This needs to be a module-level function, because we do not yet have an instance when Django loads the models. ZWAGTAILIMAGES_RENDITION_STORAGEz[WAGTAILIMAGES_RENDITION_STORAGE must be either a valid storage alias or dotted module path.) getattrr rr@strrrr ImportErrorr)storagemoduler=r=r>get_rendition_storage}s      r\c@s4eZdZddZddZeddZeddZd S) ImageFileMixincCs(z|jjWdSty"YdS0dS)zM Returns True if the image is hosted on the local filesystem TFN)filepathNotImplementedErrorrNr=r=r>is_stored_locallys  z ImageFileMixin.is_stored_locallyc Cs^|jdurXz|jj|_Wn0tyH}ztt|WYd}~n d}~00|jdgd|jS)N file_sizeZ update_fields)rcr^size Exceptionr8rXsave)rNer=r=r> get_file_sizes "zImageFileMixin.get_file_sizec csd}zJ|j}|jjrL|r*|jdn|jdj}||jjd}d}Wn0ty~}zt t |WYd}~n d}~00| dz|VW|r| n|r| 0dS)NFrbr^Tr) r^closedrbopen_meta get_fieldrZnameOSErrorr8rXseekclose)rNZ close_file image_filerZrhr=r=r> open_files$"  zImageFileMixin.open_fileccs:|}tj|VWdn1s,0YdSN)rtwillowImagerl)rNrsr=r=r>get_willow_images zImageFileMixin.get_willow_imageN)r9r:r;rbrirrtrxr=r=r=r>r]s   r]c@s eZdZdZddZddZdS)WagtailImageFieldFilezS Override the ImageFieldFile in order to use Willow instead of Pillow. cCst|ds||_|jS)zV override _get_image_dimensions to call our own get_image_dimensions. _dimensions_cache)hasattrget_image_dimensionsrzrar=r=r>_get_image_dimensionss  z+WagtailImageFieldFile._get_image_dimensionsc Csh|j}zB|tj|}|W|r2|S|dS|dn|rX|n |d0dS)z The upstream ImageFieldFile calls a local function get_image_dimensions. In this implementation we've made get_image_dimensions a method to make it easier to override for Wagtail developers in the future. rN)rkrlrvrwget_sizerrrq)rNrrimager=r=r>r|s     z*WagtailImageFieldFile.get_image_dimensionsN)r9r:r;r<r}r|r=r=r=r>rysryc@seZdZdZeZdS)WagtailImageFieldzv Override the attr_class on the Django ImageField Model to inject our ImageFieldFile with Willow support. N)r9r:r;r<ryZ attr_classr=r=r=r>rsrc seZdZejdeddZeededddZ ejdded d d Z ej edd d Z ej edd d Z ejeddddZejejedddd ejdZde_eddeddZejdddZejdddZejdddZejdddZejdd dZejddd ddZe Z!fddZ"ddZ#ddZ$dd Z%d!d"Zd#d$Z&e'd%d&Z(e)j*e+j,dd'd(e+-de+.de+/de+j,d)d'd(e+-d)ge+.d*e+.d+e+.d,gZ*d-d.Z0d/d0Z1d1d2Z2d3d4Z3d5d6Z4d7d8Z5d9d:Z6d;d<Z7e8d=d>Z9d?d@dAdBZ:dCdDdEdFdGZ;dHdCdIdJdKZdHdQdRdSdTZ?dLdUdRdVdWZ@dLdUdRdXdYZAdLdZdCd[d\d]ZBdd^dLd_d_d[d`daZCdbdcZDdddeZEdfdgZFe'dhdiZGe'djdkZHdldmZIGdndodoZJZKS)p AbstractImagetitle) max_length verbose_namer^widthheight)r upload_to width_field height_fieldT description)blankrrdefaultF)reditablez created at)rZ auto_now_adddb_indexzuploaded by user)rnullrr on_deleteNtags) help_textrr)rr)rr()rrrrcs"tj|i|d|_d|_dSNF)super__init__ decorativecontextual_alt_text)rNargskwargs __class__r=r>r.szAbstractImage.__init__cCs6|}t||_Wdn1s(0YdSru)rtr. file_hash)rNfr=r=r>_set_file_hash3s zAbstractImage._set_file_hashcCs&|jdkr ||jdgd|jS)Nrrrd)rrrgrar=r=r> get_file_hash7s zAbstractImage.get_file_hashcCs,|j|jj|_||jddSNr)r^rlrercrrqrar=r=r>_set_image_file_metadata>s  z&AbstractImage._set_image_file_metadatacCsd}|jjj|}dddt|D}tj||}t|dkrt|d}tj |\}}|d| |}tj||}|S)z Generates a file path in the "original_images" folder. Ensuring ASCII characters and limiting length to prevent filesystem issues during uploads. Zoriginal_imagesrcss"|]}t|dkr|ndVqdS)_N)ord)rDir=r=r> Ssz.AbstractImage.get_upload_to.._^N) r^fieldrZget_valid_namejoinr"osr_lensplitext)rNrU folder_name full_pathZ chars_to_trimprefix extensionr=r=r>rRHs   zAbstractImage.get_upload_tocCs t|Sru)r+Zget_grouped_references_torar=r=r> get_usagebszAbstractImage.get_usagecCstd|jfdS)Nzwagtailimages:image_usage)r)ridrar=r=r> usage_urleszAbstractImage.usage_url )Zboostrouploaded_by_user created_atrcCs|jSru)rrar=r=r>__str__yszAbstractImage.__str__cCs\t|tjstS|jj|jjkr$dS|j}|dur:||uS||jkoZ|j|jkoZ|j|jkS)a Customise the definition of equality so that two Image instances referring to the same image but different contextual alt text or decorative status are considered different. All other aspects are copied from Django's base `Model` implementation. FN) r@rModelNotImplementedrmZconcrete_modelpkrr)rNotherZmy_pkr=r=r>__eq__|s    zAbstractImage.__eq__cCs&|jdurtdt|j|j|jfS)zH Match the semantics of the custom equality definition. Nz8Model instances without primary key value are unhashable)r TypeErrorhashrrrar=r=r>__hash__s zAbstractImage.__hash__cCstdd|j|jSr)r)rrrar=r=r>get_rectszAbstractImage.get_rectcCsD|jdur@|jdur@|jdur@|jdur@t|j|j|j|jSdSru) focal_point_x focal_point_yfocal_point_widthfocal_point_heightr) from_pointrar=r=r>get_focal_pointszAbstractImage.get_focal_pointcCs |duSru)rrar=r=r>has_focal_pointszAbstractImage.has_focal_pointcCsF|dur*|j|_|j|_|j|_|j|_nd|_d|_d|_d|_dSru)Z centroid_xrZ centroid_yrrrrr)rNZrectr=r=r>set_focal_points zAbstractImage.set_focal_pointc CsV|r dS|}|}|rztdd|D}tdd|D}tdd|D}tdd|D}t||||}nt|}|rtdd|D}tdd|D}tdd|D}td d|D}t||||}nWddSWdn1s0Y|j\} } |j\} } | d 9} | d 9} t| d } t| d } t | | | | S) Ncss|]}|dVqdSrNr=rDfacer=r=r>rz:AbstractImage.get_suggested_focal_point..css|]}|dVqdSNr=rr=r=r>rrcss|]}|dVqdS)Nr=rr=r=r>rrcss|]}|dVqdS)Nr=rr=r=r>rrcss|]}|dVqdSrr=rDfeaturer=r=r>rrcss|]}|dVqdSrr=rr=r=r>rrcss|]}|dVqdSrr=rr=r=r>rrcss|]}|dVqdSrr=rr=r=r>rrg333333?d) is_svgrxZ detect_facesminmaxr)Zdetect_featuresZcentroidrer) rNrvZfaceslefttoprightZbottom focal_pointfeaturesxyrrr=r=r>get_suggested_focal_points2 0    z'AbstractImage.get_suggested_focal_pointcCs |jjjS)z,Get the Rendition model for this Image model)rGrelZ related_modelclsr=r=r>rKsz!AbstractImage.get_rendition_modelz"Iterable[AbstractRendition] | NonereturncCs&dt|divr|jSt|ddS)NrG_prefetched_objects_cacherH)rWrGrMrar=r=r>_get_prefetched_renditionss z(AbstractImage._get_prefetched_renditionsAbstractRenditionNone) renditionrc CsVz|jdj|Wnttfy,Yn0z|j|WntyPYn0dSNrG)rZ _result_cacheappendAttributeErrorKeyErrorrH)rNrr=r=r>_add_to_prefetched_renditionss z+AbstractImage._add_to_prefetched_renditionsz Filter | str)rErcCs||}t|trt|d}z||}Wn(|jyR||}||Yn0||| ||j }|j |||S)a, Returns a ``Rendition`` instance with a ``file`` field value (an image) reflecting the supplied ``filter`` value and focal point values from this object. Note: If using custom image models, an instance of the custom rendition model will be returned. rB) rKr@rXrAfind_existing_rendition DoesNotExistcreate_renditionrconstruct_cache_key get_cache_keyrB cache_backendset)rNrE Renditionr cache_keyr=r=r> get_renditions    zAbstractImage.get_renditionrAcCs6|}z|||WSty0|jYn0dS)a Returns an existing ``Rendition`` instance with a ``file`` field value (an image) reflecting the supplied ``filter`` value and focal point values from this object. If no such rendition exists, a ``DoesNotExist`` error is raised for the relevant model. Note: If using custom image models, an instance of the custom rendition model will be returned. N)rKfind_existing_renditionsrr)rNrErr=r=r>rs  z%AbstractImage.find_existing_renditioncCs,|jj|j||d||id\}}|S)a Creates and returns a ``Rendition`` instance with a ``file`` field value (an image) reflecting the supplied ``filter`` value and focal point values from this object. This method is usually called by ``Image.get_rendition()``, after first checking that a suitable rendition does not already exist. Note: If using custom image models, an instance of the custom rendition model will be returned. r^) filter_specfocal_point_keydefaults)rGZ get_or_createrBrgenerate_rendition_file)rNrErcreatedr=r=r>r&s  zAbstractImage.create_renditiondict[str, AbstractRendition])rOrcst|dtr.ddt|D}j|fdd|D}j|D]\}} |||<qXfddD}|rj |fdd|DS)a  Returns a ``dict`` of ``Rendition`` instances with image files reflecting the supplied ``filters``, keyed by filter spec patterns. Note: If using custom image models, instances of the custom rendition model will be returned. rcSsg|] }t|qSr=)rA)rDrBr=r=r>rFFrz0AbstractImage.get_renditions..csg|]}|vr|qSr=r=rDrrGr=r>rFLrcs4i|],\}}t|dds||j|qS) _from_cacheF)rWrrrB)rDrErrrNr=r> Rs  z0AbstractImage.get_renditions..csi|]}|j|qSr=rrCrr=r>r ^r) rKr@rXdictfromkeyskeysrcreate_renditionsitemsrrZset_many)rNrO not_foundrErZcache_additionsr=)rrGrNr>get_renditions;s     zAbstractImage.get_renditionszdict[Filter, AbstractRendition]c sfdd|D}i}|durtt}|D]8}z||j}Wnty^Yq6Yq60|||q6|D]8\}}|}|D] }|j |krd|_ ||<qxqqxnfdd|D} j |  D]}||j}|_||<q܇fdd|D} | rbt} | D]}| t|j|dO} qj| D]}||j}||<qHS) a Returns a dictionary of existing ``Rendition`` instances with ``file`` values (images) reflecting the supplied ``filters`` and the focal point values from this object. Filters for which an existing rendition cannot be found are omitted from the return value. If none of the requested renditions have been created before, the return value will be an empty dict. cSsi|] }|j|qSr=rrr=r=r>r mrz:AbstractImage.find_existing_renditions..NTcs$g|]\}}||qSr=)rr)rDrBrErr=r>rFsz:AbstractImage.find_existing_renditions..csg|]}|vr|qSr=r=r)foundr=r>rFrrr)rKrrlistrrrrrrrrZget_manyvaluesrrrBrGrE) rNrOZfilters_by_specrHZpotential_matchesrrErGrZ cache_keysrlookup_qr=)rrrNr>r`sL            z&AbstractImage.find_existing_renditionscs}|siSt|dkr2|d}||iSi}dd|D}}|Wdn1sj0Yg}tjjddBtjfdd |DD]}| | qWdn1s0Yg} t } |D]} | t | j | j d O} qj| D]Z} || j }| ||<t|D]8} | j | j kr*| j | j kr*|| | | jq*q |jj|d d D]} || j }| ||<qx| D]}|jd dq|S)aP Creates multiple ``Rendition`` instances with image files reflecting the supplied ``filters``, and returns them as a ``dict`` keyed by the relevant ``Filter`` instance. Where suitable renditions already exist in the database, they will be returned instead, so as not to create duplicates. This method is usually called by ``Image.get_renditions()``, after first checking that a suitable rendition does not already exist. Note: If using custom image models, an instance of the custom rendition model will be returned. rrcSsi|] }|j|qSr=rrr=r=r>r rz3AbstractImage.create_renditions..Nr) max_workersc3s"|]}j|tVqdSru)Zsubmitgenerate_rendition_instancerrCexecutorZoriginal_image_bytesrNr=r>rs z2AbstractImage.create_renditions..rT)Zignore_conflictsF)rg)rKrrrtread concurrentZfuturesZThreadPoolExecutorZ as_completedrresultrrrrGrErremover^rLZ bulk_createdelete)rNrOrrEZ return_valueZ filter_mapr^Z to_createfutureZfiles_for_deletionrrexistingnewr=rr>r sN   & .        zAbstractImage.create_renditionsr)rEsourcerc Cs2|||j|||j|t||jjdddS)z Use the supplied ``source`` image to create and return an **unsaved** ``Rendition`` instance, with a ``file`` value reflecting the supplied ``filter`` value and focal point values from this object. ror")rrrr^)rKrBrrrr^ro)rNrEr"r=r=r>rsz)AbstractImage.generate_rendition_instancer$rc Cs||}td|j|jt}z<|j|ttj d|d}td|j|jt|dWn td|j|jYn0t j |j j}t j |\}}|jddt|j} |r|d| } |d d t| } | d| } t|j| d S) a Generates an in-memory image matching the supplied ``filter`` value and focal point value from this object, wraps it in a ``File`` object with a suitable filename, and returns it. The return value is used as the ``file`` field value for rendition objects saved by ``AbstractImage.create_rendition()``. If the contents of ``self.file`` has already been read into memory, the ``source`` keyword can be used to provide a reference to the in-memory ``File``, bypassing the need to reload the image contents from storage. NOTE: The responsibility of generating the new image from the original falls to the supplied ``filter`` object. If you want to do anything custom with rendition images (for example, to preserve metadata from the original image), you might want to consider swapping out ``filter`` for an instance of a custom ``Filter`` subclass of your design. z&Generating '%s' rendition for image %d)max_sizer$z/Generated '%s' rendition for image %d in %.1fmsiz.Failed to generate '%s' rendition for image %d|.N;r#)rloggerdebugrBrtimerunr r ZFILE_UPLOAD_MAX_MEMORY_SIZErr_basenamer^rorreplaceIMAGE_FORMAT_EXTENSIONS format_namerrr) rNrEr"r start_timeZgenerated_imageZinput_filenameZ input_filename_without_extensionZinput_extensionZoutput_extensionZ!output_filename_without_extensionZoutput_filenamer=r=r>rsR     z%AbstractImage.generate_rendition_filecCs |j|jkSru)rrrar=r=r> is_portraitVszAbstractImage.is_portraitcCs |j|jkSru)rrrar=r=r> is_landscapeYszAbstractImage.is_landscapecCs tj|jj\}}|dkS)Nr/)rr_rr^rolower)rNrextr=r=r>r\szAbstractImage.is_svgcCstj|jjSru)rr_r-r^rorar=r=r>rU`szAbstractImage.filenamecCst|ddp|jS)Nr)rWrrar=r=r>default_alt_textdszAbstractImage.default_alt_textcCsddlm}||d|S)Nr)permission_policyZchange)Zwagtail.images.permissionsr7Z user_has_permission_for_instance)rNuserr7r=r=r>is_editable_by_userks z!AbstractImage.is_editable_by_userc@seZdZdZdS)zAbstractImage.MetaTNr9r:r;abstractr=r=r=r>Metapsr<)Lr9r:r;r CharFieldrrrrRr^r IntegerFieldrrZ DateTimeFieldr ForeignKeyr ZAUTH_USER_MODELZSET_NULLrwagtail_reference_index_ignorer rZPositiveIntegerFieldrrrrrcrr?Z as_managerrLrrrrrpropertyrr*Z search_fieldsr,Z SearchFieldZAutocompleteFieldZ FilterFieldZ RelatedFieldsrrrrrrrr classmethodrKrrrrrrrr rrr2r3rrUr6r9r< __classcell__r=r=rr>rs       (  %KTF  rc@s"eZdZdZGdddejZdS)rw) rr^rZ collectionrrrrrc@s"eZdZedZedZdgZdS)z Image.Metarimages)Z choose_imagezCan choose imageN)r9r:r;rrZverbose_name_pluralZ permissionsr=r=r=r>r<sr<N)r9r:r;Zadmin_form_fieldsrr<r=r=r=r>rwts rwc@seZdZdZedZedZedZedZ d!ddZ e d d d d d Z e ddZeddZeddZd"ddZed#dddddZd$ddddddZdd ZdS)%rAz Represents one or more operations that can be applied to an Image to produce a rendition appropriate for final display on the website. Usually this would be a resize operation, but could potentially involve colour processing, etc. z^[A-Za-z0-9_\-\.]+$z^[A-Za-z0-9_\-\.\|]+$z^[A-Za-z0-9_\-\.{},]+$z^[A-Za-z0-9_\-\.{},\|]+$NcCs ||_dSrur)rNrBr=r=r>rszFilter.__init__zstr | Iterable[str]z list[str])rBrc st|tr$d|vrdnd}||}g}|D]b}d|vrd|vr|d\}|d\}|d}|fdd|Dq,||gq,tj|}dd|DS) z Converts a spec pattern with brace-expansions, into a list of spec patterns. For example, "width-{100,200}" becomes ["width-100", "width-200"]. Supports providing filter specs already split, or pipe or space-separated. r& {},csg|]}|qSr=r=)rDoptionrsuffixr=r>rFrz&Filter.expand_spec..cSsg|]}d|qS)r&)r)rDZ combinationr=r=r>rFr)r@rXsplitr itertoolsproduct) rNrB separatorZexpanded_segmentssegmentZoptions_suffixedZoptions_patternoptions combinationsr=rJr> expand_specs    zFilter.expand_speccCs~i}tdD]}|t|qg}|jdD]D}|d}|d|vr^td|d||d}|||q4|S)NZregister_image_operationsr&-rzUnrecognised operation: %s)r!Z get_hooksupdater rBrLr#r)rNZregistered_operationsfn operationsZop_specZ op_spec_partsZop_classr=r=r>rWs    zFilter.operationscCsdd|jDS)NcSsg|]}t|tr|qSr=)r@r(rD operationr=r=r>rFs z/Filter.transform_operations..rWrar=r=r>transform_operationsszFilter.transform_operationscCsdd|jDS)NcSsg|]}t|tr|qSr=)r@r%rXr=r=r>rFs z,Filter.filter_operations..rZrar=r=r>filter_operationsszFilter.filter_operationscCs<|s|j|jf}t||d}|jD]}|||}q&|S)ac Returns an ImageTransform with all the transforms in this filter applied. The ImageTransform is an object with two attributes: - .size - The size of the final image - .matrix - An affine transformation matrix that combines any transform/scale/rotation operations that need to be applied to the image )Z image_is_svg)rrr'rr[r,)rNrre transformrYr=r=r> get_transforms   zFilter.get_transformrr)rr"ccsJ|durtj|Vn.|}|VWdn1s<0YdSru)rvrwrlrx)rNrr"Z willow_imager=r=r>rxs zFilter.get_willow_imager)routputr"c CsV|||2}|j}|}|||jj|jjf}|| }| |j }d|i}|j D]}| |||pv|}qbd|vr|d} n@ddddd} |sd| d<ttdi} | | | ||} | dkr(d|vr|d} n ttd d } |r|d }|j|| d d d WdS| dkrN|j|d dWdS| dkrp||WdS| dkrd|vrd|dvr|j|d dWdSd|vr|d} n ttdd} |j|| dWdS| dkrdd|vr(d|dvr(|j|d dWdSd|vr<|d} n ttdd} |j|| dWdS| dkrd|vrd|dvr|j|d dWdSd|vr|d} n ttdd} |j|| dWdS| dkr||WdS| dkr"||WdStd| d Wdn1sH0YdS)!Nzoriginal-formatz output-formatr2r1)r0Zbmpr4r7r3Z WAGTAILIMAGES_FORMAT_CONVERSIONSz jpeg-qualityZWAGTAILIMAGES_JPEG_QUALITYU)rrrT)qualityZ progressiveoptimize)rbr4zoutput-format-optionslossless)rcz webp-qualityZWAGTAILIMAGES_WEBP_QUALITYP)rar0z avif-qualityZWAGTAILIMAGES_AVIF_QUALITYr7z heic-qualityZWAGTAILIMAGES_HEIC_QUALITYr5r6zUnknown output image format '')rxr0Z auto_orientr^rrrZcroprroundresizerer\r,Z has_animationrWr rUgetZ has_alphaZset_background_color_rgbZ save_as_jpegZ save_as_pngZ save_as_gifZ save_as_webpZ save_as_avifZ save_as_heicZ save_as_svgZ save_as_icor$) rNrr_r"rvZoriginal_formatr]envrYZ output_formatZdefault_conversions conversionrar=r=r>r,s                              z Filter.runcCsjg}|jD]0}t|dgD]}t||d}|t|qq d|}|sNdSt|dddS)NZ vary_fieldsrrTzutf-8) rWrWrrXrhashlibsha1encode hexdigest)rNrZ vary_partsrYrvalueZ vary_stringr=r=r>rfs   zFilter.get_cache_key)N)N)N)N)r9r:r;r<recompileZ spec_patternZpipe_spec_patternZexpanding_spec_patternZpipe_expanding_spec_patternrrBrSrrWrAr[r\r^rrxr,rr=r=r=r>rAs&         prAc@sZeZdZdZddddddZedd d d Zd d ZddZddZ ddddZ dS)ResponsiveImagez A custom object used to represent a collection of renditions. Provides a 'renditions' property to access the renditions, and renders to the front-end HTML. Nrdict[str, Any] | NonerGattrscCst||_||_dSru)rrrGrvrNrGrvr=r=r>r~szResponsiveImage.__init__zlist[AbstractRendition])renditions_listcCs*t|dkr|djSddd|DS)Nrrz, cSs g|]}|jd|jdqS)rEw)urlr)rDrr=r=r>rFrz4ResponsiveImage.get_width_srcset..)rrzr)rrxr=r=r>get_width_srcsets  z ResponsiveImage.get_width_srcsetcCs8|jpi}t|jdkr(||j|d<|jd|S)Nrsrcsetr)rvrrGr|img_tag)rNrvr=r=r>__html__s zResponsiveImage.__html__cCs t|Sru)rrrar=r=r>rszResponsiveImage.__str__cCs t|jSru)boolrGrar=r=r>__bool__szResponsiveImage.__bool__)rcCs&t|tr"|j|jko |j|jkSdSr)r@rsrGrv)rNrr=r=r>rs zResponsiveImage.__eq__)N) r9r:r;r<rrBr|rrrrr=r=r=r>rsws  rs FileFormatro mime_typecsveZdZeddeddeddedded d gZdd d dfdd Zd ddddZddZfddZZ S)Picturer0z image/avifr4z image/webpr1z image/jpegr2z image/pngr3z image/gifNrrtrucst|||||_dSru)rr get_formatsformatsrwrr=r>rszPicture.__init__z"dict[str, list[AbstractRendition]])rGrcCs^tt}|D]4\}}tjD]$}d||vr|||qqqt|dkrZiS|S)z Group renditions by the format they are for, if any. If there is only one format, no grouping is required. zformat-r)rrrr&Zsupported_formatsrrr )rNrGrrBrfmtr=r=r>rs zPicture.get_formatscCs*t|jD]}|j|jvr |jSq dSru)reversedsource_format_orderror)rNrr=r=r>get_fallback_formats zPicture.get_fallback_formatc s|jstdtdS|jp$i}d|vr>d|ddnd}|}|j|}g}|jD]P}|j|kr^|j|jvr^||j|j}|j }| d|d|d|d q^t |d kr|||d <|d  |} tdd || dS) Nz z sizeszsizes="z" rzrr}r)rrrrrvrrror|rrrr~r) rNrvrZfallback_formatZfallback_renditionssourcesrr}mimefallbackrr=r>rs      zPicture.__html__)N) r9r:r;rrrrrrrCr=r=rr>rs  rcs$eZdZejdddZeeedddZ ej ddZ ej ddZ ejd dd dd Z dZed d ZeddZeddZeddZeddZeddZeddZeddZifddZddZd d!Zefd"d#Zed$d%Ze d&d'd(d)Z!d*d+Z"d,d-Z#Gd.d/d/Z$Z%S)0rrT)rrrr)rrZrrF)rr)rrrrcCs|jjSru)r^rzrar=r=r>rzszAbstractRendition.urlcCs@t|jdr|jjrdSt|jdr4|jjr4|jjS|jjSdS)Nrrr)r{rrrr6rar=r=r>alts zAbstractRendition.altcCs t|jS)zg The src, width, height, and alt attributes for an tag, as a HTML string )r attrs_dictrar=r=r>rvszAbstractRendition.attrscCs(td|jfd|jfd|jfd|jfgS)zX A dict of the src, width, height, and alt attributes for an tag. srcrrr)rrzrrrrar=r=r>rszAbstractRendition.attrs_dictcCs(|j}ttdr$|dr$tj|}|S)NWAGTAILADMIN_BASE_URL/)rzr{r startswithr)rNrzr=r=r>full_url+s zAbstractRendition.full_urlcCs t|jSru)rArrar=r=r>rE2szAbstractRendition.filtercCs*|j}|r&|j|j}||SdSru)rrrEr^r])rNZimage_focal_pointr]r=r=r>r6s zAbstractRendition.focal_pointcCsL|j}|rDt|jd|j}t|jd|j}d|d|dSdSdS)a Returns a `background-position` rule to be put in the inline style of an element which uses the rendition for its background. This positions the rendition according to the value of the focal point. This is helpful for when the element does not have the same aspect ratio as the rendition. For example: {% image page.image fill-1920x600 as image %}
rzbackground-position: z% z%;zbackground-position: 50% 50%;N)rintrrrr)rNrZhorzZvertr=r=r>background_position_style=s z+AbstractRendition.background_position_stylecCs:|j}|tdj||tdt|dS)NZ wagtailimagesz)rcopyrUr Zget_app_configZ default_attrsrr)rNZextra_attributesrvr=r=r>r~Ss  zAbstractRendition.img_tagcCs|Sru)r~rar=r=r>r\szAbstractRendition.__html__cCs"d}|jjj|}tj||S)z{ Generates a file path within the "images" folder by combining the folder name and the validated filename. rD)r^rrZrrr_r)rNrUrr=r=r>rR_szAbstractRendition.get_upload_toc sPtjfi|}|jjsLtdd|jjDsL|tjd|d|dd|S)Ncss|]}t|hdkVqdS)>rrrN)r)rD constraintr=r=r>rksz*AbstractRendition.check..z@Custom rendition model %r has an invalid unique_together settingzCustom rendition models must include the constraint ('image', 'filter_spec', 'focal_point_key') in their unique_together definition.zwagtailimages.E001)hintobjr) rcheckrmr;anyunique_togetherrr Error)rrerrorsrr=r>rgs  zAbstractRendition.checkcCsddt|j|j||gS)Nzwagtail-rendition-rT)rrXrr)rZfilter_cache_keyrr=r=r>r|sz%AbstractRendition.construct_cache_keyrrcCs*z tdWSty$ttYS0dSr)rrrrr=r=r>rs  zAbstractRendition.cache_backendcCs||j|j|jSru)rrrrrar=r=r>rs zAbstractRendition.get_cache_keycCs|j|dSru)rrrrar=r=r>purge_from_cachesz"AbstractRendition.purge_from_cachec@seZdZdZdS)zAbstractRendition.MetaTNr:r=r=r=r>r<sr<)&r9r:r;rr=rrrVr\r^r>rrrr@rArzrrvrrrErrrr~rrRrBr staticmethodrrrrrr<rCr=r=rr>rsR            rc@s,eZdZejedejdZGdddZdS)rrG)Z related_namerc@seZdZdZdS)zRendition.Meta))rrrN)r9r:r;rr=r=r=r>r<sr<N) r9r:r;rr?rwZCASCADErr<r=r=r=r>rsr)t __future__rconcurrent.futuresrrlrMloggingos.pathrrqr+ collectionsrrrcollections.abcr contextlibriortempfiler typingr rvZ django.appsr Z django.confr Z django.corer Zdjango.core.cacherrrZdjango.core.cache.backends.baserZdjango.core.exceptionsrZdjango.core.filesrZdjango.core.files.storagerrrZ django.dbrZdjango.db.modelsrZdjango.forms.utilsrZ django.urlsrZdjango.utils.functionalrrZdjango.utils.module_loadingrZdjango.utils.safestringrZdjango.utils.translationrrZtaggit.managersr Zwagtailr!Zwagtail.coreutilsr"Zwagtail.images.exceptionsr#r$Zwagtail.images.image_operationsr%r&r'r(Zwagtail.images.rectr)Zwagtail.modelsr*r+Zwagtail.searchr,Zwagtail.search.querysetr-Zwagtail.utils.filer. getLoggerr)r/IOErrorr8ZQuerySetr?rRrVr\r]fieldsfilesZImageFieldFileryZ ImageFieldrZIndexedrrrwrArsrrrrr=r=r=r>s                              B wo-L#