roman 5.1

Integer to Roman numerals converter

roman

Small helper library to convert arabic to roman numerals.

There are two ways to use this library.

1. Importing it into your application

import roman

# to roman
number = int(input('> ')) # 10
print(roman.toRoman(number))

# from roman
number = input('> ') # X
print(roman.fromRoman(number))

2. roman CLI command

~$ roman 972
CMLXXII
# use the -r/--reverse to convert Roman numerals
~$ roman -r CMLXXII
972
# case insensitive
~$ roman -r cMlxxii
972

Change log

5.1 (2025-07-18)

• Hide undocumented special behavior for N behind method parameter. (#30)

5.0 (2025-01-15)

• Drop support for Python 3.7, 3.8.

• Add support for lower case roman numerals. (#22)

4.2 (2024-04-25)

• Remove overlooked mentions of the Python 2.1.1 license (#17)

• Add support for Python 3.12 and 3.13.

4.1 (2023-05-26)

• Change license to the Zope Public License (ZPL) version 2.1 (#15)

4.0 (2023-02-28)

• Add support for Python 3.10, 3.11.

• Drop support for Python 2.7, 3.5, 3.6.

3.3 (2020-07-12)

• added support for Python 3.9

• added CLI command roman with -r/--reverse to convert back from Roman

• added simple usage instructions

3.2 (2019-04-14)

• expanded test coverage

• Added support for 0 -> N (see https://en.wikipedia.org/wiki/Roman_numerals#Zero)

• Added support for Python 3.8

3.1 (2018-10-24)

• Added support for Python 3.7.

3.0 (2018-05-28)

• Added support for Python 3.5, 3.6 and PyPy3.

• Dropped support for Python 2.6 and 3.3.

2.0.0 (2013-02-25)

• Added Python 3.3 and PyPy support.

• Added tests.

1.4.0 (2009-07-23)

• Initial PyPI release.