v1.0.0
First stable release. hebrewcal is a pure-Python library for the Hebrew calendar — no runtime dependencies, no network calls. This release completes the roadmap; the public API is now considered stable.
Features
- Calendars & conversion: proleptic Gregorian and Julian (with an explicit reform helper) and a complete Hebrew calendar (molad/halakim, dechiyot, year typing, keviah, Metonic cycle), interconvertible through Rata Die. Parsing, formatting, gematria numerals, name tables, and the Anno Mundi era.
- Astronomy: solar position, sunrise/sunset, twilight, and the molad as a civil instant.
- Holidays: festivals, fasts (with postponement), modern Israeli days, minority feasts, Rosh Chodesh, the Omer and the special Shabbatot — Israel and Diaspora.
- Religious times: candle lighting and Havdalah, zmanim, the molad announcement, yahrzeit, Torah readings, and the Shmita cycle.
- Alternative calendars: the Qumran 364-day calendar plus documented computed Samaritan and Karaite models.
- An optional command-line interface (
hebrewcal).
Installation
pip install hebrewcalRequires Python 3.11+. Documentation: https://hebrewcal.readthedocs.io