https://github.com/paylogic/traduki

Internationalisation helper for SQLAlchemy-based projects
https://github.com/paylogic/traduki

Last synced: 4 months ago
JSON representation

Internationalisation helper for SQLAlchemy-based projects

• Host: GitHub
• URL: https://github.com/paylogic/traduki
• Owner: paylogic
• License: mit
• Created: 2014-02-04T21:39:27.000Z (over 12 years ago)
• Default Branch: master
• Last Pushed: 2024-10-17T12:36:04.000Z (over 1 year ago)
• Last Synced: 2025-08-17T10:41:44.997Z (10 months ago)
• Language: Python
• Homepage:
• Size: 42 KB
• Stars: 0
• Watchers: 18
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGES.rst
  • License: LICENSE.txt

Awesome Lists containing this project

README

          
traduki: SQLAlchemy internationalisation

========================================

The ``traduki`` package provides internationalisation helper classes for SQLAlchemy-based projects.

.. image:: https://api.travis-ci.org/paylogic/traduki.png

   :target: https://travis-ci.org/paylogic/traduki

.. image:: https://img.shields.io/pypi/v/traduki.svg

   :target: https://crate.io/packages/traduki/

.. image:: https://coveralls.io/repos/paylogic/traduki/badge.png?branch=master

   :target: https://coveralls.io/r/paylogic/traduki

Installation

------------

.. sourcecode::

    pip install traduki

Usage

-----

traduki usage example:

.. code-block:: python

    from sqlalchemy.ext.declarative import declarative_base

    Base = declarative_base()

    import traduki

    def get_current_language():

        """Current language callback for our project."""

        return request.locale

    def get_language_chain():

        """Language chain (fallback rule) callback for our project."""

        return {'*': request.locale}

    i18n_attributes = traduki.initialize(Base, ['en', 'ru'], get_current_language, get_language_chain)

    Session = sessionmaker(bind=engine)

    sess = Session()

    class MyModel(Base)

        title_id = i18n_attributes.i18n_column(nullable=False, unique=False)

        title = i18n_attributes.i18n_relation(title_id)

        """Title."""

    my_object = MyModel()

    my_object.title = {'en': 'English title', 'pt': 'Portugese title'}

    sess.add(my_object)

    sess.commit()

    assert sess.refresh(my_object).title.get_dict() == {'en': 'English title', 'pt': 'Portugese title'}

Contact

-------

If you have questions, bug reports, suggestions, etc. please create an issue on

the `GitHub project page `_.

License

-------

This software is licensed under the `MIT license `_

See `License `_

© 2018 Paylogic International.