puber – Text tools for publishers

puber is a lightweight toolkit for text normalization and preparation for publishing workflows.

The project is designed as a growing set of utilities for working with human-oriented text data.

At the moment, the package provides basic name normalization, but its functionality will be expanded with additional text processing tools in future releases.

Installation

Using pip

pip install --upgrade puber

For development:

pip install -e .

Recommended for CLI use: pipx

If you primarily use puber as a command-line tool, it is best installed with pipx.
This isolates the package in its own virtual environment and avoids polluting your system Python:

pipx install --upgrade puber

After installation it will be available globally:

puber --help

Requirements

• Python 3.9+
• macOS, Linux, or Windows

Usage

Command-line interface

Currently available commands:

# Normalize as personal name
puber norm -n "Татьяна М. Иванова" # -> Иванова Т.М.

Python API

from puber import norm_name

print(norm_name("Татьяна М. Иванова"))  # -> Иванова Т.М.

Testing

The project includes an extensive automated test suite for text normalization.

Run tests from the project root:

pytest

For src-layout development:

pip install -e .
pytest

License

MIT License
(c) 2025 Timur Ulyahin
https://github.com/ucomru

Project Homepage

GitHub:
https://github.com/ucomru/python-puber

PyPI:
https://pypi.org/project/puber/