zope.i18nmessageid

What it is and what it does

zope.i18nmessageid is a small library that creates message factory objects for marking translatable strings in Python source code with internationalization metadata. When you call the factory with a string, it returns a special unicode object that carries both the original text and a source domain identifier—information that translation systems need to know which translation catalog to use and what context the string belongs to. This decouples message declaration from translation: your code marks strings as translatable and associates them with a domain, while a separate translation layer handles the actual lookup and substitution of localized text.

The package is part of the Zope ecosystem and is typically used in web applications that need to support multiple languages. It has one runtime dependency on zope.interface and is actively maintained with broad Python version support. Installation is straightforward with prebuilt wheels for common platforms.

Use it for:

• Mark translatable strings in web applications with a source domain so translation catalogs can locate and replace them.
• Declare messages in template files and Python source that will be extracted and sent to translators without embedding translation logic.
• Build multilingual applications where view code needs to pass translatable text to templates without knowing the user's language.
• Create reusable message factories for different modules so each can have its own translation domain and catalog.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides message factory objects that tag unicode strings with internationalization metadata (source domain and optional default translation) for use in translation workflows.

Yes, if you are building applications that use zope.i18n for internationalization. The package is stable, actively maintained, and has no known vulnerabilities. However, verify the ZPL-2.1 license compatibility with your project first, as the license treatment is marked unclear. If you are not using a framework that depends on this package, you likely do not need it.

Install

zope-i18nmessageid on PyPI

pip install zope-i18nmessageid

uv add zope-i18nmessageid

poetry add zope-i18nmessageid

Installing zope.i18nmessageid

Before you install

Medium install friction with prebuilt wheels for Python 3.10–3.14 on multiple platforms. Actively maintained with a recent release; last commit on 2026-08-14. Single runtime dependency on zope.interface.

License in practice

Licensed under ZPL-2.1, but license treatment is marked unclear in the fact sheet. Verify the exact terms and any obligations before use in proprietary or GPL-licensed projects.

Quickstart

pip install zope.i18nmessageid
from zope.i18nmessageid import MessageFactory
_ = MessageFactory('my.domain')
msg = _('Hello World')

Requires Python 3.10 or later.

Verify before relying

• What does 'unclear' license treatment mean in practice—are there known compatibility issues with other licenses?
• Does zope.interface have any system-level dependencies that would affect installation on minimal environments?

Package facts

Evidence: zope_i18nmessageid-8.2-cp310-cp310-macosx_10_9_x86_64.whl; zope_i18nmessageid-8.2-cp310-cp310-macosx_11_0_arm64.whl; zope_i18nmessageid-8.2-cp310-cp310-manylinux1_i686.manylinux2014_i686.manylinux_2_17_i686.manylinux_2_5_i686.whl; zope_i18nmessageid-8.2-cp310-cp310-manylinux1_x86_64.manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_5_x86_64.whl; zope_i18nmessageid-8.2-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.whl; zope_i18nmessageid-8.2-cp310-cp310-win_amd64.whl; zope_i18nmessageid-8.2-cp311-cp311-macosx_10_9_x86_64.whl; zope_i18nmessageid-8.2-cp311-cp311-macosx_11_0_arm64.whl; zope_i18nmessageid-8.2-cp311-cp311-manylinux1_i686.manylinux2014_i686.manylinux_2_17_i686.manylinux_2_5_i686.whl; zope_i18nmessageid-8.2-cp311-cp311-manylinux1_x86_64.manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_5_x86_64.whl; zope_i18nmessageid-8.2-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.whl; zope_i18nmessageid-8.2-cp311-cp311-win_amd64.whl; zope_i18nmessageid-8.2-cp312-cp312-macosx_10_9_x86_64.whl; zope_i18nmessageid-8.2-cp312-cp312-macosx_11_0_arm64.whl; zope_i18nmessageid-8.2-cp312-cp312-manylinux1_i686.manylinux2014_i686.manylinux_2_17_i686.manylinux_2_5_i686.whl; zope_i18nmessageid-8.2-cp312-cp312-manylinux1_x86_64.manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_5_x86_64.whl; zope_i18nmessageid-8.2-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.whl; zope_i18nmessageid-8.2-cp312-cp312-win_amd64.whl; zope_i18nmessageid-8.2-cp313-cp313-macosx_10_9_x86_64.whl; zope_i18nmessageid-8.2-cp313-cp313-macosx_11_0_arm64.whl

Keywords: zope, i18n, message, factory

Tags

More WWW/HTTP packages