Development Status
- 5 - Production/Stable
Intended Audience
- Developers
Programming Language
- Python
License
- OSI Approved :: Zope Public License
Natural Language
- English
Operating System
- OS Independent
roman
Small helper library to convert arabic to roman numerals.
There are two ways to use this library.
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))roman CLI command
~$ roman 972
CMLXXII
# use the -r/--reverse to convert Roman numerals
~$ roman -r CMLXXII
972
# case insensitive
~$ roman -r cMlxxii
972Change log
5.2 (2025-11-11)
Add support for Python 3.14.
Drop support for Python 3.9.
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.