django-parlor
Django model translations with even less nasty hacks.
Installation
pip install django-parlor
Usage
from django.contrib import admin
from django.db import models
from parlor.admin import TranslatableAdmin
from parlor.models import TranslatableModel
class MyModel(TranslatableModel):
...
class MyModelTranslation(models.Model):
parent = MyModel.get_parent_field()
language_code = MyModel.get_language_field()
label = models.CharField(max_length=32)
...
class Meta:
unique_together = [('parent', 'language_code')]
admin.site.register(MyModel, TranslatableAdmin)
animal = MyModel.objects.create()
animal.translations.create(language_code='en', label='Frog')
animal.translations.create(language_code='de', label='Frosch')
print(animal.label)
Status
Right now this is more of a proof-of-concept. If people are interested in this library it could certainly be expanded.
Relation to django-parler
Standing on the Shoulders of Giants
There are two popular libraries for model translation in Django: django-modeltranslation and django-parler. The former adds additional columns to the same table while the latter adds a new table for each translatable model. Both of these libraries use a lot of magic which makes them easy to use, but also leads to some hard-to-debug edge cases.
There is also django-translated-fields, which uses the same basic approach as django-modeltranslation, but with much less magic (and much less lines of code).
Here I try to do something similar for django-parler, which has been unmaintained for some time now.
Migration
If you want to migrate from django-parler to django-parlor, you need to replace
all instances of parler.TranslatedFields by explicit translation models as
described above. Note that the parent field is called master in
django-parler.
To keep using the same data, you will also need to set Meta.db_table to the
name generated by django-parler (typically myapp_mymodel_translation).
Finally you should run manage.py makemigrations. The generated migrations
will only contain minor changes though.
Conceptual differences
- With django-parlor, the translation model must be created explicitly.
- In the admin UI, django-parlor uses a stock inline instead of a custom tabbed interface.
- django-parlor only provides basic attribute access while django-parler provides a lot more features.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file django_parlor-0.0.4.tar.gz.
File metadata
- Download URL: django_parlor-0.0.4.tar.gz
- Upload date:
- Size: 4.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
361877d342d9784103485956a741154912a90069dcdc8806c4392ab26adf8af4
|
|
| MD5 |
6005e5acd8abce053942f7598e581281
|
|
| BLAKE2b-256 |
3e9585462ed89768b1c95c197c7ac86c177443726c2114b06281ef4033927a81
|
Provenance
The following attestation bundles were made for django_parlor-0.0.4.tar.gz:
Publisher:
main.yml on xi/django-parlor
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
django_parlor-0.0.4.tar.gz -
Subject digest:
361877d342d9784103485956a741154912a90069dcdc8806c4392ab26adf8af4 - Sigstore transparency entry: 1708105943
- Sigstore integration time:
-
Permalink:
xi/django-parlor@14ce571c47eca932b8b8db97a8e87fc787b588e7 -
Branch / Tag:
refs/tags/0.0.4 - Owner: https://github.com/xi
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
main.yml@14ce571c47eca932b8b8db97a8e87fc787b588e7 -
Trigger Event:
push
-
Statement type:
File details
Details for the file django_parlor-0.0.4-py3-none-any.whl.
File metadata
- Download URL: django_parlor-0.0.4-py3-none-any.whl
- Upload date:
- Size: 4.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
db2e713049f0373b904450918f910f2c394ea1ddb6c3b8b211c91c347f55a24f
|
|
| MD5 |
c1878728e5a2dcadc491c5201784851a
|
|
| BLAKE2b-256 |
21b2fd2929f0e0dc8db2c6ab9fcbcf21cea11d48b8cd9416ba0ca3d001dbc59f
|
Provenance
The following attestation bundles were made for django_parlor-0.0.4-py3-none-any.whl:
Publisher:
main.yml on xi/django-parlor
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
django_parlor-0.0.4-py3-none-any.whl -
Subject digest:
db2e713049f0373b904450918f910f2c394ea1ddb6c3b8b211c91c347f55a24f - Sigstore transparency entry: 1708105984
- Sigstore integration time:
-
Permalink:
xi/django-parlor@14ce571c47eca932b8b8db97a8e87fc787b588e7 -
Branch / Tag:
refs/tags/0.0.4 - Owner: https://github.com/xi
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
main.yml@14ce571c47eca932b8b8db97a8e87fc787b588e7 -
Trigger Event:
push
-
Statement type:
