hdZddlmZddlmZddlmZddlmZdZ GddejZ Gd d Z Gd d Z Gd dZy)a All fields that are attached to the models. The core design of django-parler is to attach descriptor fields to the shared model, which then proxies the get/set calls to the translated model. The :class:`TranslatedField` objects are automatically added to the shared model, but may be added explicitly as well. This also allows to set the ``any_language`` configuration option. It's also useful for abstract models; add a :class:`TranslatedField` to indicate that the derived model is expected to provide that translatable field. )ImproperlyConfigured)models)ForwardManyToOneDescriptor) pretty_namec(|jrt|jtst|jd|jj j }|j}|jdk(r|S |j}|k|j|rtd|jd|j|jr&td|jd|jd|S#t$rtd|dwxYw) z^ Check whether the 'master' field on a TranslatedFieldsModel is correctly configured. z3.master should be a ForeignKey to the shared table.__fake__zTranslatable model z2 does not appear to inherit from TranslatableModelz The model 'z.' already has an associated translation table!z5' already has an associated translation field named 'z'!)master isinstancerr__name__field remote_fieldmodel __module__ _parler_metaAttributeError TypeError_has_translations_model_has_translations_field related_name) new_classr shared_modelmetas =/home/dcms/DCMS/lib/python3.12/site-packages/parler/fields.py_validate_masterrsI   :i.>.>@Z#["!!""U V  ##))66L%%L*, ((    ' ' 2&l3344bc   ' ' (A(A B&l3344ijvkDkDjEEGH    !,/a b   s = C88Dc"eZdZdZfdZxZS)TranslationsForeignKeyzE Foreign Key field that adds translations to the `to` model. cddlm}t| ||t |j t |j |r|j j|yy)Nr)TranslatedFieldsModelMixin) parler.modelsrsupercontribute_to_related_classrr issubclasscontribute_translations)selfclsrelatedr __class__s rr!z2TranslationsForeignKey.contribute_to_related_class;sG< +C9$ djj"< = JJ . .s 3 >)r r __qualname____doc__r! __classcell__)r's@rrr6s44r(rc.eZdZdZddZdZedZy)TranslatedFielda= Proxy field attached to a model. The field is automatically added to the shared model. However, this can be assigned manually to be more explicit, or to pass the ``any_language`` value. The ``any_language=True`` option causes the attribute to always return a translated value, even when the current language and fallback are missing. This can be useful for "title" attributes for example. Example: .. code-block:: python from django.db import models from parler.models import TranslatableModel, TranslatedFieldsModel class MyModel(TranslatableModel): title = TranslatedField(any_language=True) # Add with any-fallback support slug = TranslatedField() # Optional, but explicitly mentioned class MyModelTranslation(TranslatedFieldsModel): # Manual model class: master = models.ForeignKey(MyModel, related_name='translations', null=True) title = models.CharField("Title", max_length=200) slug = models.SlugField("Slug") c<d|_d|_||_d|_yN)rname any_language_meta)r$r1s r__init__zTranslatedField.__init__bs  ( r(c `||_||_t||jt|yr/)rr0setattrTranslatedFieldDescriptor)r$r%r0kwargss rcontribute_to_classz#TranslatedField.contribute_to_classhs(   TYY 9$ ?@r(c|j4|jjj|j|_|jSr/)r2rr_get_extension_by_fieldr0r$s rrzTranslatedField.metaps6 :: 00HHSDJzzr(N)F)r rr)r*r3r8propertyrr(rr-r-Es&8 Ar(r-c@eZdZdZdZd dZdZdZdZe dZ y) r6zv Descriptor for translated attributes. This attribute proxies all get/set calls to the translated model. c||_y)z. :type field: TranslatedField N)r )r$r s rr3z"TranslatedFieldDescriptor.__init__~s  r(Nc|s|Sd}|jj} |jd|}t||jjS#|jj$rd}|jj r|j |}|0|jdd|jjdf|_Yd}~d}~wwxYw)NT) use_fallbackrrrz Attempted to read attribute .) r r_get_translated_modelr DoesNotExistr1_get_any_translated_modelargsr0getattr)r$instance instance_type translationres r__get__z!TranslatedFieldDescriptor.__get__sK zz "88dQU8VK{DJJOO44zz&& zz&&&@@A "VVAYK'EdjjooEVVWXZ# sAC*AC  Cc|,t|jjjd|j dd|jj }t ||jj|y)Nz must be accessed via instanceFT)rA auto_creater)rr opts object_namerDrr5r0)r$rIvaluerKs r__set__z!TranslatedFieldDescriptor.__set__sf   DJJOO$?$?#@@^!_` `44Dtzz5   TZZ__e4r(c|j|jj}t||jjy)NrB)rDr rdelattrr0)r$rIrKs r __delete__z$TranslatedFieldDescriptor.__delete__s144$**//4J  TZZ__-r(cd|jjd|jjjd|jjdS)N)r'r r rr0r;s r__repr__z"TranslatedFieldDescriptor.__repr__sC4>>**+51A1A1J1J0K1TZZ__L]]^__r(c|jjj}|t|jjS|j j |jj}|jS)a$ Ensure that the admin ``list_display`` renders the correct verbose name for translated fields. The :func:`~django.contrib.admin.utils.label_for_field` function uses :func:`~django.db.models.Options.get_field_by_name` to find the find and ``verbose_name``. However, for translated fields, this option does not exist, hence it falls back to reading the attribute and trying ``short_description``. Ideally, translated fields should also appear in this list, to be treated like regular fields. )r rrrr0r2 get_field verbose_name)r$translations_modelr s rshort_descriptionz+TranslatedFieldDescriptor.short_descriptions]"ZZ__22  %tzz/ /"((224::??C!!!r(r/) r rr)r*r3rMrSrVrZr<r_r=r(rr6r6ws5  50 5.`""r(r6c$eZdZdZddZdZdZy)LanguageCodeDescriptorz\ This is the property to access the ``language_code`` in the ``TranslatableModel``. Nc"|s|S|jSr/)_current_language)r$rIrJs rrMzLanguageCodeDescriptor.__get__sK)))r(ctd)NzhThe 'language_code' attribute cannot be changed directly! Use the set_current_language() method instead.r)r$rIrRs rrSzLanguageCodeDescriptor.__set__s v  r(ctd)Nz0The 'language_code' attribute cannot be deleted!re)r$rIs rrVz!LanguageCodeDescriptor.__delete__sOPPr(r/)r rr)r*rMrSrVr=r(rraras*  Qr(raN)r*django.core.exceptionsr django.dbr+django.db.models.fields.related_descriptorsrdjango.forms.utilsrr ForeignKeyrr-r6rar=r(rrlsT 8R*!H 4V.. 4//dM"M"`QQr(