Convert IDs to human-readable labels.
Country IDs translated using the standard id:name
-format. Click here for source.
A package suite for translating IDs typically found in databases. Translation is highly configurable and tested for multiple different SQL dialects and schema naming paradigms. The included TOML configuration format as well as the support functions make it easy to create and share working configurations with anyone who needs them.
The fastest way to get started with id-translation
is the 🍪id-translation-project Cookiecutter template. It is
designed to allow power users to quickly specify shared configurations that "just work" for other users; see the example
below.
from big_corporation_inc.id_translation import translate
print(
"The first employee at Big Corporation Inc. was:",
translate(1, names="employee_id"),
)
Check out this demo project (and its 📚generated documentation) to get a preview of what Your generated project might look like, or continue to the next section for a brief feature overview.
'{id}:{name}'
), including full
Format Specification Mini-Language support. Extensions for optional keys.int
, string
, and UUID
. Optional heuristics for UUID-like strings.list
, dict
, set
, tuple
.pandas.MultiIndex
types.The package is published through the Python Package Index (PyPI). Source code is available on GitHub: https://github.com/rsundqvist/id-translation
pip install -U id-translation
This is the preferred method to install id-translation
, as it will always install the
most recent stable release.
Hosted on Read the Docs: https://id-translation.readthedocs.io
All contributions, bug reports, bug fixes, documentation improvements, enhancements, and ideas are welcome. To get started, see the Contributing Guide and Code of Conduct.