Metadata-Version: 2.4
Name: setuptools-gettext
Version: 0.1.16
Summary: Setuptools gettext extension plugin
Maintainer-email: Breezy Developers <breezy-core@googlegroups.com>
Project-URL: Homepage, https://github.com/breezy-team/setuptools-gettext
Project-URL: repository, https://github.com/breezy-team/setuptools-gettext.git
Keywords: setuptools,gettext
Classifier: Topic :: Software Development :: Version Control
Classifier: License :: OSI Approved :: GNU General Public License v2 or later (GPLv2+)
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.9
Classifier: Operating System :: POSIX
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: COPYING
Requires-Dist: setuptools>=61.0
Requires-Dist: tomli>=1.2.1; python_version < "3.11"
Provides-Extra: dev
Requires-Dist: ruff==0.14.2; extra == "dev"
Requires-Dist: mypy==1.18.2; extra == "dev"
Provides-Extra: translate-toolkit
Requires-Dist: translate-toolkit>=3.14.0; extra == "translate-toolkit"
Dynamic: license-file

# setuptools plugin for gettext

Compile .po files into .mo files.

This plugin adds `build_mo`, `clean_mo` and `install_mo` subcommands for
setup.py as well as hooking those into standard commands.

## Usage

By default, setuptools_gettext compiles and installs mo files when there is a
`po` directory present that contains ``.po`` files.

The .mo files are installed adjacent to your package as package data in a subdirectory called ``locale``.

You can override these settings in ``pyproject.toml``:

```toml
[build-system]
requires = ["setuptools", "setuptools-gettext"]
...

[tool.setuptools-gettext]
# directory in which the .po files can be found 
source_dir = "po"
# directory in which the generated .mo files are placed when building
build_dir = "breezy/locale"
```

## Compilation tool

By default, either ``msgfmt`` or the `translate-toolkit` package is used to
compile the .po files into .mo files - whichever is available.

The ``--msgfmt`` option can be used to force the use of ``msgfmt``, and the
``--translate-toolkit`` option can be used to force the use of the
translate-toolkit.

At the moment, ``msgfmt`` is preferred. In the future, the translate-toolkit
will become the default.

You can use the ``translate-toolkit`` extra to install the translate-toolkit
package.
