GreekRomanUtils 1.1.1

The module converts Arabic numerals to Greek and Roman numbers

English

Module converting Arabic numerals to Greek and Roman numbers

Version: 1.1.1
Supported Python: 3.11, 3.12, 3.13, 3.14, 3.15
Repository: GitHub - GreekRomanNumerical
License: Apache 2.0

Description

The library converts Arabic numbers, such as 1234, to Roman equivalents, such as MCCXXXIV, or Greek — Α_ΣΛΔ.

This module can also output Greek numbers in different formats. For example, the number 20005003001 can be represented as Κ___Ε__Γ_Α or Κ~Ε~Γ~Α. In addition, it is possible to output the text name of the digits, for example, Kappa macron Epsilon macron Gamma macron Alpha, or output them in lowercase.

Installation

Install the package using pip:

pip install GreekRomanUtils

Hybrid backend (Python + Rust)

Starting from this migration stage, the public API stays unchanged while internal conversion logic can run on a Rust backend.

• Default behavior: try Rust backend first, fallback to Python automatically.
• Force Python backend:

GREEKROMAN_FORCE_PYTHON=1

Development workflow with uv

Install dependencies:

uv sync --dev

Run tests in Python-only mode:

GREEKROMAN_FORCE_PYTHON=1 uv run pytest -v

Build/install Rust extension in editable mode for hybrid testing:

uv run maturin develop --manifest-path rust/Cargo.toml
uv run pytest -v

The structure of the project

There are two main classes: GreekConvert and RomanConvert. They implement the logic of converting to the corresponding numbers. There are also classes GreekAlphabet and RomanNumberAlphabet, which are used to store lists and dictionaries.
There are proprietary data types GreekNumber and RomanNumber for working with Greek and Roman numbers, which will allow you to perform basic mathematical operations with them.

Main functions

For "GreekConvert":

• change_capital — A flag that controls the conversion of characters to upper or lower case.
• change_positional — Change the positional mode for conversion.
• convert — The function of converting an Arabic number to a Greek one, returns GreekNumber object. For example, the number 20005003001 is converted to Κ___Ε__Γ_Α (non-positional mode) or to Κ~Ε~Γ~Α (positional mode).
• convert_to_arabic — A function for converting a Greek number to an Arabic one.
• unicode_to_name — The function converts a Unicode character into its name.
• name_to_unicode — The reverse operation for unicode_to_name.

The "GreekNumber" class:

• set_number — Set a new value.
• set_positional — Set the positional mode flag (affects display format: underscore _ for non-positional, tilde ~ for positional).
• set_capital — Set the upper case flag.
• get_number — Get the current number.
• get_positional — Get the positional flag value.
• get_capital — Get the capital flag value.
• get_str — Get the textual representation of the number (e.g., "alpha beta gamma").
• And basic mathematical operations (+, -, *, /, //, %, **, ==, !=, <, <=, >, >=).

For "RomanConvert":

• convert — The method converts an Arabic number to a Roman number, returns RomanNumber object.
• convert_to_arabic — The reverse method for convert.

For "RomanNumber":

• set_number — Set a new value.
• get_number — Get the current number.
• get_value — Get the string representation of the Roman numeral.
• And basic mathematical operations (+, -, *, /, //, %, **, ==, !=, <, <=, >, >=).

---

Ru

Модуль преобразование арабских цифр в греческие и римские числа

Версия: 1.1.1
Поддерживаемые версии Python: 3.11, 3.12, 3.13, 3.14, 3.15
Репозиторий: GitHub - GreekRomanNumerical
Лицензия: Apache 2.0

Описание

Библиотека преобразует арабские числа, такие как 1234, в римские эквиваленты, например, MCCXXXIV, или греческие — Α_ΣΛΔ.

Также этот модуль может выводить греческие цифры в разных форматах. Например, число 20005003001 можно представить как Κ___Ε__Γ_Α или Κ~Ε~Γ~Α. Кроме того, есть возможность выводить текстовое название цифр, например, Kappa macron Epsilon macron Gamma macron Alpha, или выводить их в нижнем регистре.

Установка

Установите пакет с помощью pip:

pip install GreekRomanUtils

Гибридный backend (Python + Rust)

На этапе миграции публичный API не меняется, но внутренняя логика конвертации может выполняться через Rust backend.

• Поведение по умолчанию: сначала попытка Rust backend, при недоступности автоматический fallback на Python.
• Принудительное отключение Rust backend:

GREEKROMAN_FORCE_PYTHON=1

Локальный workflow через uv

Установка зависимостей:

uv sync --dev

Запуск тестов в Python-only режиме:

GREEKROMAN_FORCE_PYTHON=1 uv run pytest -v

Сборка/подключение Rust-расширения для hybrid-режима:

uv run maturin develop --manifest-path rust/Cargo.toml
uv run pytest -v

Структура пректа

Есть два основных класса: GreekConvert и RomanConvert. Они реализуют логику преобразования в соответствующие числа. Также есть классы GreekAlphabet и RomanNumberAlphabet, которые используются для хранения списков и словарей.
Есть собственные типы данных GreekNumber и RomanNumber для работы с греческими и римскими числами, что позволит выполнять с ними базовые математические операции.

Основные функции

Для «GreekConvert»:

• change_capital — Флаг, управляющий преобразованием символов в верхний или нижний регистр.
• change_positional — Изменить режим позиционного преобразования.
• convert — Функция преобразования арабского числа в греческое, возвращает объект GreekNumber. Например, число 20005003001 преобразуется в Κ___Ε__Γ_Α (непозиционный режим) или в Κ~Ε~Γ~Α (позиционный режим).
• convert_to_arabic — Функция преобразования греческого числа в арабское.
• unicode_to_name — Функция преобразует символ Unicode в его название.
• name_to_unicode — Обратная операция для unicode_to_name.

Класс «GreekNumber»:

• set_number — Установить новое значение.
• set_positional — Установить флаг позиционного режима (влияет на формат отображения: подчеркивание _ для непозиционного, тильда ~ для позиционного).
• set_capital — Установить флаг верхнего регистра.
• get_number — Получить текущее число.
• get_positional — Получить значение флага позиционности.
• get_capital — Получить значение флага регистра.
• get_str — Получить текстовое представление числа (например, "alpha beta gamma").
• И базовые математические операции (+, -, *, /, //, %, **, ==, !=, <, <=, >, >=).

Для «RomanConvert»:

• convert — Метод преобразует арабское число в римское, возвращает объект RomanNumber.
• convert_to_arabic — Обратный метод для convert.

Для «RomanNumber»:

• set_number — Установить новое значение.
• get_number — Получить текущее число.
• get_value — Получить строковое представление римского числа.
• И базовые математические операции (+, -, *, /, //, %, **, ==, !=, <, <=, >, >=).

Схема пректа

License

Apache License 2.0