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.

Source Distribution

roman-numerals-0.1.0.tar.gz (13.1 kB view hashes)

Uploaded source

Built Distribution

roman_numerals-0.1.0-py3-none-any.whl (6.3 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page