Skip to main content
https://github.com/zopefoundation/roman/actions/workflows/tests.yml/badge.svg https://coveralls.io/repos/github/zopefoundation/roman/badge.svg?branch=master Current version on PyPI Supported Python versions

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))
  1. 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.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)

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.

Metadata

Release files for roman 5.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for roman 5.2
File Size Uploaded
roman-5.2.tar.gz 8.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for roman 5.2
File Interpreter ABI Platform
roman-5.2-py3-none-any.whl Python 3 none any Details

Total release size: 14.2 kB

Release files / roman-5.2.tar.gz

Download URL roman-5.2.tar.gz
Size 8.2 kB
Tags Source
SHA-256 checksum
How to use checksums
275fe9f46290f7d0ffaea1c33251b92b8e463ace23660508ceef522e7587cb6f
BLAKE2b-256 checksum
How to use checksums
9c7c3901b35ed856329bf98e84da8e5e0b4d899ea0027eee222f1be42a24ff3f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.12.12

Release files / roman-5.2-py3-none-any.whl

Download URL roman-5.2-py3-none-any.whl
Size 6.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
89d3b47400388806d06ff77ea77c79ab080bc127820dea6bf34e1f1c1b8e676e
BLAKE2b-256 checksum
How to use checksums
1014ea3cdd7276fcd731a9003fe4abeb6b395a38110ddff6a6a509f4ee00f741
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.12.12

Release history Release notifications | RSS feed

This release

5.2 This release

2 release files

5.1

2 release files

5.0

2 release files

4.2

2 release files

4.1

2 release files

4.0

2 release files

3.3

2 release files

3.2

2 release files

3.1

1 release file

3.0

1 release file

2.0.0

1 release file

1.4.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page