Skip to main content
2025 Python Packaging Survey is now live!  Take the survey now

A content translation framework for django integrated automatically in the normal ORM. Removes the pain of having to think about translations in a django project.

Project description

Model translations made easy.

This project is yet another attempt at making model translations suck less in Django. It uses an automatically created Translations Model to store translatable fields in arbitrary languages with a foreign key to the main model.

Features

  • Simple API - less than 10 new methods.

  • Reliable - more than 200 test cases and counting.

  • Versatile - can manipulate arbitrary languages without changing the DB schema.

  • Complete - supports relationships, proxy models, and - from v0.5 - abstract models.

  • Fast - few and simple queries

  • High level - no custom SQL Compiler or other scary things

  • Batteries included - translation-enabled forms and admin are provided.

  • Compatible with Django 1.3 to 1.7, running Python 2.6+ or 3.3+.

Example

Normal.objects.all()

Returns all objects, but without any translated fields attached - this query is just the default django queryset and can therefore be used as usual.

Normal.objects.language().all()

Returns all objects as translated instances, but only the ones that are translated into the currect language. You can also specify which language to get, using e.g.

Normal.objects.language(“en”).all()

Thanks to

Jonas Obrist (https://github.com/ojii) for making django-nani and for helping me with this project.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page