.. _spkg_roman_numerals:

roman_numerals: Manipulate well-formed Roman numerals
=====================================================

Description
-----------

A library for manipulating well-formed Roman numerals.

Integers between 1 and 3,999 (inclusive) are supported. Numbers beyond
this range will return an OutOfRangeError.

The classical system of roman numerals requires that the same character
may not appear more than thrice consecutively, meaning that ‘MMMCMXCIX’
(3,999) is the largest well-formed Roman numeral. The smallest is ‘I’ (1),
as there is no symbol for zero in Roman numerals.

License
-------

This project is licenced under the terms of either the Zero-Clause 
BSD licence or the CC0 1.0 Universal licence

Upstream Contact
----------------

https://pypi.org/project/roman-numerals-py/


Type
----

standard


Dependencies
------------

- $(PYTHON)
- :ref:`spkg_pip`

Version Information
-------------------

package-version.txt::

    3.1.0

version_requirements.txt::

    roman-numerals-py

Installation commands
---------------------

.. tab:: PyPI:

   .. CODE-BLOCK:: bash

       $ pip install roman-numerals-py

.. tab:: Sage distribution:

   .. CODE-BLOCK:: bash

       $ sage -i roman_numerals

.. tab:: Arch Linux:

   .. CODE-BLOCK:: bash

       $ sudo pacman -S python-roman-numerals-py

.. tab:: conda-forge:

   .. CODE-BLOCK:: bash

       $ conda install roman-numerals-py

.. tab:: Fedora/Redhat/CentOS:

   .. CODE-BLOCK:: bash

       $ sudo dnf install python-roman-numerals-py

.. tab:: FreeBSD:

   .. CODE-BLOCK:: bash

       $ sudo pkg install textproc/py-roman-numerals-py

.. tab:: Gentoo Linux:

   .. CODE-BLOCK:: bash

       $ sudo emerge dev-python/roman-numerals-py

.. tab:: MacPorts:

   .. CODE-BLOCK:: bash

       $ sudo port install py-roman-_numerals_py

.. tab:: openSUSE:

   .. CODE-BLOCK:: bash

       $ sudo zypper install python-roman-numerals


If the system package is installed and if the (experimental) option
``--enable-system-site-packages`` is passed to ``./configure``, then 
``./configure`` will check if the system package can be used.
