{"library":"roman","title":"Roman Numeral Converter","description":"The `roman` library is a small, active Python utility that facilitates the conversion of Arabic (decimal) integers to Roman numerals and vice versa. Currently at version 5.2, it supports Python 3.10 and newer, with a history of regular updates often tied to Python version compatibility.","language":"python","status":"active","last_verified":"Fri May 15","install":{"commands":["pip install roman"],"cli":null},"imports":["import roman","import roman\nroman.toRoman(...)","import roman\nroman.fromRoman(...)","from roman import InvalidRomanNumeralError"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"import roman\n\n# Convert integer to Roman numeral\nnumeral = roman.toRoman(1994)\nprint(f\"1994 in Roman numerals: {numeral}\")\n\n# Convert Roman numeral to integer\ninteger = roman.fromRoman('MCMXCIV')\nprint(f\"MCMXCIV as an integer: {integer}\")\n\n# Example with zero (N)\nzero_numeral = roman.toRoman(0)\nprint(f\"0 in Roman numerals: {zero_numeral}\")\n\n# Handling invalid input\ntry:\n    invalid_int = roman.fromRoman('ABC')\n    print(invalid_int)\nexcept roman.InvalidRomanNumeralError as e:\n    print(f\"Error converting 'ABC': {e}\")","lang":"python","description":"This quickstart demonstrates how to convert between integers and Roman numerals using `roman.toRoman()` and `roman.fromRoman()`. It also shows how the library handles the special case for zero ('N') and catches errors for invalid Roman numeral input.","tag":null,"tag_description":null,"last_tested":null,"results":[]},"compatibility":{"tag":null,"tag_description":null,"last_tested":"2026-05-15","installed_version":"5.1","pypi_latest":"5.2","is_stale":true,"summary":{"python_range":"3.10–3.9","success_rate":100,"avg_install_s":1.5,"avg_import_s":0.01,"wheel_type":"wheel"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"roman","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.01,"mem_mb":0.3,"disk_size":"17.8M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"roman","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.4,"import_time_s":0,"mem_mb":0.3,"disk_size":"18M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"roman","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.01,"mem_mb":0.4,"disk_size":"19.6M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"roman","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.5,"import_time_s":0.01,"mem_mb":0.4,"disk_size":"20M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"roman","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.01,"mem_mb":0.4,"disk_size":"11.5M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"roman","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.4,"import_time_s":0.01,"mem_mb":0.4,"disk_size":"12M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"roman","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.01,"mem_mb":0.6,"disk_size":"11.3M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"roman","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.4,"import_time_s":0.01,"mem_mb":0.3,"disk_size":"12M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"roman","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.01,"mem_mb":0.3,"disk_size":"17.3M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"roman","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.7,"import_time_s":0,"mem_mb":0.3,"disk_size":"18M"}]}}