ummalqura

What it is and what it does

ummalqura is a Python library for bidirectional conversion between Gregorian and Hijri (Islamic) calendar dates. It provides localized month and day names in both Arabic and English, along with utility methods to query Hijri dates for specific calendar boundaries and current dates.

The package wraps date conversion logic into a HijriDate class that accepts either Gregorian or Hijri dates as input and exposes properties for retrieving the equivalent date in the other calendar system. It has no runtime dependencies, making installation straightforward, but the project has been unmaintained since its final release on 2017-12-26.

Use it for:

• Convert user-submitted Gregorian dates to Hijri equivalents for Islamic calendar applications or localized interfaces.
• Display Hijri month and day names in Arabic for applications serving Arabic-speaking users.
• Query the start and end dates of a given Hijri month for scheduling or calendar planning features.
• Retrieve current Hijri date and month for real-time Islamic calendar displays or event tracking.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Converts between Gregorian and Hijri calendar dates, returning day and month names in Arabic and English.

No. The package is abandoned (last update 2017-12-26), has an unclear license ('Waqef' with no SPDX mapping), and carries high install friction. While it has no known vulnerabilities and no dependencies, the lack of maintenance and legal clarity make it unsuitable for production use. Consider a maintained alternative for Hijri calendar conversion.

Install

ummalqura on PyPI

pip install ummalqura

uv add ummalqura

poetry add ummalqura

Installing ummalqura

Before you install

High install friction and abandoned maintenance status since 2017-12-26. The package has not been updated since its final release, with no active development or support.

License in practice

License is listed as 'Waqef' with no SPDX mapping, making its legal treatment unclear. Users should verify compatibility with their project's licensing requirements before use.

Quickstart

from ummalqura.hijri_date import HijriDate
from datetime import date

# Convert Gregorian to Hijri
um = HijriDate(2017, 12, 26, gr=True)
print(um.month, um.year)  # 4 1439
print(um.day_name, um.month_name)  # الثلاثاء ربيع الثاني

# Convert Hijri to Gregorian
gregorian = HijriDate.get_georing_date('1439-04-08')
print(gregorian)  # 2017-12-26

Verify before relying

• Whether 'Waqef' is a recognized open-source license and what restrictions it imposes
• Python version compatibility (requires_python is unspecified in metadata)
• Accuracy of Hijri conversion algorithm relative to current Islamic calendar standards

Package facts

Evidence: ummalqura-2.0.1.tar.gz

Keywords: ummalqura

Tags

More Utilities packages