# Roman Numeral Conversion Utilities

This is a utility module for converting from and to Roman numerals. It supports numbers upto 3,999,999, using the vinculum to denote multiplication by `1000`

. (i.e.: `X`

is `10`

while `X̅`

is `10000`

.) The only letter that this does not apply to is `I`

, as `M`

already existed for `1000`

.

Special credit goes to Paul M. Winkler, for the original basis for a large chunk of the core converter functions as written in the Python Cookbook.

## Quick Start

Install the package:

pip3 install romanicize

Once installed, a command line utility is available to your shell:

$ romanicize 2021 MMXXI $ romanicize MMXIX 2019

With a Python script, convert from an integer to a Roman numeral:

from romanicize import to_numeral print(to_numeral(2021)) # Outputs: MMXXI

Within a Python script, convert from a Roman numeral to an integer:

from romanicize import to_int print(to_int('MV̅DLXXVIII')) # Outputs: 4578