Skip to main content

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.

Project details

Download files

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

Files for roman-numerals, version 0.1.0
Filename, size File type Python version Upload date Hashes
Filename, size roman_numerals-0.1.0-py3-none-any.whl (6.3 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size roman-numerals-0.1.0.tar.gz (13.1 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page