h8dZddlZddlZddlmZmZddlmZddlm Z m Z m Z m Z ddl mZmZddlmZddlmZmZdd lmZdd lmZdd lmZdd lmZdd lmZddlm Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'ddl(m)Z)m*Z*m+Z+m,Z,m-Z-ddl.m/Z/ddl0m1Z1ddl2m3Z3m4Z4m5Z5m6Z6m7Z7dZ8Gdde9e Z:ede;ZGddZ?Gdde?ejZAGddeZBGd d!ZCGd"d#eCejeB$ZDGd%d&ZEGd'd(ZFy))af The models and fields for translation support. The default is to use the :class:`TranslatedFields` class in the model, like: .. code-block:: python from django.db import models from parler.models import TranslatableModel, TranslatedFields class MyModel(TranslatableModel): translations = TranslatedFields( title = models.CharField(_("Title"), max_length=200) ) class Meta: verbose_name = _("MyModel") def __str__(self): return self.title It's also possible to create the translated fields model manually: .. code-block:: python from django.db import models from parler.models import TranslatableModel, TranslatedFieldsModel from parler.fields import TranslatedField class MyModel(TranslatableModel): title = TranslatedField() # Optional, explicitly mention the field class Meta: verbose_name = _("MyModel") def __str__(self): return self.title class MyModelTranslation(TranslatedFieldsModel): master = models.ForeignKey(MyModel, related_name='translations', null=True) title = models.CharField(_("Title"), max_length=200) class Meta: verbose_name = _("MyModel translation") This has the same effect, but also allows to to override the :func:`~django.db.models.Model.save` method, or add new methods yourself. The translated model is compatible with django-hvad, making the transition between both projects relatively easy. The manager and queryset objects of django-parler can work together with django-mptt and django-polymorphic. N) OrderedDict defaultdict)settings) FieldErrorImproperlyConfiguredObjectDoesNotExistValidationError)modelsrouter) ModelBase)ForwardManyToOneDescriptorManyToManyDescriptor) force_str)lazy)gettext) gettext_lazy)signals)MISSING_cache_translation!_cache_translation_needs_fallback_delete_cached_translation_delete_cached_translationsget_cached_translated_fieldget_cached_translation is_missing)LanguageCodeDescriptorTranslatedFieldTranslatedFieldDescriptorTranslationsForeignKey_validate_master)TranslatableManager)compat) get_languageget_language_settingsget_language_titleget_null_language_errornormalize_language_code)TranslatableModelMixinTranslatableModelTranslatedFieldsTranslatedFieldsModelTranslatedFieldsModelBaseTranslationDoesNotExistceZdZdZy)r-a' A tagging interface to detect missing translations. The exception inherits from :class:`~exceptions.AttributeError` to reflect what is actually happening. Therefore it also causes the templates to handle the missing attributes silently, which is very useful in the admin for example. The exception also inherits from :class:`~django.core.exceptions.ObjectDoesNotExist`, so any code that checks for this can deal with missing translations out of the box. This class is also used in the ``DoesNotExist`` object on the translated model, which inherits from: * this class * the ``sharedmodel.DoesNotExist`` class * the original ``translatedmodel.DoesNotExist`` class. This makes sure that the regular code flow is decently handled by existing exception handlers. N)__name__ __module__ __qualname____doc__=/home/dcms/DCMS/lib/python3.12/site-packages/parler/models.pyr-r-us   r4r-c^tdj|jjS)Nz{0} Translation)rformat_meta verbose_name)xs r5r;s!G,=$>$E$EaggFZFZ$[r4c v|si}|jjrtd|j|jj|d<|jj |d<|jj |d<t|jdgdgz|d<|jd|jjd|jd t||jd d t|jd }i}|j|td tf||d <|j |d<t#j$|d<t'||ddt"j(|d<t+|t,f|}t.j0|j }t3||||S)aP Dynamically create the translations model. Create the translations model for the shared model 'model'. :param related_name: The related name for the reverse FK from the translations model. :param meta: A (optional) dictionary of attributes for the translations model's inner Meta class. :param fields: A dictionary of fields to put on the translations model. Two fields are enforced on the translations model: language_code: A 15 char, db indexed field. master: A ForeignKey back to the shared model. Those two fields are unique together. z6Can't create TranslatedFieldsModel for abstract class app_label db_tablespacemanagedunique_together) language_codemasterdb_table _translationr9default_permissionsr3 TranslationMetar0objectsFT) related_nameeditablenull on_deleterB)r8abstract TypeErrorr/r=r>r?listget setdefaultrC_lazy_verbose_namestrupdatetypeobjectr0r ManagerrCASCADEr,r+sysmodulessetattr) shared_modelrImetafieldsnameattrstranslations_modelmods r5create_translations_modelrcs ""D\EZEZD[ \  %**44D(..<#>"?| LMOON$6|$DE OO)2. ,''( 4 5D E LL&D1E&M&11E,~~'E),! .. E(O34:O9QSXY ++l-- .C C)* r4ceZdZdZddZdZy)r*a Wrapper class to define translated fields on a model. The field name becomes the related name of the :class:`TranslatedFieldsModel` subclass. Example: .. code-block:: python from django.db import models from parler.models import TranslatableModel, TranslatedFields class MyModel(TranslatableModel): translations = TranslatedFields( title = models.CharField("Title", max_length=200) ) When the class is initialized, the attribute will point to a :class:`~django.db.models.fields.related.ForeignRelatedObjectsDescriptor` object. Hence, accessing ``MyModel.translations.related.related_model`` returns the original model via the :class:`django.db.models.related.RelatedObject` class. .. To fetch the attribute, you can also query the Parler metadata: MyModel._parler_meta.get_model_by_related_name('translations') :param meta: A dictionary of `Meta` options, passed to the :class:`TranslatedFieldsModel` instance. Example: .. code-block:: python class MyModel(TranslatableModel): translations = TranslatedFields( title = models.CharField("Title", max_length=200), slug = models.SlugField("Slug"), meta = {'unique_together': [('language_code', 'slug')]}, ) Nc .||_||_d|_yN)r^r]r_)selfr]r^s r5__init__zTranslatedFields.__init__s   r4c V||_t|||jfi|jyrf)r_rcr]r^)rgclsr_kwargss r5contribute_to_classz$TranslatedFields.contribute_to_classs" !#tTYYF$++Fr4rf)r/r0r1r2rhrlr3r4r5r*r*s(T Gr4r*ceZdZdZdZeZfdZddZdZ ddZ dZ ddZ d Z d Zdd Zdd Zdd Z ddZddZddZddZddZfdZdfd Zdfd ZdZdZd dZfdZde_xZS)!r(z Base model mixin class to handle translations. All translatable fields will appear on this model, proxying the calls to the :class:`TranslatedFieldsModel`. Nci}d}|rF|jdd}|jjD]} |j|||<d|_d|_t ||i|tt|_t|xs t|_|r|j|j fi|yy#t$rYwxYw)N_current_language) pop _parler_metaget_all_fieldsKeyError_translations_cacherosuperrhrdictr'r#_set_translated_fields)rgargsrktranslated_kwargscurrent_languagefield __class__s r5rhzTranslatableModelMixin.__init__s %zz*=tD **99; /5zz%/@%e, $( !% $)&)$/t#4 !8  . "   'D ' '(>(> TBS T % sB<< CCc Dg}|jjdi|D]P\}}|j|d|}|jD]\}} t ||||j|R|S#t $r"t |di} || |<t |d| YUwxYw)z9 Assign fields to the translated models. T)rA auto_creater]deferred_many_to_manyr3)rq _split_fields_get_translated_modelitemsr[rNgetattrappend) rgrAr^rH parler_meta model_fields translationr{valuers r5rwz-TranslatableModelMixin._set_translated_fields/s)H):):)H)H)R6)R ( %K44+K5K!- 2 2 4 Y uYK6 Y NN; ' (!Y-4KAXZ\,])38)%0K)@BWX Ys A44(BBc |tt|j}|j|jj |drtd||j |fi|D]}|j|y)aO Add a translation to the model. The :func:`save_translations` function is called afterwards. The object will be saved immediately, similar to calling :func:`~django.db.models.manager.Manager.create` or :func:`~django.db.models.fields.related.RelatedManager.create` on related fields. NzTranslation already exists: ) ValueErrorr&rqrt root_modelrPrwsave_translation)rgrAr^r]rs r5create_translationz)TranslatableModelMixin.create_translationEs  467 7    # #DOO 4 8 8 4 ;M?KL L7466}OO /K  ! !+ . /r4c|tt| |j}n|j|g}d}|D]^} |j||}|j |dz } |j|j|= |j|j=`|std||S#|jj $rYwxYw#t$rYVwxYw#ttf$rYwxYw)z Delete a translation from a model. :param language_code: The language to remove. :param related_name: If given, only the model matching that related_name is removed. rr]zTranslation does not exist: ) rr&rqrmodel DoesNotExistdeletertrs_prefetched_objects_cacherel_nameAttributeError)rgrArImetas num_deletedr]rs r5delete_translationz)TranslatableModelMixin.delete_translation\s  467 7  %%E&&|45E  D "88T8R    1 K ,,TZZ8G 224==A# *;M?KL L+::**    #H-  s5B,&C C,CC CCC,+C,c|jS)z+ Get the current language. )rorgs r5get_current_languagez+TranslatableModelMixin.get_current_languages %%%r4cht|xs t|_|r|jddyy)zG Switch the currently activate language of the object. FT) use_fallbackr~N)r'r#ror)rgrA initializes r5set_current_languagez+TranslatableModelMixin.set_current_languages5"99X,.!Y   & &Et & L r4c4|j}|r|dSdS)z\ .. deprecated:: 1.5 Use :func:`get_fallback_languages` instead. rN)get_fallback_languages)rg fallbackss r5get_fallback_languagez,TranslatableModelMixin.get_fallback_languages# //1 (y|2d2r4ct|j}|dDcgc]}||jk7s|}}|xsgScc}w)z Return the fallback language codes, which are used in case there is no translation for the currently active language. r)r$ro)rg lang_dictlangrs r5rz-TranslatableModelMixin.get_fallback_languagessI *$*@*@A &/ &<_dH^H^@^T_ _B`s>>c|!|j}|tt|jj |} t |j |j| S#t$rq||j|vrYyt|||d}||j|k(cYS |j|dd|Yy#|jj$rYYywxYwwxYw)z Return whether a translation for the given language exists. Defaults to the current language code. .. versionadded 1.2 Added the ``related_name`` parameter. rTrIrFrr~r])rorr&rq_get_extension_by_related_namerrtrrs_read_prefetched_translationsrrArr)rgrArIr]rVs r5has_translationz&TranslatableModelMixin.has_translations   22M$ !8!:;;  ?? M "$":":4::"F}"UVV V   B B B MM,m,TF!++}<< **!5t+ ::**  + s0%A&&C  C (B??CC CC c|jj|}|j|}|td|D}n4|j |}|j ddj d}|rNd|j|jjD}tt|t|zS|S)z Return the language codes of all translated variations. .. versionadded 1.2 Added the ``include_unsaved`` and ``related_name`` parameters. rc34K|]}|jywrfrA).0objs r5 zATranslatableModelMixin.get_available_languages..s!H#"3"3!HsrAT)flatc3>K|]\}}t|r|ywrfr)rkvs r5rzATranslatableModelMixin.get_available_languages..s"aR\]^R_s) rqr_get_prefetched_translationssorted_get_translated_queryset values_listorder_byrtrrrOset)rgrIinclude_unsavedr]prefetch db_languagesqslocal_languagess r5get_available_languagesz.TranslatableModelMixin.get_available_languagess   ?? M44$4?  !!Hx!HHL..D.9B>>/>ENN_L "66tzzBHHJOL)C,@@A A r4c^|jj|}|j||S)z, Fetch the translated model r)rqrr)rgrArIr]s r5get_translationz&TranslatableModelMixin.get_translations0  ?? M))-d)CCr4c X|j td|j td|s!|j}|t t ||jj}|j|j} ||}t|s|S |rDd|i}|jr|jjs||d<|jdi|}|||<|Sd} t/|} ||vrCt&||<|jjr |jt1|||j$ | d gt3| d z} |rI| rG| D]} | |k(r |j5| d || cSdj7dj9| d } |jj-dj7|j:j<|j|| xsd#t$r|jjs|j|j|}|-|D]'}|j|k(s|||<t!||ccYSnt#|||j$|}|+|j|k7r t&||<|||j<|cYSt|j)|drnU |j+|j)|}|||<t!||cYS#|jj,$rYnwxYwYqwxYw#|jj,$rYwxYw)z4 Fetch the translated fields model. Nz0No translation is assigned to the current model!zDAccessing translated fields before super.__init__() is not possible.rrrrArBrIcoderFrz (tried fallbacks {}), zV{0} does not have a translation for the current language! {0} ID #{1}, language={2}{3}r3)rqrrt RuntimeErrorrorr&rootrrrs_stateaddingpkrrArrrrrPrrr$rrOrr7joinr8r9) rgrArr~r] local_cacherVrrk fallback_msgrfallback_choices fallback_langs r5rz,TranslatableModelMixin._get_translated_modelsx    $&'YZ Z  # # +V  22M$ !8!:;; <$$))D..tzz: . * /Ff% &`  Fwwt{{11#'x TZZ)&)F)/K &M )-8  +*1K &;;%%)<1$ TXTaTab%f-.i 6L1MM ,"2  !]255%E{Y]6 399$))IkDZ:[\Ljj%% ++16 ''-ASQS,  w( *;;%%$''*=<<$<G'#+*!//=@9?K 6.v6#)M *4m$--VbF)!//=@9@K 6.sQ!:a=AQsrr)rqrrrtrorrPrnextvalues StopIterationrrrAr IndexError) rgr]tr_modelrcheck_languagesrtransrrs r5_get_any_translated_modelz0TranslatableModelMixin._get_any_translated_modelss* <$$))D::..x8  $5569T9T9VVO %4%M'OOM4@EZ%6$ %Q{'9'9';QQQ 88d8CH#&qk ";;;FqI 6AK 11 2 { + !    s6C,/ C,;C,? C,!/C;, C87C8; DDc~||jj}t||j}|j S)z Return the queryset that points to the translated model. If there is a prefetch, it can be read from this queryset. )rqrrr get_queryset)rgr]accessors r5rz/TranslatableModelMixin._get_translated_querysets9 <$$))D4/$$&&r4c||jj}|j} |j|S#tt f$rYywxYw)z< Return the queryset with prefetch results. N)rqrrrrrs)rgr]rIs r5rz3TranslatableModelMixin._get_prefetched_translationssR <$$))D}}  11,? ?)  s5AAc ||jj}|j|j}|j |}g}|<|D]7}|j }|j |||vst||s3|||<9|S)Nr)rqrrtrrrArr)rgr]rrlanguages_seenrrs r5rz4TranslatableModelMixin._read_prefetched_translationss <$$))D..tzz: 44$4?  ' 4 "00%%d+{*jT9J.K(3K%  4 r4clt||i||jdd|j|i|y)N update_fields)rusaverpsave_translationsrgrxrkr|s r5rzTranslatableModelMixin.saves9  d%f%  ?D)//r4c8t|t| |Srf)rrurrgusingr|s r5rzTranslatableModelMixin.deletes#D)w~e$$r4ci} t|||jj D]6}|j D]!}t |r |j|#8|r t|y#t$r}|j}Yd}~{d}~wwxYw#t$r%}|j|jYd}~d}~wwxYw)zL Also validate the unique_together of the translated model. )excludeN)ruvalidate_uniquer error_dictrtrrrT)rgrerrorserrr|s r5rz&TranslatableModelMixin.validate_uniques  " G #G # 4 33::< 0K*113 0 k*0///@  0 0 !&) )  "\\F "'0MM!,,//0s/A6B6 B? BB C!CCc|jj}|jD]S}||j}t |j }|D]$}t |r|j|g|i|&Uy)aQ The method to save all translations. This can be overwritten to implement any custom additions. This method calls :func:`save_translation` for every fetched language. :param args: Any custom arguments to pass to :func:`save`. :param kwargs: Any custom arguments to pass to :func:`save`. N)rtcopyrqrrOrrr)rgrxrk local_cachesr]r translationsrs r5rz(TranslatableModelMixin.save_translationss//446 %% DD&tzz2K 2 2 45L , D k*%%%kCDCFC  D Dr4c|j|jjr td|j |jrJ|j s,|jj |j_||_|j|i|t|di}|rD|jD] \}}t||j|"|jyy)a+ Save the translation when it's modified, or unsaved. .. note:: When a derived model provides additional translated fields, this method receives both the original and extended translation. To distinguish between both objects, check for ``translation.related_name``. :param translation: The translation :type translation: TranslatedFieldsModel :param args: Any custom arguments to pass to :func:`save`. :param kwargs: Any custom arguments to pass to :func:`save`. Nz@Can't save translations when the master object is not yet saved.r) rrrr is_modified master_iddbrBrrrr)rgrrxrkr fieldnamers r5rz'TranslatableModelMixin.save_translations 77?dkk00ab b >> ![%<%<(((,  ""%%) " K  d -f -!( 5Lb Q $9$?$?$A ; 5 Y/33E: ;     !r4c~|jj|}|r0||jk7r! |j||d}t ||S t ||S#t $rYnwxYw#t $rYnwxYw|r0|j |}| t ||S#t$rYnwxYwt|r|S|S)a{ Fetch a translated property, and return a default value when both the translation and fallback language are missing. When ``any_language=True`` is used, the function also looks into other languages to find a suitable value. This feature can be useful for "title" attributes for example, to make sure there is at least something being displayed. Also consider using ``field = TranslatedField(any_language=True)`` in the model itself, to make this behavior the default for the given field. .. versionchanged 1.5:: The *default* parameter may also be a callable. T)r]rr) rq_get_extension_by_fieldrorrr-rrscallable)rgr{defaultrA any_languager]rrs r5safe_translation_getterz.TranslatableModelMixin.safe_translation_getter%s  88? ]d.D.DD 55m$]a5bx//  tU++ +  +   88d8CK&";66 G 9 Ns5A A* A'&A'* A65A6 B B('B(cnt||i|t||jj yrf)rurefresh_from_dbrrtclearrs r5rz&TranslatableModelMixin.refresh_from_dbPs/ 00#D)   &&(r4Trf)F)NN)NF)NFFN)NNF) r/r0r1r2rqrrArhrwrrrrrrrrrrrrrrrrrrrrr alters_data __classcell__r|s@r5r(r(sL+,MU<,/.(T&M3*X 0DOS~ @#J ' $0%*0D0 D)V) #'Or4r(c2eZdZdZGddZeZy)r)z Base model class to handle translations. All translatable fields will appear on this model, proxying the calls to the :class:`TranslatedFieldsModel`. ceZdZdZy)TranslatableModel.MetaTN)r/r0r1rMr3r4r5rGr _sr4rGN)r/r0r1r2rGr!rHr3r4r5r)r)Xs "#Gr4r)c"eZdZdZfdZxZS)r,a7 .. versionadded 1.2 Meta-class for the translated fields model. It performs the following steps: * It validates the 'master' field, in case it's added manually. * It tells the original model to use this model for translations. * It adds the proxy attributes to the shared model. ct|||||}|dtjk(r|S|jj s|jj r|Stt|jdtsYtjdj|jjtt!|}|j#||S)Nrr{zsPlease change {}.master to a parler.fields.TranslationsForeignKey field to support translations in data migrations.)ru__new__r Modelr8rMproxy isinstancerrBrwarningswarnr7 model_nameDeprecationWarningr contribute_translations)mcsr_basesr` new_classr\r|s r5rz!TranslatedFieldsModelBase.__new__ssGOCue< 8v|| #  ?? # #y'<'< ')"2"2G<>TU MM##)6)//*D*D#E" ,I6L  - -l ;r4)r/r0r1r2rrr s@r5r,r,fs r4r,ceZdZdZdZfdZedZedZedZ edZ dfd Z dfd Z d Z d Zedd Zed ZdZdZxZS)TranslatedFieldsModelMixinzD Base class for the model that holds the translated fields. Nctjj|j||t ||i||j |_tjj|j||y)N)senderrxrk) rpre_translation_initsendr|rurh_get_field_values_original_valuespost_translation_initrs r5rhz#TranslatedFieldsModelMixin.__init__sf$$))dSY)Z $)&) $ 6 6 8%%**$..tTZ*[r4c<|j|jk7S)zP Tell whether the object content is modified since fetching it. )r"r!rs r5rz&TranslatedFieldsModelMixin.is_modifieds $$(>(>(@@@r4c:t|jdk(S)z; True when there are no translated fields. r)lenget_translated_fieldsrs r5is_emptyz#TranslatedFieldsModelMixin.is_emptys 4--/0A55r4cj|jjjjjS)zC Returns the shared model this model is linked to. )r|rBr{ remote_fieldrrs r5r\z'TranslatedFieldsModelMixin.shared_models& ~~$$**77===r4cj|jjjjjS)z[ Returns the related name that this model is known at in the shared model. )r|rBr{r*rIrs r5rIz'TranslatedFieldsModelMixin.related_names& ~~$$**77DDDr4c |jJd|xs!tj|j|}|jdu}|j j s-tjj|j|||t|0d||d||j|_t||j j s0tj j|j|| ||yy)NzgNo language is set or detected for this TranslatableModelMixin. Is the translations system initialized?instance)rr.rawr)r/r)rr.createdr/rr3)rAr db_for_writer|rr8 auto_createdrpre_translation_saver r\ru save_baser!r"rpost_translation_save)rgr/rrk record_existsr|s r5r4z$TranslatedFieldsModelMixin.save_bases!!-  6 -K,,T^^dKt+ zz&&  ( ( - -((4S .  9c9&9 $ 6 6 84 zz&&  ) ) . .((** / 'r4c|xs!tj|j|}|jjs,t j j|j||t|)|t||jjs-t jj|j||yy)Nr-)rr.r)r) r r1r|r8r2rpre_translation_deleter r\rurrpost_translation_deleters r5rz!TranslatedFieldsModelMixin.deletesK,,T^^dKzz&&  * * / /((4u 0  U#"4(zz&&  + + 0 0((4u 1 'r4c|jjDcgc]*}|jr |jr|j ,c}Scc}wrf)r8 get_fields is_relation many_to_one get_attnamergr{s r5_get_field_namesz+TranslatedFieldsModelMixin._get_field_namessK..0 $$(9(9       s/Ac|jjDcgc]4}|jr |jrt ||j 6c}Scc}wrf)r8r;r<r=rr>r?s r5r!z,TranslatedFieldsModelMixin._get_field_valuessR..0 $$(9(9 D%++- .   s9Ac|jjDcgc]}|jdvr |j}}|r?||jjDcgc]}|jdvr |jc}z }|Scc}wcc}w)N)rArBid)r8 local_fieldsr_local_many_to_many)rj include_m2mfress r5r'z0TranslatedFieldsModelMixin.get_translated_fieldssYY++ vv>> FF   5566!BB C   s !A?!Bc| |j}|W|dj|urF|j t |||j jjjn!>!K!K )6)#& ZZ--::GG )L %--/ >D > '|T: ",?X0YZ#%l&;&;%<: '))     m %l^3ef  B" J!55lDI Js E87 F8F#F;:F;c>tt|jSrf)rr%rArs r5__str__z"TranslatedFieldsModelMixin.__str__Us+D,>,>?@@r4cdj|jj|j|j|j S)Nz<{}: #{}, {}, master: #{}>)r7r|r/rrArrs r5__repr__z#TranslatedFieldsModelMixin.__repr__Xs6+22 NN # #TWWd.@.@$..  r4)FNrfT)r/r0r1r2rBrhpropertyrr(r\rIr4rr@r! classmethodr'rrSrUrr s@r5rrs F\AA 66 >> EE "H"    F F PA r4rcleZdZejedejddZGddZ y)r+LanguageT)choices max_lengthdb_indexceZdZdZdZy)TranslatedFieldsModel.MetaTr3N)r/r0r1rMrEr3r4r5rGr`es  r4rGN) r/r0r1r"HideChoicesCharField_r LANGUAGESrArGr3r4r5r+r+^s30F// * x11b4M!!r4r+) metaclassc$eZdZdZdZddZdZy)rMz3 Meta data for a single inheritance level. c.||_||_||_yrf)r\rr)rgr\rarIs r5rhzParlerMeta.__init__os(' $ r4c:|jj|S)z= Return the translated fields of this model. rF)rr')rgrFs r5r'z ParlerMeta.get_translated_fieldsus zz//K/HHr4cdj|jj|j|jjS)Nz)r7r\r/rrrs r5rUzParlerMeta.__repr__}s6*11    & & tzz7J7J  r4NrV)r/r0r1r2rhr'rUr3r4r5rMrMjs% I r4rMceZdZdZdZdZdZedZdZ dZ dZ d Z d Z d Zdd ZdZdZdZdZdZdZdZy )rNz0 Meta data for the translatable models. c|dcxurt|tur td||_d|_|,||_||_d|_g|_t|_ ny|jxs|}d|_||_|j |_|j |_t|j|_|jj|_ |jt|||y)Nz Expected a TranslatedFieldsModelFT) issubclassr+rNrP inheritedr root_rel_name_root _extensionsr_fields_to_modelrOrrLrM)rgrPr\rarIrs r5rhzParlerOptions.__init__s  bZ8JLa-b b>? ? c  <0DO!-D DJ!D $/MD ! ::%D!DNDJ"ooDO!%!3!3D  $D$4$45D $($9$9$>$>$@D ! j/A<PQr4c|jr td|jj||j}|j D]}||j |<y)NzRAdding translations afterwards to an already inherited model is not supported yet.)rmrrprrr'rq)rgr]rar_s r5rLzParlerOptions.add_metasc >>d  %"ZZ&<<> =D*rrrz extensions)rr7r\r/rrr&rp)rgrs r5rUzParlerOptions.__repr__szyy/66    & & MM JJ  d&&'1,B   57s4;K;K7L6M[2Y   r4c |jdS)z The top level object in the inheritance chain. This is an alias for accessing the first item in the collection. r)rprs r5rzParlerOptions.roots ""r4c,t|jS)zD Access all :class:`ParlerMeta` objects associated. )iterrprs r5__iter__zParlerOptions.__iter__sD$$%%r4c ttr|jSttr|j St fd|jDS#t ttf$rtddwxYw)zF Get an :class:`ParlerMeta` object by index or model. rc3BK|]}|jk(s|ywrfr)rr]items r5rz,ParlerOptions.__getitem__..sTTtASDTszItem 'z ' not found) rintrprSrrrrrs)rgr{s `r5 __getitem__zParlerOptions.__getitem__s 7$$''--D#&:::MMTT-=-=TTTz84 7VD656 6 7sA"!A"A""$Bc,t|jSrf)r&rprs r5__len__zParlerOptions.__len__s4##$$r4cT|jDcgc]}|jc}Scc}w)zT Return all translated models associated with the the shared model. )rpr)rgr]s r5get_all_modelszParlerOptions.get_all_modelss"(,'7'78t 888s%cHt|jjS)zJ Return all translated fields associated with this model. )rOrqkeysrs r5rrzParlerOptions.get_all_fieldssD))..011r4c6|jjS)zV Convenience function, return all translated fields with their model. )rqrrs r5get_fields_with_modelz#ParlerOptions.get_fields_with_models$$**,,r4NcH|j|}|j|S)z Return the translated fields of this model. By default, the top-level translation is required, unless ``related_name`` is provided. rh)rr')rgrIrFr]s r5r'z#ParlerOptions.get_translated_fieldss( 22<@))k)BBr4cZ |j|S#t$rtd|dwxYw)zX Find the :class:`TranslatedFieldsModel` that contains the given field. z"Translated field does not exist: 'rK)rqrsrrgr_s r5get_model_by_fieldz ParlerOptions.get_model_by_fields? K((. . KA$qIJ J Ks*c<|j|}|jSrf)rrrgrIr]s r5get_model_by_related_namez'ParlerOptions.get_model_by_related_names22<@zzr4c@tfd|jDS)Nc3<K|]}|jk(ywrfrz)rr]rs r5rz8ParlerOptions._has_translations_model..sD44::&Danyrp)rgrs `r5_has_translations_modelz%ParlerOptions._has_translations_modelsD43C3CDDDr4c@tfd|jDS)Nc3<K|]}|jk(ywrf)r)rr]r_s r5rz8ParlerOptions._has_translations_field.. sFT4==D(Frrrs `r5_has_translations_fieldz%ParlerOptions._has_translations_field sFT5E5EFFFr4c| td|j|}|jD]}|j|k(s|cSy)za Find the ParlerOptions object that corresponds with the given translated field. NzExpected field name)rNrrpr)rgr_rr]s r5rz%ParlerOptions._get_extension_by_field sM <12 2**40$$ DzzX%  r4c||jdS|jD]}|j|k(s|cStdj|jj j |)z Find which model is connected to a given related name. If the related name is ``None``, the :attr:`root_model` will be returned. rz6No translated model of '{}' has a reverse name of '{}')rprrr7rr\r/rs r5rz,ParlerOptions._get_extension_by_related_namess  ##A& &$$ D}} ,   D K K &&//   r4c+K|jD]2}i}|jjD] } ||||< ||f4y#t$rY"wxYwwrf)rprr'rs)rgr^r]rr{s r5rzParlerOptions._split_fields+so$$ 'DL99; *0-L'  & & '  s'/AA A AAAA)NT)r/r0r1r2rhrLrUrWrrwr}rrrrrr'rrrrrrrr3r4r5rNrNsvRB = ##& 7%9 2 - CKEG  $ 'r4rN)Gr2rYr collectionsrr django.confrdjango.core.exceptionsrrrr django.dbr r django.db.models.baser +django.db.models.fields.related_descriptorsr rdjango.utils.encodingrdjango.utils.functionalrdjango.utils.translationrrrbparlerr parler.cacherrrrrrrr parler.fieldsrrrrr parler.managersr! parler.utilsr"parler.utils.i18nr#r$r%r&r'__all__rr-rSrRrcr*r(rr)r,rr+rMrNr3r4r5rs 6n 0  %+,(,6   0  n.@ ([]`a>B3G3GlR 'R 'j $. $$ $NN N b ! 8Q !  2r'r'r4