Changelog

Changelog

1.0.0 — first independent al-falak release

al-falak is versioned independently from adhanpy (a separate PyPI package). Entries below marked 1.0.5 / 1.0.4 are upstream adhanpy lineage, kept for provenance.

• Breaking: Package renamed from adhanpy to alfalak (PyPI: al-falak)
• Breaking: Dedicated AlFalakError hierarchy replaces builtins (AstronomicalError, ConfigurationError, ValidationError)
• Breaking: Python >= 3.11 required (3.9/3.10 reached end-of-life)
• Fix hour-rollover in rounded_minute (10:59:31 now rounds to 11:00)
• Polar day/night and undefined Asr now raise with diagnostic messages
• Narrowed bare except: clauses
• Unknown madhab raises ConfigurationError; non-CalculationMethod method raises TypeError
• PrayerTimes accepts a Coordinates object as well as a tuple
• Method parameters are now copied per instance (no shared globals)
• Ship py.typed (PEP 561) and complete type annotations
• Define the public API surface (__all__-pinned)
• Add PrayerTimes.time_for_prayer(Prayer) accessor
• Add Qibla direction calculation
• Add polar-day/night estimation strategies (PolarCircleRule)
• Add SunnahTimes (middle and last third of the night)
• Add python -m alfalak CLI
• Validate inputs: coordinates, angles, intervals
• Build backend is now hatchling (setup.py removed)
• Dev process: ruff lint gate, mypy --disallow-untyped-defs

1.0.5

• Fix AttributeError when method is not provided or set to None

1.0.4

• Fix rounding of minutes function incorrectly setting 60 for minutes
• Bring support for Python 3.9