├── docs ├── .gitkeep ├── images │ ├── widget.png │ └── field_with_langs.jpeg └── diagrams │ ├── struct.png │ └── struct.uml ├── tof ├── tests │ ├── __init__.py │ └── tests.py ├── management │ ├── __init__.py │ └── commands │ │ └── benchmark.py ├── migrations │ ├── __init__.py │ ├── 0002_auto_20191118_1000.py │ ├── 0003_auto_20191127_0907.py │ └── 0001_initial.py ├── views.py ├── fixtures │ └── languages_data.json.gz ├── __init__.py ├── apps.py ├── static │ └── tof │ │ ├── js │ │ ├── translation_inline.js │ │ ├── translatable_fields_widget.js │ │ ├── translation_form.js │ │ └── translatable_fields_form.js │ │ └── css │ │ └── style.css ├── managers.py ├── settings.py ├── templates │ └── tof │ │ └── multiwidget.html ├── utils.py ├── fields.py ├── decorators.py ├── forms.py ├── admin.py └── models.py ├── example_project ├── main │ ├── __init__.py │ ├── migrations │ │ ├── __init__.py │ │ ├── 0003_vintage_description.py │ │ ├── 0002_auto_20191119_1134.py │ │ ├── 0004_winery.py │ │ └── 0001_initial.py │ ├── apps.py │ ├── templates │ │ └── main │ │ │ └── index.html │ ├── views.py │ ├── models.py │ └── admin.py ├── example │ ├── __init__.py │ ├── asgi.py │ ├── wsgi.py │ ├── urls.py │ └── settings.py ├── pyproject.toml ├── manage.py └── poetry.lock ├── AUTHORS ├── CONTRIBUTING.md ├── .editorconfig ├── .github └── workflows │ ├── publish.yml │ ├── style.yml │ └── tests.yml ├── setup.cfg ├── LICENSE ├── pyproject.toml ├── .gitignore ├── wiki_django_tof.md ├── README.md └── README_ru.md /docs/.gitkeep: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /tof/tests/__init__.py: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /tof/management/__init__.py: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /tof/migrations/__init__.py: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /example_project/main/__init__.py: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /example_project/example/__init__.py: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /example_project/main/migrations/__init__.py: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /tof/views.py: -------------------------------------------------------------------------------- 1 | # -*- coding: utf-8 -*- 2 | -------------------------------------------------------------------------------- /docs/images/widget.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/mom1/django-tof/HEAD/docs/images/widget.png -------------------------------------------------------------------------------- /docs/diagrams/struct.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/mom1/django-tof/HEAD/docs/diagrams/struct.png -------------------------------------------------------------------------------- /docs/images/field_with_langs.jpeg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/mom1/django-tof/HEAD/docs/images/field_with_langs.jpeg -------------------------------------------------------------------------------- /tof/fixtures/languages_data.json.gz: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/mom1/django-tof/HEAD/tof/fixtures/languages_data.json.gz -------------------------------------------------------------------------------- /example_project/main/apps.py: -------------------------------------------------------------------------------- 1 | from django.apps import AppConfig 2 | 3 | 4 | class MainConfig(AppConfig): 5 | name = 'main' 6 | -------------------------------------------------------------------------------- /AUTHORS: -------------------------------------------------------------------------------- 1 | Alphabetical list of contributors: 2 | 3 | * Ракитин Алексей (maybejke) 4 | * Stolpasov Maksim (MaxST) 5 | 6 | With support from: 7 | * Maxim Danilov (Danilovmy) 8 | -------------------------------------------------------------------------------- /CONTRIBUTING.md: -------------------------------------------------------------------------------- 1 | # Contributing 2 | 3 | Fork the original repository at: 4 | Send a merge request with your changes in separate branch 5 | -------------------------------------------------------------------------------- /tof/__init__.py: -------------------------------------------------------------------------------- 1 | # -*- coding: utf-8 -*- 2 | # @Author: MaxST 3 | # @Date: 2019-10-28 19:01:21 4 | # @Last Modified by: MaxST 5 | # @Last Modified time: 2019-11-17 15:10:42 6 | default_app_config = 'tof.apps.TofConfig' 7 | -------------------------------------------------------------------------------- /example_project/main/templates/main/index.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | index 5 | 6 | 7 |

Current language is:

8 |

{{ request.LANGUAGE_CODE }}

