Skip to main content
Warning: You are using the test version of PyPI. This is a pre-production deployment of Warehouse. Changes made here affect the production instance of TestPyPI (
Help us improve Python packaging - Donate today!

A library to convert between integers and Unicode Roman numerals.

Project Description

This library will convert integers to unicode Roman numerals, or vice versa. The library supports Apostrophus and Vinculum notation on top of standard Roman numerals.

This library also supports the use of unicode fallback characters. For example, when using fallback characters, instead of outputting code point U+216F (Ⅿ) the library will output the latin M character, which looks identical to the Roman numeral glyph.

Please keep in mind that fallback characters should only be used if escape sequences are unavailable.

Road Map

  • 0.1 Convert between numerals and integers
  • 0.2 Integrate services like PyUp and TravisCI
  • 0.3 Add support for fallback characters
  • 0.4 Write documenation
  • 0.5 Add support for Apostrophus
  • 0.6 Add support for Vinculum
  • 1.0 Full feature release


The structure of the project forces tests to run on an installed version of the code.

You can run the tests directly with python test. Alternatively, you could install the package with pip install -e . or python develop and then run tests with py.test.

To run linters, checkers, and tests on multiple Python versions, simply invoke tox.

Release History

Release History

This version
History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
roman_numerals-0.0.1-py3-none-any.whl (5.9 kB) Copy SHA256 Checksum SHA256 py3 Wheel May 24, 2017
roman-numerals-0.0.1.tar.gz (12.0 kB) Copy SHA256 Checksum SHA256 Source May 24, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting