Ƿi6QdZddlZddlZ ddlZdZn #e$rdZYnwxYw ddlZdZn #e$rdZYnwxYwddlm Z ddl m Z ddl m Z mZmZmZmZddlmZdd lmZdd lmZdd lmZee d d ZGddZGddeeZGddeeZGdde ZGddeZ Gdde!Z"GddZ#Gdde#eZ$dS)zo Django Extensions additional model fields Some fields might require additional dependencies to be installed. NTF)settings)ImproperlyConfigured) DateTimeField CharField SlugFieldQUniqueConstraint) LOOKUP_SEP)slugify)get_random_string) force_str$EXTENSIONS_MAX_UNIQUE_QUERY_ATTEMPTSdc6eZdZdZedZdZdZdS)UniqueFieldMixinctt||ts"td|dS)Nz#'{}' argument must be True or False) isinstancegetattrbool ValueErrorformat)selfattrnames \/srv/django_bis/venv311/lib/python3.11/site-packages/django_extensions/db/fields/__init__.py check_is_boolzUniqueFieldMixin.check_is_bool%sH'$11488 UBII(SSTT T U UcNfdjDS)Nctg|]4}|jr|js|j|j||jkr|jndf5SN) is_relation one_to_one many_to_one related_modelmodel).0f model_clss r z0UniqueFieldMixin._get_fields..+sf   ?@= $%L 56] GH 17i//T :   r)_meta get_fields)r's`r _get_fieldszUniqueFieldMixin._get_fields)s<    DMOD^D^D`D`    rc||D](\}}|r!||kr|jcS)|jSr)r+_default_managerall)rr' slug_fieldfieldr$s r get_querysetzUniqueFieldMixin.get_queryset0sf ,,Y77 4 4LE5 4*,,-1133333)--///rcj|}jr|j}i}jjD]$}j|vr|D]}t|d||<%t} tjdd} | rGtd| } | D]3} j| j vr#fd| j D} | tdi| z} 4t|}||j<|r|j | fi|r)t|}||j<||j | fi|)tj||S)N)pk constraintsc,t|tSr)rr )cs rz.UniqueFieldMixin.find_unique..Is*Q(899rcJi|]}|jk |t|d Sr)attnamer)r%r0model_instancers r z0UniqueFieldMixin.find_unique..Ms>!!!! DL00w~udCC000r) r1 __class__r3excluder)unique_togetherr9rrfilterfieldsnextsetattr)rr:r0iteratorargsquerysetkwargsparamsparamqueryr4unique_constraintsunique_constraint conditionnews`` r find_uniquezUniqueFieldMixin.find_unique6s$$^%=uEE   >''>+<'==H$*: I IF|v%%#IIE$+NE4$H$HF5MMn2M4HH  ,!'99;"" &8 , ,!<#4#;;;!!!!!%6%=!!!I Q^^^^+E8nn"t| '99&99 'x..C#&F4<  '99&99 '  c222 rN)__name__ __module__ __qualname__r staticmethodr+r1rOr<rrrr#s_UUU  \ 000 $$$$$rrcfeZdZdZfdZdZedZdZdZ dZ dZ d Z fd Z xZS) AutoSlugFielda AutoSlugField By default, sets editable=False, blank=True. Required arguments: populate_from Specifies which field, list of fields, or model method the slug will be populated from. populate_from can traverse a ForeignKey relationship by using Django ORM syntax: populate_from = 'related_model__field' Optional arguments: separator Defines the used separator (default: '-') overwrite If set to True, overwrites the slug on every save (default: False) slugify_function Defines the function which will be used to "slugify" a content (default: :py:func:`~django.template.defaultfilters.slugify` ) It is possible to provide custom "slugify" function with the ``slugify_function`` function in a model class. ``slugify_function`` function in a model class takes priority over ``slugify_function`` given as an argument to :py:class:`~AutoSlugField`. Example .. code-block:: python # models.py from django.db import models from django_extensions.db.fields import AutoSlugField class MyModel(models.Model): def slugify_function(self, content): return content.replace('_', '-').lower() title = models.CharField(max_length=42) slug = AutoSlugField(populate_from='title') Inspired by SmileyChris' Unique Slugify snippet: http://www.djangosnippets.org/snippets/690/ cv|dd|dd|dd}|td||_t |sJt |t tfs|f}td|Dstd|z|d t|_ |d d |_ |d d|_ |d |d d|_|d |dd|_|d|dt"|_t'j|i|dS)NblankTeditableF populate_fromz missing 'populate_from' argumentc3@K|]}t|tVdSr)rstr)r%es r z)AutoSlugField.__init__..s,AAaz!S))AAAAAArzB'populate_from' must be str or list[str] or tuple[str], found `%s`slugify_function separator- overwriteoverwrite_on_addallow_duplicatesmax_unique_query_attempts) setdefaultpopr_populate_fromcallablerlisttupler. TypeErrorr r^r_rarrbrcMAX_UNIQUE_QUERY_ATTEMPTSrdsuper__init__)rrErGrYr=s rrnzAutoSlugField.__init__s'4(((*e,,, ?D99  ?@@ @"/D  && vmdE];; 2!. 1 AA=AAAAA v dgt tuuu & +=w G GK55K77 ;''' & +=t D D -... & +=u E E -...)/4OQj)k)k&$)&)))))rcdtj|jz}tjd|z|j|}tjd|d|dd|S)a  Clean up a slug by removing slug separator characters that occur at the beginning or end of a slug. If an alternate separator is used, it will also replace any instances of the default '-' separator with the new separator. z(?:-|%s)z%s+^z+|z+$)reescaper_sub)rvaluere_seps r _slug_stripzAutoSlugField._slug_stripsVbi777uv~t~u==vvffffff5r5AAArc |r ||SdSNrqr<)contentr^s r slugify_funczAutoSlugField.slugify_funcs  -##G,, ,rrc#RK|Vt||jD]q}|}|j|}t|}|jrBt||z|jkr'|d|j|z }||}||}|Vrt d|d|jd)Nzmax slug attempts for z exceeded ())rangerdr_lenslug_lenrw RuntimeError)r original_slugstartislugendend_lens rslug_generatorzAutoSlugField.slug_generatorsud<==  A D NNAA.C#hhG} .TW!4t}!D!D4T]W445''--!T33'DJJJJl}}}VZVtVtVtuvvvrc tj}d}|r jsd}jr|rd}|r|Sj}t |t tfs|f}j j}tdj   fd}j t||}d}|j_jr|dj}|}|} jrt%j||S|| |S)NFTr^cZ|S)N)r^)r{get_slug_fields) lookup_valuer:rr^s rr7z+AutoSlugField.create_slug..s3d.?.?   > >-/@/ / r)rr9rarbrgrrirjr) get_fieldr^r_joinmap max_lengthrrwrcrCrOr) rr:addruse_existing_slugrYr/slug_for_fieldrrr^s `` @r create_slugzAutoSlugField.create_slugs~t|44!  % %!%    &S & %   K+ -$77 .*-M#)33DLAA ">3EtG\]]      ~""3~}#E#EFF#- = ('D%%    NDL$ 7 7 7K J(;(;M5(Q(QSS Src Bt|rd||zS|t}|}|D]F} t||}#t$r&t d||||wxYwt|r d|zS|S)Nz%szbvalue {} in AutoSlugField's 'populate_from' argument {} returned an error - {} has no attribute {})rhsplitr rAttributeErrorr)rr:rlookup_value_pathattrelems rrzAutoSlugField.get_slug_fieldss L ! ! 7,,~666 6(..z::% 9 9D 9tT**! 9 9 9$xlD$88999 9 D>> !$$&&=  s A0BcLt|||}|Sr)r r)rr:rrus rpre_savezAutoSlugField.pre_saves$$**>3??@@ rcdS)Nrr<rs rget_internal_typezAutoSlugField.get_internal_type{rct\}}}}|j|d<|jdks |j|d<|jdurd|d<|jdurd|d<||||fS)NrYr`r_FTrarc)rm deconstructrgr_rarcrnamepathrErGr=s rrzAutoSlugField.deconstructs#(77#6#6#8#8 dD&"&"5~$$"&.F;  > & &"&F;    - -)-F% &T4''r)rPrQrR__doc__rnrwrSr{rrrrrr __classcell__r=s@rrUrU]s55n*****8 B B B\ w w w+S+S+SZ( ( ( ( ( ( ( ( ( (rrUcDeZdZdZfdZdZdZdZdZfdZ xZ S)RandomCharFielda2 RandomCharField By default, sets editable=False, blank=True, unique=False. Required arguments: length Specifies the length of the field Optional arguments: unique If set to True, duplicate entries are not allowed (default: False) lowercase If set to True, lowercase the alpha characters (default: False) uppercase If set to True, uppercase the alpha characters (default: False) include_alpha If set to True, include alpha characters (default: True) include_digits If set to True, include digit characters (default: True) include_punctuation If set to True, include punctuation characters (default: False) keep_default If set to True, keeps the default initialization value (default: False) c|dd|dd|dd|_|jtd|j|d<|dd|_|d|d d|_|d |jr|jrtd |d d|_|d |d d|_|d |d d|_ |dd|_ |d |dt|_ d|vrd|d<tj|i|dS)NrWTrXFlengthzmissing 'length' argumentr lowercase uppercasez@the 'lowercase' and 'uppercase' arguments are mutually exclusiveinclude_digits include_alphainclude_punctuation keep_defaultrdunique)rerfrrrrrrrrrrlrdrmrnrrErGr=s rrnzRandomCharField.__init__Gs'4(((*e,,,jj400 ; 899 9#{|K77 ;'''K77 ;''' > adn a_`` `$jj)94@@ +,,,#ZZ>> ?+++#)::.CU#K#K "JJ~u== 0111)/4OQj)k)k& 6 ! !$F8 $)&)))))rc#Kt|jD],}dt|j|V-t d|jz)Nrqz+max random character attempts exceeded (%s))r~rdrr rr)rcharsrs rrandom_char_generatorz%RandomCharField.random_char_generatoresat566 A AA''+DK??@@ @ @ @ @H4Kiijjjrc<|jjD]}|j|vrdSdS)NTF)r)r?r9)rr:rHs rin_unique_togetherz"RandomCharField.in_unique_togetherjs5$*:  F|v%%tt&urcl|r|jr.t||jdkrt||jSd}|jr=|jr|t jz }n&|jr|t jz }n|t j z }|j r|t j z }|j r|t j z }||}|js<||s't#|}t%||j||S|||j|j|Sry)rrr9rrstringascii_lowercaserascii_uppercase ascii_lettersrdigitsr punctuationrrrrBrCrOr)r)rr:r population random_charsrNs rrzRandomCharField.pre_savepsG 9t( 9gndl.S.SWY.Y.Y>4<88 8   3~ 3f44  3f44 f22   ( &- 'J  # - &, ,J11*== { 4#:#:>#J#J |$$C NDL# 6 6 6J   * *4< 8 8    rcdS)Nrr<rs r internal_typezRandomCharField.internal_typerrcXt\}}}}|j|d<|d=|jdur |j|d<|jdur |j|d<|jdur |j|d<|jdur |j|d<|jdur |j|d <|jdur |j|d <||||fS) NrrTrrFrrrr) rmrrrrrrrrrs rrzRandomCharField.deconstructs#(77#6#6#8#8 dD&;x < >T ! !"&.F;  >T ! !"&.F;    & &&*&8F? #  % ' ''+':F# $  #t + +,0,DF( ) ;$  #{F8 T4''r) rPrQrRrrnrrrrrrrs@rrr$s  D*****<kkk     >(((((((((rrc.eZdZdZdZdZfdZxZS)CreationDateTimeFieldzc CreationDateTimeField By default, sets editable=False, blank=True, auto_now_add=True c|dd|dd|ddtj|g|Ri|dS)NrXFrWT auto_now_addrerrnrrErGs rrnzCreationDateTimeField.__init__sk*e,,,'4(((.$///t5d555f55555rcdSNrr<rs rrz'CreationDateTimeField.get_internal_typerct\}}}}|jdurd|d<|jdurd|d<|jdurd|d<||||fS)NFTrXrWr)rmrrXrWrrs rrz!CreationDateTimeField.deconstructsu#(77#6#6#8#8 dD& = % %!%F:  :T ! !#F7O  E ) )%)F> "T4''r)rPrQrRrrnrrrrs@rrrs` 666 (((((((((rrc8eZdZdZdZdZfdZfdZxZS)ModificationDateTimeFieldz ModificationDateTimeField By default, sets editable=False, blank=True, auto_now=True Sets value to now every time the object is saved. c\|ddtj|g|Ri|dS)Nauto_nowTrrs rrnz"ModificationDateTimeField.__init__s?*d+++t5d555f55555rcdSrr<rs rrz+ModificationDateTimeField.get_internal_typerrcvt\}}}}|jdurd|d<||||fS)NFTr)rmrrrs rrz%ModificationDateTimeField.deconstructsG#(77#6#6#8#8 dD& = % %!%F: T4''rct|ddst||jSt||S)Nupdate_modifiedT)rr9rmr)rr:rr=s rrz"ModificationDateTimeField.pre_savesD~'8$?? 9>4<88 8ww444r) rPrQrRrrnrrrrrs@rrrsy666((((( 555555555rrceZdZdS)UUIDVersionErrorN)rPrQrRr<rrrrsDrrcPeZdZdZdZ d fd ZdZfdZfd Zfd Z xZ S) UUIDFieldMixina UUIDFieldMixin By default uses UUID version 4 (randomly generated UUID). The field support all uuid versions which are natively supported by the uuid python module, except version 2. For more information see: http://docs.python.org/lib/module-uuid.html $NTc @tstd| d|j|r"d|_d| d<| dd||_||_||_||_||_ |p||_ tj | d|i| dS)NzW'uuid' module is required for UUIDField. (Do you have Python 2.5 or higher installed ?)rFTrWrX verbose_name) HAS_UUIDrreDEFAULT_MAX_LENGTHempty_strings_allowedautoversionnode clock_seq namespace uuid_namermrn) rrrrrrrrrrErGr=s rrnzUUIDFieldMixin.__init__s B&(ABB B,(?@@@  1).D &"F7O   j% 0 0 0   """*dTDlDVDDDDDrc|jr |jdkrtjS|jdkrtj|j|jS|jdkrt d|jdkrtj|j|j S|jdkrtj |j|j St d|jz)Nrr UUID version 2 is not supported.UUID version %s is not valid.) ruuiduuid4uuid1rrruuid3rruuid5rs r create_uuidzUUIDFieldMixin.create_uuids| St|q00:<<  \Q  :di88 8 \Q  "#EFF F \Q  :dndn== = \Q  :dndn== ="#BT\#QRR RrcTt||}|jr=|r;|9t|}t ||j||S|jr9|s7t|}t ||j||Sr)rmrrr rrCr9)rr:rrur=s rrzUUIDFieldMixin.pre_saves  55 9 = =d..0011E NDL% 8 8 8Ly = =!$"2"2"4"455 e<<< rc H|jrdStjdi|S)Nr<)rrm formfield)rrGr=s rrzUUIDFieldMixin.formfields/ 9 4 uww **6***rcvt\}}}}|dd|jkr|d=|jdur |j|d<|jdkr |j|d<|j |j|d<|j |j|d<|j |j|d<|j |j |d <||||fS) NrTrrrrrrr) rmrgetrrrrrrrrrs rrzUUIDFieldMixin.deconstruct#s#(77#6#6#8#8 dD& ::lD ) )T-D D D|$ 9D !YF6N <1   $ F9  9 !YF6N > %"&.F;  > %"&.F;  > %"&)F; T4''r)NNTrNNNN) rPrQrRrrrnrrrrrrs@rrrsHIFJEEEEEE, S S S     +++++ (((((((((rrc,eZdZdZdZfdZdZxZS)ShortUUIDFieldz ShortUUIDFied Generates concise (22 characters instead of 36), unambiguous, URL-safe UUIDs. Based on `shortuuid`: https://github.com/stochastic-technologies/shortuuid ctj|i|tstd|d|jdS)Nza'shortuuid' module is required for ShortUUIDField. (Do you have Python 2.5 or higher installed ?)r)rmrnHAS_SHORT_UUIDrrerrs rrnzShortUUIDField.__init__Csb$)&))) L&(KLL L,(?@@@@@rch|jr |jdkrtjS|jdkrtjS|jdkrtd|jdkrtd|jdkrtj|jStd |jz) Nrrrrrz UUID version 3 is not supported.r)rr)r shortuuidrrrrs rrzShortUUIDField.create_uuidIs| St|q00>## # \Q  >## # \Q  "#EFF F \Q  "#EFF F \Q  >t~666 6"#BT\#QRR Rr)rPrQrRrrrnrrrs@rrr8seAAAAA S S S S S S Srr)%rrrrrr ImportErrorrr django.confrdjango.core.exceptionsrdjango.db.modelsrrrrr django.db.models.constantsr django.template.defaultfiltersr django.utils.cryptor django.utils.encodingr rrlrrUrrr Exceptionrrrr<rrr s  KKKHHHHHNNNNN! 777777UUUUUUUUUUUUUU111111222222111111++++++$GH.TVYZZ77777777tD(D(D(D(D($iD(D(D(N~(~(~(~(~(& ~(~(~(B(((((M(((655555 55558     y   U(U(U(U(U(U(U(U(pSSSSS^YSSSSSs(22