9 | {% for wine in wines %} 10 | {{ wine.title }}|{{ wine.description }}
11 | {% endfor %} 12 | 13 | 14 | -------------------------------------------------------------------------------- /example_project/main/views.py: -------------------------------------------------------------------------------- 1 | # -*- coding: utf-8 -*- 2 | # @Author: MaxST 3 | # @Date: 2019-10-28 20:30:42 4 | # @Last Modified by: MaxST 5 | # @Last Modified time: 2019-11-18 15:11:01 6 | from django.views.generic import TemplateView 7 | 8 | from .models import Wine 9 | 10 | 11 | class Index(TemplateView): 12 | extra_context = {'wines': Wine.objects.all()} 13 | template_name = 'main/index.html' 14 | -------------------------------------------------------------------------------- /.editorconfig: -------------------------------------------------------------------------------- 1 | # Check http://editorconfig.org for more information 2 | # This is the main config file for this project: 3 | root = true 4 | 5 | [*] 6 | charset = utf-8 7 | trim_trailing_whitespace = true 8 | end_of_line = lf 9 | indent_style = space 10 | insert_final_newline = true 11 | indent_size = 2 12 | 13 | [*.{py,kv}] 14 | indent_size = 4 15 | 16 | [*.{md,rst,in}] 17 | indent_style = ignore 18 | indent_size = ignore 19 | -------------------------------------------------------------------------------- /example_project/example/asgi.py: -------------------------------------------------------------------------------- 1 | """ 2 | ASGI config for example project. 3 | 4 | It exposes the ASGI callable as a module-level variable named ``application``. 5 | 6 | For more information on this file, see 7 | https://docs.djangoproject.com/en/dev/howto/deployment/asgi/ 8 | """ 9 | 10 | import os 11 | 12 | from django.core.asgi import get_asgi_application 13 | 14 | os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'example.settings') 15 | 16 | application = get_asgi_application() 17 | -------------------------------------------------------------------------------- /example_project/example/wsgi.py: -------------------------------------------------------------------------------- 1 | """ 2 | WSGI config for example project. 3 | 4 | It exposes the WSGI callable as a module-level variable named ``application``. 5 | 6 | For more information on this file, see 7 | https://docs.djangoproject.com/en/dev/howto/deployment/wsgi/ 8 | """ 9 | 10 | import os 11 | 12 | from django.core.wsgi import get_wsgi_application 13 | 14 | os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'example.settings') 15 | 16 | application = get_wsgi_application() 17 | -------------------------------------------------------------------------------- /example_project/pyproject.toml: -------------------------------------------------------------------------------- 1 | [tool.poetry] 2 | name = "example_project" 3 | version = "0.3.0" 4 | description = "" 5 | authors = ["MaxST "] 6 | 7 | [tool.poetry.dependencies] 8 | python = "^3.6" 9 | django = "^3.0" 10 | django-tof = {path = "..", develop = true} 11 | 12 | [tool.poetry.dev-dependencies] 13 | ipdb = "*" 14 | django-debug-toolbar = "*" 15 | mixer = "^6.1.3" 16 | coverage = "^5.0" 17 | 18 | [build-system] 19 | requires = ["poetry>=0.12"] 20 | build-backend = "poetry.masonry.api" 21 | -------------------------------------------------------------------------------- /example_project/main/migrations/0003_vintage_description.py: -------------------------------------------------------------------------------- 1 | # Generated by Django 3.0rc1 on 2019-11-27 09:07 2 | 3 | from django.db import migrations, models 4 | 5 | 6 | class Migration(migrations.Migration): 7 | 8 | dependencies = [ 9 | ('main', '0002_auto_20191119_1134'), 10 | ] 11 | 12 | operations = [ 13 | migrations.AddField( 14 | model_name='vintage', 15 | name='description', 16 | field=models.TextField(blank=True, null=True, verbose_name='Description'), 17 | ), 18 | ] 19 | -------------------------------------------------------------------------------- /tof/migrations/0002_auto_20191118_1000.py: -------------------------------------------------------------------------------- 1 | # Generated by Django 3.0b1 on 2019-11-18 10:00 2 | from django.core.management import call_command 3 | from django.db import migrations 4 | 5 | 6 | def load_fixture(apps, schema_editor): 7 | call_command('loaddata', 'languages_data.json.gz') 8 | 9 | 10 | def del_fixture(apps, schema_editor): 11 | language = apps.get_model('tof', 'Language') 12 | language.objects.all().delete() 13 | 14 | 15 | class Migration(migrations.Migration): 16 | 17 | dependencies = [ 18 | ('tof', '0001_initial'), 19 | ] 20 | 21 | operations = [ 22 | migrations.RunPython(load_fixture, reverse_code=del_fixture), 23 | ] 24 | -------------------------------------------------------------------------------- /.github/workflows/publish.yml: -------------------------------------------------------------------------------- 1 | name: Publish to PyPI 2 | on: 3 | release: 4 | types: [created] 5 | jobs: 6 | publish: 7 | runs-on: ubuntu-latest 8 | steps: 9 | - uses: actions/checkout@v1 10 | - name: Set up Python 11 | uses: actions/setup-python@v1 12 | with: 13 | python-version: "3.x" 14 | - name: Install dependencies 15 | run: | 16 | python -m pip install --upgrade pip 17 | python -m pip install poetry 18 | - name: Build and publish 19 | env: 20 | PYPI_TOKEN: ${{ secrets.PYPI_TOKEN }} 21 | run: | 22 | python -m poetry publish --build -u __token__ -p $PYPI_TOKEN 23 | -------------------------------------------------------------------------------- /example_project/manage.py: -------------------------------------------------------------------------------- 1 | #!/usr/bin/env python 2 | """Django's command-line utility for administrative tasks.""" 3 | import os 4 | import sys 5 | 6 | 7 | def main(): 8 | os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'example.settings') 9 | try: 10 | from django.core.management import execute_from_command_line 11 | except ImportError as exc: 12 | raise ImportError( 13 | "Couldn't import Django. Are you sure it's installed and " 14 | "available on your PYTHONPATH environment variable? Did you " 15 | "forget to activate a virtual environment?" 16 | ) from exc 17 | execute_from_command_line(sys.argv) 18 | 19 | 20 | if __name__ == '__main__': 21 | main() 22 | -------------------------------------------------------------------------------- /setup.cfg: -------------------------------------------------------------------------------- 1 | [bdist_wheel] 2 | universal = 1 3 | 4 | [flake8] 5 | max-line-length = 128 6 | statistics = False 7 | 8 | # Excluding some directories: 9 | exclude = 10 | .git 11 | __pycache__ 12 | migrations 13 | manage.py 14 | example_project 15 | 16 | # Flake plugins: 17 | inline-quotes = single 18 | accept-encodings = utf-8 19 | 20 | # Disable some pydocstyle checks: 21 | ignore = D100, D104, D106, D401, X100, W504 22 | 23 | 24 | [isort] 25 | include_trailing_comma=true 26 | multi_line_output=5 27 | indent=4 28 | combine_as_imports=true 29 | use_parentheses=true 30 | balanced_wrapping=true 31 | skip_glob=*/tof/**/migrations/*.py,*/tests/**/*.py 32 | 33 | 34 | [yapf] 35 | based_on_style = pep8 36 | column_limit = 128 37 | i18n_comment=NOQA 38 | -------------------------------------------------------------------------------- /.github/workflows/style.yml: -------------------------------------------------------------------------------- 1 | name: Check style 2 | on: [push] 3 | jobs: 4 | style: 5 | runs-on: ubuntu-latest 6 | steps: 7 | - uses: actions/checkout@v1 8 | - name: Set up Python 9 | uses: actions/setup-python@v1 10 | with: 11 | python-version: "3.x" 12 | - name: Install dependencies 13 | run: | 14 | python -m pip install --upgrade pip 15 | pip install flake8 flake8-broken-line flake8-bugbear flake8-builtins flake8-coding flake8-commas flake8-comprehensions flake8-eradicate flake8-quotes pep8-naming darglint 16 | - name: Lint with flake8 17 | run: | 18 | # stop the build if there are Python syntax errors or undefined names 19 | flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics 20 | # exit-zero treats all errors as warnings. 21 | flake8 . --count --exit-zero --statistics 22 | -------------------------------------------------------------------------------- /tof/apps.py: -------------------------------------------------------------------------------- 1 | # -*- coding: utf-8 -*- 2 | # @Author: MaxST 3 | # @Date: 2019-10-29 10:05:01 4 | # @Last Modified by: MaxST 5 | # @Last Modified time: 2019-11-22 14:24:05 6 | import sys 7 | 8 | from django.apps import AppConfig 9 | from django.db import connection 10 | 11 | 12 | class TofConfig(AppConfig): 13 | """Класс настроек приложения. 14 | 15 | Тут будем при старте сервера кэшировать список переводимых полей 16 | 17 | Attributes: 18 | name: Имя приложения 19 | """ 20 | name = 'tof' 21 | 22 | def ready(self): 23 | # Exception if did not make migration 24 | if connection.introspection.table_names(): 25 | for arg in ('migrate', 'makemigrations'): 26 | if arg in sys.argv: 27 | return # pragma: no cover 28 | for field in self.models_module.TranslatableField.objects.all(): 29 | field.add_translation_to_class() 30 | -------------------------------------------------------------------------------- /example_project/main/migrations/0002_auto_20191119_1134.py: -------------------------------------------------------------------------------- 1 | # Generated by Django 3.0b1 on 2019-11-19 11:34 2 | 3 | from django.db import migrations, models 4 | import django.db.models.deletion 5 | 6 | 7 | class Migration(migrations.Migration): 8 | 9 | dependencies = [ 10 | ('main', '0001_initial'), 11 | ] 12 | 13 | operations = [ 14 | migrations.AlterModelOptions( 15 | name='wine', 16 | options={'ordering': ('sort',), 'verbose_name': 'wine', 'verbose_name_plural': 'wine-plural'}, 17 | ), 18 | migrations.CreateModel( 19 | name='Vintage', 20 | fields=[ 21 | ('id', models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')), 22 | ('year', models.IntegerField(default=0, verbose_name='Year')), 23 | ('wine', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='vintages', to='main.Wine')), 24 | ], 25 | ), 26 | ] 27 | -------------------------------------------------------------------------------- /example_project/main/migrations/0004_winery.py: -------------------------------------------------------------------------------- 1 | # Generated by Django 3.0 on 2019-12-10 19:55 2 | 3 | from django.db import migrations, models 4 | 5 | 6 | class Migration(migrations.Migration): 7 | 8 | dependencies = [ 9 | ('main', '0003_vintage_description'), 10 | ] 11 | 12 | operations = [ 13 | migrations.CreateModel( 14 | name='Winery', 15 | fields=[ 16 | ('id', models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')), 17 | ('title', models.CharField(blank=True, default='', max_length=250, verbose_name='Title')), 18 | ('description', models.TextField(blank=True, null=True, verbose_name='Description')), 19 | ('sort', models.IntegerField(blank=True, default=0, null=True, verbose_name='Sort')), 20 | ], 21 | options={ 22 | 'verbose_name': 'Winery', 23 | 'verbose_name_plural': 'Winery-plural', 24 | 'ordering': ('sort',), 25 | }, 26 | ), 27 | ] 28 | -------------------------------------------------------------------------------- /.github/workflows/tests.yml: -------------------------------------------------------------------------------- 1 | name: Test tof 2 | on: [push] 3 | jobs: 4 | test: 5 | runs-on: ubuntu-latest 6 | strategy: 7 | max-parallel: 4 8 | matrix: 9 | python-version: [3.6, 3.7, 3.8] 10 | fail-fast: false 11 | steps: 12 | - uses: actions/checkout@v1 13 | - name: Set up Python ${{ matrix.python-version }} 14 | uses: actions/setup-python@v1 15 | with: 16 | python-version: ${{ matrix.python-version }} 17 | - name: Install dependencies 18 | run: | 19 | python -m pip install --upgrade pip 20 | python -m pip install poetry 21 | cd ./example_project/ 22 | python -m poetry install 23 | - name: Test with django test 24 | run: | 25 | cd ./example_project/ 26 | python -m poetry run coverage run --source='tof' manage.py test tof 27 | python -m poetry run coverage xml 28 | - name: Codecov 29 | uses: codecov/codecov-action@v1.0.5 30 | with: 31 | token: ${{ secrets.CODECOV_TOKEN }} 32 | file: ./example_project/coverage.xml 33 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | MIT License 2 | 3 | Copyright (c) 2019 Stolpasov Maksim 4 | 5 | Permission is hereby granted, free of charge, to any person obtaining a copy 6 | of this software and associated documentation files (the "Software"), to deal 7 | in the Software without restriction, including without limitation the rights 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 9 | copies of the Software, and to permit persons to whom the Software is 10 | furnished to do so, subject to the following conditions: 11 | 12 | The above copyright notice and this permission notice shall be included in all 13 | copies or substantial portions of the Software. 14 | 15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 21 | SOFTWARE. 22 | -------------------------------------------------------------------------------- /tof/static/tof/js/translation_inline.js: -------------------------------------------------------------------------------- 1 | /* 2 | * @Author: MaxST 3 | * @Date: 2019-12-04 16:33:59 4 | * @Last Modified by: MaxST 5 | * @Last Modified time: 2019-12-15 17:00:55 6 | */ 7 | (function ($) { 8 | "use strict"; 9 | $(document).ready(function () { 10 | var fld = $(".field-field .admin-autocomplete").not("[name*=__prefix__]"); 11 | fld.attr("readonly", true); 12 | fld.on("select2:opening", function (e) { 13 | if ($(this).attr("readonly") || $(this).is(":hidden")) { 14 | e.preventDefault(); 15 | } 16 | }); 17 | fld.each(function () { 18 | if ($(this).is("[readonly]")) { 19 | $(this) 20 | .closest(".form-group") 21 | .find("span.select2-selection__choice__remove") 22 | .first() 23 | .remove(); 24 | $(this) 25 | .closest(".form-group") 26 | .find("li.select2-search") 27 | .first() 28 | .remove(); 29 | $(this) 30 | .closest(".form-group") 31 | .find("span.select2-selection__clear") 32 | .first() 33 | .remove(); 34 | } 35 | }); 36 | }); 37 | }(jQuery)); 38 | -------------------------------------------------------------------------------- /tof/managers.py: -------------------------------------------------------------------------------- 1 | # -*- coding: utf-8 -*- 2 | # @Author: MaxST 3 | # @Date: 2019-11-17 15:02:55 4 | # @Last Modified by: MaxST 5 | # @Last Modified time: 2019-11-19 16:40:49 6 | from django.db import models 7 | 8 | from .decorators import tof_filter, tof_prefetch 9 | 10 | 11 | class DecoratedMixIn: 12 | @tof_filter # noqa 13 | def filter(self, *args, **kwargs): # noqa 14 | return super().filter(*args, **kwargs) 15 | 16 | @tof_filter # noqa 17 | def exclude(self, *args, **kwargs): 18 | return super().exclude(*args, **kwargs) 19 | 20 | @tof_filter # noqa 21 | def get(self, *args, **kwargs): 22 | return super().get(*args, **kwargs) 23 | 24 | 25 | class TranslationsQuerySet(DecoratedMixIn, models.QuerySet): 26 | pass 27 | 28 | 29 | class TranslationManager(DecoratedMixIn, models.Manager): 30 | default_name = 'trans_objects' 31 | _queryset_class = TranslationsQuerySet 32 | 33 | def __init__(self, name=None): 34 | self.default_name = name or self.default_name 35 | super().__init__() 36 | 37 | @tof_prefetch() 38 | def get_queryset(self, *args, **kwargs): 39 | return super().get_queryset(*args, **kwargs) 40 | -------------------------------------------------------------------------------- /tof/settings.py: -------------------------------------------------------------------------------- 1 | # -*- coding: utf-8 -*- 2 | # @Author: MaxST 3 | # @Date: 2019-10-29 17:39:13 4 | # @Last Modified by: MaxST 5 | # @Last Modified time: 2019-11-26 11:57:39 6 | from django.conf import settings 7 | from django.core.exceptions import ImproperlyConfigured 8 | 9 | DEFAULT_LANGUAGE = getattr(settings, 'DEFAULT_LANGUAGE', 'en') or 'en' 10 | 11 | SITE_ID = getattr(settings, 'SITE_ID', None) 12 | 13 | # need support siteid 14 | # maybe beter use information about neighbors 15 | FALLBACK_LANGUAGES = { 16 | SITE_ID: ('en', 'de', 'ru'), 17 | 'fr': ('nl', ), 18 | } 19 | 20 | FALLBACK_LANGUAGES = getattr(settings, 'FALLBACK_LANGUAGES', FALLBACK_LANGUAGES) 21 | 22 | if not isinstance(FALLBACK_LANGUAGES, dict): 23 | raise ImproperlyConfigured('FALLBACK_LANGUAGES is not dict') # pragma: no cover 24 | 25 | for item in FALLBACK_LANGUAGES.values(): 26 | if not isinstance(item, (list, tuple)): 27 | raise ImproperlyConfigured('FALLBACK_LANGUAGES`s values must list ot tuple') # pragma: no cover 28 | 29 | # can be '__all__', 'current', ['en', 'de'], {'en', ('en', 'de', 'ru')} 30 | DEFAULT_FILTER_LANGUAGE = getattr(settings, 'DEFAULT_FILTER_LANGUAGE', 'current') 31 | 32 | CHANGE_DEFAULT_MANAGER = getattr(settings, 'CHANGE_DEFAULT_MANAGER', True) 33 | -------------------------------------------------------------------------------- /tof/templates/tof/multiwidget.html: -------------------------------------------------------------------------------- 1 | {% load i18n static %} 2 | {% spaceless %} 3 | {% get_current_language as LANGUAGE_CODE %} 4 | {% with widget.attrs.id as common_id %} 5 |
6 | {% for widget in widget.subwidgets %} 7 | 8 | 11 |
12 | {% include widget.template_name %} 13 |
14 | {% endfor %} 15 | 20 | 21 |
22 |
23 | {% endwith %} 24 | {% endspaceless %} 25 | -------------------------------------------------------------------------------- /example_project/main/migrations/0001_initial.py: -------------------------------------------------------------------------------- 1 | # Generated by Django 3.0b1 on 2019-10-29 13:55 2 | 3 | from django.db import migrations, models 4 | 5 | 6 | class Migration(migrations.Migration): 7 | 8 | initial = True 9 | 10 | dependencies = [ 11 | ] 12 | 13 | operations = [ 14 | migrations.CreateModel( 15 | name='Wine', 16 | fields=[ 17 | ('id', models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')), 18 | ('title', models.CharField(blank=True, default='', max_length=250, verbose_name='Title')), 19 | ('description', models.TextField(blank=True, null=True, verbose_name='Description')), 20 | ('active', models.BooleanField(default=False, verbose_name='Active')), 21 | ('sort', models.IntegerField(blank=True, default=0, null=True, verbose_name='Sort')), 22 | ('temperature_from', models.FloatField(blank=True, help_text='in ° C', null=True, verbose_name='Temperature_from')), 23 | ('temperature_to', models.FloatField(blank=True, help_text='in ° C', null=True, verbose_name='Temperature_to')), 24 | ], 25 | options={ 26 | 'verbose_name': 'wine', 27 | 'verbose_name_plural': 'wine-plural', 28 | 'ordering': ('title',), 29 | }, 30 | ), 31 | ] 32 | -------------------------------------------------------------------------------- /tof/static/tof/css/style.css: -------------------------------------------------------------------------------- 1 | /* 2 | * @Author: MaxST 3 | * @Date: 2019-11-26 13:42:30 4 | * @Last Modified by: MaxST 5 | * @Last Modified time: 2019-11-29 14:51:37 6 | */ 7 | .itab { 8 | display: none; 9 | opacity: 0; 10 | position: absolute; 11 | } 12 | .tabbed-area { 13 | overflow: hidden; 14 | display: flex; 15 | flex-wrap: wrap; 16 | padding: 0; 17 | } 18 | label.ltab { 19 | text-align: center; 20 | outline: none; 21 | border: 1px solid #CCCCCC; 22 | background: #eeeeee repeat-x; 23 | border-bottom-width: 0; 24 | color: #666666; 25 | padding: 4px 10px; 26 | margin-top: 2px; 27 | -moz-border-radius-topright: 4px; 28 | -webkit-border-top-right-radius: 4px; 29 | -moz-border-radius-topleft: 4px; 30 | -webkit-border-top-left-radius: 4px; 31 | border-top-left-radius: 4px; 32 | border-top-right-radius: 4px; 33 | display: block; 34 | width: 18px; 35 | } 36 | .ltab:hover { 37 | background-color: #ddd; 38 | cursor: pointer; 39 | } 40 | .itab:checked + .ltab { 41 | background: #7CA0C7 repeat-x; 42 | color: #fff; 43 | padding: 6px 10px 4px; 44 | margin-top: 0; 45 | } 46 | .tab { 47 | display: none; 48 | order: 99; 49 | flex-grow: 1; 50 | width: 100%; 51 | } 52 | .itab:checked + .ltab + .tab { 53 | display: block; 54 | } 55 | .related-widget-wrapper-link.add-language, 56 | .related-widget-wrapper-link.add-language:hover { 57 | text-decoration: initial; 58 | opacity: .8; 59 | color: initial; 60 | } 61 | -------------------------------------------------------------------------------- /example_project/example/urls.py: -------------------------------------------------------------------------------- 1 | # -*- coding: utf-8 -*- 2 | """example URL Configuration 3 | 4 | The `urlpatterns` list routes URLs to views. For more information please see: 5 | https://docs.djangoproject.com/en/dev/topics/http/urls/ 6 | Examples: 7 | Function views 8 | 1. Add an import: from my_app import views 9 | 2. Add a URL to urlpatterns: path('', views.home, name='home') 10 | Class-based views 11 | 1. Add an import: from other_app.views import Home 12 | 2. Add a URL to urlpatterns: path('', Home.as_view(), name='home') 13 | Including another URLconf 14 | 1. Import the include() function: from django.urls import include, path 15 | 2. Add a URL to urlpatterns: path('blog/', include('blog.urls')) 16 | """ 17 | from django.conf import settings 18 | from django.conf.urls.i18n import i18n_patterns # for local 19 | from django.contrib import admin 20 | from django.shortcuts import redirect 21 | from django.urls import include, path 22 | from main.views import Index 23 | 24 | urlpatterns = i18n_patterns( 25 | path('admin/', admin.site.urls), 26 | path('', Index.as_view()), 27 | ) 28 | 29 | if settings.DEBUG: 30 | if 'debug_toolbar' in settings.INSTALLED_APPS: 31 | import debug_toolbar 32 | urlpatterns = [ 33 | path('__debug__/', include(debug_toolbar.urls)), 34 | ] + urlpatterns 35 | else: 36 | urlpatterns = i18n_patterns(path('admin/password_change/', lambda x: redirect('admin:index'))) + urlpatterns 37 | -------------------------------------------------------------------------------- /pyproject.toml: -------------------------------------------------------------------------------- 1 | [tool.poetry] 2 | name = 'django-tof' 3 | version = "0.3.2" 4 | description = 'Translate fields of django models without having to restart the server, without changing the model code.' 5 | authors = ['MaxST '] 6 | license = 'MIT' 7 | repository = 'https://github.com/mom1/django-tof' 8 | homepage = 'https://github.com/mom1/django-tof/wiki/django-tof' 9 | keywords = ['translations', 'translate', 'django', 'model'] 10 | readme = 'README.md' 11 | classifiers = [ 12 | 'Development Status :: 5 - Production/Stable', 13 | 'Environment :: Web Environment', 14 | 'Framework :: Django', 15 | 'Framework :: Django :: 2.2', 16 | 'Framework :: Django :: 3.0', 17 | 'Intended Audience :: Developers', 18 | 'License :: OSI Approved :: MIT License', 19 | 'Operating System :: OS Independent', 20 | 'Programming Language :: Python', 21 | 'Programming Language :: Python :: 3.6', 22 | 'Programming Language :: Python :: 3.7', 23 | 'Programming Language :: Python :: 3.8', 24 | 'Topic :: Database', 25 | 'Topic :: Internet :: WWW/HTTP :: Dynamic Content', 26 | 'Topic :: Text Processing :: Linguistic' 27 | ] 28 | include = ['AUTHORS'] 29 | exclude = ['setup.cfg'] 30 | packages = [ 31 | { include = 'tof' }, 32 | ] 33 | 34 | [tool.poetry.dependencies] 35 | python = '^3.6' 36 | django = '>=2.2' 37 | 38 | [tool.poetry.dev-dependencies] 39 | 40 | [build-system] 41 | requires = ['poetry>=0.12'] 42 | build-backend = 'poetry.masonry.api' 43 | -------------------------------------------------------------------------------- /tof/migrations/0003_auto_20191127_0907.py: -------------------------------------------------------------------------------- 1 | # Generated by Django 3.0rc1 on 2019-11-27 09:07 2 | 3 | from django.db import migrations, models 4 | import django.db.models.deletion 5 | 6 | 7 | class Migration(migrations.Migration): 8 | 9 | dependencies = [ 10 | ('contenttypes', '0002_remove_content_type_name'), 11 | ('tof', '0002_auto_20191118_1000'), 12 | ] 13 | 14 | operations = [ 15 | migrations.AlterField( 16 | model_name='translatablefield', 17 | name='content_type', 18 | field=models.ForeignKey(limit_choices_to=models.Q(_negated=True, app_label='tof'), on_delete=django.db.models.deletion.CASCADE, related_name='translatablefields', to='contenttypes.ContentType'), 19 | ), 20 | migrations.AlterField( 21 | model_name='translation', 22 | name='content_type', 23 | field=models.ForeignKey(limit_choices_to=models.Q(_negated=True, app_label='tof'), on_delete=django.db.models.deletion.CASCADE, related_name='translations', to='contenttypes.ContentType'), 24 | ), 25 | migrations.AlterField( 26 | model_name='translation', 27 | name='field', 28 | field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='translations', to='tof.TranslatableField'), 29 | ), 30 | migrations.AlterField( 31 | model_name='translation', 32 | name='lang', 33 | field=models.ForeignKey(limit_choices_to=models.Q(is_active=True), on_delete=django.db.models.deletion.CASCADE, related_name='translations', to='tof.Language'), 34 | ), 35 | ] 36 | -------------------------------------------------------------------------------- /tof/utils.py: -------------------------------------------------------------------------------- 1 | # -*- coding: utf-8 -*- 2 | # @Author: MaxST 3 | # @Date: 2019-10-30 14:19:55 4 | # @Last Modified by: MaxST 5 | # @Last Modified time: 2019-12-01 15:56:34 6 | from django.utils.html import html_safe 7 | from django.utils.translation import get_language 8 | from .settings import DEFAULT_LANGUAGE, FALLBACK_LANGUAGES, SITE_ID 9 | 10 | 11 | @html_safe 12 | class TranslatableText(str): 13 | def __getattr__(self, attr): 14 | if len(attr) == 2: 15 | attrs = vars(self) 16 | for lang in self.get_fallback_languages(attr): 17 | if lang in attrs: 18 | return attrs[lang] 19 | return attrs.get('_origin') or '' 20 | raise AttributeError(attr) 21 | 22 | def __getitem__(self, key): 23 | return str(self)[key] 24 | 25 | def __str__(self): 26 | return getattr(self, self.get_lang(), '') 27 | 28 | def __repr__(self): 29 | return f"'{self}'" 30 | 31 | def __eq__(self, other): 32 | return str(self) == str(other) 33 | 34 | def __add__(self, other): 35 | return f'{self}{other}' 36 | 37 | def __radd__(self, other): 38 | return f'{other}{self}' 39 | 40 | def __bool__(self): 41 | return bool(vars(self)) 42 | 43 | @staticmethod 44 | def get_lang(): 45 | lang, *_ = get_language().partition('-') 46 | return lang 47 | 48 | def get_fallback_languages(self, attr): 49 | for fallback in (FALLBACK_LANGUAGES.get(attr) or (), FALLBACK_LANGUAGES.get(SITE_ID) or ()): 50 | yield from (lang for lang in fallback if lang != attr) 51 | yield DEFAULT_LANGUAGE 52 | -------------------------------------------------------------------------------- /example_project/main/models.py: -------------------------------------------------------------------------------- 1 | # -*- coding: utf-8 -*- 2 | # @Author: MaxST 3 | # @Date: 2019-10-28 20:30:42 4 | # @Last Modified by: MaxST 5 | # @Last Modified time: 2019-12-10 22:48:00 6 | from django.db import models 7 | from django.utils.translation import gettext_lazy as _ 8 | 9 | 10 | class Winery(models.Model): 11 | class Meta: 12 | verbose_name = _('Winery') 13 | verbose_name_plural = _('Winery-plural') 14 | ordering = ('sort', ) 15 | 16 | title = models.CharField(_('Title'), max_length=250, default='', blank=True, null=False) 17 | description = models.TextField(_('Description'), null=True, blank=True) 18 | sort = models.IntegerField(_('Sort'), default=0, blank=True, null=True) 19 | 20 | 21 | class Wine(models.Model): 22 | class Meta: 23 | verbose_name = _('wine') 24 | verbose_name_plural = _('wine-plural') 25 | ordering = ('sort', ) 26 | 27 | title = models.CharField(_('Title'), max_length=250, default='', blank=True, null=False) 28 | description = models.TextField(_('Description'), null=True, blank=True) 29 | active = models.BooleanField(_('Active'), default=False) 30 | sort = models.IntegerField(_('Sort'), default=0, blank=True, null=True) 31 | 32 | temperature_from = models.FloatField(_('Temperature_from'), help_text=_('in ° C'), null=True, blank=True) 33 | temperature_to = models.FloatField(_('Temperature_to'), help_text=_('in ° C'), null=True, blank=True) 34 | 35 | 36 | class Vintage(models.Model): 37 | wine = models.ForeignKey(Wine, related_name='vintages', on_delete=models.CASCADE) 38 | year = models.IntegerField(_('Year'), default=0) 39 | description = models.TextField(_('Description'), null=True, blank=True) 40 | -------------------------------------------------------------------------------- /tof/management/commands/benchmark.py: -------------------------------------------------------------------------------- 1 | # -*- coding: utf-8 -*- 2 | # @Author: MaxST 3 | # @Date: 2019-11-25 13:13:55 4 | # @Last Modified by: MaxST 5 | # @Last Modified time: 2019-11-25 15:24:50 6 | import timeit 7 | 8 | from django.contrib.contenttypes.models import ContentType 9 | from django.core.management.base import BaseCommand 10 | from django.utils import translation 11 | from main.models import Wine 12 | from mixer.backend.django import mixer 13 | from tof.models import TranslatableField 14 | 15 | 16 | class Command(BaseCommand): 17 | def handle(self, *args, **options): 18 | n = 1000 19 | nruns = 10 20 | translation.activate('it') 21 | 22 | ct = ContentType.objects.get_for_model(Wine) 23 | TranslatableField.objects.all().delete() 24 | fld = TranslatableField.objects.create(name='title', title='Title', content_type=ct) 25 | fld.save() 26 | Wine.objects.all().delete() 27 | some_models = mixer.cycle(n).blend(Wine, title=mixer.sequence('Wine {0}')) 28 | with translation.override('it'): 29 | for instance in some_models: 30 | instance.title = 'it ' + instance.title 31 | instance.save() 32 | 33 | print( 34 | 'TOF', 35 | timeit.timeit(""" 36 | for m in Wine.objects.all(): 37 | if not m.title.it.startswith('it'): 38 | raise ValueError(m.title) 39 | """, 40 | globals=globals(), 41 | number=1)) 42 | print( 43 | 'TOF', 44 | timeit.timeit(""" 45 | for m in Wine.objects.all(): 46 | if not m.title.it.startswith('it'): 47 | raise ValueError(m.title) 48 | """, 49 | globals=globals(), 50 | number=nruns) / nruns) 51 | -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | # Byte-compiled / optimized / DLL files 2 | __pycache__/ 3 | *.py[cod] 4 | *$py.class 5 | 6 | # C extensions 7 | *.so 8 | 9 | # Distribution / packaging 10 | .Python 11 | build/ 12 | develop-eggs/ 13 | dist/ 14 | downloads/ 15 | eggs/ 16 | .eggs/ 17 | lib/ 18 | lib64/ 19 | parts/ 20 | sdist/ 21 | var/ 22 | wheels/ 23 | *.egg-info/ 24 | .installed.cfg 25 | *.egg 26 | MANIFEST 27 | pip-wheel-metadata/ 28 | 29 | # PyInstaller 30 | # Usually these files are written by a python script from a template 31 | # before PyInstaller builds the exe, so as to inject date/other infos into it. 32 | *.manifest 33 | *.spec 34 | 35 | # Installer logs 36 | pip-log.txt 37 | pip-delete-this-directory.txt 38 | 39 | # Unit test / coverage reports 40 | htmlcov/ 41 | .tox/ 42 | .coverage 43 | .coverage.* 44 | .cache 45 | nosetests.xml 46 | coverage.xml 47 | *.cover 48 | .hypothesis/ 49 | .pytest_cache/ 50 | 51 | # Translations 52 | *.mo 53 | *.pot 54 | 55 | # Django stuff: 56 | *.log 57 | local_settings.py 58 | db.sqlite3 59 | db.sqlite3-journal 60 | 61 | # Flask stuff: 62 | instance/ 63 | .webassets-cache 64 | 65 | # Scrapy stuff: 66 | .scrapy 67 | 68 | # Sphinx documentation 69 | docs/_build/ 70 | 71 | # PyBuilder 72 | target/ 73 | 74 | # Jupyter Notebook 75 | .ipynb_checkpoints 76 | 77 | # pyenv 78 | .python-version 79 | 80 | # celery beat schedule file 81 | celerybeat-schedule 82 | 83 | # SageMath parsed files 84 | *.sage.py 85 | 86 | # Environments 87 | .env 88 | .venv 89 | env/ 90 | venv/ 91 | ENV/ 92 | env.bak/ 93 | venv.bak/ 94 | 95 | # pycharm 96 | .idea/ 97 | 98 | # Spyder project settings 99 | .spyderproject 100 | .spyproject 101 | 102 | # Rope project settings 103 | .ropeproject 104 | 105 | # mkdocs documentation 106 | /site 107 | 108 | # mypy 109 | .mypy_cache/ 110 | -------------------------------------------------------------------------------- /example_project/main/admin.py: -------------------------------------------------------------------------------- 1 | # -*- coding: utf-8 -*- 2 | # @Author: MaxST 3 | # @Date: 2019-10-28 20:30:42 4 | # @Last Modified by: MaxST 5 | # @Last Modified time: 2019-12-10 22:54:21 6 | from django.contrib import admin 7 | from tof.admin import TofAdmin, TranslationTabularInline 8 | from tof.decorators import tof_prefetch 9 | 10 | from .models import Vintage, Wine, Winery 11 | 12 | 13 | @admin.register(Winery) 14 | class WineryAdmin(TofAdmin): 15 | """Example translatable field №3 16 | 17 | This class is example where you can see Tabular inline 18 | 19 | Attributes: 20 | list_display: [description] 21 | search_fields: [description] 22 | inlines 23 | """ 24 | list_display = ('title', 'description', 'sort') 25 | search_fields = ('title', ) 26 | inlines = (TranslationTabularInline, ) 27 | 28 | 29 | @admin.register(Wine) 30 | class WineAdmin(TofAdmin): 31 | """Example translatable field №2 32 | 33 | This class is example where translatable field save values to all added languages 34 | 35 | Attributes: 36 | list_display: [description] 37 | search_fields: [description] 38 | form: [description] 39 | """ 40 | list_display = ('title', 'description', 'active', 'sort') 41 | search_fields = ('title', ) 42 | only_current_lang = ('description', ) 43 | 44 | 45 | @admin.register(Vintage) 46 | class VintageAdmin(admin.ModelAdmin): 47 | """Example translatable field №1 48 | 49 | This class is example where translatable field save value only in current language 50 | 51 | Attributes: 52 | list_display: [description] 53 | """ 54 | list_display = search_fields = ('wine__title', 'year', 'description') 55 | 56 | def wine__title(self, obj, *args, **kwargs): 57 | return obj.wine.title 58 | 59 | @tof_prefetch('wine') 60 | def get_queryset(self, request): 61 | return super().get_queryset(request) 62 | -------------------------------------------------------------------------------- /tof/static/tof/js/translatable_fields_widget.js: -------------------------------------------------------------------------------- 1 | /* 2 | * @Author: MaxST 3 | * @Date: 2019-11-26 13:42:43 4 | * @Last Modified by: MaxST 5 | * @Last Modified time: 2019-12-15 17:14:38 6 | */ 7 | (function ($) { 8 | "use strict"; 9 | function dismissRelatedLookupPopupLang(win, chosenId) { 10 | $ = django.jQuery; 11 | var name = windowname_to_id(win.name); 12 | var elem = document.getElementById(name); 13 | if (elem.className.indexOf("vManyToManyRawIdAdminField") !== -1 && elem.value) { 14 | elem.value += "," + chosenId; 15 | } 16 | if (elem.className.indexOf("itab") !== -1 && elem.value) { 17 | var newItab = $(".itab", $(elem.parentNode)).first().clone(); 18 | var newLtab = $(".ltab", $(elem.parentNode)).first().clone(); 19 | var newTab = $(".tab", $(elem.parentNode)).first().clone(); 20 | var arrId = newItab.attr("id").split("_"); 21 | arrId[0] = chosenId; 22 | arrId[arrId.length - 1] = chosenId; 23 | var additionalId = arrId.join("_"); 24 | var oldLabel = $('.ltab[for="' + additionalId + '"]'); 25 | if (oldLabel.length === 0) { 26 | newItab.attr("id", additionalId); 27 | newLtab.attr("for", additionalId); 28 | newLtab.text(chosenId); 29 | newTab.children().attr({id: arrId.slice(1).join("_"), name: arrId.slice(2).join("_"), value: "", lang: chosenId}).text("").val(""); 30 | var destination = ".tabbed-area._" + newItab.attr("name") + " .add-tab"; 31 | newItab.insertBefore(destination); 32 | newLtab.insertBefore(destination); 33 | newTab.insertBefore(destination); 34 | newLtab.click(); 35 | } else { 36 | oldLabel.click(); 37 | } 38 | } else { 39 | document.getElementById(name).value = chosenId; 40 | } 41 | win.close(); 42 | } 43 | $(document).ready(function () { 44 | window.dismissRelatedLookupPopup = dismissRelatedLookupPopupLang; 45 | }); 46 | })(jQuery); 47 | -------------------------------------------------------------------------------- /docs/diagrams/struct.uml: -------------------------------------------------------------------------------- 1 | @startuml 2 | package models.py <> { 3 | class Translations { 4 | + content_type 5 | + object_id 6 | + {field} content_object : GenericForeignKey() 7 | + field 8 | + lang 9 | + value 10 | } 11 | 12 | abstract class TranslationsFieldsMixin { 13 | + {field} _translations : GenericRelation('Translations') 14 | + __init__() 15 | # {method} _all_translations : cached_property Dict 16 | + save() 17 | + _add_deferred_translated_field(name) : classmethod 18 | + _del_deferred_translated_field(name) : classmethod 19 | } 20 | 21 | class TranslatableFields { 22 | + name 23 | + title 24 | + content_type 25 | + save() 26 | + delete() 27 | } 28 | 29 | class Language { 30 | + iso_639_1 31 | + iso_639_2T 32 | + iso_639_2B 33 | + iso_639_3 34 | + family 35 | } 36 | Translations -up-> Language : "lang" 37 | Translations -down-> TranslatableFields 38 | TranslationsFieldsMixin -> Translations 39 | } 40 | package apps.py <>{ 41 | class TofConfig(AppConfig) { 42 | + name = 'tof' 43 | + ready() 44 | } 45 | } 46 | 47 | package query_utils.py <>{ 48 | class DeferredTranslatedAttribute { 49 | field 50 | __init__(field) 51 | __get__(instance) 52 | get_translation(instance=None, field_name=None, language=None) 53 | get_fallback_languages(lang) : lru_cache(maxsize=32) 54 | get_lang(is_obj=False) 55 | get_field_name(ct=None) 56 | get_trans_field_name() 57 | __set__(instance, value) 58 | save(instance) 59 | __delete__(instance) 60 | } 61 | } 62 | 63 | package other_django_apps <>{ 64 | class SomeModel{ 65 | + title 66 | + description 67 | } 68 | } 69 | 70 | note right of SomeModel : Динамически наследуется в\napps.py TofConfig.ready() 71 | 72 | TranslationsFieldsMixin <|-- SomeModel 73 | TranslationsFieldsMixin "1" *-right- "1..*" DeferredTranslatedAttribute : "_field_tof" 74 | Translations --> SomeModel : "content_type" 75 | TranslatableFields --> SomeModel : "content_type" 76 | @enduml 77 | -------------------------------------------------------------------------------- /tof/static/tof/js/translation_form.js: -------------------------------------------------------------------------------- 1 | /* 2 | * @Author: MaxST 3 | * @Date: 2019-11-09 13:52:25 4 | * @Last Modified by: MaxST 5 | * @Last Modified time: 2019-12-15 17:15:01 6 | */ 7 | (function ($) { 8 | "use strict"; 9 | window.generic_view_json = function (url, text) { 10 | var $drop = $("#id_object_id"); 11 | var $select = $drop; 12 | var value = $drop.val(); 13 | if (! $select.parent().is(".related-widget-wrapper")) { 14 | $select = $('
'); 15 | $drop.replaceWith($select); 16 | } else { 17 | $select = $select.parent(); 18 | } 19 | var sel = $(""); 20 | sel.attr({ 21 | "id": "id_name", 22 | "name": "name", 23 | "class": "admin-autocomplete", 24 | "tabindex": -1, 25 | "data-allow-clear": false, 26 | "data-placeholder": "", 27 | "data-theme": "admin-autocomplete" 28 | }); 29 | var data = [{id: "", text: ""}]; 30 | sel.append(''); 31 | $.each(fields, function (index, field) { 32 | var selected = ""; 33 | if (field === value) { 34 | selected = "selected"; 35 | } 36 | sel.append('"); 37 | data.push({id: field, text: field}); 38 | }); 39 | var commonData = data; 40 | $select.html(sel); 41 | $("#id_name").change(function () { 42 | var title = $(this).val(); 43 | $("#id_title").val(title[0].toUpperCase() + title.slice(1)); 44 | }); 45 | return $("#id_name").djangoAdminSelect2({ 46 | ajax: { 47 | data(requestData) { 48 | commonData = data.filter(function(item) { 49 | if (requestData.term) { 50 | return item.text.startsWith(requestData.term); 51 | } 52 | return true; 53 | }); 54 | }, 55 | processResults(getData, page) { 56 | return {results: commonData}; 57 | } 58 | } 59 | }); 60 | }; 61 | $(document).ready(function () { 62 | $("#id_content_type").change(); 63 | $("#id_content_type").change(function () { 64 | $("#id_name").removeAttr("readonly"); 65 | if (!$(this).val()) { 66 | $("#id_name").attr("readonly", true); 67 | return; 68 | } 69 | $.get({ 70 | url: "?id_ct=" + $(this).val(), 71 | success(data, textStatus, jqXHR) { 72 | if (data.errors) { 73 | return alert(data.errors); 74 | } 75 | generic_view_json(data.fields, data.text); 76 | }, 77 | dataType: "json" 78 | }); 79 | }); 80 | }); 81 | 82 | }(jQuery)); 83 | 84 | -------------------------------------------------------------------------------- /tof/migrations/0001_initial.py: -------------------------------------------------------------------------------- 1 | # Generated by Django 3.0b1 on 2019-11-18 10:00 2 | 3 | from django.db import migrations, models 4 | import django.db.models.deletion 5 | 6 | 7 | class Migration(migrations.Migration): 8 | 9 | initial = True 10 | 11 | dependencies = [ 12 | ('contenttypes', '0002_remove_content_type_name'), 13 | ] 14 | 15 | operations = [ 16 | migrations.CreateModel( 17 | name='Language', 18 | fields=[ 19 | ('iso', models.CharField(max_length=2, primary_key=True, serialize=False, unique=True)), 20 | ('is_active', models.BooleanField(default=True, verbose_name='Active')), 21 | ], 22 | options={ 23 | 'verbose_name': 'Language', 24 | 'verbose_name_plural': 'Languages', 25 | 'ordering': ['iso'], 26 | }, 27 | ), 28 | migrations.CreateModel( 29 | name='TranslatableField', 30 | fields=[ 31 | ('id', models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')), 32 | ('name', models.CharField(help_text='Name field', max_length=250, verbose_name='Field name')), 33 | ('title', models.CharField(help_text="Name user's field", max_length=250, verbose_name='User field name')), 34 | ('content_type', models.ForeignKey(limit_choices_to=models.Q(_negated=True, app_label='tof'), on_delete=django.db.models.deletion.CASCADE, to='contenttypes.ContentType')), 35 | ], 36 | options={ 37 | 'verbose_name': 'Translatable field', 38 | 'verbose_name_plural': 'Translatable fields', 39 | 'ordering': ('content_type', 'name'), 40 | 'unique_together': {('content_type', 'name')}, 41 | }, 42 | ), 43 | migrations.CreateModel( 44 | name='Translation', 45 | fields=[ 46 | ('id', models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')), 47 | ('object_id', models.PositiveIntegerField(help_text='First set the field')), 48 | ('value', models.TextField(help_text='Value field', verbose_name='Value')), 49 | ('content_type', models.ForeignKey(limit_choices_to=models.Q(_negated=True, app_label='tof'), on_delete=django.db.models.deletion.CASCADE, to='contenttypes.ContentType')), 50 | ('field', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='Translation', to='tof.TranslatableField')), 51 | ('lang', models.ForeignKey(limit_choices_to=models.Q(is_active=True), on_delete=django.db.models.deletion.CASCADE, related_name='Translation', to='tof.Language')), 52 | ], 53 | options={ 54 | 'verbose_name': 'Translation', 55 | 'verbose_name_plural': 'Translation', 56 | 'unique_together': {('content_type', 'object_id', 'field', 'lang')}, 57 | }, 58 | ), 59 | ] 60 | -------------------------------------------------------------------------------- /tof/fields.py: -------------------------------------------------------------------------------- 1 | # -*- coding: utf-8 -*- 2 | # @Author: MaxST 3 | # @Date: 2019-11-26 19:55:31 4 | # @Last Modified by: MaxST 5 | # @Last Modified time: 2019-11-29 12:04:04 6 | from django.core.exceptions import ValidationError 7 | from django.forms.fields import CharField, MultiValueField 8 | from django.utils.translation import get_language 9 | 10 | from .forms import TranslatableFieldHiddenWidget, TranslatableFieldWidget 11 | from .utils import TranslatableText 12 | 13 | 14 | class TranslatableFieldFormField(MultiValueField): 15 | widget = TranslatableFieldWidget 16 | hidden_widget = TranslatableFieldHiddenWidget 17 | 18 | def __init__(self, field=None, *args, **kwargs): 19 | fld = (field or CharField(*args, **kwargs)) 20 | fld.widget.attrs.update({'lang': get_language()}) 21 | widget = self.widget(fld.widget) 22 | super().__init__((fld,), widget=widget) 23 | 24 | def compress(self, data_list): 25 | trans = TranslatableText() 26 | vars(trans).update({key if key else get_language(): val for key, val in data_list}) 27 | return trans 28 | 29 | def clean(self, value): 30 | clean_data = [] 31 | errors = [] 32 | if self.disabled and not isinstance(value, list): 33 | value = self.widget.decompress(value) 34 | if not value or isinstance(value, (list, tuple)): 35 | if not value or not [v for v in value if v[1] not in self.empty_values]: 36 | if self.required: 37 | raise ValidationError(self.error_messages['required'], code='required') 38 | else: 39 | return self.compress([]) 40 | else: 41 | raise ValidationError(self.error_messages['invalid'], code='invalid') 42 | for lang, field_value in value: 43 | if field_value in self.empty_values: 44 | if self.require_all_fields: 45 | # Raise a 'required' error if the MultiValueField is 46 | # required and any field is empty. 47 | if self.required: 48 | raise ValidationError(self.error_messages['required'], code='required') 49 | elif self.fields[0].required: 50 | # Otherwise, add an 'incomplete' error to the list of 51 | # collected errors and skip field cleaning, if a required 52 | # field is empty. 53 | if self.fields[0].error_messages['incomplete'] not in errors: 54 | errors.append(self.fields[0].error_messages['incomplete']) 55 | continue 56 | try: 57 | clean_data.append((lang, self.fields[0].clean(field_value))) 58 | except ValidationError as e: 59 | # Collect all validation errors in a single list, which we'll 60 | # raise at the end of clean(), rather than raising a single 61 | # exception for the first error we encounter. Skip duplicates. 62 | errors.extend(m for m in e.error_list if m not in errors) 63 | if errors: 64 | raise ValidationError(errors) 65 | 66 | out = self.compress(clean_data) 67 | self.validate(out) 68 | self.run_validators(out) 69 | return out 70 | -------------------------------------------------------------------------------- /tof/decorators.py: -------------------------------------------------------------------------------- 1 | # -*- coding: utf-8 -*- 2 | # @Author: MaxST 3 | # @Date: 2019-11-17 15:03:06 4 | # @Last Modified by: MaxST 5 | # @Last Modified time: 2019-12-15 16:25:52 6 | from functools import wraps 7 | 8 | from django.db.models import Q 9 | from django.utils.translation import get_language 10 | 11 | from .settings import DEFAULT_FILTER_LANGUAGE, DEFAULT_LANGUAGE 12 | 13 | 14 | def tof_prefetch(*wrapper_args): 15 | def _tof_prefetch(func): 16 | @wraps(func) 17 | def wrapper(*args, **kwargs): 18 | entrys = [ 19 | f'{i}___translations' for i in wrapper_args 20 | if getattr(getattr(args[0].model, i).field.related_model, '_translations', None) 21 | ] if wrapper_args else ['_translations'] 22 | return func(*args, **kwargs).prefetch_related(*entrys) 23 | 24 | return wrapper 25 | 26 | return _tof_prefetch 27 | 28 | 29 | def tof_filter(func): 30 | @wraps(func) 31 | def wrapper(self, *args, **kwargs): 32 | tof_fields = getattr(self.model._meta, '_field_tof', {}).get('by_name') 33 | new_args, new_kwargs = args, kwargs 34 | if tof_fields: 35 | new_args = [] 36 | for arg in args: 37 | if isinstance(arg, Q): 38 | # modify Q objects (warning: recursion ahead) 39 | arg = expand_q_filters(arg, tof_fields) 40 | new_args.append(arg) 41 | 42 | new_kwargs = {} 43 | for key, value in list(kwargs.items()): 44 | # modify kwargs (warning: recursion ahead) 45 | new_key, new_value, _ = expand_filter(tof_fields, key, value) 46 | new_kwargs.update({new_key: new_value}) 47 | 48 | return func(self, *new_args, **new_kwargs) 49 | 50 | return wrapper 51 | 52 | 53 | def expand_q_filters(q, tof_fields): 54 | new_children = [] 55 | for qi in q.children: 56 | if isinstance(qi, tuple): 57 | # this child is a leaf node: in Q this is a 2-tuple of: 58 | # (filter parameter, value) 59 | key, value, repl = expand_filter(tof_fields, *qi) 60 | query = Q(**{key: value}) 61 | if repl: 62 | query |= Q(**{qi[0]: qi[1]}) 63 | new_children.append(query) 64 | else: 65 | # this child is another Q node: recursify! 66 | new_children.append(expand_q_filters(qi, tof_fields)) 67 | q.children = new_children 68 | return q 69 | 70 | 71 | def expand_filter(tof_fields, key, value): 72 | field_name, sep, lookup = key.partition('__') 73 | field = tof_fields.get(field_name) 74 | if field: 75 | query = Q(**{f'value{sep}{lookup}': value}) 76 | if DEFAULT_FILTER_LANGUAGE == '__all__': 77 | pass 78 | elif DEFAULT_FILTER_LANGUAGE == 'current': 79 | query &= Q(lang=get_language()) 80 | elif isinstance(DEFAULT_FILTER_LANGUAGE, basestring): 81 | query &= Q(lang=DEFAULT_FILTER_LANGUAGE) 82 | elif isinstance(DEFAULT_FILTER_LANGUAGE, (list, tuple)): 83 | query &= Q(lang__in=DEFAULT_FILTER_LANGUAGE) 84 | elif isinstance(DEFAULT_FILTER_LANGUAGE, dict): 85 | query &= Q(lang__in=DEFAULT_FILTER_LANGUAGE.get(get_language(), (DEFAULT_LANGUAGE, ))) 86 | else: 87 | query &= Q(lang=get_language()) 88 | return 'id__in', field.translations.filter(query).values_list('object_id', flat=True), True 89 | return key, value, False 90 | -------------------------------------------------------------------------------- /example_project/example/settings.py: -------------------------------------------------------------------------------- 1 | """ 2 | Django settings for example project. 3 | 4 | Generated by 'django-admin startproject' using Django 3.0b1. 5 | 6 | For more information on this file, see 7 | https://docs.djangoproject.com/en/dev/topics/settings/ 8 | 9 | For the full list of settings and their values, see 10 | https://docs.djangoproject.com/en/dev/ref/settings/ 11 | """ 12 | 13 | import os 14 | 15 | # Build paths inside the project like this: os.path.join(BASE_DIR, ...) 16 | BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__))) 17 | 18 | # Quick-start development settings - unsuitable for production 19 | # See https://docs.djangoproject.com/en/dev/howto/deployment/checklist/ 20 | 21 | # SECURITY WARNING: keep the secret key used in production secret! 22 | SECRET_KEY = 'e&-64ptoq=#jwr3_957abcxm0k2#pe$3kw$z4qdval&6f*m4sw' 23 | 24 | # SECURITY WARNING: don't run with debug turned on in production! 25 | DEBUG = True 26 | 27 | ALLOWED_HOSTS = [] 28 | 29 | # Application definition 30 | 31 | INSTALLED_APPS = [ 32 | 'django.contrib.admin', 33 | 'django.contrib.auth', 34 | 'django.contrib.contenttypes', 35 | 'django.contrib.sessions', 36 | 'django.contrib.messages', 37 | 'django.contrib.staticfiles', 38 | 'main', 39 | 'tof', 40 | ] 41 | 42 | MIDDLEWARE = [ 43 | 'django.middleware.security.SecurityMiddleware', 44 | 'django.contrib.sessions.middleware.SessionMiddleware', 45 | 'django.middleware.locale.LocaleMiddleware', # for local 46 | 'django.middleware.common.CommonMiddleware', 47 | 'django.middleware.csrf.CsrfViewMiddleware', 48 | 'django.contrib.auth.middleware.AuthenticationMiddleware', 49 | 'django.contrib.messages.middleware.MessageMiddleware', 50 | 'django.middleware.clickjacking.XFrameOptionsMiddleware', 51 | ] 52 | 53 | if DEBUG: 54 | INSTALLED_APPS += ['debug_toolbar'] 55 | INTERNAL_IPS = ['127.0.0.1'] 56 | MIDDLEWARE = ['debug_toolbar.middleware.DebugToolbarMiddleware'] + MIDDLEWARE 57 | ROOT_URLCONF = 'example.urls' 58 | 59 | TEMPLATES = [ 60 | { 61 | 'BACKEND': 'django.template.backends.django.DjangoTemplates', 62 | 'DIRS': [], 63 | 'APP_DIRS': True, 64 | 'OPTIONS': { 65 | 'context_processors': [ 66 | 'django.template.context_processors.debug', 67 | 'django.template.context_processors.request', 68 | 'django.contrib.auth.context_processors.auth', 69 | 'django.contrib.messages.context_processors.messages', 70 | ], 71 | }, 72 | }, 73 | ] 74 | 75 | WSGI_APPLICATION = 'example.wsgi.application' 76 | 77 | # Database 78 | # https://docs.djangoproject.com/en/dev/ref/settings/#databases 79 | 80 | DATABASES = { 81 | 'default': { 82 | 'ENGINE': 'django.db.backends.sqlite3', 83 | 'NAME': os.path.join(BASE_DIR, 'db.sqlite3'), 84 | } 85 | } 86 | 87 | # Password validation 88 | # https://docs.djangoproject.com/en/dev/ref/settings/#auth-password-validators 89 | 90 | AUTH_PASSWORD_VALIDATORS = [ 91 | { 92 | 'NAME': 'django.contrib.auth.password_validation.UserAttributeSimilarityValidator', 93 | }, 94 | { 95 | 'NAME': 'django.contrib.auth.password_validation.MinimumLengthValidator', 96 | }, 97 | { 98 | 'NAME': 'django.contrib.auth.password_validation.CommonPasswordValidator', 99 | }, 100 | { 101 | 'NAME': 'django.contrib.auth.password_validation.NumericPasswordValidator', 102 | }, 103 | ] 104 | 105 | # Internationalization 106 | # https://docs.djangoproject.com/en/dev/topics/i18n/ 107 | 108 | LANGUAGE_CODE = 'en-us' 109 | 110 | TIME_ZONE = 'UTC' 111 | 112 | USE_I18N = True 113 | 114 | USE_L10N = True 115 | 116 | USE_TZ = True 117 | 118 | # Static files (CSS, JavaScript, Images) 119 | # https://docs.djangoproject.com/en/dev/howto/static-files/ 120 | 121 | STATIC_URL = '/static/' 122 | -------------------------------------------------------------------------------- /wiki_django_tof.md: -------------------------------------------------------------------------------- 1 | ## Goal 2 | 3 | Create a freeware library to run translation of fields without need to 4 | restart the server, without changing model code, storing the translations 5 | in database and ability to search all translations, current language or by 6 | translations of a specify language. 7 | 8 | ### Problem 9 | 10 | Existing solutions for their approach are divided into those who 11 | store the translation in a separate column of the main table 12 | and on those who store the translation in separate tables for 13 | each model. These approaches overlap the restriction is that 14 | if you want to start to translate a new field or model you are making 15 | changes in the structure of the database and in consequence 16 | of what is necessary server restart. In parallel with this, 17 | the majority of decisions to make make changes to the model 18 | code making it more difficult to understand. 19 | 20 | ### Solution 21 | 22 | To solve the problems it is proposed to develop a Django application that 23 | would allow to store in one table a reference to a field in the model, and in 24 | another - translations in a shared table with a static structure would not change 25 | the standard scenario of using ORM fields and would not require 26 | server restart. 27 | 28 | ### Usage scenario 29 | 30 | ~~~python 31 | class Book(models.Model): 32 | title = models.CharField(_('Title'), max_length=250, default='', blank=True, null=False) 33 | active = models.BooleanField(_('active'), default=False) 34 | sort = models.IntegerField(_('sort'), default=0, blank=True, null=True) 35 | book = Book.objects.create(title='Title') 36 | ~~~ 37 | Then the title field is added to the table of translated fields 38 | TranslatableFields. Programmatically or through the admin interface: 39 | 40 | ~~~python 41 | fld = TranslatableFields.objects.create( 42 | name='title', 43 | content_type=ContentType.objects.get_for_model(Book), 44 | ) 45 | ~~~ 46 | 47 | And in the translation table added translation for the instance. 48 | Programmatically or through the admin interface: 49 | 50 | ~~~python 51 | Translations.objects.create( 52 | content_object=book, 53 | field=fld, 54 | lang=Language.objects.get('en'), 55 | value='en', 56 | ) 57 | ~~~ 58 | 59 | Then you can interact with model Book: 60 | 61 | ~~~python 62 | from django.utils.translation import activate 63 | 64 | activate('en') 65 | book = Book.objects.first() 66 | book.title # => Title en 67 | ~~~ 68 | ### Prototypes of interfaces: 69 | 70 | In the first approximation of the interfaces you will need a widget for translatable 71 | fields. 72 | 73 | ![Widget for translatable fields](https://github.com/mom1/django-tof/blob/master/docs/images/widget.png) 74 | 75 | Where the tab with an active language are marked with a blue colour. 76 | 77 | Not empty bookmarks are marked in dark. 78 | 79 | Also, at the end of bookmarks, you need to add a bookmark with the + symbol by clicking 80 | which opens the language selection dialog. The selected language appears as 81 | bookmark. 82 | 83 | ### Terms 84 | 85 | Main MVP should take no more then 2 mounth. 86 | 87 | - Working prototype no more then 1 month. 88 | 89 | - Testing and documentation - 1 month. 90 | 91 | - A pilot project - 1 month. 92 | 93 | 94 | PACKAGE|Model code changing|Storage of translations|Need to restart the server to display the new translation|Changing the structure when adding a field as a translatable field 95 | -------|-------------------|-----------------------|---------------------------------------------------------|------------------------------------------------------------------ 96 | DJANGO-MODELTRANSLATION| - |Table fields of the translated model| - | + 97 | DJANGO-HVAD| + |Separate table for each model| - | + 98 | DJANGO-PARLER| + |Separate table for each model| - | + 99 | Default Django Translation| - |.po files| + | - 100 | -------------------------------------------------------------------------------- /tof/forms.py: -------------------------------------------------------------------------------- 1 | # -*- coding: utf-8 -*- 2 | # @Author: MaxST 3 | # @Date: 2019-11-09 13:47:17 4 | # @Last Modified by: MaxST 5 | # @Last Modified time: 2019-12-15 14:13:23 6 | from functools import wraps 7 | from django.contrib.contenttypes.models import ContentType 8 | from django import forms 9 | from django.utils.translation import get_language 10 | 11 | from .utils import TranslatableText 12 | 13 | 14 | class TranslationsForm(forms.ModelForm): 15 | class Media: 16 | js = ('tof/js/translation_form.js', ) 17 | 18 | 19 | class TranslationsInLineForm(forms.ModelForm): 20 | def __init__(self, *args, parent_object=None, **kwargs): 21 | super().__init__(*args, **kwargs) 22 | self.parent_object = parent_object 23 | field = self.fields.get('field') 24 | if field: 25 | field.widget.widget.get_url = self.filter_ct(field.widget.widget.get_url) 26 | field.widget.can_add_related = field.widget.can_change_related = False 27 | 28 | def filter_ct(self, func): 29 | @wraps(func) 30 | def wrapper(*args, **kwargs): 31 | response = func(*args, **kwargs) 32 | if self.parent_object: 33 | return f'{response}?ct={ContentType.objects.get_for_model(self.parent_object).pk}' 34 | return response 35 | 36 | return wrapper 37 | 38 | 39 | class TranslatableFieldForm(forms.ModelForm): 40 | class Media: 41 | js = ('tof/js/translatable_fields_form.js', ) 42 | 43 | 44 | class TranslatableFieldWidget(forms.MultiWidget): 45 | template_name = 'tof/multiwidget.html' 46 | input_type = 'text' 47 | 48 | def __init__(self, widget=None, attrs=None): 49 | widget = widget or forms.TextInput(attrs={**(attrs or {}), 'lang': get_language()}) 50 | super().__init__((widget, )) 51 | 52 | def get_context(self, name, value, attrs): 53 | context = super(forms.MultiWidget, self).get_context(name, value, attrs) 54 | if self.is_localized: 55 | for widget in self.widgets: 56 | widget.is_localized = self.is_localized 57 | # value is a list of values, each corresponding to a widget 58 | # in self.widgets. 59 | if not isinstance(value, list): 60 | value = self.decompress(value) 61 | 62 | final_attrs = context['widget']['attrs'] 63 | input_type = final_attrs.pop('type', self.input_type) 64 | id_ = final_attrs.get('id') 65 | subwidgets = [] 66 | for i, widget in enumerate(self.widgets): 67 | if input_type is not None: 68 | widget.input_type = input_type 69 | try: 70 | widget_lang, widget_value = value[i] 71 | except IndexError: 72 | widget_value = None 73 | widget_lang = None 74 | if id_: 75 | widget_attrs = final_attrs.copy() 76 | widget_attrs['id'] = f'{id_}{widget_lang and f"_{widget_lang}" or ""}' 77 | else: 78 | widget_attrs = final_attrs 79 | widget_name = f'{name}{widget_lang and f"_{widget_lang}" or ""}' 80 | subwidgets.append(widget.get_context(widget_name, widget_value, widget_attrs)['widget']) 81 | context['widget']['subwidgets'] = subwidgets 82 | return context 83 | 84 | def decompress(self, value): 85 | if value and isinstance(value, TranslatableText): 86 | response = [(k, v) for k, v in vars(value).items() if k != '_origin'] 87 | return response or [(get_language(), value._origin)] 88 | return [(get_language(), value)] 89 | 90 | def render(self, name, value, attrs=None, renderer=None): 91 | widget = self.widgets.pop(0) 92 | if isinstance(value, TranslatableText): 93 | attrs_custom = {**widget.attrs, **(attrs or {})} 94 | for key in vars(value).keys(): 95 | if key != '_origin': 96 | attrs_custom['lang'] = key 97 | self.widgets.append(type(widget)(attrs=attrs_custom)) 98 | if not self.widgets: 99 | self.widgets.append(widget) 100 | return super().render(name, value, attrs, renderer) 101 | 102 | def value_from_datadict(self, data, files, name): 103 | response = getattr(self, '_datadict', self) 104 | if response is self: 105 | response = [] 106 | chunk_name = f'{name}_' 107 | for key, val in data.items(): 108 | if key.startswith(chunk_name): 109 | *_, lang = key.rpartition('_') 110 | response.append((lang, val)) 111 | self._datadict = response 112 | return response 113 | 114 | def value_omitted_from_data(self, data, files, name): 115 | return bool(self.value_from_datadict(data, files, name)) 116 | 117 | @property 118 | def media(self): 119 | css = {'all': ('tof/css/style.css', )} 120 | js = ('tof/js/translatable_fields_widget.js', ) 121 | return forms.Media(css=css, js=js) 122 | 123 | 124 | class TranslatableFieldHiddenWidget(TranslatableFieldWidget): 125 | def __init__(self, attrs=None): 126 | super().__init__(attrs) 127 | for widget in self.widgets: 128 | widget.input_type = 'hidden' 129 | 130 | 131 | class TranslationFieldModelForm(forms.ModelForm): 132 | only_current_lang = () 133 | 134 | def __init__(self, *args, **kwargs): 135 | super().__init__(*args, **kwargs) 136 | _field_tof = getattr(self._meta.model._meta, '_field_tof', {}).get('by_name') 137 | if _field_tof: 138 | from .fields import TranslatableFieldFormField 139 | for name in set(_field_tof.keys()) - set(self.only_current_lang): 140 | if name in self.fields: 141 | self.fields[name] = TranslatableFieldFormField(self.fields[name]) 142 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | ![GitHub issues](https://img.shields.io/github/issues/mom1/django-tof.svg) 2 | ![GitHub stars](https://img.shields.io/github/stars/mom1/django-tof.svg) 3 | ![GitHub Release Date](https://img.shields.io/github/release-date/mom1/django-tof.svg) 4 | ![GitHub commits since latest release](https://img.shields.io/github/commits-since/mom1/django-tof/latest.svg) 5 | ![GitHub last commit](https://img.shields.io/github/last-commit/mom1/django-tof.svg) 6 | [![GitHub license](https://img.shields.io/github/license/mom1/django-tof)](https://github.com/mom1/django-tof/blob/master/LICENSE) 7 | [![Codacy Badge](https://api.codacy.com/project/badge/Grade/ef1b0b5bb51048a6a03f3cc87798f9f9)](https://www.codacy.com/manual/mom1/django-tof?utm_source=github.com&utm_medium=referral&utm_content=mom1/django-tof&utm_campaign=Badge_Grade) 8 | [![codecov](https://codecov.io/gh/mom1/django-tof/branch/master/graph/badge.svg)](https://codecov.io/gh/mom1/django-tof) 9 | 10 | [![PyPI](https://img.shields.io/pypi/v/django-tof.svg)](https://pypi.python.org/pypi/django-tof) 11 | [![PyPI](https://img.shields.io/pypi/pyversions/django-tof.svg)]() 12 | ![PyPI - Downloads](https://img.shields.io/pypi/dm/django-tof.svg?label=pip%20installs&logo=python) 13 | 14 | # django-tof 15 | Django models translation on fly 🛸️ 16 | 17 | ---- 18 | This project was initiated, promoted and accompanied by winePad GmbH. All development based on ideas, experience and financing by winePad GmbH (winePad.at). 19 | 20 | ---- 21 | 22 | [![IMAGE ALT TEXT HERE](https://img.youtube.com/vi/i0QJJJEMKSU/0.jpg)](https://www.youtube.com/watch?v=i0QJJJEMKSU) 23 | 24 | _[Russian readme](README_ru.md)_ 25 | 26 | ---- 27 | The background and objectives of this projects are described [here](https://github.com/mom1/django-tof/wiki/django-tof) 28 | 29 | An Application for dynamic translation of existing Django models into any number of languages. 30 | 31 | - without need to change existing model classes 32 | - without need to reboot servers 33 | - without changing the use of translated fields 34 | - ready to work after install and indicated in INSTALLED_APPS 35 | - fully integrated in Django admin 36 | 37 | ## Installation 38 | 39 | `pip install django-tof` 40 | 41 | `python manage.py migrate tof` 42 | 43 | ~~~python 44 | # settings.py 45 | ... 46 | INSTALLED_APPS = [ 47 | ... 48 | 'tof', 49 | ... 50 | ] 51 | ~~~ 52 | Don't forget to do if it necessary `python manage.py collectstatic` 53 | 54 | ## How to use 55 | 56 | 1. In the simplest use case django-tof allows you to store translation into the current language. 57 | You don't need special settings for this, just add this field into admin panel to the "Translatable fields" model. 58 | In this case if current language is 'en', then the value saved in the model will be displayed only if the current language is 'en'. 59 | 1. If you need to support a certain number of languages and add them at the same time, you can use `TofAdmin`. 60 | Using the `class CustomModelAdmin(TofAdmin)` will cause the translated fields (added to the "Translatable fields") will be able to specify a specific language. 61 | At the same time, it is possible to leave some fields in the previous form by specify them in `TofAdmin` with attribute `only_current_lang = ('description', )`.
62 | ![Widget for translatable fields](https://raw.githubusercontent.com/mom1/django-tof/master/docs/images/field_with_langs.jpeg) 63 | 1. You can also use inline translation submission forms. To do this, specify admin class (always inherited from "TofAdmin") `inlines = (TranslationTabularInline, )` 64 | or `inlines = (TranslationStackedInline, )` 65 | 66 | ## Programmatic use 67 | Like a standard using, but it is possible to get a specific translation. 68 | 69 | ~~~python 70 | from django.utils.translation import activate 71 | 72 | activate('en') 73 | book = Book.objects.first() 74 | book.title # => Title en 75 | book.title.de # => Title de 76 | ~~~ 77 | 78 | ## Settings 79 | 80 | _The value for these variables can be specified in your settings.py_ 81 | 82 | DEFAULT_LANGUAGE: _default_ "en" - Default language is stub, used if not other translations is found. 83 | 84 | FALLBACK_LANGUAGES: _default_ `{SITE_ID: ('en', 'de', 'ru'), 'fr': ('nl', ),}` - Determinate the order of search of languages for translation if the translation is in desired 85 | no language. The key can be SITE_ID, None or language. 86 | 87 | The processing order is this, if a translation into current/requested language is not found, then first we checked by the language key, if there is, looking translations for requested languages, 88 | if not - we take the SIDE_ID key. 89 | For example: 90 | 91 | - if current language "fr", then searching order will be next: "fr" -> "nl" -> DEFAULT_LANGUAGE -> then if there is an original value that was before the declaration of this field like translatable. 92 | - if current language "en", then searching order will be next "en" -> "de" -> "ru" -> DEFAULT_LANGUAGE -> then if there is an original value that was before the declaration of this field like translatable. 93 | 94 | DEFAULT_FILTER_LANGUAGE: _default_ "current" - Indicates in which translations search/filter values. May be in the next forms `__all__`, `current`, `['en', 'de']`, `{'en', ('en', 'de', 'ru')}` 95 | 96 | - `current` - if this value is assigned, the filtering is occurs only on the translation into the current language. This is a default value. 97 | - `__all__` - if this value is assigned, the filtering is occurs for all translations. 98 | - `['en', 'de']` - if this value is assigned, the filtering is occurs according to translations of the specified languages. 99 | - `{'en', ('en', 'de', 'ru')}` - if this value is assigned, the filtering is occurs according to translations of languages received by the key of current language. 100 | 101 | CHANGE_DEFAULT_MANAGER: _default_ "True" - Changing the default manager of the model. If it True, then standard manager is transferred into class attribute "objects_origin", 102 | and "objects" becomes the standard manager inherited from standard with adding the functionality that recognized translated fields and takes into account settings from DEFAULT_FILTER_LANGUAGE. 103 | 104 | 105 | ## Requirements 106 | 107 | - Python (\>=3.6) 108 | - Django (\>=2.2) 109 | 110 | ## How to start development 111 | 112 | 1. Fork this project 113 | 2. Clone the repo 114 | 3. Create new branch 115 | 4. **Change directory `example_project`** 116 | 5. You can use [pyenv](https://github.com/pyenv/pyenv) to select the version of python `pyenv local 3.8.0` 117 | 6. We are using [poetry](https://poetry.eustace.io/docs/#installation) 118 | 7. Run: `poetry env use python` to use your python version. 119 | 8. Run: `poetry install` to install all requirements. 120 | 9. Run: `poetry shell` for activation virtual environment. 121 | 10. Run: `python manage.py runserver` to start the development server. 122 | -------------------------------------------------------------------------------- /README_ru.md: -------------------------------------------------------------------------------- 1 | ![GitHub issues](https://img.shields.io/github/issues/mom1/django-tof.svg) 2 | ![GitHub stars](https://img.shields.io/github/stars/mom1/django-tof.svg) 3 | ![GitHub Release Date](https://img.shields.io/github/release-date/mom1/django-tof.svg) 4 | ![GitHub commits since latest release](https://img.shields.io/github/commits-since/mom1/django-tof/latest.svg) 5 | ![GitHub last commit](https://img.shields.io/github/last-commit/mom1/django-tof.svg) 6 | [![GitHub license](https://img.shields.io/github/license/mom1/django-tof)](https://github.com/mom1/django-tof/blob/master/LICENSE) 7 | [![Codacy Badge](https://api.codacy.com/project/badge/Grade/ef1b0b5bb51048a6a03f3cc87798f9f9)](https://www.codacy.com/manual/mom1/django-tof?utm_source=github.com&utm_medium=referral&utm_content=mom1/django-tof&utm_campaign=Badge_Grade) 8 | [![codecov](https://codecov.io/gh/mom1/django-tof/branch/master/graph/badge.svg)](https://codecov.io/gh/mom1/django-tof) 9 | 10 | [![PyPI](https://img.shields.io/pypi/v/django-tof.svg)](https://pypi.python.org/pypi/django-tof) 11 | [![PyPI](https://img.shields.io/pypi/pyversions/django-tof.svg)]() 12 | ![PyPI - Downloads](https://img.shields.io/pypi/dm/django-tof.svg?label=pip%20installs&logo=python) 13 | 14 | # django-tof 15 | Django models translation on fly 🛸️ 16 | 17 | ---- 18 | Этот проект был инициирован, продвигался и сопровождался winePad GmbH. Разработка полностью основана на идеях, опыте и финансировании winePad GmbH (winePad.at). 19 | 20 | ---- 21 | 22 | [![IMAGE ALT TEXT HERE](https://img.youtube.com/vi/i0QJJJEMKSU/0.jpg)](https://www.youtube.com/watch?v=i0QJJJEMKSU) 23 | 24 | ---- 25 | Предпосылки и цели этого проекта описаны [тут](https://github.com/mom1/django-tof/wiki/django-tof) 26 | 27 | Приложение для перевода динамического содержимого существующих моделей Django на произвольное количество языков 28 | 29 | - без необходимости изменения исходных классов моделей 30 | - без необходимости перезапуска сервера 31 | - без изменения схемы использования переводимых полей 32 | - готов к работе сразу после установки и указании в INSTALLED_APPS 33 | - полностью интегрирован в админку Django. 34 | 35 | ## Установка 36 | 37 | `pip install django-tof` 38 | 39 | `python manage.py migrate tof` 40 | 41 | ~~~python 42 | # settings.py 43 | ... 44 | INSTALLED_APPS = [ 45 | ... 46 | 'tof', 47 | ... 48 | ] 49 | ~~~ 50 | Не забудьте сделать при необходимости `python manage.py collectstatic` 51 | 52 | ## Использование 53 | 54 | 1. В самом простом варианте использования django-tof позволяет хранить перевод на текущий язык. 55 | Для этого не требуется особых настроек достаточно добавить это поле в админке в модель "Translatable fields". 56 | В этом случае если текущий язык en то значение сохраненное в моделе будет выводится только если текущий язык en. 57 | 1. Если нужно поддерживать некоторое количество языков и вносить их одновременно то для удобства можно воспользоваться `TofAdmin`. 58 | Использование `class CustomModelAdmin(TofAdmin)` приведет к тому что переводимые поля (добавленные в "Translatable fields") будут иметь возможность 59 | указать конкретный язык. При этом есть возможность некоторые поля оставить в предыдущем виде указав их в `TofAdmin` атрибут `only_current_lang = ('description', )`.
60 | ![Widget for translatable fields](https://raw.githubusercontent.com/mom1/django-tof/master/docs/images/field_with_langs.jpeg) 61 | 1. Также можно использовать инлайн формы представления переводов. Для этого в админ классе (обязательно унаследованного от "TofAdmin") указать 62 | `inlines = (TranslationTabularInline, )` или `inlines = (TranslationStackedInline, )` 63 | В этом случае для избежания двоякости значений переводимое поле будет скрыто классом "TofAdmin" автоматически. 64 | 65 | ## Использование программно 66 | 67 | Ни чем не отличается от стандартного, но имеется возможность получить специфичный перевод. 68 | 69 | ~~~python 70 | from django.utils.translation import activate 71 | 72 | activate('en') 73 | book = Book.objects.first() 74 | book.title # => Title en 75 | book.title.de # => Title de 76 | ~~~ 77 | 78 | ## Настройка 79 | 80 | _Значение для этих переменных можно указать в вашем settings.py_ 81 | 82 | DEFAULT_LANGUAGE: _по умолчанию_ "en" - Дефолтный язык заглушка, используется если не найдено ни каких других переводов. 83 | 84 | FALLBACK_LANGUAGES: _по умолчанию_ `{SITE_ID: ('en', 'de', 'ru'), 'fr': ('nl', ),}` - Определяет порядок перебора языков для поиска перевода если перевода на искомом 85 | языке нет. Ключом может быть SITE_ID, None или язык. 86 | Порядок обработки такой, если не найден перевод на текущий/запрашиваемый язык то сначала проверяем по ключу языка если есть ищем переводы по указанным языкам если нет то берем по ключу SITE_ID. 87 | Для примера 88 | 89 | - если текущий язык "fr" то порядок поиска переводов будет следующим "fr" -> "nl" -> DEFAULT_LANGUAGE -> затем если есть оригинальное значение которое было до объявления этого поля переводимым. 90 | - если текущий язык "en" то порядок поиска переводов будет следующим "en" -> "de" -> "ru" -> DEFAULT_LANGUAGE -> затем если есть оригинальное значение которое было до объявления этого поля переводимым. 91 | 92 | DEFAULT_FILTER_LANGUAGE: _по умолчанию_ "current" - Указывает в каких переводах искать/фильтровать значения. может быть в следующих видах `__all__`, `current`, `['en', 'de']`, `{'en', ('en', 'de', 'ru')}` 93 | 94 | - `current` - если присвоено это значения то фильтрация происходит только по переводу на текущий язык. Это значение по умолчанию. 95 | - `__all__` - если присвоено это значения то фильтрация происходит по всем переводам. 96 | - `['en', 'de']` - если присвоено это значения то фильтрация происходит по переводам указанных языков. 97 | - `{'en', ('en', 'de', 'ru')}` - - если присвоено это значения то фильтрация происходит по переводам языков полученных по ключу текущего языка. 98 | 99 | CHANGE_DEFAULT_MANAGER: _по умолчанию_ "True" - Изменять ли дефолтный менеджер в моделе. Если True то стандартный менеджер переносится в атрибут класса "objects_origin", 100 | а "objects" становится менеджером унаследованным от стандартного с добавлением функционала распознающего переводимые поля и учитывающий настройки из DEFAULT_FILTER_LANGUAGE. 101 | 102 | ## Требования 103 | 104 | - Python (\>=3.6) 105 | - Django (\>=2.2) 106 | 107 | ## Как начать разработку 108 | 109 | 1. Форкнуть этот проект 110 | 2. Склонировать репозиторий 111 | 3. Создать свою ветку 112 | 4. **Перейти в директорию `example_project`** 113 | 5. Вы можете использовать [pyenv](https://github.com/pyenv/pyenv) для выбора версии python `pyenv local 3.8.0` 114 | 6. Мы используем [poetry](https://poetry.eustace.io/docs/#installation) 115 | 7. Запустить: `poetry env use python` для использования вашей версии python. 116 | 8. Запустить: `poetry install` для установки всех зависимостей. 117 | 9. Запустить: `poetry shell` для активации виртуального окружения. 118 | 10. Запустить: `python manage.py runserver` для запуска сервера разработчика 119 | -------------------------------------------------------------------------------- /tof/admin.py: -------------------------------------------------------------------------------- 1 | # -*- coding: utf-8 -*- 2 | # @Author: MaxST 3 | # @Date: 2019-10-28 12:30:45 4 | # @Last Modified by: MaxST 5 | # @Last Modified time: 2019-12-15 16:23:55 6 | import logging 7 | 8 | from django import forms 9 | from django.contrib import admin 10 | from django.contrib.admin.options import IS_POPUP_VAR 11 | from django.contrib.contenttypes.admin import ( 12 | GenericInlineModelAdmin, GenericStackedInline, GenericTabularInline, 13 | ) 14 | from django.contrib.contenttypes.forms import BaseGenericInlineFormSet 15 | from django.contrib.contenttypes.models import ContentType 16 | from django.db.models import CharField, Q, TextField 17 | from django.http import JsonResponse 18 | from django.urls import reverse 19 | from django.utils.translation import gettext_lazy as _ 20 | 21 | from .forms import ( 22 | TranslatableFieldForm, TranslationFieldModelForm, 23 | TranslationsForm, TranslationsInLineForm, 24 | ) 25 | from .models import Language, TranslatableField, Translation 26 | 27 | # Get an instance of a logger 28 | logger = logging.getLogger('django') 29 | 30 | 31 | @admin.register(ContentType) 32 | class ContentTypeAdmin(admin.ModelAdmin): 33 | search_fields = ('app_label', 'model') 34 | 35 | def get_search_results(self, request, queryset, search_term): 36 | queryset, use_distinct = super().get_search_results(request, queryset, search_term) 37 | return queryset.filter(~Q(app_label='tof')), use_distinct 38 | 39 | def has_add_permission(self, *args, **kwargs): 40 | return False 41 | 42 | def has_change_permission(self, *args, **kwargs): 43 | return False 44 | 45 | def has_delete_permission(self, *args, **kwargs): 46 | return False 47 | 48 | 49 | @admin.register(Language) 50 | class LanguageAdmin(admin.ModelAdmin): 51 | search_fields = ('iso', ) 52 | list_display = ('iso', 'is_active') 53 | list_editable = ('is_active', ) 54 | 55 | def get_search_results(self, request, queryset, search_term): 56 | queryset, use_distinct = super().get_search_results(request, queryset, search_term) 57 | query = Q(is_active=True) if IS_POPUP_VAR in request.GET or 'autocomplete' in request.path else Q() 58 | return queryset.filter(query), use_distinct 59 | 60 | 61 | @admin.register(TranslatableField) 62 | class TranslatableFieldAdmin(admin.ModelAdmin): 63 | form = TranslatableFieldForm 64 | search_fields = ('content_type__model', 'title') 65 | list_display = ('content_type', 'name', 'title') 66 | 67 | fieldsets = ((None, { 68 | 'fields': ( 69 | 'content_type', 70 | 'name', 71 | 'title', 72 | ), 73 | }), ) 74 | 75 | autocomplete_fields = ('content_type', ) 76 | 77 | def delete_queryset(self, request, queryset): 78 | for obj in queryset: 79 | obj.delete() 80 | 81 | def get_search_results(self, request, queryset, search_term): 82 | ct = request.GET.get('ct') 83 | query = Q() 84 | if ct: 85 | query = Q(content_type_id=ct) 86 | return super().get_search_results(request, queryset.filter(query), search_term) 87 | 88 | def _changeform_view(self, request, object_id, form_url, extra_context): 89 | id_ct = request.GET.get('id_ct') 90 | if id_ct: 91 | try: 92 | ct = ContentType.objects.get_for_id(id_ct) 93 | model = ct.model_class() 94 | return JsonResponse({ 95 | 'pk': ct.pk, 96 | 'fields': [ 97 | f.attname for f in model._meta.get_fields() 98 | if isinstance(f, (CharField, TextField)) and f.column != 'password' 99 | ], 100 | }) 101 | except Exception as e: 102 | logger.error(e) 103 | return JsonResponse({'errors': _('You choose wrong content type')}) 104 | return super()._changeform_view(request, object_id, form_url, extra_context) 105 | 106 | 107 | @admin.register(Translation) 108 | class TranslationAdmin(admin.ModelAdmin): 109 | form = TranslationsForm 110 | list_display = ('content_object', 'lang', 'field', 'value') 111 | list_filter = ('content_type', ) 112 | fieldsets = ((None, { 113 | 'fields': ( 114 | ('field', 'lang'), 115 | 'object_id', 116 | 'value', 117 | ), 118 | }), ( 119 | 'hidden', 120 | { 121 | 'classes': ('hidden', ), 122 | 'fields': ('content_type', ), 123 | }, 124 | )) 125 | autocomplete_fields = ('field', 'lang') 126 | url_name = '%s:%s_%s_autocomplete' 127 | 128 | def get_readonly_fields(self, request, obj): 129 | response = list(super().get_readonly_fields(request, obj)) 130 | if obj and obj.pk: 131 | response.extend(['field', 'object_id']) 132 | return tuple(response) 133 | 134 | def _changeform_view(self, request, object_id, form_url, extra_context): 135 | fld_id = request.GET.get('field_id') 136 | if fld_id: 137 | try: 138 | ct = TranslatableField.objects.get(id=fld_id).content_type 139 | id_obj = request.GET.get('id_obj') 140 | model = ct.model_class() 141 | url = reverse(self.url_name % (self.admin_site.name, model._meta.app_label, model._meta.model_name)) 142 | return JsonResponse({ 143 | 'pk': ct.pk, 144 | 'url': url, 145 | 'text': str(model.objects.get(pk=id_obj)) if id_obj else '', 146 | }) 147 | except Exception as e: 148 | logger.error(e) 149 | return JsonResponse({'errors': _('You choose wrong content type')}) 150 | return super()._changeform_view(request, object_id, form_url, extra_context) 151 | 152 | 153 | class TranslationFormSet(BaseGenericInlineFormSet): 154 | def get_form_kwargs(self, index): 155 | kwargs = super().get_form_kwargs(index) 156 | kwargs['parent_object'] = self.instance 157 | return kwargs 158 | 159 | 160 | class TranslationInline(GenericInlineModelAdmin): 161 | model = Translation 162 | extra = 0 163 | autocomplete_fields = ('field', 'lang') 164 | fields = ('field', 'lang', 'value') 165 | formset = TranslationFormSet 166 | form = TranslationsInLineForm 167 | 168 | @property 169 | def media(self): 170 | media = super().media 171 | js = ('tof/js/translation_inline.js', ) 172 | return media + forms.Media(js=js) 173 | 174 | 175 | class TranslationStackedInline(TranslationInline, GenericStackedInline): 176 | pass 177 | 178 | 179 | class TranslationTabularInline(TranslationInline, GenericTabularInline): 180 | pass 181 | 182 | 183 | class TofAdmin(admin.ModelAdmin): 184 | form = TranslationFieldModelForm 185 | only_current_lang = () 186 | 187 | def get_readonly_fields(self, request, obj=None): 188 | response = list(super().get_readonly_fields(request, obj)) 189 | field_tof = getattr(self.model._meta, '_field_tof', {}).get('by_name') 190 | if field_tof and any(issubclass(c, TranslationInline) for c in self.inlines): 191 | response.extend(field_tof.keys()) 192 | return tuple(response) 193 | 194 | def get_form(self, request, obj=None, change=False, **kwargs): 195 | form = super().get_form(request, obj=obj, change=change, **kwargs) 196 | form.only_current_lang += self.only_current_lang 197 | return form 198 | -------------------------------------------------------------------------------- /tof/models.py: -------------------------------------------------------------------------------- 1 | # -*- coding: utf-8 -*- 2 | # @Author: MaxST 3 | # @Date: 2019-10-23 17:24:33 4 | # @Last Modified by: MaxST 5 | # @Last Modified time: 2019-12-02 18:08:48 6 | 7 | from django.contrib.contenttypes.fields import ( 8 | GenericForeignKey, GenericRelation, 9 | ) 10 | from django.contrib.contenttypes.models import ContentType 11 | from django.db import models 12 | from django.db.models import Q 13 | from django.utils.functional import cached_property 14 | from django.utils.translation import gettext_lazy as _ 15 | 16 | from .managers import TranslationManager 17 | from .settings import CHANGE_DEFAULT_MANAGER 18 | from .utils import TranslatableText 19 | 20 | 21 | class Translation(models.Model): 22 | class Meta: 23 | verbose_name = _('Translation') 24 | verbose_name_plural = _('Translation') 25 | unique_together = ('content_type', 'object_id', 'field', 'lang') 26 | 27 | content_type = models.ForeignKey( 28 | ContentType, 29 | limit_choices_to=~Q(app_label='tof'), 30 | on_delete=models.CASCADE, 31 | related_name='translations', 32 | ) 33 | object_id = models.PositiveIntegerField(help_text=_('First set the field')) 34 | content_object = GenericForeignKey() 35 | 36 | field = models.ForeignKey('TranslatableField', related_name='translations', on_delete=models.CASCADE) 37 | lang = models.ForeignKey( 38 | 'Language', 39 | related_name='translations', 40 | limit_choices_to=Q(is_active=True), 41 | on_delete=models.CASCADE, 42 | ) 43 | 44 | value = models.TextField(_('Value'), help_text=_('Value field')) 45 | 46 | def __str__(self): 47 | return f'{self.content_object}.{self.field.name}.{self.lang} = "{self.value}"' 48 | 49 | 50 | class TranslationFieldMixin(models.Model): 51 | class Meta: 52 | abstract = True 53 | 54 | _translations = GenericRelation(Translation, verbose_name=_('Translation')) 55 | 56 | def __init__(self, *args, **kwargs): 57 | super().__init__(*args, **kwargs) 58 | self._end_init = True 59 | 60 | @cached_property 61 | def _all_translations(self): 62 | attrs, names_mapper = vars(self), self._meta._field_tof['by_id'] 63 | for trans in self._translations.all(): 64 | name = names_mapper[trans.field_id].name 65 | attrs[name] = trans_obj = attrs.get(name) or TranslatableText() 66 | vars(trans_obj)[trans.lang_id] = trans.value 67 | return attrs 68 | 69 | def get_translation(self, name): 70 | attrs = vars(self) 71 | if '_end_init' in attrs: 72 | attrs = self._all_translations 73 | return attrs.get(name) or TranslatableText() 74 | 75 | def save(self, *args, **kwargs): 76 | super().save(*args, **kwargs) 77 | for translated_field in self._meta._field_tof['by_id'].values(): 78 | translated_field.save_translation(self) 79 | 80 | 81 | class TranslatableField(models.Model): 82 | class Meta: 83 | verbose_name = _('Translatable field') 84 | verbose_name_plural = _('Translatable fields') 85 | ordering = ('content_type', 'name') 86 | unique_together = ('content_type', 'name') 87 | 88 | name = models.CharField(_('Field name'), max_length=250, help_text=_('Name field')) 89 | title = models.CharField(_('User field name'), max_length=250, help_text=_("Name user's field")) 90 | content_type = models.ForeignKey( 91 | ContentType, 92 | limit_choices_to=~Q(app_label='tof'), 93 | on_delete=models.CASCADE, 94 | related_name='translatablefields', 95 | ) 96 | 97 | def __str__(self): 98 | return f'{self.content_type.model}|{self.title}' 99 | 100 | def save(self, *args, **kwargs): 101 | super().save(*args, **kwargs) 102 | self.add_translation_to_class() 103 | 104 | def delete(self, *args, **kwargs): 105 | self.remove_translation_from_class() 106 | super().delete(*args, **kwargs) 107 | 108 | def __get__(self, instance, instance_cls): 109 | return instance.get_translation(self.name) if instance else vars(instance_cls).get(self.name) 110 | 111 | def __set__(self, instance, value): 112 | attrs = vars(instance) 113 | if isinstance(value, TranslatableText): 114 | attrs[self.name] = value 115 | else: 116 | translation = attrs[self.name] = instance.get_translation(self.name) 117 | vars(translation)[translation.get_lang() if '_end_init' in attrs else '_origin'] = str(value) 118 | 119 | def __delete__(self, instance): 120 | vars(self).pop(self.name, None) 121 | instance._meta._field_tof['by_name'].pop(instance._meta._field_tof['by_id'].pop(self.id, self).name, None) 122 | 123 | def save_translation(self, instance): 124 | val = instance.get_translation(self.name) 125 | if val: 126 | for lang, value in vars(val).items(): 127 | if lang != '_origin': 128 | translation, _ = instance._translations.get_or_create(field=self, lang_id=lang) 129 | translation.value = value 130 | translation.save() 131 | 132 | def add_translation_to_class(self, trans_mng=None): 133 | cls = self.content_type.model_class() 134 | if not hasattr(cls._meta, '_field_tof'): 135 | cls.__bases__ = (TranslationFieldMixin, ) + cls.__bases__ 136 | cls._meta._field_tof = {'by_name': {}, 'by_id': {}} 137 | if CHANGE_DEFAULT_MANAGER and not isinstance(cls._default_manager, TranslationManager): 138 | origin = cls.objects 139 | new_mng_cls = type(f'TranslationManager{cls.__name__}', (TranslationManager, type(origin)), {}) 140 | trans_mng = trans_mng or new_mng_cls() 141 | trans_mng.contribute_to_class(cls, trans_mng.default_name) 142 | cls._meta.default_manager_name = trans_mng.default_name 143 | # FIXME 144 | del cls.objects 145 | trans_mng.contribute_to_class(cls, 'objects') 146 | origin.contribute_to_class(cls, 'objects_origin') 147 | setattr( 148 | cls, 149 | cls._meta._field_tof['by_name'].setdefault(cls._meta._field_tof['by_id'].setdefault(self.id, self).name, self).name, 150 | self, 151 | ) 152 | 153 | def remove_translation_from_class(self): 154 | cls = self.content_type.model_class() 155 | cls._meta._field_tof['by_name'].pop(cls._meta._field_tof['by_id'].pop(self.id, self).name, None) 156 | delattr(cls, self.name) 157 | field = cls._meta.get_field(self.name) 158 | field.contribute_to_class(cls, self.name) 159 | if not cls._meta._field_tof['by_id']: 160 | del cls._meta._field_tof 161 | cls.__bases__ = tuple(base for base in cls.__bases__ if base != TranslationFieldMixin) # important! 162 | if CHANGE_DEFAULT_MANAGER and isinstance(cls._default_manager, TranslationManager): 163 | delattr(cls, cls._default_manager.default_name) 164 | cls._meta.default_manager_name = None 165 | mng = cls.objects_origin 166 | del cls.objects 167 | del cls.objects_origin 168 | mng.contribute_to_class(cls, 'objects') 169 | 170 | 171 | class Language(models.Model): 172 | class Meta: 173 | verbose_name = _('Language') 174 | verbose_name_plural = _('Languages') 175 | ordering = ['iso'] 176 | 177 | iso = models.CharField(max_length=2, unique=True, primary_key=True) 178 | is_active = models.BooleanField(_(u'Active'), default=True) 179 | 180 | def __str__(self): 181 | return self.iso 182 | -------------------------------------------------------------------------------- /tof/tests/tests.py: -------------------------------------------------------------------------------- 1 | # -*- coding: utf-8 -*- 2 | # @Author: MaxST 3 | # @Date: 2019-11-15 19:17:59 4 | # @Last Modified by: MaxST 5 | # @Last Modified time: 2019-12-15 14:23:41 6 | from django.contrib import admin 7 | from django.contrib.admin.models import LogEntry 8 | from django.contrib.admin.options import IS_POPUP_VAR 9 | from django.contrib.admin.sites import AdminSite 10 | from django.contrib.admin.views.main import SEARCH_VAR 11 | from django.contrib.auth.admin import UserAdmin 12 | from django.contrib.auth.models import User 13 | from django.contrib.contenttypes.models import ContentType 14 | from django.core.exceptions import ValidationError 15 | from django.core.management import call_command 16 | from django.db.models import Q 17 | from django.test import TestCase 18 | from django.test.client import RequestFactory 19 | from django.urls import reverse 20 | from django.utils.translation import activate, override 21 | from main.models import Vintage, Wine, Winery 22 | from mixer.backend.django import mixer 23 | from tof.admin import ( 24 | ContentTypeAdmin, LanguageAdmin, TranslatableFieldAdmin, TranslationAdmin, 25 | ) 26 | from tof.fields import TranslatableFieldFormField 27 | from tof.models import ( 28 | Language, TranslatableField, Translation, TranslationFieldMixin, 29 | ) 30 | from tof.settings import FALLBACK_LANGUAGES 31 | from tof.utils import TranslatableText 32 | 33 | site = admin.AdminSite(name='admin') 34 | 35 | site.register(User, UserAdmin) 36 | site.register(ContentType, ContentTypeAdmin) 37 | site.register(Language, LanguageAdmin) 38 | site.register(TranslatableField, TranslatableFieldAdmin) 39 | site.register(Translation, TranslationAdmin) 40 | 41 | 42 | def create_field(name='title', cls=None): 43 | ct = ContentType.objects.get_for_model(cls or Wine) 44 | fld = TranslatableField.objects.filter(content_type=ct).first() 45 | if not fld: 46 | mixer.blend(TranslatableField, name=name, title=name.title(), content_type=ct) 47 | 48 | 49 | def clean_model(cls, attr='title'): 50 | if issubclass(cls, TranslationFieldMixin): 51 | for fld in {**cls._meta._field_tof['by_id']}.values(): 52 | fld.remove_translation_from_class() 53 | 54 | 55 | class TranslatableFieldTestCase(TestCase): 56 | @classmethod 57 | def setUpTestData(cls): 58 | clean_model(Wine) 59 | clean_model(LogEntry) 60 | mixer.blend(Wine, title='Wine 1') 61 | 62 | def test_save(self): 63 | wine1 = Wine.objects.first() 64 | log = LogEntry.objects.first() 65 | self.assertNotIsInstance(wine1, TranslationFieldMixin) 66 | self.assertNotIsInstance(log, TranslationFieldMixin) 67 | self.assertIsNone(vars(LogEntry._meta).get('_field_tof')) 68 | create_field() 69 | self.assertIsInstance(wine1, TranslationFieldMixin) 70 | self.assertIsNotNone(vars(Wine._meta).get('_field_tof')) 71 | self.assertIsNone(vars(LogEntry._meta).get('_field_tof')) 72 | create_field('change_message', LogEntry) 73 | self.assertIsNotNone(vars(LogEntry._meta).get('_field_tof')) 74 | 75 | def test_delete(self): 76 | create_field() 77 | wine1 = Wine.objects.first() 78 | self.assertIsInstance(wine1, TranslationFieldMixin) 79 | fld = TranslatableField.objects.first() 80 | fld.delete() 81 | wine1 = Wine.objects.first() 82 | self.assertNotIsInstance(wine1, TranslationFieldMixin) 83 | self.assertEqual(wine1.title, 'Wine 1') 84 | wine2 = mixer.blend(Wine, title='Wine 2') 85 | self.assertEqual(wine2.title, 'Wine 2') 86 | 87 | def test_str(self): 88 | create_field() 89 | fld = TranslatableField.objects.first() 90 | self.assertEqual(str(fld), 'wine|Title') 91 | 92 | 93 | class TranslationTestCase(TestCase): 94 | @classmethod 95 | def setUpTestData(cls): 96 | clean_model(Wine) 97 | mixer.blend(Wine, title='Wine 1') 98 | create_field() 99 | 100 | def test_str(self): 101 | fld = TranslatableField.objects.first() 102 | lang_en = Language.objects.get(iso='en') 103 | new_title = 'Wine 1 en' 104 | wine1 = Wine.objects.first() 105 | 106 | self.assertEqual(wine1.title, 'Wine 1') 107 | 108 | trans = mixer.blend(Translation, content_object=wine1, field=fld, lang=lang_en, value=new_title) 109 | str_make = f'{wine1}.{fld.name}.{lang_en} = "{new_title}"' 110 | self.assertEqual(str(trans), str_make) 111 | 112 | 113 | class TranslationFieldMixinTestCase(TestCase): 114 | @classmethod 115 | def setUpTestData(cls): 116 | clean_model(Wine) 117 | mixer.blend(Wine, title='Wine 1') 118 | create_field() 119 | 120 | def test_save(self): 121 | wine1 = Wine.objects.first() 122 | title_de = 'Wine 1 de' 123 | title_en = 'Wine 1 en' 124 | title_nl = 'Wine 1 en' 125 | with override('de'): 126 | wine1.title = title_de 127 | wine1.save() 128 | 129 | wine1 = Wine.objects.first() 130 | self.assertEqual(wine1.title.de, title_de) 131 | value = TranslatableText() 132 | vars(value).update({'en': title_en, 'nl': title_nl}) 133 | wine1.title = value 134 | wine1.save() 135 | wine1 = Wine.objects.first() 136 | self.assertEqual(wine1.title.en, title_en) 137 | self.assertEqual(wine1.title.nl, title_nl) 138 | 139 | def test_get(self): 140 | self.assertIsInstance(Wine.title, TranslatableField) 141 | 142 | def test_prefetch(self): 143 | wine1 = Wine.objects.first() 144 | wine1.title = f'{wine1.title}' 145 | wine1.save() 146 | with self.assertNumQueries(2): 147 | for wine in Wine.objects.all(): 148 | self.assertIsNotNone(wine.title) 149 | mixer.cycle(5).blend(Wine, title=mixer.sequence('Wine {0}')) 150 | with override('en'): 151 | for wine in Wine.objects.all(): 152 | wine.title = f'{wine.title} en' 153 | wine.save() 154 | with self.assertNumQueries(2): 155 | for wine in Wine.objects.all(): 156 | self.assertIsNotNone(wine.title.en) 157 | 158 | 159 | class FilterTestCase(TestCase): 160 | @classmethod 161 | def setUpTestData(cls): 162 | clean_model(Wine) 163 | mixer.blend(Wine, title='Wine 1') 164 | create_field() 165 | 166 | def test_behavior(self): 167 | wine1 = Wine.objects.first() 168 | title_de = 'Wine 1 de' 169 | title_nl = 'Wine 1 nl' 170 | for title in (title_de, title_nl): 171 | with override(title.split()[-1]): 172 | wine1.title = title 173 | wine1.save() 174 | 175 | wine1 = Wine.objects.first() 176 | 177 | with override('nl'): 178 | self.assertEqual(str(wine1.title), title_nl) 179 | 180 | with override('fr'): 181 | self.assertEqual(str(wine1.title), title_nl) 182 | 183 | with override('de'): 184 | serch_wine = Wine.objects.filter(title=title_de).first() 185 | self.assertEqual(title_de, str(serch_wine.title)) 186 | serch_wine = Wine.objects.exclude(title=title_de).first() 187 | self.assertIsNone(serch_wine) 188 | serch_wine = Wine.objects.get(title=title_de) 189 | self.assertEqual(title_de, str(serch_wine.title)) 190 | serch_wine = Wine.objects.filter(Q(title=title_de)).first() 191 | self.assertEqual(title_de, str(serch_wine.title)) 192 | 193 | serch_wine = Wine.objects.filter(title=title_nl).first() 194 | self.assertIsNone(serch_wine) 195 | from tof import decorators 196 | decorators.DEFAULT_FILTER_LANGUAGE = '__all__' 197 | serch_wine = Wine.objects.filter(title=title_nl).first() 198 | self.assertEqual(wine1, serch_wine) 199 | decorators.DEFAULT_FILTER_LANGUAGE = 'nl' 200 | serch_wine = Wine.objects.filter(title=title_nl).first() 201 | self.assertEqual(wine1, serch_wine) 202 | decorators.DEFAULT_FILTER_LANGUAGE = ('nl', ) 203 | serch_wine = Wine.objects.filter(title=title_nl).first() 204 | self.assertEqual(wine1, serch_wine) 205 | decorators.DEFAULT_FILTER_LANGUAGE = {'de': ('nl', )} 206 | serch_wine = Wine.objects.filter(title=title_nl).first() 207 | self.assertEqual(wine1, serch_wine) 208 | decorators.DEFAULT_FILTER_LANGUAGE = set() 209 | serch_wine = Wine.objects.filter(title=title_de).first() 210 | self.assertEqual(wine1, serch_wine) 211 | 212 | 213 | class TranslatableTextTestCase(TestCase): 214 | @classmethod 215 | def setUpTestData(cls): 216 | clean_model(Wine) 217 | mixer.blend(Wine, title='Wine 1') 218 | create_field() 219 | 220 | def test_common(self): 221 | wine1 = Wine.objects.first() 222 | title_nl = 'Wine 1 nl' 223 | for title in (title_nl, ): 224 | with override(title.split()[-1]): 225 | wine1.title = title 226 | wine1.save() 227 | 228 | val = wine1.title 229 | 230 | self.assertIsInstance(val, TranslatableText) 231 | self.assertEqual(val, 'Wine 1') 232 | self.assertEqual(val[0], 'W') 233 | self.assertEqual(val + '1', 'Wine 11') 234 | self.assertEqual('1' + val, '1Wine 1') 235 | self.assertEqual(repr(val), f"'{val}'") 236 | self.assertEqual(str(val), val.__html__()) 237 | self.assertFalse(hasattr(val, 'resolve_expression')) 238 | self.assertFalse(hasattr(val, 'prepare_database_save')) 239 | FALLBACK_LANGUAGES['aa'] = ('nl', ) 240 | with override('aa'): 241 | self.assertEqual(str(val), title_nl) 242 | del wine1.title 243 | self.assertEqual(wine1.title, 'Wine 1') 244 | 245 | 246 | class Benchmark(TestCase): 247 | def test_benchmark(self): 248 | call_command('benchmark') 249 | 250 | 251 | class ModelAdminTests(TestCase): 252 | factory = RequestFactory() 253 | 254 | @classmethod 255 | def setUpTestData(cls): 256 | activate('en') 257 | cls.superuser = User.objects.create_superuser(username='super', email='a@b.com', password='xxx') 258 | 259 | def setUp(self): 260 | clean_model(Wine) 261 | mixer.blend(Wine, title='Wine 1') 262 | create_field() 263 | self.site = AdminSite() 264 | 265 | def test_search_result(self): 266 | wine = ContentType.objects.get_for_model(Wine) 267 | vintage = ContentType.objects.get_for_model(Vintage) 268 | winery = ContentType.objects.get_for_model(Winery) 269 | m = ContentTypeAdmin(ContentType, site) 270 | request = self.factory.get('/', data={SEARCH_VAR: 'tof'}) 271 | request.user = self.superuser 272 | cl = m.get_changelist_instance(request) 273 | self.assertCountEqual(cl.queryset, []) 274 | 275 | request = self.factory.get('/', data={SEARCH_VAR: 'main'}) 276 | request.user = self.superuser 277 | cl = m.get_changelist_instance(request) 278 | self.assertCountEqual(cl.queryset, [vintage, wine, winery]) 279 | 280 | m = LanguageAdmin(Language, site) 281 | lang_aa = Language.objects.get(iso='aa') 282 | request = self.factory.get('/', data={SEARCH_VAR: 'aa', IS_POPUP_VAR: '1'}) 283 | request.user = self.superuser 284 | cl = m.get_changelist_instance(request) 285 | self.assertCountEqual(cl.queryset, [lang_aa]) 286 | 287 | lang_aa.is_active = False 288 | lang_aa.save() 289 | 290 | request = self.factory.get('/', data={SEARCH_VAR: 'aa', IS_POPUP_VAR: '1'}) 291 | request.user = self.superuser 292 | cl = m.get_changelist_instance(request) 293 | self.assertCountEqual(cl.queryset, []) 294 | 295 | request = self.factory.get('/autocomplete/', data={SEARCH_VAR: 'aa'}) 296 | request.user = self.superuser 297 | cl = m.get_changelist_instance(request) 298 | self.assertCountEqual(cl.queryset, []) 299 | 300 | def test_delete_qs(self): 301 | request = self.factory.get('/') 302 | request.user = self.superuser 303 | m = TranslatableFieldAdmin(TranslatableField, site) 304 | m.delete_queryset(request, TranslatableField.objects.all()) 305 | wine1 = Wine.objects.first() 306 | self.assertNotIsInstance(wine1, TranslationFieldMixin) 307 | 308 | def test_response(self): 309 | # TranslatableFieldAdmin 310 | ct = ContentType.objects.get_for_model(Wine) 311 | field = TranslatableField.objects.first() 312 | self.client.force_login(self.superuser) 313 | url = reverse('admin:tof_translatablefield_change', args=(field.pk, )) 314 | response = self.client.get(url) 315 | self.assertEqual(response.status_code, 200) 316 | response = self.client.get(url, data={'id_ct': ct.pk}) 317 | self.assertEqual(response.json(), {'pk': 7, 'fields': ['title', 'title', 'title', 'title', 'description']}) # WTF? 318 | response = self.client.get(url, data={'id_ct': 999}) 319 | self.assertTrue('errors' in response.json()) 320 | # TranslationAdmin 321 | wine1 = Wine.objects.first() 322 | wine1.title = 'Wine 1 en' 323 | wine1.save() 324 | trans = Translation.objects.first() 325 | url = reverse('admin:tof_translation_change', args=(trans.pk, )) 326 | response = self.client.get(url) 327 | self.assertEqual(response.status_code, 200) 328 | response = self.client.get(url, data={'field_id': field.pk}) 329 | url_auto = reverse('admin:main_wine_autocomplete') 330 | self.assertEqual(response.json(), { 331 | 'pk': field.content_type.pk, 332 | 'url': url_auto, 333 | 'text': '', 334 | }) 335 | response = self.client.get(url, data={'field_id': field.pk, 'id_obj': wine1.pk}) 336 | self.assertEqual(response.json(), {'pk': field.content_type.pk, 'text': str(wine1), 'url': url_auto}) 337 | response = self.client.get(url, data={'field_id': 999, 'id_obj': wine1.pk}) 338 | self.assertTrue('errors' in response.json()) 339 | # 340 | wine = Wine.objects.first() 341 | url = reverse('admin:main_wine_change', args=(wine.pk, )) 342 | response = self.client.get(url) 343 | self.assertContains(response, 'translatable_fields_widget.js') 344 | self.assertContains(response, 'en_id_title_en') 345 | 346 | 347 | class FieldTests(TestCase): 348 | def test_field(self): 349 | activate('en') 350 | fld = TranslatableFieldFormField() 351 | data = [['en', 'Wine en'], ['de', 'Wine de']] 352 | cmps = fld.clean(data) 353 | self.assertEqual(dict(data), vars(cmps)) 354 | with self.assertRaises(ValidationError): 355 | fail_data = data.copy() 356 | fail_data[0] = ['en', ''] 357 | cmps = fld.clean(fail_data) 358 | 359 | fld.required = False 360 | self.assertEqual('', fld.clean(None)) 361 | fld.required = True 362 | 363 | fld.require_all_fields = False 364 | cmps = fld.clean(fail_data) 365 | self.assertEqual(dict(fail_data), vars(cmps)) 366 | fld.fields[0].required = True 367 | with self.assertRaises(ValidationError): 368 | fld.clean(fail_data) 369 | fld.fields[0].required = False 370 | fld.require_all_fields = True 371 | 372 | with self.assertRaises(ValidationError): 373 | cmps = fld.clean(None) 374 | 375 | val = TranslatableText() 376 | vars(val).update(dict(data)) 377 | with self.assertRaises(ValidationError): 378 | fld.clean(val) 379 | fld.disabled = True 380 | fld.required = False 381 | self.assertEqual('Wine en', fld.clean(val)) 382 | fld.required = True 383 | fld.disabled = False 384 | with self.assertRaises(ValidationError): 385 | fail_data[0][1] += '\x00' 386 | fld.clean(fail_data) 387 | -------------------------------------------------------------------------------- /example_project/poetry.lock: -------------------------------------------------------------------------------- 1 | [[package]] 2 | category = "dev" 3 | description = "Disable App Nap on OS X 10.9" 4 | marker = "python_version >= \"3.4\" and sys_platform == \"darwin\"" 5 | name = "appnope" 6 | optional = false 7 | python-versions = "*" 8 | version = "0.1.0" 9 | 10 | [[package]] 11 | category = "main" 12 | description = "ASGI specs, helper code, and adapters" 13 | name = "asgiref" 14 | optional = false 15 | python-versions = "*" 16 | version = "3.2.3" 17 | 18 | [package.extras] 19 | tests = ["pytest (>=4.3.0,<4.4.0)", "pytest-asyncio (>=0.10.0,<0.11.0)"] 20 | 21 | [[package]] 22 | category = "dev" 23 | description = "Specifications for callback functions passed in to an API" 24 | marker = "python_version >= \"3.4\"" 25 | name = "backcall" 26 | optional = false 27 | python-versions = "*" 28 | version = "0.1.0" 29 | 30 | [[package]] 31 | category = "dev" 32 | description = "Cross-platform colored terminal text." 33 | marker = "python_version >= \"3.4\" and sys_platform == \"win32\"" 34 | name = "colorama" 35 | optional = false 36 | python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*" 37 | version = "0.4.3" 38 | 39 | [[package]] 40 | category = "dev" 41 | description = "Code coverage measurement for Python" 42 | name = "coverage" 43 | optional = false 44 | python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*, <4" 45 | version = "5.0" 46 | 47 | [package.extras] 48 | toml = ["toml"] 49 | 50 | [[package]] 51 | category = "dev" 52 | description = "Decorators for Humans" 53 | marker = "python_version >= \"3.4\"" 54 | name = "decorator" 55 | optional = false 56 | python-versions = ">=2.6, !=3.0.*, !=3.1.*" 57 | version = "4.4.1" 58 | 59 | [[package]] 60 | category = "main" 61 | description = "A high-level Python Web framework that encourages rapid development and clean, pragmatic design." 62 | name = "django" 63 | optional = false 64 | python-versions = ">=3.6" 65 | version = "3.0" 66 | 67 | [package.dependencies] 68 | asgiref = ">=3.2,<4.0" 69 | pytz = "*" 70 | sqlparse = ">=0.2.2" 71 | 72 | [package.extras] 73 | argon2 = ["argon2-cffi (>=16.1.0)"] 74 | bcrypt = ["bcrypt"] 75 | 76 | [[package]] 77 | category = "dev" 78 | description = "A configurable set of panels that display various debug information about the current request/response." 79 | name = "django-debug-toolbar" 80 | optional = false 81 | python-versions = ">=3.5" 82 | version = "2.1" 83 | 84 | [package.dependencies] 85 | Django = ">=1.11" 86 | sqlparse = ">=0.2.0" 87 | 88 | [[package]] 89 | category = "main" 90 | description = "" 91 | develop = true 92 | name = "django-tof" 93 | optional = false 94 | python-versions = '^3.6' 95 | version = "0.3.1" 96 | 97 | [package.dependencies] 98 | django = ">=2.2" 99 | 100 | [package.source] 101 | reference = "" 102 | type = "directory" 103 | url = ".." 104 | 105 | [[package]] 106 | category = "dev" 107 | description = "Faker is a Python package that generates fake data for you." 108 | name = "faker" 109 | optional = false 110 | python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*" 111 | version = "0.9.1" 112 | 113 | [package.dependencies] 114 | python-dateutil = ">=2.4" 115 | six = ">=1.10" 116 | text-unidecode = "1.2" 117 | 118 | [[package]] 119 | category = "dev" 120 | description = "IPython-enabled pdb" 121 | name = "ipdb" 122 | optional = false 123 | python-versions = ">=2.7" 124 | version = "0.12.3" 125 | 126 | [package.dependencies] 127 | setuptools = "*" 128 | 129 | [package.dependencies.ipython] 130 | python = ">=3.4" 131 | version = ">=5.1.0" 132 | 133 | [[package]] 134 | category = "dev" 135 | description = "IPython: Productive Interactive Computing" 136 | marker = "python_version >= \"3.4\"" 137 | name = "ipython" 138 | optional = false 139 | python-versions = ">=3.6" 140 | version = "7.10.2" 141 | 142 | [package.dependencies] 143 | appnope = "*" 144 | backcall = "*" 145 | colorama = "*" 146 | decorator = "*" 147 | jedi = ">=0.10" 148 | pexpect = "*" 149 | pickleshare = "*" 150 | prompt-toolkit = ">=2.0.0,<3.0.0 || >3.0.0,<3.0.1 || >3.0.1,<3.1.0" 151 | pygments = "*" 152 | setuptools = ">=18.5" 153 | traitlets = ">=4.2" 154 | 155 | [package.extras] 156 | all = ["nose (>=0.10.1)", "qtconsole", "pygments", "nbconvert", "Sphinx (>=1.3)", "nbformat", "requests", "testpath", "ipykernel", "notebook", "ipyparallel", "ipywidgets", "numpy (>=1.14)"] 157 | doc = ["Sphinx (>=1.3)"] 158 | kernel = ["ipykernel"] 159 | nbconvert = ["nbconvert"] 160 | nbformat = ["nbformat"] 161 | notebook = ["notebook", "ipywidgets"] 162 | parallel = ["ipyparallel"] 163 | qtconsole = ["qtconsole"] 164 | test = ["nose (>=0.10.1)", "requests", "testpath", "pygments", "nbformat", "ipykernel", "numpy (>=1.14)"] 165 | 166 | [[package]] 167 | category = "dev" 168 | description = "Vestigial utilities from IPython" 169 | marker = "python_version >= \"3.4\"" 170 | name = "ipython-genutils" 171 | optional = false 172 | python-versions = "*" 173 | version = "0.2.0" 174 | 175 | [[package]] 176 | category = "dev" 177 | description = "An autocompletion tool for Python that can be used for text editors." 178 | marker = "python_version >= \"3.4\"" 179 | name = "jedi" 180 | optional = false 181 | python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*" 182 | version = "0.15.1" 183 | 184 | [package.dependencies] 185 | parso = ">=0.5.0" 186 | 187 | [package.extras] 188 | testing = ["colorama", "docopt", "pytest (>=3.1.0,<5.0.0)"] 189 | 190 | [[package]] 191 | category = "dev" 192 | description = "Mixer -- Is a fixtures replacement. Supported Django ORM, SqlAlchemy ORM, Mongoengine ODM and custom python objects." 193 | name = "mixer" 194 | optional = false 195 | python-versions = "*" 196 | version = "6.1.3" 197 | 198 | [package.dependencies] 199 | Faker = "0.9.1" 200 | 201 | [[package]] 202 | category = "dev" 203 | description = "A Python Parser" 204 | marker = "python_version >= \"3.4\"" 205 | name = "parso" 206 | optional = false 207 | python-versions = "*" 208 | version = "0.5.2" 209 | 210 | [package.extras] 211 | testing = ["docopt", "pytest (>=3.0.7)"] 212 | 213 | [[package]] 214 | category = "dev" 215 | description = "Pexpect allows easy control of interactive console applications." 216 | marker = "python_version >= \"3.4\" and sys_platform != \"win32\"" 217 | name = "pexpect" 218 | optional = false 219 | python-versions = "*" 220 | version = "4.7.0" 221 | 222 | [package.dependencies] 223 | ptyprocess = ">=0.5" 224 | 225 | [[package]] 226 | category = "dev" 227 | description = "Tiny 'shelve'-like database with concurrency support" 228 | marker = "python_version >= \"3.4\"" 229 | name = "pickleshare" 230 | optional = false 231 | python-versions = "*" 232 | version = "0.7.5" 233 | 234 | [[package]] 235 | category = "dev" 236 | description = "Library for building powerful interactive command lines in Python" 237 | marker = "python_version >= \"3.4\"" 238 | name = "prompt-toolkit" 239 | optional = false 240 | python-versions = ">=3.6" 241 | version = "3.0.2" 242 | 243 | [package.dependencies] 244 | wcwidth = "*" 245 | 246 | [[package]] 247 | category = "dev" 248 | description = "Run a subprocess in a pseudo terminal" 249 | marker = "python_version >= \"3.4\" and sys_platform != \"win32\"" 250 | name = "ptyprocess" 251 | optional = false 252 | python-versions = "*" 253 | version = "0.6.0" 254 | 255 | [[package]] 256 | category = "dev" 257 | description = "Pygments is a syntax highlighting package written in Python." 258 | marker = "python_version >= \"3.4\"" 259 | name = "pygments" 260 | optional = false 261 | python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*" 262 | version = "2.5.2" 263 | 264 | [[package]] 265 | category = "dev" 266 | description = "Extensions to the standard Python datetime module" 267 | name = "python-dateutil" 268 | optional = false 269 | python-versions = "!=3.0.*,!=3.1.*,!=3.2.*,>=2.7" 270 | version = "2.8.1" 271 | 272 | [package.dependencies] 273 | six = ">=1.5" 274 | 275 | [[package]] 276 | category = "main" 277 | description = "World timezone definitions, modern and historical" 278 | name = "pytz" 279 | optional = false 280 | python-versions = "*" 281 | version = "2019.3" 282 | 283 | [[package]] 284 | category = "dev" 285 | description = "Python 2 and 3 compatibility utilities" 286 | name = "six" 287 | optional = false 288 | python-versions = ">=2.6, !=3.0.*, !=3.1.*" 289 | version = "1.13.0" 290 | 291 | [[package]] 292 | category = "main" 293 | description = "Non-validating SQL parser" 294 | name = "sqlparse" 295 | optional = false 296 | python-versions = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*" 297 | version = "0.3.0" 298 | 299 | [[package]] 300 | category = "dev" 301 | description = "The most basic Text::Unidecode port" 302 | name = "text-unidecode" 303 | optional = false 304 | python-versions = "*" 305 | version = "1.2" 306 | 307 | [[package]] 308 | category = "dev" 309 | description = "Traitlets Python config system" 310 | marker = "python_version >= \"3.4\"" 311 | name = "traitlets" 312 | optional = false 313 | python-versions = "*" 314 | version = "4.3.3" 315 | 316 | [package.dependencies] 317 | decorator = "*" 318 | ipython-genutils = "*" 319 | six = "*" 320 | 321 | [package.extras] 322 | test = ["pytest", "mock"] 323 | 324 | [[package]] 325 | category = "dev" 326 | description = "Measures number of Terminal column cells of wide-character codes" 327 | marker = "python_version >= \"3.4\"" 328 | name = "wcwidth" 329 | optional = false 330 | python-versions = "*" 331 | version = "0.1.7" 332 | 333 | [metadata] 334 | content-hash = "495f28c55c5f7b2b9eb05e1b1e50162852eb98811513237b35afbd8a9a188063" 335 | python-versions = "^3.6" 336 | 337 | [metadata.files] 338 | appnope = [ 339 | {file = "appnope-0.1.0-py2.py3-none-any.whl", hash = "sha256:5b26757dc6f79a3b7dc9fab95359328d5747fcb2409d331ea66d0272b90ab2a0"}, 340 | {file = "appnope-0.1.0.tar.gz", hash = "sha256:8b995ffe925347a2138d7ac0fe77155e4311a0ea6d6da4f5128fe4b3cbe5ed71"}, 341 | ] 342 | asgiref = [ 343 | {file = "asgiref-3.2.3-py2.py3-none-any.whl", hash = "sha256:ea448f92fc35a0ef4b1508f53a04c4670255a3f33d22a81c8fc9c872036adbe5"}, 344 | {file = "asgiref-3.2.3.tar.gz", hash = "sha256:7e06d934a7718bf3975acbf87780ba678957b87c7adc056f13b6215d610695a0"}, 345 | ] 346 | backcall = [ 347 | {file = "backcall-0.1.0.tar.gz", hash = "sha256:38ecd85be2c1e78f77fd91700c76e14667dc21e2713b63876c0eb901196e01e4"}, 348 | {file = "backcall-0.1.0.zip", hash = "sha256:bbbf4b1e5cd2bdb08f915895b51081c041bac22394fdfcfdfbe9f14b77c08bf2"}, 349 | ] 350 | colorama = [ 351 | {file = "colorama-0.4.3-py2.py3-none-any.whl", hash = "sha256:7d73d2a99753107a36ac6b455ee49046802e59d9d076ef8e47b61499fa29afff"}, 352 | {file = "colorama-0.4.3.tar.gz", hash = "sha256:e96da0d330793e2cb9485e9ddfd918d456036c7149416295932478192f4436a1"}, 353 | ] 354 | coverage = [ 355 | {file = "coverage-5.0-cp27-cp27m-macosx_10_12_x86_64.whl", hash = "sha256:9c871b006c878a890c6e44a5b2f3c6291335324b298c904dc0402ee92ee1f0be"}, 356 | {file = "coverage-5.0-cp27-cp27m-macosx_10_13_intel.whl", hash = "sha256:e5a675f6829c53c87d79117a8eb656cc4a5f8918185a32fc93ba09778e90f6db"}, 357 | {file = "coverage-5.0-cp27-cp27m-manylinux1_i686.whl", hash = "sha256:81326f1095c53111f8afc95da281e1414185f4a538609a77ca50bdfa39a6c207"}, 358 | {file = "coverage-5.0-cp27-cp27m-manylinux1_x86_64.whl", hash = "sha256:8873dc0d8f42142ea9f20c27bbdc485190fff93823c6795be661703369e5877d"}, 359 | {file = "coverage-5.0-cp27-cp27m-win32.whl", hash = "sha256:44b783b02db03c4777d8cf71bae19eadc171a6f2a96777d916b2c30a1eb3d070"}, 360 | {file = "coverage-5.0-cp27-cp27m-win_amd64.whl", hash = "sha256:d52c1c2d7e856cecc05aa0526453cb14574f821b7f413cc279b9514750d795c1"}, 361 | {file = "coverage-5.0-cp27-cp27mu-manylinux1_i686.whl", hash = "sha256:ba259f68250f16d2444cbbfaddaa0bb20e1560a4fdaad50bece25c199e6af864"}, 362 | {file = "coverage-5.0-cp27-cp27mu-manylinux1_x86_64.whl", hash = "sha256:475bf7c4252af0a56e1abba9606f1e54127cdf122063095c75ab04f6f99cf45e"}, 363 | {file = "coverage-5.0-cp35-cp35m-macosx_10_12_x86_64.whl", hash = "sha256:91f2491aeab9599956c45a77c5666d323efdec790bfe23fcceafcd91105d585a"}, 364 | {file = "coverage-5.0-cp35-cp35m-manylinux1_i686.whl", hash = "sha256:979daa8655ae5a51e8e7a24e7d34e250ae8309fd9719490df92cbb2fe2b0422b"}, 365 | {file = "coverage-5.0-cp35-cp35m-manylinux1_x86_64.whl", hash = "sha256:1a4b6b6a2a3a6612e6361130c2cc3dc4378d8c221752b96167ccbad94b47f3cd"}, 366 | {file = "coverage-5.0-cp35-cp35m-win32.whl", hash = "sha256:56b13000acf891f700f5067512b804d1ec8c301d627486c678b903859d07f798"}, 367 | {file = "coverage-5.0-cp35-cp35m-win_amd64.whl", hash = "sha256:81042a24f67b96e4287774014fa27220d8a4d91af1043389e4d73892efc89ac6"}, 368 | {file = "coverage-5.0-cp36-cp36m-macosx_10_13_x86_64.whl", hash = "sha256:fec32646b98baf4a22fdceb08703965bd16dea09051fbeb31a04b5b6e72b846c"}, 369 | {file = "coverage-5.0-cp36-cp36m-manylinux1_i686.whl", hash = "sha256:7fe3e2fde2bf1d7ce25ebcd2d3de3650b8d60d9a73ce6dcef36e20191291613d"}, 370 | {file = "coverage-5.0-cp36-cp36m-manylinux1_x86_64.whl", hash = "sha256:be1d89614c6b6c36d7578496dc8625123bda2ff44f224cf8b1c45b810ee7383f"}, 371 | {file = "coverage-5.0-cp36-cp36m-win32.whl", hash = "sha256:47c81ee687eafc2f1db7f03fbe99aab81330565ebc62fb3b61edfc2216a550c8"}, 372 | {file = "coverage-5.0-cp36-cp36m-win_amd64.whl", hash = "sha256:3be5338a2eb4ef03c57f20917e1d12a1fd10e3853fed060b6d6b677cb3745898"}, 373 | {file = "coverage-5.0-cp37-cp37m-macosx_10_13_x86_64.whl", hash = "sha256:79388ae29c896299b3567965dbcd93255f175c17c6c7bca38614d12718c47466"}, 374 | {file = "coverage-5.0-cp37-cp37m-manylinux1_i686.whl", hash = "sha256:4a7f8e72b18f2aca288ff02255ce32cc830bc04d993efbc87abf6beddc9e56c0"}, 375 | {file = "coverage-5.0-cp37-cp37m-manylinux1_x86_64.whl", hash = "sha256:d609a6d564ad3d327e9509846c2c47f170456344521462b469e5cb39e48ba31c"}, 376 | {file = "coverage-5.0-cp37-cp37m-win32.whl", hash = "sha256:50197163a22fd17f79086e087a787883b3ec9280a509807daf158dfc2a7ded02"}, 377 | {file = "coverage-5.0-cp37-cp37m-win_amd64.whl", hash = "sha256:b5ed7837b923d1d71c4f587ae1539ccd96bfd6be9788f507dbe94dab5febbb5d"}, 378 | {file = "coverage-5.0-cp38-cp38-macosx_10_13_x86_64.whl", hash = "sha256:c95bb147fab76f2ecde332d972d8f4138b8f2daee6c466af4ff3b4f29bd4c19e"}, 379 | {file = "coverage-5.0-cp38-cp38-manylinux1_i686.whl", hash = "sha256:0cd13a6e98c37b510a2d34c8281d5e1a226aaf9b65b7d770ef03c63169965351"}, 380 | {file = "coverage-5.0-cp38-cp38-manylinux1_x86_64.whl", hash = "sha256:88d2cbcb0a112f47eef71eb95460b6995da18e6f8ca50c264585abc2c473154b"}, 381 | {file = "coverage-5.0-cp38-cp38m-win32.whl", hash = "sha256:2ee55e6dba516ddf6f484aa83ccabbb0adf45a18892204c23486938d12258cde"}, 382 | {file = "coverage-5.0-cp38-cp38m-win_amd64.whl", hash = "sha256:a6d092545e5af53e960465f652e00efbf5357adad177b2630d63978d85e46a72"}, 383 | {file = "coverage-5.0-cp39-cp39m-win32.whl", hash = "sha256:79fd5d3d62238c4f583b75d48d53cdae759fe04d4fb18fe8b371d88ad2b6f8be"}, 384 | {file = "coverage-5.0-cp39-cp39m-win_amd64.whl", hash = "sha256:c1b030a79749aa8d1f1486885040114ee56933b15ccfc90049ba266e4aa2139f"}, 385 | {file = "coverage-5.0.tar.gz", hash = "sha256:e1bad043c12fb58e8c7d92b3d7f2f49977dcb80a08a6d1e7a5114a11bf819fca"}, 386 | ] 387 | decorator = [ 388 | {file = "decorator-4.4.1-py2.py3-none-any.whl", hash = "sha256:5d19b92a3c8f7f101c8dd86afd86b0f061a8ce4540ab8cd401fa2542756bce6d"}, 389 | {file = "decorator-4.4.1.tar.gz", hash = "sha256:54c38050039232e1db4ad7375cfce6748d7b41c29e95a081c8a6d2c30364a2ce"}, 390 | ] 391 | django = [ 392 | {file = "Django-3.0-py3-none-any.whl", hash = "sha256:6f857bd4e574442ba35a7172f1397b303167dae964cf18e53db5e85fe248d000"}, 393 | {file = "Django-3.0.tar.gz", hash = "sha256:d98c9b6e5eed147bc51f47c014ff6826bd1ab50b166956776ee13db5a58804ae"}, 394 | ] 395 | django-debug-toolbar = [ 396 | {file = "django-debug-toolbar-2.1.tar.gz", hash = "sha256:24c157bc6c0e1648e0a6587511ecb1b007a00a354ce716950bff2de12693e7a8"}, 397 | {file = "django_debug_toolbar-2.1-py3-none-any.whl", hash = "sha256:77cfba1d6e91b9bc3d36dc7dc74a9bb80be351948db5f880f2562a0cbf20b6c5"}, 398 | ] 399 | django-tof = [] 400 | faker = [ 401 | {file = "Faker-0.9.1-py2.py3-none-any.whl", hash = "sha256:74b32991f8e08e4f2f84858b919eca253becfaec4b3fa5fcff7fdbd70d5d78b1"}, 402 | {file = "Faker-0.9.1.tar.gz", hash = "sha256:c2ce42dd8361e6d392276006d757532562463c8642b1086709584200b7fd7758"}, 403 | ] 404 | ipdb = [ 405 | {file = "ipdb-0.12.3.tar.gz", hash = "sha256:5d9a4a0e3b7027a158fc6f2929934341045b9c3b0b86ed5d7e84e409653f72fd"}, 406 | ] 407 | ipython = [ 408 | {file = "ipython-7.10.2-py3-none-any.whl", hash = "sha256:190a279bd3d4fc585a611e9358a88f1048cc57fd688254a86f9461889ee152a6"}, 409 | {file = "ipython-7.10.2.tar.gz", hash = "sha256:762d79a62b6aa96b04971e920543f558dfbeedc0468b899303c080c8068d4ac2"}, 410 | ] 411 | ipython-genutils = [ 412 | {file = "ipython_genutils-0.2.0-py2.py3-none-any.whl", hash = "sha256:72dd37233799e619666c9f639a9da83c34013a73e8bbc79a7a6348d93c61fab8"}, 413 | {file = "ipython_genutils-0.2.0.tar.gz", hash = "sha256:eb2e116e75ecef9d4d228fdc66af54269afa26ab4463042e33785b887c628ba8"}, 414 | ] 415 | jedi = [ 416 | {file = "jedi-0.15.1-py2.py3-none-any.whl", hash = "sha256:786b6c3d80e2f06fd77162a07fed81b8baa22dde5d62896a790a331d6ac21a27"}, 417 | {file = "jedi-0.15.1.tar.gz", hash = "sha256:ba859c74fa3c966a22f2aeebe1b74ee27e2a462f56d3f5f7ca4a59af61bfe42e"}, 418 | ] 419 | mixer = [ 420 | {file = "mixer-6.1.3-py2.py3-none-any.whl", hash = "sha256:f1ccab542a1304d7b3da5d6ebe9f53de1aac2288427121a3a54a63e08c3a5367"}, 421 | {file = "mixer-6.1.3.tar.gz", hash = "sha256:3601e84134b79cd4ac663f79a39fc3005d6a3f37692e7062cc3c0a727ab79940"}, 422 | ] 423 | parso = [ 424 | {file = "parso-0.5.2-py2.py3-none-any.whl", hash = "sha256:5c1f7791de6bd5dbbeac8db0ef5594b36799de198b3f7f7014643b0c5536b9d3"}, 425 | {file = "parso-0.5.2.tar.gz", hash = "sha256:55cf25df1a35fd88b878715874d2c4dc1ad3f0eebd1e0266a67e1f55efccfbe1"}, 426 | ] 427 | pexpect = [ 428 | {file = "pexpect-4.7.0-py2.py3-none-any.whl", hash = "sha256:2094eefdfcf37a1fdbfb9aa090862c1a4878e5c7e0e7e7088bdb511c558e5cd1"}, 429 | {file = "pexpect-4.7.0.tar.gz", hash = "sha256:9e2c1fd0e6ee3a49b28f95d4b33bc389c89b20af6a1255906e90ff1262ce62eb"}, 430 | ] 431 | pickleshare = [ 432 | {file = "pickleshare-0.7.5-py2.py3-none-any.whl", hash = "sha256:9649af414d74d4df115d5d718f82acb59c9d418196b7b4290ed47a12ce62df56"}, 433 | {file = "pickleshare-0.7.5.tar.gz", hash = "sha256:87683d47965c1da65cdacaf31c8441d12b8044cdec9aca500cd78fc2c683afca"}, 434 | ] 435 | prompt-toolkit = [ 436 | {file = "prompt_toolkit-3.0.2-py3-none-any.whl", hash = "sha256:0278d2f51b5ceba6ea8da39f76d15684e84c996b325475f6e5720edc584326a7"}, 437 | {file = "prompt_toolkit-3.0.2.tar.gz", hash = "sha256:63daee79aa8366c8f1c637f1a4876b890da5fc92a19ebd2f7080ebacb901e990"}, 438 | ] 439 | ptyprocess = [ 440 | {file = "ptyprocess-0.6.0-py2.py3-none-any.whl", hash = "sha256:d7cc528d76e76342423ca640335bd3633420dc1366f258cb31d05e865ef5ca1f"}, 441 | {file = "ptyprocess-0.6.0.tar.gz", hash = "sha256:923f299cc5ad920c68f2bc0bc98b75b9f838b93b599941a6b63ddbc2476394c0"}, 442 | ] 443 | pygments = [ 444 | {file = "Pygments-2.5.2-py2.py3-none-any.whl", hash = "sha256:2a3fe295e54a20164a9df49c75fa58526d3be48e14aceba6d6b1e8ac0bfd6f1b"}, 445 | {file = "Pygments-2.5.2.tar.gz", hash = "sha256:98c8aa5a9f778fcd1026a17361ddaf7330d1b7c62ae97c3bb0ae73e0b9b6b0fe"}, 446 | ] 447 | python-dateutil = [ 448 | {file = "python-dateutil-2.8.1.tar.gz", hash = "sha256:73ebfe9dbf22e832286dafa60473e4cd239f8592f699aa5adaf10050e6e1823c"}, 449 | {file = "python_dateutil-2.8.1-py2.py3-none-any.whl", hash = "sha256:75bb3f31ea686f1197762692a9ee6a7550b59fc6ca3a1f4b5d7e32fb98e2da2a"}, 450 | ] 451 | pytz = [ 452 | {file = "pytz-2019.3-py2.py3-none-any.whl", hash = "sha256:1c557d7d0e871de1f5ccd5833f60fb2550652da6be2693c1e02300743d21500d"}, 453 | {file = "pytz-2019.3.tar.gz", hash = "sha256:b02c06db6cf09c12dd25137e563b31700d3b80fcc4ad23abb7a315f2789819be"}, 454 | ] 455 | six = [ 456 | {file = "six-1.13.0-py2.py3-none-any.whl", hash = "sha256:1f1b7d42e254082a9db6279deae68afb421ceba6158efa6131de7b3003ee93fd"}, 457 | {file = "six-1.13.0.tar.gz", hash = "sha256:30f610279e8b2578cab6db20741130331735c781b56053c59c4076da27f06b66"}, 458 | ] 459 | sqlparse = [ 460 | {file = "sqlparse-0.3.0-py2.py3-none-any.whl", hash = "sha256:40afe6b8d4b1117e7dff5504d7a8ce07d9a1b15aeeade8a2d10f130a834f8177"}, 461 | {file = "sqlparse-0.3.0.tar.gz", hash = "sha256:7c3dca29c022744e95b547e867cee89f4fce4373f3549ccd8797d8eb52cdb873"}, 462 | ] 463 | text-unidecode = [ 464 | {file = "text-unidecode-1.2.tar.gz", hash = "sha256:5a1375bb2ba7968740508ae38d92e1f889a0832913cb1c447d5e2046061a396d"}, 465 | {file = "text_unidecode-1.2-py2.py3-none-any.whl", hash = "sha256:801e38bd550b943563660a91de8d4b6fa5df60a542be9093f7abf819f86050cc"}, 466 | ] 467 | traitlets = [ 468 | {file = "traitlets-4.3.3-py2.py3-none-any.whl", hash = "sha256:70b4c6a1d9019d7b4f6846832288f86998aa3b9207c6821f3578a6a6a467fe44"}, 469 | {file = "traitlets-4.3.3.tar.gz", hash = "sha256:d023ee369ddd2763310e4c3eae1ff649689440d4ae59d7485eb4cfbbe3e359f7"}, 470 | ] 471 | wcwidth = [ 472 | {file = "wcwidth-0.1.7-py2.py3-none-any.whl", hash = "sha256:f4ebe71925af7b40a864553f761ed559b43544f8f71746c2d756c7fe788ade7c"}, 473 | {file = "wcwidth-0.1.7.tar.gz", hash = "sha256:3df37372226d6e63e1b1e1eda15c594bca98a22d33a23832a90998faa96bc65e"}, 474 | ] 475 | --------------------------------------------------------------------------------