# pyright: reportGeneralTypeIssues=warning, reportOptionalMemberAccess=warning, reportOptionalOperand=warning import datetime import importlib import os import shutil import sys from decimal import Decimal from modeltranslation.translator import TranslationOptions import pytest from django import forms from django.apps import apps as django_apps from django.conf import settings as django_settings from django.core.exceptions import ImproperlyConfigured, ValidationError from django.core.files.base import ContentFile from django.core.files.storage import default_storage from django.core.management import call_command from django.core.management.base import CommandError from django.db import IntegrityError from django.db.models import CharField, Count, F, Q, Value from django.db.models.functions import Cast, Concat from django.test import TestCase, TransactionTestCase from django.test.utils import override_settings from django.utils.translation import get_language, override, trans_real from parameterized import parameterized # type: ignore[import-untyped] from modeltranslation import translator from modeltranslation import settings as mt_settings from modeltranslation.forms import TranslationModelForm from modeltranslation.manager import MultilingualManager from modeltranslation.models import autodiscover from modeltranslation.tests import models, translation from modeltranslation.utils import ( auto_populate, build_lang, build_localized_fieldname, fallbacks, ) # How many models are registered for tests. TEST_MODELS = 41 class reload_override_settings(override_settings): """Context manager that not only override settings, but also reload modeltranslation conf.""" def __enter__(self): super().__enter__() importlib.reload(mt_settings) def __exit__(self, exc_type, exc_value, traceback): super().__exit__(exc_type, exc_value, traceback) importlib.reload(mt_settings) # In this test suite fallback language is turned off. This context manager temporarily turns it on. def default_fallback(): return reload_override_settings( MODELTRANSLATION_FALLBACK_LANGUAGES=(mt_settings.DEFAULT_LANGUAGE,) ) def get_field_names(model): names = set() fields = model._meta.get_fields() for field in fields: if field.is_relation and field.many_to_one and field.related_model is None: continue if field.model != model and field.model._meta.concrete_model == model._meta.concrete_model: continue names.add(field.name) if hasattr(field, "attname"): names.add(field.attname) return names def assert_db_record(instance, **expected_fields): """ Compares field values stored in the db. """ actual = ( type(instance) .objects.rewrite(False) .filter(pk=instance.pk) .values(*expected_fields.keys()) .first() ) assert actual == expected_fields class ModeltranslationTransactionTestBase(TransactionTestCase): cache = django_apps @classmethod def setUpClass(cls): """Save registry (and restore it after tests).""" super().setUpClass() from copy import copy from modeltranslation.translator import translator cls.registry_cpy = copy(translator._registry) @classmethod def tearDownClass(cls): from modeltranslation.translator import translator translator._registry = cls.registry_cpy super().tearDownClass() def setUp(self): super().setUp() self._old_language = get_language() trans_real.activate("de") def tearDown(self): super().tearDown() trans_real.activate(self._old_language) class ModeltranslationTestBase(TestCase, ModeltranslationTransactionTestBase): pass class TestAutodiscover(ModeltranslationTestBase): # The way the ``override_settings`` works on ``TestCase`` is wicked; # it patches ``_pre_setup`` and ``_post_teardown`` methods. # Because of this, if class B extends class A and both are ``override_settings``'ed, # class B settings would be overwritten by class A settings (if some keys clash). # To solve this, override some settings after parents ``_pre_setup`` is called. def _pre_setup(self): super()._pre_setup() # Add test_app to INSTALLED_APPS new_installed_apps = django_settings.INSTALLED_APPS + ("modeltranslation.tests.test_app",) self.__override = override_settings(INSTALLED_APPS=new_installed_apps) self.__override.enable() def _post_teardown(self): self.__override.disable() importlib.reload(mt_settings) # restore mt_settings.FALLBACK_LANGUAGES super()._post_teardown() def tearDown(self): # Rollback model classes del self.cache.all_models["test_app"] from .test_app import models importlib.reload(models) # Delete translation modules from import cache sys.modules.pop("modeltranslation.tests.test_app.translation", None) sys.modules.pop("modeltranslation.tests.project_translation", None) super().tearDown() def check_news(self): from .test_app.models import News fields = dir(News()) assert "title" in fields assert "title_en" in fields assert "title_de" in fields assert "visits" in fields assert "visits_en" not in fields assert "visits_de" not in fields def check_other(self, present=True): from .test_app.models import Other fields = dir(Other()) assert "name" in fields if present: assert "name_en" in fields assert "name_de" in fields else: assert "name_en" not in fields assert "name_de" not in fields def test_simple(self): """Check if translation is imported for installed apps.""" autodiscover() self.check_news() self.check_other(present=False) @reload_override_settings( MODELTRANSLATION_TRANSLATION_FILES=("modeltranslation.tests.project_translation",) ) def test_global(self): """Check if translation is imported for global translation file.""" autodiscover() self.check_news() self.check_other() @reload_override_settings( MODELTRANSLATION_TRANSLATION_FILES=("modeltranslation.tests.test_app.translation",) ) def test_duplication(self): """Check if there is no problem with duplicated filenames.""" autodiscover() self.check_news() class ModeltranslationTest(ModeltranslationTestBase): """Basic tests for the modeltranslation application.""" def test_registration(self): langs = tuple(val for val, label in django_settings.LANGUAGES) assert langs == tuple(mt_settings.AVAILABLE_LANGUAGES) assert 2 == len(langs) assert "de" in langs assert "en" in langs assert translator.translator # Check that all models are registered for translation assert len(translator.translator.get_registered_models()) == TEST_MODELS # Try to unregister a model that is not registered with pytest.raises(translator.NotRegistered): translator.translator.unregister(models.BasePage) # Try to get options for a model that is not registered with pytest.raises(translator.NotRegistered): translator.translator.get_options_for_model( models.ThirdPartyModel, ) # Ensure that a base can't be registered after a subclass. with pytest.raises(translator.DescendantRegistered): translator.translator.register(models.BasePage) # Or unregistered before it. with pytest.raises(translator.DescendantRegistered): translator.translator.unregister(models.Slugged) def test_registration_field_conflicts(self): before = len(translator.translator.get_registered_models()) # Exception should be raised when conflicting field name detected with pytest.raises(ValueError): translator.translator.register(models.ConflictModel, fields=("title",)) with pytest.raises(ValueError): translator.translator.register( models.AbstractConflictModelB, fields=("title",), ) with pytest.raises(ValueError): translator.translator.register( models.MultitableConflictModelB, fields=("title",), ) # Model should not be registered assert len(translator.translator.get_registered_models()) == before def test_fields(self): field_names = dir(models.TestModel()) assert "id" in field_names assert "title" in field_names assert "title_de" in field_names assert "title_en" in field_names assert "text" in field_names assert "text_de" in field_names assert "text_en" in field_names assert "url" in field_names assert "url_de" in field_names assert "url_en" in field_names assert "email" in field_names assert "email_de" in field_names assert "email_en" in field_names def test_verbose_name(self): verbose_name = models.TestModel._meta.get_field("title_de").verbose_name assert verbose_name == "title [de]" def test_custom_verbose_name(self): def get_verbose_name(verbose_name, language): return f"({language}) {verbose_name}" with reload_override_settings( MODELTRANSLATION_BUILD_LOCALIZED_VERBOSE_NAME=get_verbose_name ): verbose_name = models.TestModel._meta.get_field("title_de").verbose_name assert verbose_name == "(de) title" def test_descriptor_introspection(self): # See Django #8248 assert isinstance(models.TestModel.title.__doc__, str), ( "Descriptor accessed on class should return itself." ) def test_fields_hashes(self): opts = models.TestModel._meta orig = opts.get_field("title") en = opts.get_field("title_en") de = opts.get_field("title_de") # Translation field retain creation_counters assert orig.creation_counter == en.creation_counter assert orig.creation_counter == de.creation_counter # But they compare unequal assert orig != en assert orig != de assert en != de # Their hashes too assert hash(orig) != hash(en) assert hash(orig) != hash(de) assert hash(en) != hash(de) assert 3 == len({orig, en, de}) # TranslationFields can compare equal if they have the same language de.language = "en" assert orig != de assert en == de assert hash(en) == hash(de) assert 2 == len({orig, en, de}) de.language = "de" def test_set_translation(self): """This test briefly shows main modeltranslation features.""" assert get_language() == "de" title_de = "title de" title_en = "title en" # The original field "title" passed in the constructor is # populated for the current language field: "title_de". inst2 = models.TestModel(title=title_de) assert inst2.title == title_de assert inst2.title_en is None assert inst2.title_de == title_de # So creating object is language-aware with override("en"): inst2 = models.TestModel(title=title_en) assert inst2.title == title_en assert inst2.title_en == title_en assert inst2.title_de is None # Value from original field is presented in current language: inst2 = models.TestModel(title_de=title_de, title_en=title_en) assert inst2.title == title_de with override("en"): assert inst2.title == title_en # Changes made via original field affect current language field: inst2.title = "foo" assert inst2.title == "foo" assert inst2.title_en == title_en assert inst2.title_de == "foo" with override("en"): inst2.title = "bar" assert inst2.title == "bar" assert inst2.title_en == "bar" assert inst2.title_de == "foo" assert inst2.title == "foo" # When conflict, language field wins with original field inst2 = models.TestModel(title="foo", title_de=title_de, title_en=title_en) assert inst2.title == title_de assert inst2.title_en == title_en assert inst2.title_de == title_de # Creating model and assigning only one language inst1 = models.TestModel(title_en=title_en) # Please note: '' and not None, because descriptor falls back to field default value assert inst1.title == "" assert inst1.title_en == title_en assert inst1.title_de is None # Assign current language value - de inst1.title = title_de assert inst1.title == title_de assert inst1.title_en == title_en assert inst1.title_de == title_de inst1.save() # Check that the translation fields are correctly saved and provide the # correct value when retrieving them again. n = models.TestModel.objects.get(title=title_de) assert n.title == title_de assert n.title_en == title_en assert n.title_de == title_de assert_db_record(n, title=title_de, title_de=title_de, title_en=title_en) # Queries are also language-aware: assert 1 == models.TestModel.objects.filter(title=title_de).count() with override("en"): assert 0 == models.TestModel.objects.filter(title=title_de).count() def test_fallback_language(self): # Present what happens if current language field is empty assert get_language() == "de" title_de = "title de" # Create model with value in de only... inst2 = models.TestModel(title=title_de) assert inst2.title == title_de assert inst2.title_en is None assert inst2.title_de == title_de # In this test environment, fallback language is not set. So return value for en # will be field's default: '' with override("en"): assert inst2.title == "" assert inst2.title_en is None # Language field access returns real value # However, by default FALLBACK_LANGUAGES is set to DEFAULT_LANGUAGE with default_fallback(): # No change here... assert inst2.title == title_de # ... but for empty en fall back to de with override("en"): assert inst2.title == title_de assert inst2.title_en is None # Still real value def test_fallback_values_1(self): """ If ``fallback_values`` is set to string, all untranslated fields would return this string. """ title1_de = "title de" n = models.FallbackModel(title=title1_de) n.save() n = models.FallbackModel.objects.get(title=title1_de) assert n.title == title1_de trans_real.activate("en") assert n.title == "fallback" def test_fallback_values_2(self): """ If ``fallback_values`` is set to ``dict``, all untranslated fields in ``dict`` would return this mapped value. Fields not in ``dict`` would return default translation. """ title1_de = "title de" text1_de = "text in german" n = models.FallbackModel2(title=title1_de, text=text1_de) n.save() n = models.FallbackModel2.objects.get(title=title1_de) trans_real.activate("en") assert n.title == "" # Falling back to default field value assert n.text == translation.FallbackModel2TranslationOptions.fallback_values["text"] def _compare_instances(self, x, y, field): assert getattr(x, field) == getattr(y, field), "Constructor diff on field %s." % field def _test_constructor(self, keywords): n = models.TestModel(**keywords) m = models.TestModel.objects.create(**keywords) opts = translator.translator.get_options_for_model(models.TestModel) for base_field, trans_fields in opts.all_fields.items(): self._compare_instances(n, m, base_field) for lang_field in trans_fields: self._compare_instances(n, m, lang_field.name) def test_constructor(self): """ Ensure that model constructor behaves exactly the same as objects.create """ # test different arguments compositions keywords = dict( # original only title="title", # both languages + original email="q@q.qq", email_de="d@d.dd", email_en="e@e.ee", # both languages without original text_en="text en", text_de="text de", ) self._test_constructor(keywords) keywords = dict( # only current language title_de="title", # only not current language url_en="http://www.google.com", # original + current text="text def", text_de="text de", # original + not current email="q@q.qq", email_en="e@e.ee", ) self._test_constructor(keywords) @parameterized.expand( [ ({"title": "DE"}, ["title"], {"title": "DE", "title_de": "DE", "title_en": None}), ({"title_de": "DE"}, ["title"], {"title": "DE", "title_de": "DE", "title_en": None}), ({"title": "DE"}, ["title_de"], {"title": "old", "title_de": "DE", "title_en": None}), ( {"title_de": "DE"}, ["title_de"], {"title": "old", "title_de": "DE", "title_en": None}, ), ( {"title": "DE", "title_en": "EN"}, ["title", "title_en"], {"title": "DE", "title_de": "DE", "title_en": "EN"}, ), ( {"title_de": "DE", "title_en": "EN"}, ["title_de", "title_en"], {"title": "old", "title_de": "DE", "title_en": "EN"}, ), ( {"title_de": "DE", "title_en": "EN"}, ["title", "title_de", "title_en"], {"title": "DE", "title_de": "DE", "title_en": "EN"}, ), ] ) def test_save_original_translation_field(self, field_values, update_fields, expected_db_values): obj = models.TestModel.objects.create(title="old") for field, value in field_values.items(): setattr(obj, field, value) obj.save(update_fields=update_fields) assert_db_record(obj, **expected_db_values) @parameterized.expand( [ ({"title": "EN"}, ["title"], {"title": "EN", "title_de": None, "title_en": "EN"}), ({"title_en": "EN"}, ["title"], {"title": "EN", "title_de": None, "title_en": "EN"}), ({"title": "EN"}, ["title_en"], {"title": "old", "title_de": None, "title_en": "EN"}), ( {"title_en": "EN"}, ["title_en"], {"title": "old", "title_de": None, "title_en": "EN"}, ), ( {"title": "EN", "title_de": "DE"}, ["title", "title_de"], {"title": "EN", "title_de": "DE", "title_en": "EN"}, ), ( {"title_de": "DE", "title_en": "EN"}, ["title_de", "title_en"], {"title": "old", "title_de": "DE", "title_en": "EN"}, ), ( {"title_de": "DE", "title_en": "EN"}, ["title", "title_de", "title_en"], {"title": "EN", "title_de": "DE", "title_en": "EN"}, ), ] ) def test_save_active_translation_field(self, field_values, update_fields, expected_db_values): with override("en"): obj = models.TestModel.objects.create(title="old") for field, value in field_values.items(): setattr(obj, field, value) obj.save(update_fields=update_fields) assert_db_record(obj, **expected_db_values) def test_save_non_original_translation_field(self): obj = models.TestModel.objects.create(title="old") obj.title_en = "en value" obj.save(update_fields=["title"]) assert_db_record(obj, title="old", title_de="old", title_en=None) obj.save(update_fields=["title_en"]) assert_db_record(obj, title="old", title_de="old", title_en="en value") def test_update_or_create_existing(self): """ Test that update_or_create works as expected """ obj = models.TestModel.objects.create(title_de="old de", title_en="old en") instance, created = models.TestModel.objects.update_or_create( pk=obj.pk, defaults={"title": "NEW DE TITLE"} ) assert created is False assert instance.title == "NEW DE TITLE" assert instance.title_en == "old en" assert instance.title_de == "NEW DE TITLE" assert_db_record( instance, title="NEW DE TITLE", title_en="old en", title_de="NEW DE TITLE", ) instance, created = models.TestModel.objects.update_or_create( pk=obj.pk, defaults={"title_de": "NEW DE TITLE 2"} ) assert created is False assert instance.title == "NEW DE TITLE 2" assert instance.title_en == "old en" assert instance.title_de == "NEW DE TITLE 2" assert_db_record( instance, # title='NEW DE TITLE', # TODO: django < 4.2 doesn't pass `"title"` into `.save(update_fields)` title_en="old en", title_de="NEW DE TITLE 2", ) with override("en"): instance, created = models.TestModel.objects.update_or_create( pk=obj.pk, defaults={"title": "NEW EN TITLE"} ) assert created is False assert instance.title == "NEW EN TITLE" assert instance.title_en == "NEW EN TITLE" assert instance.title_de == "NEW DE TITLE 2" assert_db_record( instance, title="NEW EN TITLE", title_en="NEW EN TITLE", title_de="NEW DE TITLE 2", ) def test_update_or_create_new(self): instance, created = models.TestModel.objects.update_or_create( pk=1, defaults={"title_de": "old de", "title_en": "old en"}, ) assert created is True assert instance.title == "old de" assert instance.title_en == "old en" assert instance.title_de == "old de" assert_db_record( instance, title="old de", title_en="old en", title_de="old de", ) def test_callable_field_default_uses_field_language(self): # the test uses translations from django.contrib.auth django.po file by # specifying a model default with one of the translatable literals from that # app # unsaved instance must follow django's behaviour for callable default raw_instance = models.TestModel() assert raw_instance.dynamic_default == "Passwort" assert raw_instance.dynamic_default_en == "password" assert raw_instance.dynamic_default_de == "Passwort" # saved instance must have same behaviour as unsaved instance instance = models.TestModel.objects.create() assert instance.dynamic_default == "Passwort" assert instance.dynamic_default_en == "password" assert instance.dynamic_default_de == "Passwort" assert_db_record( instance, dynamic_default="Passwort", dynamic_default_en="password", dynamic_default_de="Passwort", ) class ModeltranslationTransactionTest(ModeltranslationTransactionTestBase): def test_unique_nullable_field(self): from django.db import transaction models.UniqueNullableModel.objects.create() models.UniqueNullableModel.objects.create() models.UniqueNullableModel.objects.create(title=None) models.UniqueNullableModel.objects.create(title=None) models.UniqueNullableModel.objects.create(title="") with pytest.raises(IntegrityError): models.UniqueNullableModel.objects.create(title="") transaction.rollback() # Postgres models.UniqueNullableModel.objects.create(title="foo") with pytest.raises(IntegrityError): models.UniqueNullableModel.objects.create(title="foo") transaction.rollback() # Postgres class FallbackTests(ModeltranslationTestBase): test_fallback = {"default": ("de",), "de": ("en",)} def test_settings(self): # Initial assert mt_settings.FALLBACK_LANGUAGES == {"default": ()} # Tuple/list with reload_override_settings(MODELTRANSLATION_FALLBACK_LANGUAGES=("de",)): assert mt_settings.FALLBACK_LANGUAGES == {"default": ("de",)} # Whole dict with reload_override_settings(MODELTRANSLATION_FALLBACK_LANGUAGES=self.test_fallback): assert mt_settings.FALLBACK_LANGUAGES == self.test_fallback # Improper language raises error config = {"default": (), "fr": ("en",)} with override_settings(MODELTRANSLATION_FALLBACK_LANGUAGES=config): with pytest.raises(ImproperlyConfigured): importlib.reload(mt_settings) importlib.reload(mt_settings) def test_resolution_order(self): from modeltranslation.utils import resolution_order with reload_override_settings(MODELTRANSLATION_FALLBACK_LANGUAGES=self.test_fallback): assert ("en", "de") == resolution_order("en") assert ("de", "en") == resolution_order("de") # Overriding config = {"default": ()} assert ("en",) == resolution_order("en", config) assert ("de", "en") == resolution_order("de", config) # Uniqueness config = {"de": ("en", "de")} assert ("en", "de") == resolution_order("en", config) assert ("de", "en") == resolution_order("de", config) # Default fallbacks are always used at the end # That's it: fallbacks specified for a language don't replace defaults, # but just are prepended config = {"default": ("en", "de"), "de": ()} assert ("en", "de") == resolution_order("en", config) assert ("de", "en") == resolution_order("de", config) # What one may have expected assert ("de",) != resolution_order("de", config) # To completely override settings, one should override all keys config = {"default": (), "de": ()} assert ("en",) == resolution_order("en", config) assert ("de",) == resolution_order("de", config) def test_fallback_languages(self): with reload_override_settings(MODELTRANSLATION_FALLBACK_LANGUAGES=self.test_fallback): title_de = "title de" title_en = "title en" n = models.TestModel(title=title_de) assert n.title_de == title_de assert n.title_en is None assert n.title == title_de trans_real.activate("en") assert n.title == title_de # since default fallback is de n = models.TestModel(title=title_en) assert n.title_de is None assert n.title_en == title_en assert n.title == title_en trans_real.activate("de") assert n.title == title_en # since fallback for de is en n.title_en = None assert n.title == "" # if all fallbacks fail, return field.get_default() def test_fallbacks_toggle(self): with reload_override_settings(MODELTRANSLATION_FALLBACK_LANGUAGES=self.test_fallback): m = models.TestModel(title="foo") with fallbacks(True): assert m.title_de == "foo" assert m.title_en is None assert m.title == "foo" with override("en"): assert m.title == "foo" with fallbacks(False): assert m.title_de == "foo" assert m.title_en is None assert m.title == "foo" with override("en"): assert m.title == "" # '' is the default def test_fallback_undefined(self): """ Checks if a sensible value is considered undefined and triggers fallbacks. Tests if the value can be overridden as documented. """ with reload_override_settings(MODELTRANSLATION_FALLBACK_LANGUAGES=self.test_fallback): # Non-nullable CharField falls back on empty strings. m = models.FallbackModel(title_en="value", title_de="") with override("en"): assert m.title == "value" with override("de"): assert m.title == "value" # Nullable CharField does not fall back on empty strings. m = models.FallbackModel(description_en="value", description_de="") with override("en"): assert m.description == "value" with override("de"): assert m.description == "" # Nullable CharField does fall back on None. m = models.FallbackModel(description_en="value", description_de=None) with override("en"): assert m.description == "value" with override("de"): assert m.description == "value" # The undefined value may be overridden. m = models.FallbackModel2(title_en="value", title_de="") with override("en"): assert m.title == "value" with override("de"): assert m.title == "" m = models.FallbackModel2(title_en="value", title_de="no title") with override("en"): assert m.title == "value" with override("de"): assert m.title == "value" class FileFieldsTest(ModeltranslationTestBase): def tearDown(self): if default_storage.exists("modeltranslation_tests"): # With FileSystemStorage uploading files creates a new directory, # that's not automatically removed upon their deletion. tests_dir = default_storage.path("modeltranslation_tests") if os.path.isdir(tests_dir): shutil.rmtree(tests_dir) super().tearDown() def test_translated_models(self): field_names = dir(models.FileFieldsModel()) assert "id" in field_names assert "title" in field_names assert "title_de" in field_names assert "title_en" in field_names assert "file" in field_names assert "file_de" in field_names assert "file_en" in field_names assert "image" in field_names assert "image_de" in field_names assert "image_en" in field_names def _file_factory(self, name, content): try: return ContentFile(content, name=name) except TypeError: # In Django 1.3 ContentFile had no name parameter file = ContentFile(content) file.name = name return file def test_translated_models_instance(self): inst = models.FileFieldsModel(title="Testtitle") trans_real.activate("en") inst.title = "title_en" inst.file = "a_en" inst.file.save("b_en", ContentFile("file in english")) inst.image = self._file_factory("i_en.jpg", "image in english") # Direct assign trans_real.activate("de") inst.title = "title_de" inst.file = "a_de" inst.file.save("b_de", ContentFile("file in german")) inst.image = self._file_factory("i_de.jpg", "image in german") inst.save() trans_real.activate("en") assert inst.title == "title_en" assert inst.file.name.count("b_en") > 0 assert inst.file.read() == b"file in english" assert inst.image.name.count("i_en") > 0 assert inst.image.read() == b"image in english" # Check if file was actually created in the global storage. assert default_storage.exists(inst.file.path) assert inst.file.size > 0 assert default_storage.exists(inst.image.path) assert inst.image.size > 0 trans_real.activate("de") assert inst.title == "title_de" assert inst.file.name.count("b_de") > 0 assert inst.file.read() == b"file in german" assert inst.image.name.count("i_de") > 0 assert inst.image.read() == b"image in german" inst.file_en.delete() inst.image_en.delete() inst.file_de.delete() inst.image_de.delete() def test_empty_field(self): from django.db.models.fields.files import FieldFile inst = models.FileFieldsModel() assert isinstance(inst.file, FieldFile) assert isinstance(inst.file2, FieldFile) inst.save() inst = models.FileFieldsModel.objects.all()[0] assert isinstance(inst.file, FieldFile) assert isinstance(inst.file2, FieldFile) def test_fallback(self): from django.db.models.fields.files import FieldFile with reload_override_settings(MODELTRANSLATION_FALLBACK_LANGUAGES=("en",)): assert get_language() == "de" inst = models.FileFieldsModel() inst.file_de = "" inst.file_en = "foo" inst.file2_de = "" inst.file2_en = "bar" assert isinstance(inst.file, FieldFile) assert isinstance(inst.file2, FieldFile) assert inst.file.name == "foo" assert inst.file2.name == "bar" inst.save() inst = models.FileFieldsModel.objects.all()[0] assert isinstance(inst.file, FieldFile) assert isinstance(inst.file2, FieldFile) assert inst.file.name == "foo" assert inst.file2.name == "bar" class ForeignKeyFieldsTest(ModeltranslationTestBase): @classmethod def setUpClass(cls): # 'model' attribute cannot be assigned to class in its definition, # because ``models`` module will be reloaded and hence class would use old model classes. super().setUpClass() cls.model = models.ForeignKeyModel def test_translated_models(self): field_names = dir(self.model()) assert "id" in field_names for f in ("test", "test_de", "test_en", "optional", "optional_en", "optional_de"): assert f in field_names assert "%s_id" % f in field_names def test_db_column_names(self): meta = self.model._meta # Make sure the correct database columns always get used: attname, col = meta.get_field("test").get_attname_column() assert attname == "test_id" assert attname == col attname, col = meta.get_field("test_en").get_attname_column() assert attname == "test_en_id" assert attname == col attname, col = meta.get_field("test_de").get_attname_column() assert attname == "test_de_id" assert attname == col def test_translated_models_instance(self): instance1 = models.TestModel(title_en="title1_en", title_de="title1_de") instance1.save() instance2 = models.TestModel(title_en="title2_en", title_de="title2_de") instance2.save() inst = self.model() trans_real.activate("de") inst.test = instance1 inst.optional = None trans_real.activate("en") # Test assigning relation by ID: inst.optional_id = instance2.pk inst.save() trans_real.activate("de") assert inst.test_id == instance1.pk assert inst.test.title == "title1_de" assert inst.test_de_id == instance1.pk assert inst.test_de.title == "title1_de" assert inst.optional is None # Test fallbacks: trans_real.activate("en") with default_fallback(): assert inst.test_id == instance1.pk assert inst.test.pk == instance1.pk assert inst.test.title == "title1_en" # Test English: assert inst.optional_id == instance2.pk assert inst.optional.title == "title2_en" assert inst.optional_en_id == instance2.pk assert inst.optional_en.title == "title2_en" # Test caching inst.test_en = instance2 inst.save() trans_real.activate("de") assert inst.test == instance1 trans_real.activate("en") assert inst.test == instance2 # Check filtering in direct way + lookup spanning manager = self.model.objects trans_real.activate("de") assert manager.filter(test=instance1).count() == 1 assert manager.filter(test_en=instance1).count() == 0 assert manager.filter(test_de=instance1).count() == 1 assert manager.filter(test=instance2).count() == 0 assert manager.filter(test_en=instance2).count() == 1 assert manager.filter(test_de=instance2).count() == 0 assert manager.filter(test__title="title1_de").count() == 1 assert manager.filter(test__title="title1_en").count() == 0 assert manager.filter(test__title_en="title1_en").count() == 1 trans_real.activate("en") assert manager.filter(test=instance1).count() == 0 assert manager.filter(test_en=instance1).count() == 0 assert manager.filter(test_de=instance1).count() == 1 assert manager.filter(test=instance2).count() == 1 assert manager.filter(test_en=instance2).count() == 1 assert manager.filter(test_de=instance2).count() == 0 assert manager.filter(test__title="title2_en").count() == 1 assert manager.filter(test__title="title2_de").count() == 0 assert manager.filter(test__title_de="title2_de").count() == 1 def test_reverse_relations(self): instance = models.TestModel(title_en="title_en", title_de="title_de") instance.save() # Instantiate many 'ForeignKeyModel' instances: fk_inst_both = self.model( title_en="f_title_en", title_de="f_title_de", test_de=instance, test_en=instance ) fk_inst_both.save() fk_inst_de = self.model( title_en="f_title_en", title_de="f_title_de", test_de_id=instance.pk ) fk_inst_de.save() fk_inst_en = self.model(title_en="f_title_en", title_de="f_title_de", test_en=instance) fk_inst_en.save() fk_option_de = self.model.objects.create(optional_de=instance) fk_option_en = self.model.objects.create(optional_en=instance) # Check that the reverse accessors are created on the model: # Explicit related_name testmodel_fields = get_field_names(models.TestModel) testmodel_methods = set(dir(models.TestModel)) assert {"test_fks", "test_fks_de", "test_fks_en"} <= testmodel_fields assert {"test_fks", "test_fks_de", "test_fks_en"} <= testmodel_methods # Implicit related_name: manager descriptor name != query field name assert {"foreignkeymodel", "foreignkeymodel_de", "foreignkeymodel_en"} <= testmodel_fields assert { "foreignkeymodel_set", "foreignkeymodel_set_de", "foreignkeymodel_set_en", } <= testmodel_methods # Check the German reverse accessor: assert fk_inst_both in instance.test_fks_de.all() assert fk_inst_de in instance.test_fks_de.all() assert fk_inst_en not in instance.test_fks_de.all() # Check the English reverse accessor: assert fk_inst_both in instance.test_fks_en.all() assert fk_inst_en in instance.test_fks_en.all() assert fk_inst_de not in instance.test_fks_en.all() # Check the default reverse accessor: trans_real.activate("de") assert fk_inst_de in instance.test_fks.all() assert fk_inst_en not in instance.test_fks.all() trans_real.activate("en") assert fk_inst_en in instance.test_fks.all() assert fk_inst_de not in instance.test_fks.all() # Check implicit related_name reverse accessor: assert fk_option_en in instance.foreignkeymodel_set.all() # Check filtering in reverse way + lookup spanning: manager = models.TestModel.objects trans_real.activate("de") assert manager.filter(test_fks=fk_inst_both).count() == 1 assert manager.filter(test_fks=fk_inst_de).count() == 1 assert manager.filter(test_fks__id=fk_inst_de.pk).count() == 1 assert manager.filter(test_fks=fk_inst_en).count() == 0 assert manager.filter(test_fks_en=fk_inst_en).count() == 1 assert manager.filter(foreignkeymodel=fk_option_de).count() == 1 assert manager.filter(foreignkeymodel=fk_option_en).count() == 0 assert manager.filter(foreignkeymodel_en=fk_option_en).count() == 1 assert manager.filter(test_fks__title="f_title_de").distinct().count() == 1 assert manager.filter(test_fks__title="f_title_en").distinct().count() == 0 assert manager.filter(test_fks__title_en="f_title_en").distinct().count() == 1 trans_real.activate("en") assert manager.filter(test_fks=fk_inst_both).count() == 1 assert manager.filter(test_fks=fk_inst_en).count() == 1 assert manager.filter(test_fks__id=fk_inst_en.pk).count() == 1 assert manager.filter(test_fks=fk_inst_de).count() == 0 assert manager.filter(test_fks_de=fk_inst_de).count() == 1 assert manager.filter(foreignkeymodel=fk_option_en).count() == 1 assert manager.filter(foreignkeymodel=fk_option_de).count() == 0 assert manager.filter(foreignkeymodel_de=fk_option_de).count() == 1 assert manager.filter(test_fks__title="f_title_en").distinct().count() == 1 assert manager.filter(test_fks__title="f_title_de").distinct().count() == 0 assert manager.filter(test_fks__title_de="f_title_de").distinct().count() == 1 # Check assignment trans_real.activate("de") instance2 = models.TestModel(title_en="title_en", title_de="title_de") instance2.save() instance2.test_fks.set((fk_inst_de, fk_inst_both)) instance2.test_fks_en.set((fk_inst_en, fk_inst_both)) assert fk_inst_both.test.pk == instance2.pk assert fk_inst_both.test_id == instance2.pk assert fk_inst_both.test_de == instance2 assert set(instance2.test_fks_de.all()) == set(instance2.test_fks.all()) assert fk_inst_both in instance2.test_fks.all() assert fk_inst_de in instance2.test_fks.all() assert fk_inst_en not in instance2.test_fks.all() trans_real.activate("en") assert set(instance2.test_fks_en.all()) == set(instance2.test_fks.all()) assert fk_inst_both in instance2.test_fks.all() assert fk_inst_en in instance2.test_fks.all() assert fk_inst_de not in instance2.test_fks.all() def test_reverse_lookup_with_filtered_queryset_manager(self): """ Make sure base_manager does not get same queryset filter as TestModel in reverse lookup https://docs.djangoproject.com/en/3.0/topics/db/managers/#base-managers """ from modeltranslation.tests.models import FilteredManager instance = models.FilteredTestModel(title_en="title_en", title_de="title_de") instance.save() assert not models.FilteredTestModel.objects.all().exists() assert models.FilteredTestModel.objects.__class__ == FilteredManager assert models.FilteredTestModel._meta.base_manager.__class__ == MultilingualManager # # create objects with relations to instance fk_inst = models.ForeignKeyFilteredModel( test=instance, title_en="f_title_en", title_de="f_title_de" ) fk_inst.save() fk_inst.refresh_from_db() # force to reset cached values assert models.ForeignKeyFilteredModel.objects.__class__ == MultilingualManager assert models.ForeignKeyFilteredModel._meta.base_manager.__class__ == MultilingualManager assert fk_inst.test == instance def test_non_translated_relation(self): non_de = models.NonTranslated.objects.create(title="title_de") non_en = models.NonTranslated.objects.create(title="title_en") fk_inst_both = self.model.objects.create( title_en="f_title_en", title_de="f_title_de", non_de=non_de, non_en=non_en ) fk_inst_de = self.model.objects.create(non_de=non_de) fk_inst_en = self.model.objects.create(non_en=non_en) # Forward relation + spanning manager = self.model.objects trans_real.activate("de") assert manager.filter(non=non_de).count() == 2 assert manager.filter(non=non_en).count() == 0 assert manager.filter(non_en=non_en).count() == 2 assert manager.filter(non__title="title_de").count() == 2 assert manager.filter(non__title="title_en").count() == 0 assert manager.filter(non_en__title="title_en").count() == 2 trans_real.activate("en") assert manager.filter(non=non_en).count() == 2 assert manager.filter(non=non_de).count() == 0 assert manager.filter(non_de=non_de).count() == 2 assert manager.filter(non__title="title_en").count() == 2 assert manager.filter(non__title="title_de").count() == 0 assert manager.filter(non_de__title="title_de").count() == 2 # Reverse relation + spanning manager = models.NonTranslated.objects trans_real.activate("de") assert manager.filter(test_fks=fk_inst_both).count() == 1 assert manager.filter(test_fks=fk_inst_de).count() == 1 assert manager.filter(test_fks=fk_inst_en).count() == 0 assert manager.filter(test_fks_en=fk_inst_en).count() == 1 assert manager.filter(test_fks__title="f_title_de").count() == 1 assert manager.filter(test_fks__title="f_title_en").count() == 0 assert manager.filter(test_fks__title_en="f_title_en").count() == 1 trans_real.activate("en") assert manager.filter(test_fks=fk_inst_both).count() == 1 assert manager.filter(test_fks=fk_inst_en).count() == 1 assert manager.filter(test_fks=fk_inst_de).count() == 0 assert manager.filter(test_fks_de=fk_inst_de).count() == 1 assert manager.filter(test_fks__title="f_title_en").count() == 1 assert manager.filter(test_fks__title="f_title_de").count() == 0 assert manager.filter(test_fks__title_de="f_title_de").count() == 1 def test_indonesian(self): field = models.ForeignKeyModel._meta.get_field("test") assert field.attname != build_localized_fieldname(field.name, "id") def test_build_lang(self): assert build_lang("en") == "en" assert build_lang("en_en") == "en_en" assert build_lang("en-en") == "en_en" assert build_lang("id") == "ind" class ManyToManyFieldsTest(ModeltranslationTestBase): @classmethod def setUpClass(cls): # 'model' attribute cannot be assigned to class in its definition, # because ``models`` module will be reloaded and hence class would use old model classes. super().setUpClass() cls.model = models.ManyToManyFieldModel def test_translated_models(self): field_names = dir(self.model()) assert "id" in field_names for f in ("test", "test_de", "test_en", "self_call_1", "self_call_1_en", "self_call_1_de"): assert f in field_names def test_db_column_names(self): meta = self.model._meta # Make sure the correct database columns always get used: field = meta.get_field("test") assert field.remote_field.through._meta.db_table == "tests_manytomanyfieldmodel_test" field = meta.get_field("test_en") assert field.remote_field.through._meta.db_table == "tests_manytomanyfieldmodel_test_en" field = meta.get_field("test_de") assert field.remote_field.through._meta.db_table == "tests_manytomanyfieldmodel_test_de" field = meta.get_field("self_call_1") assert field.remote_field.through._meta.db_table == "tests_manytomanyfieldmodel_self_call_1" field = meta.get_field("self_call_1_en") assert ( field.remote_field.through._meta.db_table == "tests_manytomanyfieldmodel_self_call_1_en" ) field = meta.get_field("self_call_1_de") assert ( field.remote_field.through._meta.db_table == "tests_manytomanyfieldmodel_self_call_1_de" ) field = meta.get_field("through_model") assert field.remote_field.through._meta.db_table == "tests_customthroughmodel" field = meta.get_field("through_model_en") assert field.remote_field.through._meta.db_table == "tests_customthroughmodel_en" field = meta.get_field("through_model_de") assert field.remote_field.through._meta.db_table == "tests_customthroughmodel_de" def test_translated_models_instance(self): models.TestModel.objects.bulk_create( models.TestModel(title_en="m2m_test_%s_en" % i, title_de="m2m_test_%s_de" % i) for i in range(10) ) self.model.objects.bulk_create( self.model(title_en="m2m_test_%s_en" % i, title_de="m2m_test_%s_de" % i) for i in range(10) ) models.NonTranslated.objects.bulk_create( models.NonTranslated(title="m2m_test_%s" % i) for i in range(10) ) testmodel_qs = models.TestModel.objects.all() testmodel_qs_1 = testmodel_qs.filter(title_en__in=["m2m_test_%s_en" % i for i in range(4)]) testmodel_qs_2 = testmodel_qs.filter( title_en__in=["m2m_test_%s_en" % i for i in range(4, 10)] ) untranslated_qs = models.NonTranslated.objects.all() self_qs = self.model.objects.all() self_qs_1 = self_qs.filter(title_en__in=["m2m_test_%s_en" % i for i in range(6)]) self_qs_2 = self_qs.filter(title_en__in=["m2m_test_%s_en" % i for i in range(6, 10)]) inst = self.model() inst.save() trans_real.activate("de") inst.test.set(list(testmodel_qs_1.values_list("pk", flat=True))) assert inst.test.through.objects.all().count() == testmodel_qs_1.count() inst.through_model.set(testmodel_qs_2) assert inst.through_model.through.objects.all().count() == testmodel_qs_2.count() inst.self_call_2.set(self_qs_1) assert inst.self_call_2.all().count() == self_qs_1.count() trans_real.activate("en") inst.trans_through_model.through.objects.bulk_create( ( inst.trans_through_model.through( title_en="m2m_test_%s_en" % (i + 1), title_de="m2m_test_%s_de" % (i + 1), rel_1_id=int(inst.pk), rel_2_id=tst_model.pk, ) for i, tst_model in enumerate(testmodel_qs[:2]) ) ) assert inst.trans_through_model.all().count() == 2 inst.untrans.set(untranslated_qs) assert inst.untrans.through.objects.all().count() == untranslated_qs.count() inst.self_call_1.set(self_qs_2) assert ( inst.self_call_1.filter(pk__in=self_qs_2.values_list("pk", flat=True)).count() == self_qs_2.count() ) trans_real.activate("de") assert inst.test.through.objects.all().count() == testmodel_qs_1.count() assert inst.through_model.through.objects.all().count() == testmodel_qs_2.count() assert inst.untrans.through.objects.count() == 0 assert inst.self_call_1.count() == 0 assert inst.trans_through_model == getattr(inst, "trans_through_model_de") # Test prevent fallbacks: trans_real.activate("en") with default_fallback(): assert inst.untrans.through.objects.all().count() == untranslated_qs.count() assert inst.trans_through_model == getattr(inst, "trans_through_model_en") # Test through properties and methods inheriance: trans_real.activate("de") through_inst = inst.through_model.through.objects.first() assert through_inst.test_property == "CustomThroughModel_de_%s" % inst.pk assert through_inst.test_method() == inst.pk + 1 # Check filtering in direct way + lookup spanning manager = self.model.objects trans_real.activate("de") assert manager.filter(test__in=testmodel_qs_1).distinct().count() == 1 assert manager.filter(test_en__in=testmodel_qs_1).distinct().count() == 0 assert manager.filter(test_de__in=testmodel_qs_1).distinct().count() == 1 assert ( manager.filter(through_model__title__in=testmodel_qs_2.values_list("title", flat=True)) .distinct() .count() == 1 ) assert ( manager.filter( through_model_en__title__in=testmodel_qs_2.values_list("title", flat=True) ).count() == 0 ) assert ( manager.filter( through_model_de__title__in=testmodel_qs_2.values_list("title", flat=True) ) .distinct() .count() == 1 ) assert manager.filter(self_call_2__in=self_qs_1).distinct().count() == 1 assert manager.filter(self_call_2_en__in=self_qs_1).count() == 0 assert manager.filter(self_call_2_de__in=self_qs_1).distinct().count() == 1 trans_real.activate("en") assert manager.filter(trans_through_model__in=testmodel_qs_1).distinct().count() == 1 assert manager.filter(trans_through_model_de__in=testmodel_qs_1).count() == 0 assert manager.filter(trans_through_model_en__in=testmodel_qs_1).distinct().count() == 1 assert manager.filter(untrans__in=untranslated_qs).distinct().count() == 1 assert manager.filter(untrans_de__in=untranslated_qs).count() == 0 assert manager.filter(untrans_en__in=untranslated_qs).distinct().count() == 1 assert manager.filter(self_call_1__in=self_qs_2).distinct().count() == 1 assert manager.filter(self_call_1_de__in=self_qs_2).count() == 0 assert manager.filter(self_call_1_en__in=self_qs_2).distinct().count() == 1 def test_reverse_relations(self): models.TestModel.objects.bulk_create( models.TestModel(title_en="m2m_test_%s_en" % i, title_de="m2m_test_%s_de" % i) for i in range(10) ) self.model.objects.bulk_create( self.model(title_en="m2m_test_%s_en" % i, title_de="m2m_test_%s_de" % i) for i in range(10) ) models.NonTranslated.objects.bulk_create( models.NonTranslated(title="m2m_test_%s" % i) for i in range(10) ) inst_both = self.model(title_en="inst_both_en", title_de="inst_both_de") inst_both.save() inst_en = self.model(title_en="inst_en_en", title_de="inst_en_de") inst_en.save() inst_de = self.model(title_en="inst_de_en", title_de="inst_de_de") inst_de.save() testmodel_qs = models.TestModel.objects.all() inst_both.test_en.set(testmodel_qs) inst_both.test_de.set(testmodel_qs) inst_en.test_en.set(testmodel_qs) inst_de.test_de.set(testmodel_qs) # Check that the reverse accessors are created on the model: # Explicit related_name testmodel_fields = get_field_names(models.TestModel) testmodel_methods = dir(models.TestModel) assert "m2m_test_ref" in testmodel_fields assert "m2m_test_ref_de" in testmodel_fields assert "m2m_test_ref_en" in testmodel_fields assert "m2m_test_ref" in testmodel_methods assert "m2m_test_ref_de" in testmodel_methods assert "m2m_test_ref_en" in testmodel_methods # Implicit related_name: manager descriptor name != query field name assert "customthroughmodel" in testmodel_fields assert "customthroughmodel_en" in testmodel_fields assert "customthroughmodel_de" in testmodel_fields assert "manytomanyfieldmodel_set" in testmodel_methods assert "manytomanyfieldmodel_en_set" in testmodel_methods assert "manytomanyfieldmodel_de_set" in testmodel_methods instance = models.TestModel.objects.first() # Check the German reverse accessor: assert inst_both in instance.m2m_test_ref_de.all() assert inst_de in instance.m2m_test_ref_de.all() assert inst_en not in instance.m2m_test_ref_de.all() # Check the English reverse accessor: assert inst_both in instance.m2m_test_ref_en.all() assert inst_en in instance.m2m_test_ref_en.all() assert inst_de not in instance.m2m_test_ref_en.all() # Check the default reverse accessor: trans_real.activate("de") assert inst_de in instance.m2m_test_ref.all() assert inst_en not in instance.m2m_test_ref.all() trans_real.activate("en") assert inst_en in instance.m2m_test_ref.all() assert inst_de not in instance.m2m_test_ref.all() # Check implicit related_name reverse accessor: inst_en.through_model.set(testmodel_qs) assert inst_en in instance.manytomanyfieldmodel_set.all() # Check filtering in reverse way + lookup spanning: manager = models.TestModel.objects trans_real.activate("de") assert manager.filter(m2m_test_ref__in=[inst_both]).count() == 10 assert manager.filter(m2m_test_ref__in=[inst_de]).count() == 10 assert manager.filter(m2m_test_ref__id__in=[inst_de.pk]).count() == 10 assert manager.filter(m2m_test_ref__in=[inst_en]).count() == 0 assert manager.filter(m2m_test_ref_en__in=[inst_en]).count() == 10 assert manager.filter(manytomanyfieldmodel__in=[inst_en]).count() == 0 assert manager.filter(manytomanyfieldmodel_en__in=[inst_en]).count() == 10 assert manager.filter(m2m_test_ref__title="inst_de_de").distinct().count() == 10 assert manager.filter(m2m_test_ref__title="inst_de_en").distinct().count() == 0 assert manager.filter(m2m_test_ref__title_en="inst_de_en").distinct().count() == 10 assert manager.filter(m2m_test_ref_en__title="inst_en_de").distinct().count() == 10 trans_real.activate("en") assert manager.filter(m2m_test_ref__in=[inst_both]).count() == 10 assert manager.filter(m2m_test_ref__in=[inst_en]).count() == 10 assert manager.filter(m2m_test_ref__id__in=[inst_en.pk]).count() == 10 assert manager.filter(m2m_test_ref__in=[inst_de]).count() == 0 assert manager.filter(m2m_test_ref_de__in=[inst_de]).count() == 10 assert manager.filter(manytomanyfieldmodel__in=[inst_en]).count() == 10 assert manager.filter(manytomanyfieldmodel__in=[inst_de]).count() == 0 assert manager.filter(manytomanyfieldmodel_de__in=[inst_de]).count() == 0 assert manager.filter(m2m_test_ref__title="inst_en_en").distinct().count() == 10 assert manager.filter(m2m_test_ref__title="inst_en_de").distinct().count() == 0 assert manager.filter(m2m_test_ref__title_de="inst_en_de").distinct().count() == 10 assert manager.filter(m2m_test_ref_de__title="inst_de_en").distinct().count() == 10 class OneToOneFieldsTest(ForeignKeyFieldsTest): @classmethod def setUpClass(cls): # 'model' attribute cannot be assigned to class in its definition, # because ``models`` module will be reloaded and hence class would use old model classes. super().setUpClass() cls.model = models.OneToOneFieldModel def test_uniqueness(self): instance1 = models.TestModel(title_en="title1_en", title_de="title1_de") instance1.save() inst = self.model() trans_real.activate("de") inst.test = instance1 trans_real.activate("en") # That's ok, since test_en is different than test_de inst.test = instance1 inst.save() # But this violates uniqueness constraint inst2 = self.model(test=instance1) with pytest.raises(IntegrityError): inst2.save() def test_reverse_relations(self): instance = models.TestModel(title_en="title_en", title_de="title_de") instance.save() # Instantiate many 'OneToOneFieldModel' instances: fk_inst_de = self.model( title_en="f_title_en", title_de="f_title_de", test_de_id=instance.pk ) fk_inst_de.save() fk_inst_en = self.model(title_en="f_title_en", title_de="f_title_de", test_en=instance) fk_inst_en.save() fk_option_de = self.model.objects.create(optional_de=instance) fk_option_en = self.model.objects.create(optional_en=instance) # Check that the reverse accessors are created on the model: # Explicit related_name testmodel_fields = get_field_names(models.TestModel) testmodel_methods = dir(models.TestModel) assert "test_o2o" in testmodel_fields assert "test_o2o_de" in testmodel_fields assert "test_o2o_en" in testmodel_fields assert "test_o2o" in testmodel_methods assert "test_o2o_de" in testmodel_methods assert "test_o2o_en" in testmodel_methods # Implicit related_name assert "onetoonefieldmodel" in testmodel_fields assert "onetoonefieldmodel_de" in testmodel_fields assert "onetoonefieldmodel_en" in testmodel_fields assert "onetoonefieldmodel" in testmodel_methods assert "onetoonefieldmodel_de" in testmodel_methods assert "onetoonefieldmodel_en" in testmodel_methods # Check the German reverse accessor: assert fk_inst_de == instance.test_o2o_de # Check the English reverse accessor: assert fk_inst_en == instance.test_o2o_en # Check the default reverse accessor: trans_real.activate("de") assert fk_inst_de == instance.test_o2o trans_real.activate("en") assert fk_inst_en == instance.test_o2o # Check implicit related_name reverse accessor: assert fk_option_en == instance.onetoonefieldmodel # Check filtering in reverse way + lookup spanning: manager = models.TestModel.objects trans_real.activate("de") assert manager.filter(test_o2o=fk_inst_de).count() == 1 assert manager.filter(test_o2o__id=fk_inst_de.pk).count() == 1 assert manager.filter(test_o2o=fk_inst_en).count() == 0 assert manager.filter(test_o2o_en=fk_inst_en).count() == 1 assert manager.filter(onetoonefieldmodel=fk_option_de).count() == 1 assert manager.filter(onetoonefieldmodel=fk_option_en).count() == 0 assert manager.filter(onetoonefieldmodel_en=fk_option_en).count() == 1 assert manager.filter(test_o2o__title="f_title_de").distinct().count() == 1 assert manager.filter(test_o2o__title="f_title_en").distinct().count() == 0 assert manager.filter(test_o2o__title_en="f_title_en").distinct().count() == 1 trans_real.activate("en") assert manager.filter(test_o2o=fk_inst_en).count() == 1 assert manager.filter(test_o2o__id=fk_inst_en.pk).count() == 1 assert manager.filter(test_o2o=fk_inst_de).count() == 0 assert manager.filter(test_o2o_de=fk_inst_de).count() == 1 assert manager.filter(onetoonefieldmodel=fk_option_en).count() == 1 assert manager.filter(onetoonefieldmodel=fk_option_de).count() == 0 assert manager.filter(onetoonefieldmodel_de=fk_option_de).count() == 1 assert manager.filter(test_o2o__title="f_title_en").distinct().count() == 1 assert manager.filter(test_o2o__title="f_title_de").distinct().count() == 0 assert manager.filter(test_o2o__title_de="f_title_de").distinct().count() == 1 # Check assignment trans_real.activate("de") instance2 = models.TestModel(title_en="title_en", title_de="title_de") instance2.save() instance2.test_o2o = fk_inst_de instance2.test_o2o_en = fk_inst_en assert fk_inst_de.test.pk == instance2.pk assert fk_inst_de.test_id == instance2.pk assert fk_inst_de.test_de == instance2 assert instance2.test_o2o_de == instance2.test_o2o assert fk_inst_de == instance2.test_o2o trans_real.activate("en") assert fk_inst_en.test.pk == instance2.pk assert fk_inst_en.test_id == instance2.pk assert fk_inst_en.test_en == instance2 assert instance2.test_o2o_en == instance2.test_o2o assert fk_inst_en == instance2.test_o2o def test_non_translated_relation(self): non_de = models.NonTranslated.objects.create(title="title_de") non_en = models.NonTranslated.objects.create(title="title_en") fk_inst_de = self.model.objects.create( title_en="f_title_en", title_de="f_title_de", non_de=non_de ) fk_inst_en = self.model.objects.create( title_en="f_title_en2", title_de="f_title_de2", non_en=non_en ) # Forward relation + spanning manager = self.model.objects trans_real.activate("de") assert manager.filter(non=non_de).count() == 1 assert manager.filter(non=non_en).count() == 0 assert manager.filter(non_en=non_en).count() == 1 assert manager.filter(non__title="title_de").count() == 1 assert manager.filter(non__title="title_en").count() == 0 assert manager.filter(non_en__title="title_en").count() == 1 trans_real.activate("en") assert manager.filter(non=non_en).count() == 1 assert manager.filter(non=non_de).count() == 0 assert manager.filter(non_de=non_de).count() == 1 assert manager.filter(non__title="title_en").count() == 1 assert manager.filter(non__title="title_de").count() == 0 assert manager.filter(non_de__title="title_de").count() == 1 # Reverse relation + spanning manager = models.NonTranslated.objects trans_real.activate("de") assert manager.filter(test_o2o=fk_inst_de).count() == 1 assert manager.filter(test_o2o=fk_inst_en).count() == 0 assert manager.filter(test_o2o_en=fk_inst_en).count() == 1 assert manager.filter(test_o2o__title="f_title_de").count() == 1 assert manager.filter(test_o2o__title="f_title_en").count() == 0 assert manager.filter(test_o2o__title_en="f_title_en").count() == 1 trans_real.activate("en") assert manager.filter(test_o2o=fk_inst_en).count() == 1 assert manager.filter(test_o2o=fk_inst_de).count() == 0 assert manager.filter(test_o2o_de=fk_inst_de).count() == 1 assert manager.filter(test_o2o__title="f_title_en2").count() == 1 assert manager.filter(test_o2o__title="f_title_de2").count() == 0 assert manager.filter(test_o2o__title_de="f_title_de2").count() == 1 class OtherFieldsTest(ModeltranslationTestBase): def test_translated_models(self): inst = models.OtherFieldsModel.objects.create() field_names = dir(inst) assert "id" in field_names assert "int" in field_names assert "int_de" in field_names assert "int_en" in field_names assert "boolean" in field_names assert "boolean_de" in field_names assert "boolean_en" in field_names assert "genericip" in field_names assert "genericip_de" in field_names assert "genericip_en" in field_names assert "float" in field_names assert "float_de" in field_names assert "float_en" in field_names assert "decimal" in field_names assert "decimal_de" in field_names assert "decimal_en" in field_names assert "json" in field_names assert "json_de" in field_names assert "json_en" in field_names inst.delete() def test_translated_models_integer_instance(self): inst = models.OtherFieldsModel() inst.int = 7 assert "de" == get_language() assert 7 == inst.int assert 7 == inst.int_de assert 42 == inst.int_en # default value is honored inst.int += 2 inst.save() assert 9 == inst.int assert 9 == inst.int_de assert 42 == inst.int_en trans_real.activate("en") inst.int -= 1 assert 41 == inst.int assert 9 == inst.int_de assert 41 == inst.int_en # this field has validator - let's try to make it below 0! inst.int -= 50 with pytest.raises(ValidationError): inst.full_clean() def test_translated_models_boolean_instance(self): inst = models.OtherFieldsModel() inst.boolean = True assert "de" == get_language() assert inst.boolean is True assert inst.boolean_de is True assert inst.boolean_en is False inst.boolean = False inst.save() assert inst.boolean is False assert inst.boolean_de is False assert inst.boolean_en is False trans_real.activate("en") inst.boolean = True assert inst.boolean is True assert inst.boolean_de is False assert inst.boolean_en is True def test_translated_models_genericipaddress_instance(self): inst = models.OtherFieldsModel() inst.genericip = "2a02:42fe::4" assert "de" == get_language() assert "2a02:42fe::4" == inst.genericip assert "2a02:42fe::4" == inst.genericip_de assert inst.genericip_en is None inst.genericip = "2a02:23fe::4" inst.save() assert "2a02:23fe::4" == inst.genericip assert "2a02:23fe::4" == inst.genericip_de assert inst.genericip_en is None trans_real.activate("en") inst.genericip = "2a02:42fe::4" assert "2a02:42fe::4" == inst.genericip assert "2a02:23fe::4" == inst.genericip_de assert "2a02:42fe::4" == inst.genericip_en # Check if validation is preserved inst.genericip = "1;2" with pytest.raises(ValidationError): inst.full_clean() def test_translated_models_float_instance(self): inst = models.OtherFieldsModel() inst.float = 0.42 assert "de" == get_language() assert 0.42 == inst.float assert 0.42 == inst.float_de assert inst.float_en is None inst.float = 0.23 inst.save() assert 0.23 == inst.float assert 0.23 == inst.float_de assert inst.float_en is None inst.float += 0.08 assert 0.31 == inst.float assert 0.31 == inst.float_de assert inst.float_en is None trans_real.activate("en") inst.float = 0.42 assert 0.42 == inst.float assert 0.31 == inst.float_de assert 0.42 == inst.float_en def test_translated_models_decimal_instance(self): inst = models.OtherFieldsModel() inst.decimal = Decimal("0.42") assert "de" == get_language() assert Decimal("0.42") == inst.decimal assert Decimal("0.42") == inst.decimal_de assert inst.decimal_en is None inst.decimal = inst.decimal - Decimal("0.19") inst.save() assert Decimal("0.23") == inst.decimal assert Decimal("0.23") == inst.decimal_de assert inst.decimal_en is None trans_real.activate("en") with pytest.raises(TypeError): inst.decimal + Decimal("0.19") assert inst.decimal is None assert Decimal("0.23") == inst.decimal_de assert inst.decimal_en is None inst.decimal = Decimal("0.42") assert Decimal("0.42") == inst.decimal assert Decimal("0.23") == inst.decimal_de assert Decimal("0.42") == inst.decimal_en def test_translated_models_date_instance(self): inst = models.OtherFieldsModel() inst.date = datetime.date(2012, 12, 31) assert "de" == get_language() assert datetime.date(2012, 12, 31) == inst.date assert datetime.date(2012, 12, 31) == inst.date_de assert inst.date_en is None inst.date = datetime.date(1999, 1, 1) inst.save() assert datetime.date(1999, 1, 1) == inst.date assert datetime.date(1999, 1, 1) == inst.date_de assert inst.date_en is None qs = models.OtherFieldsModel.objects.filter(date="1999-1-1") assert len(qs) == 1 assert qs[0].date == datetime.date(1999, 1, 1) trans_real.activate("en") inst.date = datetime.date(2012, 12, 31) assert datetime.date(2012, 12, 31) == inst.date assert datetime.date(1999, 1, 1) == inst.date_de assert datetime.date(2012, 12, 31) == inst.date_en def test_translated_models_datetime_instance(self): inst = models.OtherFieldsModel() inst.datetime = datetime.datetime(2012, 12, 31, 23, 42) assert "de" == get_language() assert datetime.datetime(2012, 12, 31, 23, 42) == inst.datetime assert datetime.datetime(2012, 12, 31, 23, 42) == inst.datetime_de assert inst.datetime_en is None inst.datetime = datetime.datetime(1999, 1, 1, 23, 42) inst.save() assert datetime.datetime(1999, 1, 1, 23, 42) == inst.datetime assert datetime.datetime(1999, 1, 1, 23, 42) == inst.datetime_de assert inst.datetime_en is None qs = models.OtherFieldsModel.objects.filter(datetime="1999-1-1 23:42") assert len(qs) == 1 assert qs[0].datetime == datetime.datetime(1999, 1, 1, 23, 42) trans_real.activate("en") inst.datetime = datetime.datetime(2012, 12, 31, 23, 42) assert datetime.datetime(2012, 12, 31, 23, 42) == inst.datetime assert datetime.datetime(1999, 1, 1, 23, 42) == inst.datetime_de assert datetime.datetime(2012, 12, 31, 23, 42) == inst.datetime_en def test_translated_models_time_instance(self): inst = models.OtherFieldsModel() inst.time = datetime.time(23, 42, 0) assert "de" == get_language() assert datetime.time(23, 42, 0) == inst.time assert datetime.time(23, 42, 0) == inst.time_de assert inst.time_en is None inst.time = datetime.time(1, 2, 3) inst.save() assert datetime.time(1, 2, 3) == inst.time assert datetime.time(1, 2, 3) == inst.time_de assert inst.time_en is None qs = models.OtherFieldsModel.objects.filter(time="01:02:03") assert len(qs) == 1 assert qs[0].time == datetime.time(1, 2, 3) trans_real.activate("en") inst.time = datetime.time(23, 42, 0) assert datetime.time(23, 42, 0) == inst.time assert datetime.time(1, 2, 3) == inst.time_de assert datetime.time(23, 42, 0) == inst.time_en def test_dates_queryset(self): Model = models.OtherFieldsModel Model.objects.create(datetime=datetime.datetime(2015, 9, 2, 0, 0)) Model.objects.create(datetime=datetime.datetime(2014, 8, 3, 0, 0)) Model.objects.create(datetime=datetime.datetime(2013, 7, 4, 0, 0)) qs = Model.objects.dates("datetime", "year", "DESC") assert list(qs) == [ datetime.date(2015, 1, 1), datetime.date(2014, 1, 1), datetime.date(2013, 1, 1), ] def test_descriptors(self): # Descriptor store ints in database and returns string of 'a' of that length inst = models.DescriptorModel() # Demonstrate desired behaviour inst.normal = 2 assert "aa" == inst.normal inst.normal = "abc" assert "aaa" == inst.normal # Descriptor on translated field works too assert "de" == get_language() inst.trans = 5 assert "aaaaa" == inst.trans inst.save() db_values = models.DescriptorModel.objects.raw_values("normal", "trans_en", "trans_de")[0] assert 3 == db_values["normal"] assert 5 == db_values["trans_de"] assert 0 == db_values["trans_en"] # Retrieval from db inst = models.DescriptorModel.objects.all()[0] assert "aaa" == inst.normal assert "aaaaa" == inst.trans assert "aaaaa" == inst.trans_de assert "" == inst.trans_en # Other language trans_real.activate("en") assert "" == inst.trans inst.trans = "q" assert "a" == inst.trans inst.trans_de = 4 assert "aaaa" == inst.trans_de inst.save() db_values = models.DescriptorModel.objects.raw_values("normal", "trans_en", "trans_de")[0] assert 3 == db_values["normal"] assert 4 == db_values["trans_de"] assert 1 == db_values["trans_en"] class ModeltranslationTestRule1(ModeltranslationTestBase): """ Rule 1: Reading the value from the original field returns the value in translated to the current language. """ def _test_field(self, field_name, value_de, value_en, deactivate=True): field_name_de = "%s_de" % field_name field_name_en = "%s_en" % field_name params = {field_name_de: value_de, field_name_en: value_en} n = models.TestModel.objects.create(**params) trans_real.activate("de") # Language is set to 'de' at this point assert get_language() == "de" assert getattr(n, field_name) == value_de assert getattr(n, field_name_de) == value_de assert getattr(n, field_name_en) == value_en # Now switch to "en" trans_real.activate("en") assert get_language() == "en" # Should now be return the english one (just by switching the language) assert getattr(n, field_name) == value_en # But explicit language fields hold their values assert getattr(n, field_name_de) == value_de assert getattr(n, field_name_en) == value_en n = models.TestModel.objects.create(**params) n.save() # Language is set to "en" at this point assert get_language() == "en" assert getattr(n, field_name) == value_en assert getattr(n, field_name_de) == value_de assert getattr(n, field_name_en) == value_en trans_real.activate("de") assert get_language() == "de" assert getattr(n, field_name) == value_de if deactivate: trans_real.deactivate() def test_rule1(self): """ Basic CharField/TextField test. """ title1_de = "title de" title1_en = "title en" text_de = "Dies ist ein deutscher Satz" text_en = "This is an english sentence" self._test_field(field_name="title", value_de=title1_de, value_en=title1_en) self._test_field(field_name="text", value_de=text_de, value_en=text_en) def test_rule1_url_field(self): self._test_field( field_name="url", value_de="http://www.google.de", value_en="http://www.google.com" ) def test_rule1_email_field(self): self._test_field( field_name="email", value_de="django-modeltranslation@googlecode.de", value_en="django-modeltranslation@googlecode.com", ) class ModeltranslationTestRule2(ModeltranslationTestBase): """ Rule 2: Assigning a value to the original field updates the value in the associated current language translation field. """ def _test_field(self, field_name, value1_de, value1_en, value2, value3, deactivate=True): field_name_de = "%s_de" % field_name field_name_en = "%s_en" % field_name params = {field_name_de: value1_de, field_name_en: value1_en} assert get_language() == "de" n = models.TestModel.objects.create(**params) assert getattr(n, field_name) == value1_de assert getattr(n, field_name_de) == value1_de assert getattr(n, field_name_en) == value1_en setattr(n, field_name, value2) n.save() assert getattr(n, field_name) == value2 assert getattr(n, field_name_de) == value2 assert getattr(n, field_name_en) == value1_en trans_real.activate("en") assert get_language() == "en" setattr(n, field_name, value3) setattr(n, field_name_de, value1_de) n.save() assert getattr(n, field_name) == value3 assert getattr(n, field_name_en) == value3 assert getattr(n, field_name_de) == value1_de if deactivate: trans_real.deactivate() def test_rule2(self): """ Basic CharField/TextField test. """ self._test_field( field_name="title", value1_de="title de", value1_en="title en", value2="Neuer Titel", value3="new title", ) def test_rule2_url_field(self): self._test_field( field_name="url", value1_de="http://www.google.de", value1_en="http://www.google.com", value2="http://www.google.at", value3="http://www.google.co.uk", ) def test_rule2_email_field(self): self._test_field( field_name="email", value1_de="django-modeltranslation@googlecode.de", value1_en="django-modeltranslation@googlecode.com", value2="django-modeltranslation@googlecode.at", value3="django-modeltranslation@googlecode.co.uk", ) class ModeltranslationTestRule3(ModeltranslationTestBase): """ Rule 3: If both fields - the original and the current language translation field - are updated at the same time, the current language translation field wins. """ def test_rule3(self): assert get_language() == "de" title = "title de" # Normal behaviour n = models.TestModel(title="foo") assert n.title == "foo" assert n.title_de == "foo" assert n.title_en is None # constructor n = models.TestModel(title_de=title, title="foo") assert n.title == title assert n.title_de == title assert n.title_en is None # object.create n = models.TestModel.objects.create(title_de=title, title="foo") assert n.title == title assert n.title_de == title assert n.title_en is None # Database save/load n = models.TestModel.objects.get(title_de=title) assert n.title == title assert n.title_de == title assert n.title_en is None # This is not subject to Rule 3, because updates are not *at the ame time* n = models.TestModel() n.title_de = title n.title = "foo" assert n.title == "foo" assert n.title_de == "foo" assert n.title_en is None @staticmethod def _index(list, element): for i, el in enumerate(list): if el is element: return i raise ValueError def test_rule3_internals(self): # Rule 3 work because translation fields are added to model field list # later than original field. original = models.TestModel._meta.get_field("title") translated_de = models.TestModel._meta.get_field("title_de") translated_en = models.TestModel._meta.get_field("title_en") fields = models.TestModel._meta.fields # Here we cannot use simple list.index, because Field has overloaded __cmp__ assert self._index(fields, original) < self._index(fields, translated_de) assert self._index(fields, original) < self._index(fields, translated_en) class ModelValidationTest(ModeltranslationTestBase): """ Tests if a translation model field validates correctly. """ def assertRaisesValidation(self, func): try: func() except ValidationError as e: return e.message_dict self.fail("ValidationError not raised.") def _test_model_validation(self, field_name, invalid_value, valid_value): """ Generic model field validation test. """ field_name_de = "%s_de" % field_name field_name_en = "%s_en" % field_name # Title need to be passed here - otherwise it would not validate params = {"title_de": "title de", "title_en": "title en", field_name: invalid_value} n = models.TestModel.objects.create(**params) # First check the original field # Expect that the validation object contains an error errors = self.assertRaisesValidation(n.full_clean) assert field_name in errors # Set translation field to a valid value # Language is set to 'de' at this point assert get_language() == "de" setattr(n, field_name_de, valid_value) n.full_clean() # All language fields are validated even though original field validation raise no error setattr(n, field_name_en, invalid_value) errors = self.assertRaisesValidation(n.full_clean) assert field_name not in errors assert field_name_en in errors # When language is changed to en, the original field also doesn't validate with override("en"): setattr(n, field_name_en, invalid_value) errors = self.assertRaisesValidation(n.full_clean) assert field_name in errors assert field_name_en in errors # Set translation field to an invalid value setattr(n, field_name_en, valid_value) setattr(n, field_name_de, invalid_value) # Expect that the validation object contains an error for url_de errors = self.assertRaisesValidation(n.full_clean) assert field_name in errors assert field_name_de in errors def test_model_validation_required(self): """ General test for CharField: if required/blank is handled properly. """ # Create an object without title (which is required) n = models.TestModel.objects.create(text="Testtext") # First check the original field # Expect that the validation object contains an error for title errors = self.assertRaisesValidation(n.full_clean) assert "title" in errors n.save() # Check the translation field # Language is set to 'de' at this point assert get_language() == "de" # Set translation field to a valid title n.title_de = "Title" n.full_clean() # Change language to en # Now validation fails, because current language (en) title is empty # So requirement validation depends on current language with override("en"): errors = self.assertRaisesValidation(n.full_clean) assert "title" in errors # However, with fallback language (most cases), it validates (because empty title # falls back to title_de): with default_fallback(): n.full_clean() # Set translation field to an empty title n.title_de = None # Even though the original field isn't optional, translation fields are # per definition always optional. So we expect that the validation # object contains no error for title_de. # However, title still raises error, since it points to empty title_de errors = self.assertRaisesValidation(n.full_clean) assert "title_de" not in errors assert "title" in errors def test_model_validation_url_field(self): self._test_model_validation( field_name="url", invalid_value="foo en", valid_value="http://code.google.com/p/django-modeltranslation/", ) def test_model_validation_email_field(self): self._test_model_validation( field_name="email", invalid_value="foo en", valid_value="django-modeltranslation@googlecode.com", ) class ModelInheritanceTest(ModeltranslationTestBase): """Tests for inheritance support in modeltranslation.""" def test_abstract_inheritance(self): field_names_b = get_field_names(models.AbstractModelB) assert "titlea" in field_names_b assert "titlea_de" in field_names_b assert "titlea_en" in field_names_b assert "titleb" in field_names_b assert "titleb_de" in field_names_b assert "titleb_en" in field_names_b assert "titled" not in field_names_b assert "titled_de" not in field_names_b assert "titled_en" not in field_names_b def test_multitable_inheritance(self): field_names_a = get_field_names(models.MultitableModelA) assert "titlea" in field_names_a assert "titlea_de" in field_names_a assert "titlea_en" in field_names_a field_names_b = get_field_names(models.MultitableModelB) assert "titlea" in field_names_b assert "titlea_de" in field_names_b assert "titlea_en" in field_names_b assert "titleb" in field_names_b assert "titleb_de" in field_names_b assert "titleb_en" in field_names_b field_names_c = get_field_names(models.MultitableModelC) assert "titlea" in field_names_c assert "titlea_de" in field_names_c assert "titlea_en" in field_names_c assert "titleb" in field_names_c assert "titleb_de" in field_names_c assert "titleb_en" in field_names_c assert "titlec" in field_names_c assert "titlec_de" in field_names_c assert "titlec_en" in field_names_c field_names_d = get_field_names(models.MultitableModelD) assert "titlea" in field_names_d assert "titlea_de" in field_names_d assert "titlea_en" in field_names_d assert "titleb" in field_names_d assert "titleb_de" in field_names_d assert "titleb_en" in field_names_d assert "titled" in field_names_d def test_inheritance(self): def assertLocalFields(model, local_fields): # Proper fields are inherited. opts = translator.translator.get_options_for_model(model) assert set(opts.local_fields.keys()) == set(local_fields) # Local translation fields are created on the model. model_local_fields = [f.name for f in model._meta.local_fields] for field in local_fields: for lang in mt_settings.AVAILABLE_LANGUAGES: translation_field = build_localized_fieldname(field, lang) assert translation_field in model_local_fields def assertFields(model, fields): # The given fields are inherited. opts = translator.translator.get_options_for_model(model) assert set(opts.all_fields.keys()) == set(fields) # Inherited translation fields are available on the model. model_fields = get_field_names(model) for field in fields: for lang in mt_settings.AVAILABLE_LANGUAGES: translation_field = build_localized_fieldname(field, lang) assert translation_field in model_fields # Translation fields can be declared on abstract classes. assertLocalFields(models.Slugged, ("slug",)) assertLocalFields(models.MetaData, ("keywords",)) assertLocalFields(models.RichText, ("content",)) # Local fields are inherited from abstract superclasses. assertLocalFields( models.Displayable, ( "slug", "keywords", ), ) assertLocalFields( models.Page, ( "slug", "keywords", "title", ), ) # But not from concrete superclasses. assertLocalFields(models.RichTextPage, ("content",)) # Fields inherited from concrete models are also available. assertFields(models.Slugged, ("slug",)) assertFields( models.Page, ( "slug", "keywords", "title", ), ) assertFields( models.RichTextPage, ( "slug", "keywords", "title", "content", ), ) class ModelInheritanceFieldAggregationTest(ModeltranslationTestBase): """ Tests for inheritance support with field aggregation in modeltranslation. """ def test_field_aggregation(self): clsb = translation.FieldInheritanceCTranslationOptions assert "titlea" in clsb.fields assert "titleb" in clsb.fields assert "titlec" in clsb.fields assert 3 == len(clsb.fields) assert isinstance(clsb.fields, tuple) def test_multi_inheritance(self): clsb = translation.FieldInheritanceETranslationOptions assert "titlea" in clsb.fields assert "titleb" in clsb.fields assert "titlec" in clsb.fields assert "titled" in clsb.fields assert "titlee" in clsb.fields assert 5 == len(clsb.fields) # there are no repetitions def test_str_instead_of_tuple(self): with pytest.raises(ImproperlyConfigured): class ModelOptions(TranslationOptions): fields = "titlea" class UpdateCommandTest(ModeltranslationTestBase): def test_update_command(self): # Here it would be convenient to use fixtures - unfortunately, # fixtures loader doesn't use raw sql but rather creates objects, # so translation descriptor affects result and we cannot set the # 'original' field value. pk1 = models.TestModel.objects.create(title_de="").pk pk2 = models.TestModel.objects.create(title_de="already").pk # Due to ``rewrite(False)`` here, original field will be affected. models.TestModel.objects.all().rewrite(False).update(title="initial") # Check raw data using ``values`` obj1 = models.TestModel.objects.filter(pk=pk1).raw_values()[0] obj2 = models.TestModel.objects.filter(pk=pk2).raw_values()[0] assert "" == obj1["title_de"] assert "initial" == obj1["title"] assert "already" == obj2["title_de"] assert "initial" == obj2["title"] call_command("update_translation_fields", "tests", verbosity=0) obj1 = models.TestModel.objects.get(pk=pk1) obj2 = models.TestModel.objects.get(pk=pk2) assert "initial" == obj1.title_de assert "already" == obj2.title_de def test_update_command_language_param(self): trans_real.activate("en") pk1 = models.TestModel.objects.create(title_en="").pk pk2 = models.TestModel.objects.create(title_en="already").pk # Due to ``rewrite(False)`` here, original field will be affected. models.TestModel.objects.all().rewrite(False).update(title="initial") call_command("update_translation_fields", "tests", language="en", verbosity=0) obj1 = models.TestModel.objects.get(pk=pk1) obj2 = models.TestModel.objects.get(pk=pk2) assert "initial" == obj1.title_en assert "already" == obj2.title_en def test_update_command_invalid_language_param(self): with pytest.raises(CommandError): call_command("update_translation_fields", language="xx", verbosity=0) def test_update_command_with_json_field(self): """ Test that the update_translation_fields command works with JSON fields. """ instance_pk = models.OtherFieldsModel.objects.create(json={"foo": "bar"}).pk models.OtherFieldsModel.objects.all().rewrite(False).update(json_de=None) instance = models.OtherFieldsModel.objects.filter(pk=instance_pk).raw_values()[0] assert instance["json"] == {"foo": "bar"} assert instance["json_de"] is None assert instance["json_en"] is None call_command( "update_translation_fields", "tests", model_name="OtherFieldsModel", verbosity=0 ) instance = models.OtherFieldsModel.objects.filter(pk=instance_pk).raw_values()[0] assert instance["json"] == {"foo": "bar"} assert instance["json_de"] == {"foo": "bar"} assert instance["json_en"] is None class TestManager(ModeltranslationTestBase): def setUp(self): # In this test case the default language is en, not de. super().setUp() trans_real.activate("en") def test_filter_update(self): """Test if filtering and updating is language-aware.""" n = models.ManagerTestModel(title="") n.title_en = "en" n.title_de = "de" n.save() m = models.ManagerTestModel(title="") m.title_en = "title en" m.title_de = "de" m.save() assert "en" == get_language() assert 0 == models.ManagerTestModel.objects.filter(title="de").count() assert 1 == models.ManagerTestModel.objects.filter(title="en").count() # Spanning works assert 2 == models.ManagerTestModel.objects.filter(title__contains="en").count() with override("de"): assert 2 == models.ManagerTestModel.objects.filter(title="de").count() assert 0 == models.ManagerTestModel.objects.filter(title="en").count() # Spanning works assert 2 == models.ManagerTestModel.objects.filter(title__endswith="e").count() # Still possible to use explicit language version assert 1 == models.ManagerTestModel.objects.filter(title_en="en").count() assert 2 == models.ManagerTestModel.objects.filter(title_en__contains="en").count() models.ManagerTestModel.objects.update(title="new") assert 2 == models.ManagerTestModel.objects.filter(title="new").count() n = models.ManagerTestModel.objects.get(pk=n.pk) m = models.ManagerTestModel.objects.get(pk=m.pk) assert "en" == n.title_en assert "new" == n.title_de assert "title en" == m.title_en assert "new" == m.title_de # Test Python3 "dictionary changed size during iteration" assert 1 == models.ManagerTestModel.objects.filter(title="en", title_en="en").count() def test_q(self): """Test if Q queries are rewritten.""" n = models.ManagerTestModel(title="") n.title_en = "en" n.title_de = "de" n.save() assert "en" == get_language() assert 0 == models.ManagerTestModel.objects.filter(Q(title="de") | Q(pk=42)).count() assert 1 == models.ManagerTestModel.objects.filter(Q(title="en") | Q(pk=42)).count() with override("de"): assert 1 == models.ManagerTestModel.objects.filter(Q(title="de") | Q(pk=42)).count() assert 0 == models.ManagerTestModel.objects.filter(Q(title="en") | Q(pk=42)).count() def test_f(self): """Test if F queries are rewritten.""" n = models.ManagerTestModel.objects.create(visits_en=1, visits_de=2) assert "en" == get_language() models.ManagerTestModel.objects.update(visits=F("visits") + 10) n = models.ManagerTestModel.objects.all()[0] assert n.visits_en == 11 assert n.visits_de == 2 with override("de"): models.ManagerTestModel.objects.update(visits=F("visits") + 20) n = models.ManagerTestModel.objects.all()[0] assert n.visits_en == 11 assert n.visits_de == 22 def test_order_by(self): """Check that field names are rewritten in order_by keys.""" manager = models.ManagerTestModel.objects manager.create(title="a") m = manager.create(title="b") manager.create(title="c") with override("de"): # Make the order of the 'title' column different. m.title = "d" m.save() titles_asc = tuple(m.title for m in manager.order_by("title")) titles_desc = tuple(m.title for m in manager.order_by("-title")) assert titles_asc == ("a", "b", "c") assert titles_desc == ("c", "b", "a") def test_order_by_meta(self): """Check that meta ordering is rewritten.""" manager = models.ManagerTestModel.objects manager.create(title="more_de", visits_en=1, visits_de=2) manager.create(title="more_en", visits_en=2, visits_de=1) manager.create(title="most", visits_en=3, visits_de=3) manager.create(title="least", visits_en=0, visits_de=0) # Ordering descending with visits_en titles_for_en = tuple(m.title_en for m in manager.all()) with override("de"): # Ordering descending with visits_de titles_for_de = tuple(m.title_en for m in manager.all()) assert titles_for_en == ("most", "more_en", "more_de", "least") assert titles_for_de == ("most", "more_de", "more_en", "least") def test_order_by_reset(self): qs = models.ManagerTestModel.objects.all() assert qs.ordered assert not qs.order_by().ordered assert not qs.values("title").order_by().ordered assert not qs.order_by().values("title").ordered, "queryset is unexpectedly ordered" def test_latest(self): manager = models.ManagerTestModel.objects manager.create(title="more_de", visits_en=1, visits_de=2) instance_2 = manager.create(title="more_en", visits_en=2, visits_de=1) lainstanceance = manager.latest("id") assert lainstanceance == instance_2 def assert_fallback(self, method, expected1, *args, **kwargs): transform = kwargs.pop("transform", lambda x: x) expected2 = kwargs.pop("expected_de", expected1) with default_fallback(): # Fallback is ('de',) obj = method(*args, **kwargs)[0] with override("de"): obj2 = method(*args, **kwargs)[0] assert transform(obj) == expected1 assert transform(obj2) == expected2 def test_values_fallback(self): manager = models.ManagerTestModel.objects manager.create(title_en="", title_de="de") assert "en" == get_language() self.assert_fallback(manager.values, "de", "title", transform=lambda x: x["title"]) self.assert_fallback(manager.values_list, "de", "title", flat=True) self.assert_fallback(manager.values_list, ("de", "", "de"), "title", "title_en", "title_de") # Settings are taken into account - fallback can be disabled with override_settings(MODELTRANSLATION_ENABLE_FALLBACKS=False): self.assert_fallback( manager.values, "", "title", expected_de="de", transform=lambda x: x["title"] ) # Test fallback values manager = models.FallbackModel.objects manager.create() self.assert_fallback(manager.values, "fallback", "title", transform=lambda x: x["title"]) self.assert_fallback(manager.values_list, ("fallback", "fallback"), "title", "text") def test_values(self): manager = models.ManagerTestModel.objects id1 = manager.create(title_en="en", title_de="de").pk raw_obj = manager.raw_values("title")[0] obj = manager.values("title")[0] with override("de"): raw_obj2 = manager.raw_values("title")[0] obj2 = manager.values("title")[0] # Raw_values returns real database values regardless of current language assert raw_obj["title"] == raw_obj2["title"] # Values present language-aware data, from the moment of retrieval assert obj["title"] == "en" assert obj2["title"] == "de" # Values_list behave similarly assert list(manager.values_list("title", flat=True)) == ["en"] with override("de"): assert list(manager.values_list("title", flat=True)) == ["de"] # Values_list with named fields behave similarly. # Also, it should preserve requested ordering. (actual,) = manager.annotate(annotated=Value(True)).values_list( "title", "annotated", "visits", named=True ) expected = ("en", True, 0) assert actual == expected assert (actual.title, actual.annotated, actual.visits) == expected with override("de"): assert list(manager.values_list("title", "visits", named=True)) == [("de", 0)] # One can always turn rewrite off a = list(manager.rewrite(False).values_list("title", flat=True)) with override("de"): b = list(manager.rewrite(False).values_list("title", flat=True)) assert a == b i2 = manager.create(title_en="en2", title_de="de2") id2 = i2.pk # This is somehow repetitive... assert "en" == get_language() assert list(manager.values("title")) == [{"title": "en"}, {"title": "en2"}] with override("de"): assert list(manager.values("title")) == [{"title": "de"}, {"title": "de2"}] # When no fields are passed, list all fields in current language. actual = list(manager.annotate(annotated=Value(True)).values()) assert actual == [ {"id": id1, "title": "en", "visits": 0, "description": None, "annotated": True}, {"id": id2, "title": "en2", "visits": 0, "description": None, "annotated": True}, ] # Similar for values_list assert list(manager.values_list()) == [(id1, "en", 0, None), (id2, "en2", 0, None)] with override("de"): assert list(manager.values_list()) == [(id1, "de", 0, None), (id2, "de2", 0, None)] # Raw_values assert list(manager.raw_values()) == list(manager.rewrite(False).values()) i2.delete() assert list(manager.raw_values()) == [ { "id": id1, "title": "en", "title_en": "en", "title_de": "de", "visits": 0, "visits_en": 0, "visits_de": 0, "description": None, "description_en": None, "description_de": None, }, ] # annotation issue (#374) assert list(manager.values_list("title", flat=True).annotate(Count("title"))) == ["en"] # custom annotation assert list(manager.filter(id=id1).annotate(custom_id=F("id")).values_list())[0][-1] == id1 assert ( list(manager.filter(id=id1).annotate(custom_id=F("id")).values())[0].get("custom_id") == id1 ) # custom annotation with fields specified assert list(manager.filter(id=id1).annotate(custom_id=F("id")).values_list("id"))[0] == ( id1, ) assert ( list(manager.filter(id=id1).annotate(custom_id=F("id")).values("id"))[0].get( "custom_id" ) is None ) def test_values_list_annotation(self): models.TestModel(title="foo").save() models.TestModel(title="foo").save() assert list(models.TestModel.objects.all().values_list("title").annotate(Count("id"))) == [ ("foo", 2) ] def test_values_with_expressions(self): manager = models.ManagerTestModel.objects id1 = manager.create(title_en="en", title_de="de").pk raw_obj = manager.raw_values("title", str_pk=Cast("pk", output_field=CharField()))[0] obj = manager.values("title", str_pk=Cast("pk", output_field=CharField()))[0] with override("de"): raw_obj2 = manager.raw_values("title", str_pk=Cast("pk", output_field=CharField()))[0] obj2 = manager.values("title", str_pk=Cast("pk", output_field=CharField()))[0] # Raw_values returns real database values regardless of current language assert raw_obj["title"] == raw_obj2["title"] assert raw_obj["str_pk"] == raw_obj2["str_pk"] # Values present language-aware data, from the moment of retrieval assert obj["title"] == "en" assert obj["str_pk"] == str(id1) assert obj2["title"] == "de" # Values_list behave similarly assert list(manager.values_list("title", Cast("pk", output_field=CharField()))) == [ ("en", str(id1)) ] with override("de"): assert list(manager.values_list("title", Cast("pk", output_field=CharField()))) == [ ("de", str(id1)) ] def test_custom_manager(self): """Test if user-defined manager is still working""" n = models.CustomManagerTestModel(title="") n.title_en = "enigma" n.title_de = "foo" n.save() m = models.CustomManagerTestModel(title="") m.title_en = "enigma" m.title_de = "bar" m.save() # Custom method assert "bar" == models.CustomManagerTestModel.objects.foo() # Ensure that get_queryset is working - filter objects to those with 'a' in title assert "en" == get_language() assert 2 == models.CustomManagerTestModel.objects.count() with override("de"): assert 1 == models.CustomManagerTestModel.objects.count() def test_custom_manager_custom_method_name(self): """Test if custom method also returns MultilingualQuerySet""" from modeltranslation.manager import MultilingualQuerySet qs = models.CustomManagerTestModel.objects.custom_qs() assert isinstance(qs, MultilingualQuerySet) def test_3rd_party_custom_manager(self): from django.contrib.auth.models import Group, GroupManager from modeltranslation.manager import MultilingualManager testmodel_fields = get_field_names(Group) assert "name" in testmodel_fields assert "name_de" in testmodel_fields assert "name_en" in testmodel_fields assert "name_en" in testmodel_fields assert isinstance(Group.objects, MultilingualManager) assert isinstance(Group.objects, GroupManager) assert "get_by_natural_key" in dir(Group.objects) def test_multilingual_queryset_pickling(self): import pickle from modeltranslation.manager import MultilingualQuerySet # typical models.CustomManagerTestModel.objects.create(title="a") qs = models.CustomManagerTestModel.objects.all() serialized = pickle.dumps(qs) deserialized = pickle.loads(serialized) assert isinstance(deserialized, MultilingualQuerySet) assert list(qs) == list(deserialized) # Generated class models.CustomManager2TestModel.objects.create() qs = models.CustomManager2TestModel.objects.all() serialized = pickle.dumps(qs) deserialized = pickle.loads(serialized) assert isinstance(deserialized, MultilingualQuerySet) assert isinstance(deserialized, models.CustomQuerySet) assert list(qs) == list(deserialized) def test_non_objects_manager(self): """Test if managers other than ``objects`` are patched too""" from modeltranslation.manager import MultilingualManager manager = models.CustomManagerTestModel.another_mgr_name assert isinstance(manager, MultilingualManager) def test_default_manager_for_inherited_models_with_custom_manager(self): """Test if default manager is still set from local managers""" manager = models.CustomManagerChildTestModel._meta.default_manager assert "objects" == manager.name assert isinstance(manager, MultilingualManager) assert isinstance(models.CustomManagerChildTestModel.translations, MultilingualManager) def test_default_manager_for_inherited_models(self): manager = models.PlainChildTestModel._meta.default_manager assert "objects" == manager.name assert isinstance(models.PlainChildTestModel.translations, MultilingualManager) def test_custom_manager2(self): """Test if user-defined queryset is still working""" from modeltranslation.manager import MultilingualManager, MultilingualQuerySet manager = models.CustomManager2TestModel.objects assert isinstance(manager, models.CustomManager2) assert isinstance(manager, MultilingualManager) qs = manager.all() assert isinstance(qs, models.CustomQuerySet) assert isinstance(qs, MultilingualQuerySet) def test_creation(self): """Test if field are rewritten in create.""" assert "en" == get_language() n = models.ManagerTestModel.objects.create(title="foo") assert "foo" == n.title_en assert n.title_de is None assert "foo" == n.title # The same result n = models.ManagerTestModel.objects.create(title_en="foo") assert "foo" == n.title_en assert n.title_de is None assert "foo" == n.title # Language suffixed version wins n = models.ManagerTestModel.objects.create(title="bar", title_en="foo") assert "foo" == n.title_en assert n.title_de is None assert "foo" == n.title def test_creation_population(self): """Test if language fields are populated with default value on creation.""" n = models.ManagerTestModel.objects.populate(True).create(title="foo") assert "foo" == n.title_en assert "foo" == n.title_de assert "foo" == n.title # You can specify some language... n = models.ManagerTestModel.objects.populate(True).create(title="foo", title_de="bar") assert "foo" == n.title_en assert "bar" == n.title_de assert "foo" == n.title # ... but remember that still original attribute points to current language assert "en" == get_language() n = models.ManagerTestModel.objects.populate(True).create(title="foo", title_en="bar") assert "bar" == n.title_en assert "foo" == n.title_de assert "bar" == n.title # points to en with override("de"): assert "foo" == n.title # points to de assert "en" == get_language() # This feature (for backward-compatibility) require populate method... n = models.ManagerTestModel.objects.create(title="foo") assert "foo" == n.title_en assert n.title_de is None assert "foo" == n.title # ... or MODELTRANSLATION_AUTO_POPULATE setting with reload_override_settings(MODELTRANSLATION_AUTO_POPULATE=True): assert mt_settings.AUTO_POPULATE is True n = models.ManagerTestModel.objects.create(title="foo") assert "foo" == n.title_en assert "foo" == n.title_de assert "foo" == n.title # populate method has highest priority n = models.ManagerTestModel.objects.populate(False).create(title="foo") assert "foo" == n.title_en assert n.title_de is None assert "foo" == n.title # Populate ``default`` fills just the default translation. # TODO: Having more languages would make these tests more meaningful. qs = models.ManagerTestModel.objects m = qs.populate("default").create(title="foo", description="bar") assert "foo" == m.title_de assert "foo" == m.title_en assert "bar" == m.description_de assert "bar" == m.description_en with override("de"): m = qs.populate("default").create(title="foo", description="bar") assert "foo" == m.title_de assert m.title_en is None assert "bar" == m.description_de assert m.description_en is None # Populate ``required`` fills just non-nullable default translations. qs = models.ManagerTestModel.objects m = qs.populate("required").create(title="foo", description="bar") assert "foo" == m.title_de assert "foo" == m.title_en assert m.description_de is None assert "bar" == m.description_en with override("de"): m = qs.populate("required").create(title="foo", description="bar") assert "foo" == m.title_de assert m.title_en is None assert "bar" == m.description_de assert m.description_en is None def test_get_or_create_population(self): """ Populate may be used with ``get_or_create``. """ qs = models.ManagerTestModel.objects m1, created1 = qs.populate(True).get_or_create(title="aaa") m2, created2 = qs.populate(True).get_or_create(title="aaa") assert created1 assert not created2 assert m1 == m2 assert "aaa" == m1.title_en assert "aaa" == m1.title_de def test_fixture_population(self): """ Test that a fixture with values only for the original fields does not result in missing default translations for (original) non-nullable fields. """ with auto_populate("required"): call_command("loaddata", "fixture.json", verbosity=0) m = models.TestModel.objects.get() assert m.title_en == "foo" assert m.title_de == "foo" assert m.text_en == "bar" assert m.text_de is None def test_fixture_population_via_command(self): """ Test that the loaddata command takes new option. """ call_command("loaddata", "fixture.json", verbosity=0, populate="required") m = models.TestModel.objects.get() assert m.title_en == "foo" assert m.title_de == "foo" assert m.text_en == "bar" assert m.text_de is None call_command("loaddata", "fixture.json", verbosity=0, populate="all") m = models.TestModel.objects.get() assert m.title_en == "foo" assert m.title_de == "foo" assert m.text_en == "bar" assert m.text_de == "bar" # Test if option overrides current context with auto_populate("all"): call_command("loaddata", "fixture.json", verbosity=0, populate=False) m = models.TestModel.objects.get() assert m.title_en == "foo" assert m.title_de is None assert m.text_en == "bar" assert m.text_de is None def assertDeferred(self, use_defer, *fields): manager = models.TestModel.objects.defer if use_defer else models.TestModel.objects.only inst1 = manager(*fields)[0] with override("de"): inst2 = manager(*fields)[0] assert "title_en" == inst1.title assert "title_en" == inst2.title with override("de"): assert "title_de" == inst1.title assert "title_de" == inst2.title def assertDeferredClass(self, item): assert len(item.get_deferred_fields()) > 0 def test_deferred(self): """ Check if ``only`` and ``defer`` are working. """ models.TestModel.objects.create(title_de="title_de", title_en="title_en") inst = models.TestModel.objects.only("title_en")[0] assert isinstance(inst, models.TestModel) self.assertDeferred(False, "title_en") with auto_populate("all"): self.assertDeferred(False, "title") self.assertDeferred(False, "title_de") self.assertDeferred(False, "title_en") self.assertDeferred(False, "title_en", "title_de") self.assertDeferred(False, "title", "title_en") self.assertDeferred(False, "title", "title_de") # Check if fields are deferred properly with ``only`` self.assertDeferred(False, "text") # Defer self.assertDeferred(True, "title") self.assertDeferred(True, "title_de") self.assertDeferred(True, "title_en") self.assertDeferred(True, "title_en", "title_de") self.assertDeferred(True, "title", "title_en") self.assertDeferred(True, "title", "title_de") self.assertDeferred(True, "text", "email", "url") def test_deferred_fk(self): """ Check if ``select_related`` is rewritten and also if ``only`` and ``defer`` are working with deferred classes """ test = models.TestModel.objects.create(title_de="title_de", title_en="title_en") with auto_populate("all"): models.ForeignKeyModel.objects.create(test=test) item = models.ForeignKeyModel.objects.select_related("test").defer("test__text")[0] self.assertDeferredClass(item.test) assert "title_en" == item.test.title assert "title_en" == item.test.__class__.objects.only("title")[0].title with override("de"): item = models.ForeignKeyModel.objects.select_related("test").defer("test__text")[0] self.assertDeferredClass(item.test) assert "title_de" == item.test.title assert "title_de" == item.test.__class__.objects.only("title")[0].title def test_deferred_spanning(self): test = models.TestModel.objects.create(title_de="title_de", title_en="title_en") with auto_populate("all"): models.ForeignKeyModel.objects.create(test=test) item1 = models.ForeignKeyModel.objects.select_related("test").defer("test__text")[0].test item2 = models.TestModel.objects.defer("text")[0] assert item1.__class__ is item2.__class__ # DeferredAttribute descriptors are present assert "text_en" in dir(item1.__class__) assert "text_de" in dir(item1.__class__) def test_deferred_rule2(self): models.TestModel.objects.create(title_de="title_de", title_en="title_en") o = models.TestModel.objects.only("title")[0] assert o.title == "title_en" o.title = "bla" assert o.title == "bla" def test_select_related(self): test = models.TestModel.objects.create(title_de="title_de", title_en="title_en") with auto_populate("all"): models.ForeignKeyModel.objects.create(untrans=test) fk_qs = models.ForeignKeyModel.objects.all() assert "untrans" not in fk_qs[0]._state.fields_cache assert "untrans" in fk_qs.select_related("untrans")[0]._state.fields_cache assert ( "untrans" not in fk_qs.select_related("untrans").select_related(None)[0]._state.fields_cache ) # untrans is nullable so not included when select_related=True assert "untrans" not in fk_qs.select_related()[0]._state.fields_cache def test_translation_fields_appending(self): from modeltranslation.manager import append_lookup_key, append_lookup_keys assert {"untrans"} == append_lookup_key(models.ForeignKeyModel, "untrans") assert {"title", "title_en", "title_de"} == append_lookup_key( models.ForeignKeyModel, "title" ) assert {"test", "test_en", "test_de"} == append_lookup_key(models.ForeignKeyModel, "test") assert {"title__eq", "title_en__eq", "title_de__eq"} == append_lookup_key( models.ForeignKeyModel, "title__eq" ) assert {"test__smt", "test_en__smt", "test_de__smt"} == append_lookup_key( models.ForeignKeyModel, "test__smt" ) big_set = { "test__url", "test__url_en", "test__url_de", "test_en__url", "test_en__url_en", "test_en__url_de", "test_de__url", "test_de__url_en", "test_de__url_de", } assert big_set == append_lookup_key(models.ForeignKeyModel, "test__url") assert {"untrans__url", "untrans__url_en", "untrans__url_de"} == append_lookup_key( models.ForeignKeyModel, "untrans__url" ) assert big_set.union(["title", "title_en", "title_de"]) == append_lookup_keys( models.ForeignKeyModel, ["test__url", "title"] ) def test_constructor_inheritance(self): inst = models.AbstractModelB() # Check if fields assigned in constructor hasn't been ignored. assert inst.titlea == "title_a" assert inst.titleb == "title_b" def test_distinct(self): """Check that field names are rewritten in distinct keys.""" manager = models.ManagerTestModel.objects manager.create( title_en="title_1_en", title_de="title_1_de", description_en="desc_1_en", description_de="desc_1_de", ) manager.create( title_en="title_1_en", title_de="title_1_de", description_en="desc_2_en", description_de="desc_2_de", ) manager.create( title_en="title_2_en", title_de="title_2_de", description_en="desc_1_en", description_de="desc_1_de", ) manager.create( title_en="title_2_en", title_de="title_2_de", description_en="desc_2_en", description_de="desc_2_de", ) # Without field arguments to distinct() all fields are used to determine # distinctness, therefore when only looking at a subset of fields in the # queryset it can appear that there are duplicates (the titles in this case) titles_for_en = tuple(m.title for m in manager.order_by("title").distinct()) with override("de"): titles_for_de = tuple(m.title for m in manager.order_by("title").distinct()) assert titles_for_en == ("title_1_en", "title_1_en", "title_2_en", "title_2_en") assert titles_for_de == ("title_1_de", "title_1_de", "title_2_de", "title_2_de") # On PostgreSQL only, distinct() can have field arguments (*fields) to specify which fields # the distinct applies to (this generates a DISTINCT ON (*fields) sql expression). # NB: DISTINCT ON expressions must be accompanied by an order_by() that starts with the # same fields in the same order if django_settings.DATABASES["default"]["ENGINE"] == "django.db.backends.postgresql": titles_for_en = tuple( (m.title, m.description) for m in manager.order_by("title", "description").distinct("title") ) with override("de"): titles_for_de = tuple( (m.title, m.description) for m in manager.order_by("title", "description").distinct("title") ) assert titles_for_en == (("title_1_en", "desc_1_en"), ("title_2_en", "desc_1_en")) assert titles_for_de == (("title_1_de", "desc_1_de"), ("title_2_de", "desc_1_de")) def test_annotate(self): """Test if annotating is language-aware.""" test = models.TestModel.objects.create(title_en="title_en", title_de="title_de") assert "en" == get_language() assert ( models.TestModel.objects.annotate(custom_title=F("title")).values_list( "custom_title", flat=True )[0] == "title_en" ) with override("de"): assert ( models.TestModel.objects.annotate(custom_title=F("title")).values_list( "custom_title", flat=True )[0] == "title_de" ) assert ( models.TestModel.objects.annotate( custom_title=Concat(F("title"), Value("value1"), Value("value2")) ).values_list("custom_title", flat=True)[0] == "title_devalue1value2" ) assert ( models.TestModel.objects.annotate( custom_title=Concat(F("title"), Concat(F("title"), Value("value"))) ).values_list("custom_title", flat=True)[0] == "title_detitle_devalue" ) models.ForeignKeyModel.objects.create(test=test) models.ForeignKeyModel.objects.create(test=test) assert ( models.TestModel.objects.annotate(Count("test_fks")).values_list( "test_fks__count", flat=True )[0] == 2 ) class TranslationModelFormTest(ModeltranslationTestBase): def test_fields(self): class TestModelForm(TranslationModelForm): class Meta: model = models.TestModel fields = "__all__" form = TestModelForm() assert list(form.base_fields) == [ "title", "title_de", "title_en", "text", "text_de", "text_en", "url", "url_de", "url_en", "email", "email_de", "email_en", "dynamic_default", "dynamic_default_de", "dynamic_default_en", ] assert list(form.fields) == ["title", "text", "url", "email", "dynamic_default"] def test_updating_with_empty_value(self): """ Can we update the current language translation with an empty value, when the original field is excluded from the form? """ class Form(forms.ModelForm): class Meta: model = models.TestModel exclude = ("text", "dynamic_default") instance = models.TestModel.objects.create(text_de="something") form = Form( {"text_de": "", "title": "a", "email_de": "", "email_en": ""}, instance=instance ) instance = form.save() assert "de" == get_language() assert "" == instance.text_de class ProxyModelTest(ModeltranslationTestBase): def test_equality(self): n = models.TestModel.objects.create(title="Title") m = models.ProxyTestModel.objects.get(title="Title") assert n.title == m.title assert n.title_de == m.title_de assert n.title_en == m.title_en class TestRequired(ModeltranslationTestBase): def assertRequired(self, field_name): assert not self.opts.get_field(field_name).blank def assertNotRequired(self, field_name): assert self.opts.get_field(field_name).blank def test_required(self): self.opts = models.RequiredModel._meta # All non required self.assertNotRequired("non_req") self.assertNotRequired("non_req_en") self.assertNotRequired("non_req_de") # Original required, but translated fields not - default behaviour self.assertRequired("req") self.assertNotRequired("req_en") self.assertNotRequired("req_de") # Set all translated field required self.assertRequired("req_reg") self.assertRequired("req_reg_en") self.assertRequired("req_reg_de") # Set some translated field required self.assertRequired("req_en_reg") self.assertRequired("req_en_reg_en") self.assertNotRequired("req_en_reg_de") # Test validation inst = models.RequiredModel() inst.req = "abc" inst.req_reg = "def" try: inst.full_clean() except ValidationError as e: error_fields = set(e.message_dict.keys()) assert {"req_reg_en", "req_en_reg", "req_en_reg_en"} == error_fields else: self.fail("ValidationError not raised!") class M2MTest(ModeltranslationTestBase): def test_m2m(self): # Create 1 instance of Y, linked to 2 instance of X, with different # English and German names. x1 = models.ModelX.objects.create(name_en="foo", name_de="bar") x2 = models.ModelX.objects.create(name_en="bar", name_de="baz") y = models.ModelY.objects.create(title="y1") models.ModelXY.objects.create(model_x=x1, model_y=y) models.ModelXY.objects.create(model_x=x2, model_y=y) with override("en"): # There's 1 X named "foo" and it's x1 y_foo = models.ModelY.objects.filter(xs__name="foo") assert 1 == y_foo.count() # There's 1 X named "bar" and it's x2 (in English) y_bar = models.ModelY.objects.filter(xs__name="bar") assert 1 == y_bar.count() # But in English, there's no X named "baz" y_baz = models.ModelY.objects.filter(xs__name="baz") assert 0 == y_baz.count() # Again: 1 X named "bar" (but through the M2M field) x_bar = y.xs.filter(name="bar") assert x2 in x_bar class InheritedPermissionTestCase(ModeltranslationTestBase): def test_managers_failure(self): """This fails with 0.13b.""" from django.contrib.auth.models import Permission, User from modeltranslation.manager import MultilingualManager from .models import InheritedPermission assert not isinstance(Permission.objects, MultilingualManager), ( "Permission is using MultilingualManager" ) assert isinstance(InheritedPermission.objects, MultilingualManager), ( "InheritedPermission is not using MultilingualManager" ) # This happens at initialization time, depending on the models # initialized. Permission._meta._expire_cache() assert not isinstance(Permission.objects, MultilingualManager), ( "Permission is using MultilingualManager" ) user = User.objects.create(username="123", is_active=True) user.has_perm("test_perm")