id_translation#

Translation of IDs with flexible formatting and name matching.

For an introduction to translation, see Translation primer and Mapping primer.

Environment variables#

ID_TRANSLATION_DISABLED#

Global switch. When true, the Translator.translate()-method returns immediately.

ID_TRANSLATION_SUPPRESS_OPTIONAL_FETCHER_INIT_ERRORS#

Global switch. Set to true (not recommended) to allow the TranslatorFactory() to discard optional fetchers that raise when imported or initialized. See the documentation for details.

Classes

Translator([fetcher, fmt, mapper, ...])

End-user interface for all translation tasks.

Modules

dio

Integration for insertion and extraction of IDs and translations to and from various data structures.

exceptions

General errors for the translation suite.

fetching

Fetching of translation data.

mapping

Mapping implementations for matching groups of elements.

offline

Offline (in-memory) translation classes.

settings

Global translation settings.

testing

Test implementations.

toml

Functions and classes for creating Translator instances from a TOML configs.

transform

User-defined transformations of IDs and translations.

translator_typing

Types that are specific to the id_translation.Translator implementation.

types

Types used for translation.

utils

Various supporting functions and classes.