.. image:: https://github.com/zopefoundation/roman/actions/workflows/tests.yml/badge.svg
:target: https://github.com/zopefoundation/roman/actions/workflows/tests.yml
.. image:: https://coveralls.io/repos/github/zopefoundation/roman/badge.svg?branch=master
:target: https://coveralls.io/github/zopefoundation/roman?branch=master
.. image:: https://img.shields.io/pypi/v/roman.svg
:target: https://pypi.org/project/roman/
:alt: Current version on PyPI
.. image:: https://img.shields.io/pypi/pyversions/roman.svg
:target: https://pypi.org/project/roman/
:alt: Supported Python versions
roman
=====
Small helper library to convert arabic to roman numerals.
There are two ways to use this library.
1. Importing it into your application
.. code-block:: python
import roman
# to roman
number = int(input('> ')) # 10
print(roman.toRoman(number))
# from roman
number = input('> ') # X
print(roman.fromRoman(number))
2. ``roman`` CLI command
.. code-block:: bash
~$ roman 972
CMLXXII
# use the -r/--reverse to convert Roman numerals
~$ roman -r CMLXXII
972
# case insensitive
~$ roman -r cMlxxii
972
Change log
==========
5.1 (2025-07-18)
----------------
- Hide undocumented special behavior for ``N`` behind method parameter.
(`#30 <https://github.com/zopefoundation/roman/issues/30>`_)
5.0 (2025-01-15)
----------------
- Drop support for Python 3.7, 3.8.
- Add support for lower case roman numerals.
(`#22 <https://github.com/zopefoundation/roman/pull/22>`_)
4.2 (2024-04-25)
----------------
- Remove overlooked mentions of the Python 2.1.1 license
(`#17 <https://github.com/zopefoundation/roman/issues/17>`_)
- Add support for Python 3.12 and 3.13.
4.1 (2023-05-26)
----------------
- Change license to the Zope Public License (ZPL) version 2.1
(`#15 <https://github.com/zopefoundation/roman/issues/15>`_)
4.0 (2023-02-28)
----------------
- Add support for Python 3.10, 3.11.
- Drop support for Python 2.7, 3.5, 3.6.
3.3 (2020-07-12)
----------------
- added support for Python 3.9
- added CLI command ``roman`` with ``-r/--reverse`` to convert back from Roman
- added simple usage instructions
3.2 (2019-04-14)
----------------
- expanded test coverage
- Added support for 0 -> N
(see https://en.wikipedia.org/wiki/Roman_numerals#Zero)
- Added support for Python 3.8
3.1 (2018-10-24)
----------------
- Added support for Python 3.7.
3.0 (2018-05-28)
----------------
- Added support for Python 3.5, 3.6 and PyPy3.
- Dropped support for Python 2.6 and 3.3.
2.0.0 (2013-02-25)
------------------
- Added Python 3.3 and PyPy support.
- Added tests.
1.4.0 (2009-07-23)
------------------
- Initial PyPI release.
Raw data
{
"_id": null,
"home_page": "https://github.com/zopefoundation/roman",
"name": "roman",
"maintainer": "Zope Foundation and Contributors",
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": "zope-dev@zope.dev",
"keywords": "roman",
"author": "Mark Pilgrim",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/30/86/8bdb59db4b7ea9a2bd93f8d25298981e09a4c9f4744cf4cbafa7ef6fee7b/roman-5.1.tar.gz",
"platform": null,
"description": ".. image:: https://github.com/zopefoundation/roman/actions/workflows/tests.yml/badge.svg\n :target: https://github.com/zopefoundation/roman/actions/workflows/tests.yml\n\n.. image:: https://coveralls.io/repos/github/zopefoundation/roman/badge.svg?branch=master\n :target: https://coveralls.io/github/zopefoundation/roman?branch=master\n\n.. image:: https://img.shields.io/pypi/v/roman.svg\n :target: https://pypi.org/project/roman/\n :alt: Current version on PyPI\n\n.. image:: https://img.shields.io/pypi/pyversions/roman.svg\n :target: https://pypi.org/project/roman/\n :alt: Supported Python versions\n\nroman\n=====\n\nSmall helper library to convert arabic to roman numerals.\n\nThere are two ways to use this library.\n\n1. Importing it into your application\n\n.. code-block:: python\n\n import roman\n\n # to roman\n number = int(input('> ')) # 10\n print(roman.toRoman(number))\n\n # from roman\n number = input('> ') # X\n print(roman.fromRoman(number))\n\n\n2. ``roman`` CLI command\n\n.. code-block:: bash\n\n ~$ roman 972\n CMLXXII\n # use the -r/--reverse to convert Roman numerals\n ~$ roman -r CMLXXII\n 972\n # case insensitive\n ~$ roman -r cMlxxii\n 972\n\n\n\nChange log\n==========\n\n5.1 (2025-07-18)\n----------------\n\n- Hide undocumented special behavior for ``N`` behind method parameter.\n (`#30 <https://github.com/zopefoundation/roman/issues/30>`_)\n\n\n5.0 (2025-01-15)\n----------------\n\n- Drop support for Python 3.7, 3.8.\n\n- Add support for lower case roman numerals.\n (`#22 <https://github.com/zopefoundation/roman/pull/22>`_)\n\n\n4.2 (2024-04-25)\n----------------\n\n- Remove overlooked mentions of the Python 2.1.1 license\n (`#17 <https://github.com/zopefoundation/roman/issues/17>`_)\n\n- Add support for Python 3.12 and 3.13.\n\n\n4.1 (2023-05-26)\n----------------\n\n- Change license to the Zope Public License (ZPL) version 2.1\n (`#15 <https://github.com/zopefoundation/roman/issues/15>`_)\n\n\n4.0 (2023-02-28)\n----------------\n\n- Add support for Python 3.10, 3.11.\n\n- Drop support for Python 2.7, 3.5, 3.6.\n\n\n3.3 (2020-07-12)\n----------------\n\n- added support for Python 3.9\n\n- added CLI command ``roman`` with ``-r/--reverse`` to convert back from Roman\n\n- added simple usage instructions\n\n\n3.2 (2019-04-14)\n----------------\n\n- expanded test coverage\n\n- Added support for 0 -> N\n (see https://en.wikipedia.org/wiki/Roman_numerals#Zero)\n\n- Added support for Python 3.8\n\n\n3.1 (2018-10-24)\n----------------\n\n- Added support for Python 3.7.\n\n\n3.0 (2018-05-28)\n----------------\n\n- Added support for Python 3.5, 3.6 and PyPy3.\n\n- Dropped support for Python 2.6 and 3.3.\n\n\n2.0.0 (2013-02-25)\n------------------\n\n- Added Python 3.3 and PyPy support.\n\n- Added tests.\n\n\n1.4.0 (2009-07-23)\n------------------\n\n- Initial PyPI release.\n",
"bugtrack_url": null,
"license": "ZPL-2.1",
"summary": "Integer to Roman numerals converter",
"version": "5.1",
"project_urls": {
"Homepage": "https://github.com/zopefoundation/roman"
},
"split_keywords": [
"roman"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "f7d027c9840ddaf331ace898c7f4aa1e1304a7acc22b844b5420fabb6d14c3a0",
"md5": "ef866ad2663cb871539a5e55ac85fa22",
"sha256": "bf595d8a9bc4a8e8b1dfa23e1d4def0251b03b494786df6b8c3d3f1635ce285a"
},
"downloads": -1,
"filename": "roman-5.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ef866ad2663cb871539a5e55ac85fa22",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 5825,
"upload_time": "2025-07-18T05:25:11",
"upload_time_iso_8601": "2025-07-18T05:25:11.496908Z",
"url": "https://files.pythonhosted.org/packages/f7/d0/27c9840ddaf331ace898c7f4aa1e1304a7acc22b844b5420fabb6d14c3a0/roman-5.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "30868bdb59db4b7ea9a2bd93f8d25298981e09a4c9f4744cf4cbafa7ef6fee7b",
"md5": "a6442c1e13564b6749e2dccb5d21bd7e",
"sha256": "3a86572e9bc9183e771769601189e5fa32f1620ffeceebb9eca836affb409986"
},
"downloads": -1,
"filename": "roman-5.1.tar.gz",
"has_sig": false,
"md5_digest": "a6442c1e13564b6749e2dccb5d21bd7e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 8066,
"upload_time": "2025-07-18T05:25:12",
"upload_time_iso_8601": "2025-07-18T05:25:12.753451Z",
"url": "https://files.pythonhosted.org/packages/30/86/8bdb59db4b7ea9a2bd93f8d25298981e09a4c9f4744cf4cbafa7ef6fee7b/roman-5.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-18 05:25:12",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "zopefoundation",
"github_project": "roman",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "roman"
}