ho V d dl Z d dlmZmZ d dlmZmZ d dlmZ d dl m
Z
m Z d dl m
Z
d dlmZ d dlmZ d d lmZ d d
lmZmZmZmZmZmZ d d lm Z d d l m Z d d
l m Z d dZ!d Z"d dZ# G d d Z$ G d d Z% G d de
Z& G d de Z' G d de e' Z( G d d e
e( Z)y) N)File ContentFile)default_storageStorage)get_image_dimensions)ImageFieldFile FieldFile)timezone) mark_safe)escape)
import_string)engine
exceptionsmodelsutilssignalsstorage)aliases)settings)ThumbnailOptionsc t | d r | j S t | t r| S t | t r/|s | j
}t
| j | j | S d}t | t r| }d} |s t d t | t r | j } t | t s | t k( r| }d} t | ||| du S )a
Get a :class:`Thumbnailer` for a source file.
The ``obj`` argument is usually either one of the following:
* ``FieldFile`` instance (i.e. a model instance file/image field
property).
* A string, which will be used as the relative name (the source will be
set to the default storage).
* ``Storage`` instance - the ``relative_name`` argument must also be
provided.
Or it could be:
* A file-like instance - the ``relative_name`` argument must also be
provided.
In this case, the thumbnailer won't use or create a cached reference
to the thumbnail (i.e. a new thumbnail will be created for every
:meth:`Thumbnailer.get_thumbnail` call).
If ``obj`` is a ``Thumbnailer`` instance, it will just be returned. If it's
an object with an ``easy_thumbnails_thumbnailer`` then the attribute is
simply returned under the assumption it is a Thumbnailer instance)
easy_thumbnails_thumbnailerNzXIf object is not a FieldFile or Thumbnailer instance, the relative name must be provided)filenamesource_storage
remote_source)hasattrr
isinstance Thumbnailerr r ThumbnailerFieldFileinstancefieldstr
ValueErrorr r r r )obj
relative_namer s E/home/dcms/DCMS/lib/python3.12/site-packages/easy_thumbnails/files.pyget_thumbnailerr( s 8 s12...#{#
C # HHM#CLL#))]KKN#s
-. . #t hh#w 3/#9
}^o ' ' c t j | | }|r:t | }|j D ] \ }}||d< |j | yy)a
Generate all of a file's aliases.
:param fieldfile: A ``FieldFile`` instance.
:param include_global: A boolean which determines whether to generate
thumbnails for project-wide aliases in addition to field, model, and
app specific aliases.
)include_globalALIASN)r allr( items
get_thumbnail) fieldfiler+ all_options thumbnailerkeyoptionss r' generate_all_aliasesr5 N sZ ++iGK%i0 ' - - / /LC "GG % %g . / r) c t j | j }d}d} t j j
j
d j || j } |j }|r|j |j fS t j j! | j" j d dk( r#ddlm} || j j( }n
t+ | | }t, j. r6|r4t j j
j1 ||d |d d
|S # t j j $ r d}Y w xY w# t j j $ r d}Y w xY w) a
Returns the (width, height) of an image, given ThumbnailFile. Set
'close' to True to close the file at the end if it is initially in an open
state.
Will attempt to get the dimensions from the file itself if they aren't
in the db.
N
dimensions) storage_hashr z.svgr )loadclosewidthheight thumbnaildefaults)r get_storage_hashr r Thumbnailobjectsselect_relatedgetr r7 ThumbnailDimensions DoesNotExistr> r? ospathsplitextr easy_thumbnails.VIL.Imager: sizer r THUMBNAIL_CACHE_DIMENSIONS
get_or_create)r r< r7 r8 dimensions_cacherA r: s r' database_get_image_dimensionsrR _ s_ ))$,,7LJ C$$,,;;LIMM%DII N 7
$ ( 3 3 #))+;+B+BB B ww '*f42$))_))
)$e<
**y ""**88 )!}
1
F 9 H ))66 $ # $ ( ( s$ AE& * E E#"E#& FFc e Zd ZdZddZd Zy) FakeFieldfakeNc " |t }|| _ y N)r r )selfr s r' __init__zFakeField.__init__ s ?%G r) c |S rW )rX r! r argskwargss r' generate_filenamezFakeField.generate_filename s r) rW )__name__
__module__ __qualname__r rY r^ r[ r) r' rT rT s D
r) rT c e Zd Zd Zy) FakeInstancec y rW r[ rX r\ r] s r' savezFakeInstance.save s r) N)r_ r` ra rf r[ r) r' rc rc s
r) rc c e Zd ZdZd fd Zd Zd Zde_ de_ d Zd Z e
ee Z ddZ d Z
d
Zd Z e
e
ee Zd fd Zd
Zd Z xZS )
ThumbnailFilez
A thumbnailed file.
This can be used just like a Django model instance's property for a file
field (i.e. an ``ImageFieldFile`` object).
c t | }t | t ||g|i | | `|r|| _ |t
}|| _ y t |t s t
| }|| _ y )N)r ) rT superrY rc r" r r r thumbnail_options) rX r r r rk r\ r]
fake_field __class__s r' rY zThumbnailFile.__init__ st w/
TKDKFK J DI $ 0 2 "3 -/?@ 01B C !2 r) c t rW NotImplementedErrorre s r' rf zThumbnailFile.save s !##r) c t rW ro re s r' deletezThumbnailFile.delete s
"##r) Tc X t | d sddlm} || | _ | j S )z
Get a PIL Image instance of this file.
The image is cached to avoid the file needing to be read again if the
function is called again.
_image_cacher ) pil_image)r !easy_thumbnails.source_generatorsru imagert )rX ru s r'
_get_imagezThumbnailFile._get_image s( t^, C"4 DJ r) c t |r|| _ |j | _ yt | d r| `t | d r| `yy)ze
Set the image for this file.
This also caches the dimensions of the image.
rt _dimensions_cacheN)rt rN rz r
_cached_image)rX rw s r'
_set_imagezThumbnailFile._set_image sA %D %*ZZD "t^,&t 01* 2r) c |8t | dd rd}n( | j j | j d}||d< | j
|d< |r0|j
t | j | j dj t |j D cg c] \ }}|d t | d
c}} }t d |z S # t $ r d}Y w xY wc c}}w ) a
Return a standard XHTML ``![]()
`` tag for this field.
:param alt: The ``alt=""`` text for the tag. Defaults to ``''``.
:param use_size: Whether to get the size of the thumbnail image for use
in the tag attributes. If ``None`` (default), the size will only
be used it if won't result in a remote file retrieval.
All other keyword parameters are added as (properly escaped) extra
attributes to the `img` tag.
Nrz TFaltsrcr= z=""z
![]()
)getattrr rK r rp urlupdatedictr> r? joinsortedr. r r )rX r~ use_sizeattrsr3 values r' tagzThumbnailFile.tag s t 0$7 %LL%%dii0 #H e xxe LLDJJt{{C D,25;;=,AC (c5 (+F5M: C D -.. + % $H% Cs 'C (C*
C'&C'c | j t | d r | j +| j j | j
d | _ | j S )N_filerb)
_require_filer r r openr rX s r' _get_filezThumbnailFile._get_file sG tW%); **499d;DJzzr) c Z |t |t s t | }|| _ d| _ y )NF)r r r
_committed)rX r s r' _set_filezThumbnailFile._set_file s( Zt%<KE
r) c | ` y rW )r r s r' _del_filezThumbnailFile._del_file s Jr) c | j rM| j rA|xs t | dd xs d}| j j | j | | _ y t
| |g|i |S )Nmoder )closedr r r r r rj )rX r r\ r] rm s r' r zThumbnailFile.open s] ;;499>746>$D ))$))T:DI7<6t6v6 6r) c t | d s.| j }| j t | | | _ | j S )Nrz r; )r r r rR rz )rX r< s r' _get_image_dimensionsz#ThumbnailFile._get_image_dimensions
s= t 01KKE IIK%BE&#D "%%%r) c t |dd }|sy|j | _ | j
S # t j j $ r d}Y Aw xY w)zl
Set image dimensions from the cached dimensions of a ``Thumbnail``
model instance.
r7 NF)r r rH rI rN rz )rX rA r7 s r' set_image_dimensionsz"ThumbnailFile.set_image_dimensions sW
L$?J !+ %%% ))66 J s
/ AA)NNN) NrW )r_ r` ra __doc__rY rf rr alters_datarx r| propertyrw r r r r r r r r
__classcell__rm s @r' rh rh st 3$$ D F
!
+
Z ,E /< Iy) 4D7& &r) rh c e Zd ZdZdZdZ d fd Zd Zd ZddZ ddZ
d Z dd
Z d Z
d Zdd
ZddZddZde_ xZS )r a
A file-like object which provides some methods to generate thumbnail
images.
You can subclass this object and override the following properties to
change the defaults (pulled from the default settings):
* source_generators
* thumbnail_processors
NTc 2 t | ||g|i | |t }|| _ |t j
}|| _ || _ d | _ || _ dD ]@ } d| z }
t | |
d t t |
j } t | |
| B y )N) basedirsubdirprefixquality extensionpreserve_extensionstransparency_extensioncheck_cache_missnamerz thumbnail_%s)rj rY r r r thumbnail_default_storagethumbnail_storager alias_targetgenerater r uppersetattr)
rX r r r r r r r\ r] default attr_namer rm s
r' rY zThumbnailer.__init__6 s t5d5f5 ! ,N , $ ' A A !2 *
- 0G '0ItY-5 )//*;<i/ 0r) c t j || j }|s t | ||d< | j |d S )z|
Retrieve a thumbnail matching the alias options (or raise a
``KeyError`` if no such alias exists).
)targetr, Tsilent_template_exception)r rG r KeyErrorr/ )rX aliasr4 s r' __getitem__zThumbnailer.__getitem__P sG
++eD,=,=>5/ ! !!'T!JJr) c t |t r|S g }||j | t |i |}d|vr| j |d< |S )z
Get the thumbnail options that includes the default options for this
thumbnailer (and the project-wide default options).
r )r r appendthumbnail_quality)rX rk r] r\ optss r' get_optionszThumbnailer.get_options[ sZ
')9 :$ $ ( KK) * 00 - - " 4 4DO r) c
, | j | }|d }d\ }}|D ]& } t | }t || t || }}( |dk( s|dk r$d}t
j |j | t j | || j | }|1d}t
j |j | j t j ||| j } | j! |t# j$ | }
|d
} |d } t& j( j+ | j d d d j- d
k( rt j. | |
}
n*t j0 | |
| | |j3 dd }
|
j5 }t7 |t8 s|j; }t= |
t? | | j@ | }| |_! d|_" |S # t t f$ r Y w xY w)z
Return an unsaved ``ThumbnailFile`` containing a thumbnail image.
The thumbnail image is generated using the ``thumbnail_options``
dictionary.
rN )r r r z.The source image has an invalid size ({0}x{1}))
fail_silentlyNz8The source file does not appear to be an image: '{name}')r transparentr subsamplingr9 svg)filenamekeep_icc_profileF)r r r r )r r rk )#r float TypeErrorr$ minmaxr EasyThumbnailsErrorformatr generate_source_imagesource_generatorsInvalidImageFormatErrorr
process_imagethumbnail_processorsget_thumbnail_namer is_transparentrJ rK rL lowersave_svg_imagesave_pil_imagerG readr bytesencoderh r r rw r )rX rk r orig_sizemin_dimmax_dimdimmsgrw thumbnail_imager r r imgdatarA s r' generate_thumbnailz Thumbnailer.generate_thumbnailj s ! , ,-> ?%f- DC
Cj #7C 0#gs2CWG D a<7Q;BC 00Y1GH H,, #T%;%;35 =LC 44SZZTYYZ5OP P ..u6G/3/H/HJ** ,,_= + ? $I.'
6
77 DII &q )!" - 3 3 5 >''(KC'' (G ':K:O:OPbdi:jlC xxz $&;;=D! ;t,d6L6L /1 * $ Q z*
s H HHc | j | }t j j | j \ }}t | j d r&|j | j j d }|j d }t j j | d dd j }| j }|du st |t t f r||v r|}n|r
| j }n | j" }|xs d}|j% }dj' | } d | i}
| j( |
z } | j* |
z } t | j, t. rt1 | j, }
n | j, }
|
| ||||
}d j3 | j4 | }t j j' | || | S ) z
Return a thumbnail filename for the given ``thumbnail_options``
dictionary and ``source_name`` (which defaults to the File's ``name``
if not provided).
locationr /r9 NTjpg_r )r2 source_filenamethumbnail_extensionrk prepared_optionsz{}{})r rJ rK splitr r r replacer lstriprL r thumbnail_preserve_extensionsr listtuple thumbnail_transparency_extensionr r r thumbnail_basedirthumbnail_subdirthumbnail_namerr# r
r thumbnail_prefix)rX rk r rK r source_extensionr r
prepared_opts opts_textr r r
namer_funcr s r' r z Thumbnailer.get_thumbnail_name s ! , ,-> ? "
dii 8 o 4&&
3<< 3 3 < ?(():(NO 22 4 3 1 5 ( LL) * &H**84F!.!4+A+A&7"9 66 #77?%% &r) c | j | }| | j }| j | }|sK|r(| j || }|r| j | |S t
j j | | |S )a
Return a ``ThumbnailFile`` containing a thumbnail.
If a matching thumbnail already exists, it will simply be returned.
By default (unless the ``Thumbnailer`` was instanciated with
``generate=False``), thumbnails that don't exist are generated.
Otherwise ``None`` is returned.
Force the generation behaviour by setting the ``generate`` param to
either ``True`` or ``False`` as required.
The new thumbnail image is generated using the ``thumbnail_options``
dictionary. If the ``save`` argument is ``True`` (default), the
generated thumbnail will be saved too.
r )senderr4 )r r r r save_thumbnailr thumbnail_missedsend)rX rk rf r r rA s r' r/ zThumbnailer.get_thumbnail s $ ! , ,-> ? }}H//0AB 3 3%.G 4 I '' 2
((-- ): . < r) c 8 |j } | j j | | j j || | j |j dd }t j ryt j j j ||j |j d \ }}|s2|j |_ |j |_
|j t j j! | y# t $ r Y w xY w)z
Save a thumbnail to the thumbnail_storage.
Also triggers the ``thumbnail_created`` signal and caches the
thumbnail values and dimensions for future lookups.
Tcreater r= r@ )r N)r r rr Exceptionrf get_thumbnail_cacher rO r rH rE rP r> r? r thumbnail_createdr
)rX rA r thumb_cacherQ createds r' r zThumbnailer.save_thumbnail
s >> " " ) )( 3
##Hi8.. NN4 / 6 . .**22@@ )'0(1(8(8 : A ;
& g
)2 &*3*:*: ' %%'!!&&i&8' s D
DDc | j ryt j | j r+t j | j | j
}n | j
}|sy|j }|syt j | j }|r(t j | j | }|sy||k S | j | }|sy|j }|j r||j k r|S y)a.
Calculate whether the thumbnail already exists and that the source is
not newer than the thumbnail.
If the source and thumbnail file storages are local, their file
modification times are used. Otherwise the database cached modification
times are used.
F)
r r is_storage_localr get_modified_timer get_source_cachemodifiedr r )rX thumbnail_namesource_modtimesourcelocal_thumbnailsthumbnail_modtimerA s r' r z Thumbnailer.thumbnail_exists, s ! !$"5"5 6 " 4 4##TYY 0N **,F #__N 11$2H2HI % 7 7&&!8 $ !%66 6,,^< % . . .I4F4F"F r) c ^ | j ry t | d r |s| j s|s | j S |xs |xr t j }t
j j j ||| j | j | j | _ | j S )N
_source_cache)r
update_modifiedr r r ) r r r r
nowr SourcerE get_filer r thumbnail_check_cache_miss)rX r
r r s r' r z Thumbnailer.get_source_cacheU s 4 )&!!)))!+V? #]] 2 2 ; ;?''dii ! < < < > !!!r) c | j ry | j d }|xs |xr t j }t j
j j ||| j ||| j S )NT)r
)r
r r r r r )
r r r
r r rD rE r" r r# )rX r r
r r r s r' r z Thumbnailer.get_thumbnail_cacheb su &&d&3!+V? ''00?**6 ! < < 1 > >r) c | j rA|xs t | dd xs d}| j j | j | | _ y | j
d y )Nr r r )r r r r r r seek)rX r s r' r zThumbnailer.openl sJ ;;>746>$D ++00DADI IIaLr) )NNNNFT)F)TNF)FFrW )r_ r` ra r r r rY r r r r r r/ r r r r r r r r s @r' r r $ sv <@GK04 K
6p,=\&2 DH05"H 9>'R "> Dr) r c t e Zd ZdZ fdZ fdZ fdZde_ d
dZde_ d Z fdZ
fd Z xZ S ) r g
A field file which provides some methods for generating (and returning)
thumbnail images.
c t | |i | | j j | _ t | j dd }|r|| _ | | _ y )Nr )rj rY r" r r r r r )rX r\ r] r rm s r' rY z ThumbnailerFieldFile.__init__} sN
$)&) "jj 0 0 #DJJ0CT J %6D " r) c T t | ||g|i | | j dd y)ze
Save the file, also saving a reference to the thumbnail cache Source
model.
Tr N)rj rf r )rX r contentr\ r] rm s r' rf zThumbnailerFieldFile.save s0
T74T4V4 T$ 7r) c | j }| j | t | |i | |r |j |j yyy)zH
Delete the image, along with any generated thumbnails.
N)r delete_thumbnailsrj rr pk)rX r\ r] source_cacherm s r' rr zThumbnailerFieldFile.delete sQ ,,. |,
'' LOO 7 ! 8 | j }d}|rt j | j }|j j D ]L }|j |k( s| j j |j |j |dz
}N |S )z
Delete any thumbnails generated from the source image.
:arg source_cache: An optional argument only used for optimisation
where the source cache instance is already known.
:returns: The number of files deleted.
r r9 ) r r rC r
thumbnailsr- r8 rr r )rX r/ deletedthumbnail_storage_hashthumbnail_caches r' r- z&ThumbnailerFieldFile.delete_thumbnails s ,,. %*%;%;&&&( "#/#:#:#>#>#@
! #//3II**11/2F2FG#**,qLG
! r) c / K | j }|rrt j | j }|j j D ]5 }|j |k( st |j | j 7 yyw)zK
Return an iterator which returns ThumbnailFile instances.
)r r N) r r rC r r1 r- r8 rh r )rX r\ r] r/ r3 r4 s r' get_thumbnailsz#ThumbnailerFieldFile.get_thumbnails s
,,. %*%;%;&&&( "#/#:#:#>#>#@
H #//3II'_-A-A040F0FH H
H s A B!'Bc t | }|j | j j D ci c] \ }}|j d s|dv r|| c}} |S c c}}w )NrA )r r r )rj __getstate__r __dict__r.
startswith)rX statekvrm s r' r8 z!ThumbnailerFieldFile.__getstate__ sg $&
++-
1||K(A1`,`
qD
s "A$
c t t d rt | | n| j j | | | j d< y )N __setstate__r )r rj r? r9 r )rX r; rm s r' r? z!ThumbnailerFieldFile.__setstate__ s< 57N + G ' MM '(,
n%r) rW )
r_ r` ra r rY rf rr r r- r6 r8 r? r r s @r' r r w sF
!8 " F. %)!H - -r) r c " e Zd ZdZ fdZ xZS )ThumbnailerImageFieldFiler( c t | j dd }|rd|vr| j |d< t || j | }t
j j | \ }}t
j j |j d }|j |j k7 r||z }t | , ||g|i | y)z
Save the image.
The image will be resized down using a ``ThumbnailField`` if
``resize_source`` (a dictionary of thumbnail options) is provided by
the field.
resize_sourceNr r9 ) r r" r r r rJ rK rL r r rj rf )
rX r r+ r\ r] r4 orig_nameext
generated_extrm s
r' rf z ThumbnailerImageFieldFile.save s $**ot< '%)%;%; "!'40CCGLG WW - -d 3NIs GG , ,W\\ :1 =M ""$ 3 =0
T74T4V4r) )r_ r` ra r rf r r s @r' rA rA s
5 5r) rA rW )FN)*rJ django.core.files.baser r django.core.files.storager r django.core.files.imagesr django.db.models.fields.filesr r django.utilsr
django.utils.safestringr django.utils.htmlr django.utils.module_loadingr
easy_thumbnailsr r r r r r easy_thumbnails.aliasr easy_thumbnails.confr easy_thumbnails.optionsr r( r5 rR rT rc rh r r rA r[ r) r' rS s 4 > 9 C ! - $ 5 O O ) ) 48'v/"#L
K&N K&\P $ P f
\-9k \-~50D 5r)