Socket
Socket
Sign inDemoInstall

django-i18nfield

Package Overview
Dependencies
0
Maintainers
2
Alerts
File Explorer

Install Socket

Detect and block malicious and high-risk dependencies

Install

    django-i18nfield

Store internationalized strings in Django models


Maintainers
2

Readme

I18nFields for Django

.. image:: https://img.shields.io/pypi/v/django-i18nfield.svg :target: https://pypi.python.org/pypi/django-i18nfield

.. image:: https://readthedocs.org/projects/django-i18nfield/badge/?version=latest :target: https://django-i18nfield.readthedocs.io/

.. image:: https://travis-ci.org/raphaelm/django-i18nfield.svg?branch=master :target: https://travis-ci.org/raphaelm/django-i18nfield

.. image:: https://codecov.io/gh/raphaelm/django-i18nfield/branch/master/graph/badge.svg :target: https://codecov.io/gh/raphaelm/django-i18nfield

This is yet another way to store multi-lingual content in Django_. In contrast to other options like django-hvad, django-modeltranslation or django-parler_ it does not require additonal database tables and you can reconfigure the available languages without any changes to the database schema. In constrast to nece_, it is not specific to PostgreSQL.

How does it work then? It stores JSON data into a TextField. Yes, this is kinda dirty and violates the 1NF_. This makes it harder for non-django based programs to interact directly with your database and is not perfectly efficient in terms of storage space. It also lacks the ability to do useful lookups, searches and indices on internationalized fields. If one of those things are important to you, this project is not for you, please choose one of the ones that we linked above.

However if those limitations are fine for you, this provides you with a very lightweight, easy to use and flexible solution. This approach has been in use in pretix_ for quite a while, so it has been tested in production. The package contains not only the model fields, but also form fields and everything you need to get them running.

Features

  • Very easy installation
  • Internationalized versions of CharField and TextField types
  • Integrated form fields types and widgets
  • Automatic migration from non-localized fields with a simple migration
  • Full support for forms and formsets
  • Possibility to dynamically limit the displayed languages
  • Very basic integration with django admin
  • Integration with Django Restframework
  • Comprehensive test suite and production-tested

Tested with:

  • Python 3.6 to 3.10
  • Django 3.2 to 4.0

License

The code in this repository is published under the terms of the Apache License. See the LICENSE file for the complete license text.

This project is maintained by Raphael Michel mail@raphaelmichel.de. See the AUTHORS file for a list of all the awesome folks who contributed to this project.

.. _pretix: https://github.com/pretix/pretix .. _django: https://www.djangoproject.com/ .. _django-hvad: https://github.com/KristianOellegaard/django-hvad .. _django-modeltranslation: https://github.com/deschler/django-modeltranslation .. _django-parler: https://github.com/django-parler/django-parler .. _nece: https://pypi.python.org/pypi/nece .. _1NF: https://en.wikipedia.org/wiki/First_normal_form

Keywords

FAQs


Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc