computus 1.0.1

Historical chronology tools (indiction, calendar systems, etc.)

Computus

A small Python library for historical chronology.

Author

Ivan Debono

Features

• Indiction calculation (Anno Domini and Byzantine Anno Mundi)
• Roman numeral conversion

Installation

Using pip

pip install computus

Using uv

uv add computus

Or:

uv pip install computus

Usage (Python)

from computus import indiction, arabic_to_roman

i = indiction(525)
print(i)                     # 3
print(arabic_to_roman(i))   # III

Command Line Usage

After installing the package, you can run it directly from the terminal.

Basic usage

computus 525

Example output:

Indiction: 3 (III)

Specify calendar system

computus 525 --calendar AD
computus 1000 --calendar AM

Help

computus --help

Description

computus provides simple tools for working with historical dating systems, inspired by the chronological methods of Late Antiquity and the Middle Ages. It currently supports:

• Calculation of the indiction cycle
• Conversion of integers to Roman numerals

Roadmap

Future features will include:

• Julian ↔ Gregorian calendar conversion
• Parsing historical date formats
• Support for additional era systems

See CHANGELOG.md for release history.

License

PolyForm Noncommercial License 1.0.0

Copyright (c) 2026 Ivan Debono