Skip to content

v1.0.0

Choose a tag to compare

@bsesic bsesic released this 09 Jun 18:04
· 27 commits to main since this release
f49e40c

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 hebrewcal

Requires Python 3.11+. Documentation: https://hebrewcal.readthedocs.io