---
id: translationstring
version: "1.4"
license: BSD-like (http://repoze.org/license.html)
license_treatment: permissive
maintenance: dormant
---

# translationstring — Utility library for i18n relied on by various Repoze and Pyramid packages

License: permissive · Maintenance: dormant · Downloads: 2.6M/mo

## What it is and what it does

translationstring is a lightweight i18n utility library used by Pylons Project packages to mark, manage, and translate text strings in Python applications. It provides a TranslationString class that wraps text with metadata (domain, default translation, message context) and a TranslationStringFactory for creating translation strings with a consistent domain. The package supports pluralization and is designed to work with Babel's translation infrastructure, though it does not depend on Babel itself.

The library is primarily used within template engines and web frameworks built on the Pylons stack. It has no runtime dependencies, making it lightweight to install. With zero known vulnerabilities and a permissive license, it is stable and safe to use, though the long dormancy since 2020 means it receives no active maintenance or updates.

Use it for:

- Mark translatable strings in Pyramid or Pylons web applications for extraction and translation workflows.
- Integrate translation support into templates using the package's translation utilities.
- Manage message pluralization and context-aware translations in applications using Babel for localization.
- Create translation string factories to enforce consistent domain naming across a codebase.
- Support multi-language applications by preparing strings for gettext-based translation pipelines.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides translation string objects and factories for marking and managing translatable text in Python applications, with support for pluralization and message contexts.

Yes, if you are working within the Pylons/Pyramid ecosystem or need lightweight i18n string management without external dependencies. The package is stable and permissively licensed, with no known vulnerabilities. However, the dormant maintenance status (last release 2020-07-09) means no active support for newer Python versions or bug fixes—verify compatibility with your target Python version before relying on it in new projects.

## Install

pip install translationstring
uv add translationstring
poetry add translationstring

## Installing translationstring

Before you install: Low friction install with no runtime dependencies. Dormant maintenance status—last release was 2020-07-09—but the repository remains active and the package is marked Production/Stable.

License in practice: Licensed under a permissive BSD-like license (Repoze Public License), imposing no significant restrictions on use or redistribution.

Quickstart:

pip install translationstring

from translationstring import TranslationString

msg = TranslationString('Hello ${name}', mapping={'name': 'World'})
print(msg)

Verify before relying:

- Whether the package works reliably with Python versions released after 2020 despite dormant maintenance status.
- Whether Babel integration remains functional and well-tested given the long gap since last release.
- Current compatibility with modern Python 3 versions beyond those listed in classifiers.

## Package facts

- License: BSD-like (http://repoze.org/license.html) (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: dormant
- Downloads: 2.6M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

i18n translation strings, internationalization library, gettext translation support, python localization, message translation factory, pluralization support, template translation utilities, i18n-localization, pylons-ecosystem, gettext-integration

[View on SkillFed](https://skillfed.io/packages/translationstring) · [View on PyPI](https://pypi.org/project/translationstring/)