hijri-datetime 0.1.0__py3-none-any.whl → 0.2.3.post0__py3-none-any.whl

hijri_datetime/__init__.py

@@ -1,3 +1,97 @@
-from .hello import say_hello
+"""
+hijri-datetime: Pythonic Hijri datetime operations.
 
-__all__ = ["say_hello"]
+A comprehensive library for working with Hijri (Islamic) calendar dates,
+providing seamless conversion between Hijri, Gregorian, and Jalali calendars.
+"""
+"""
+hijri-datetime: Pythonic Hijri datetime operations.
+"""
+
+# Version management with fallback
+try:
+    from _version import __version__
+except ImportError:
+    # Fallback version when setuptools_scm hasn't run yet
+    try:
+        from importlib.metadata import version
+        __version__ = version("hijri-datetime")
+    except ImportError:
+        # Ultimate fallback
+        __version__ = "unknown"
+
+# Main exports
+from .date import (
+    HijriDate,
+)
+
+from .datetime import (
+    HijriDateTime,
+)
+
+
+from .time import (
+    HijriTime,
+)
+
+
+from .range import (
+    HijriDateRange,
+)
+
+from .conversion import (
+    hijri_to_gregorian,
+    gregorian_to_hijri,
+    hijri_to_jalali,
+    jalali_to_hijri,
+)
+
+from .exceptions import (
+    HijriError,
+    InvalidHijriDate,
+    ConversionError,
+)
+
+from .utils import (
+    is_valid_hijri_date,
+    get_hijri_month_name,
+    get_hijri_weekday_name,
+)
+
+# Convenience imports
+from .constants import (
+    HIJRI_MONTHS,
+    HIJRI_WEEKDAYS,
+    ISLAMIC_EPOCH,
+)
+
+__all__ = [
+    "__version__",
+    # Core classes
+    "HijriDate",
+    "HijriDateTime", 
+    "HijriTime",
+    "HijriDateRange",
+    # Conversion functions
+    "hijri_to_gregorian",
+    "gregorian_to_hijri",
+    "hijri_to_jalali",
+    "jalali_to_hijri",
+    # Exceptions
+    "HijriError",
+    "InvalidHijriDate",
+    "ConversionError",
+    # Utilities
+    "is_valid_hijri_date",
+    "get_hijri_month_name",
+    "get_hijri_weekday_name",
+    # Constants
+    "HIJRI_MONTHS",
+    "HIJRI_WEEKDAYS",
+    "ISLAMIC_EPOCH",
+]
+
+# Package metadata
+__author__ = "m.lotfi"
+__email__ = "m.lotfi@email.com"
+__description__ = "Pythonic Hijri datetime — handle full & partial dates, ranges, and seamless Gregorian & Jalali conversion."

hijri_datetime/_version.py

@@ -0,0 +1,34 @@
+# file generated by setuptools-scm
+# don't change, don't track in version control
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from typing import Tuple
+    from typing import Union
+
+    VERSION_TUPLE = Tuple[Union[int, str], ...]
+    COMMIT_ID = Union[str, None]
+else:
+    VERSION_TUPLE = object
+    COMMIT_ID = object
+
+version: str
+__version__: str
+__version_tuple__: VERSION_TUPLE
+version_tuple: VERSION_TUPLE
+commit_id: COMMIT_ID
+__commit_id__: COMMIT_ID
+
+__version__ = version = '0.2.3.post0'
+__version_tuple__ = version_tuple = (0, 2, 3, 'post0')
+
+__commit_id__ = commit_id = None

hijri_datetime/constants.py

@@ -0,0 +1,64 @@
+"""Constants for Hijri calendar."""
+
+from datetime import date
+
+# Hijri month names in Arabic and English
+HIJRI_MONTHS = [
+    "Muharram",
+    "Safar", 
+    "Rabi' al-awwal",
+    "Rabi' al-thani",
+    "Jumada al-awwal",
+    "Jumada al-thani",
+    "Rajab",
+    "Sha'ban",
+    "Ramadan",
+    "Shawwal",
+    "Dhu al-Qi'dah",
+    "Dhu al-Hijjah"
+]
+
+HIJRI_MONTHS_ARABIC = [
+    "محرم",
+    "صفر",
+    "ربيع الأول", 
+    "ربيع الثاني",
+    "جمادى الأولى",
+    "جمادى الثانية",
+    "رجب",
+    "شعبان",
+    "رمضان",
+    "شوال",
+    "ذو القعدة",
+    "ذو الحجة"
+]
+
+# Weekday names
+HIJRI_WEEKDAYS = [
+    "Saturday",  # Sabt
+    "Sunday",    # Ahad
+    "Monday",    # Ithnayn
+    "Tuesday",   # Thulatha
+    "Wednesday", # Arbi'a
+    "Thursday",  # Khamis
+    "Friday"     # Jumu'ah
+]
+
+HIJRI_WEEKDAYS_ARABIC = [
+    "السبت",
+    "الأحد", 
+    "الإثنين",
+    "الثلاثاء",
+    "الأربعاء",
+    "الخميس",
+    "الجمعة"
+]
+
+# Islamic epoch (July 16, 622 CE in Gregorian calendar)
+ISLAMIC_EPOCH = date(622, 7, 16)
+
+# Days in each Hijri month (simplified - actual lengths vary)
+HIJRI_MONTH_DAYS = [30, 29, 30, 29, 30, 29, 30, 29, 30, 29, 30, 29]
+
+# Leap year pattern for Hijri calendar (30-year cycle)
+HIJRI_LEAP_YEARS = [2, 5, 7, 10, 13, 16, 18, 21, 24, 26, 29]

hijri_datetime/date.py

@@ -0,0 +1,135 @@
+"""Core Hijri date and time classes."""
+
+from datetime import date, datetime, time
+from typing import Optional, Union, Tuple
+import calendar
+
+from exceptions import InvalidHijriDate
+from constants import HIJRI_MONTHS, HIJRI_WEEKDAYS
+
+
+class HijriDate:
+    """Represents a Hijri calendar date."""
+    
+    def __init__(self, year: int, month: int, day: int):
+        """Initialize a Hijri date.
+        
+        Args:
+            year: Hijri year
+            month: Hijri month (1-12)
+            day: Hijri day (1-30)
+            
+        Raises:
+            InvalidHijriDate: If the date is invalid
+        """
+        if not self._is_valid_date(year, month, day):
+            raise InvalidHijriDate(f"Invalid Hijri date: {year}-{month}-{day}")
+            
+        self.year = year
+        self.month = month
+        self.day = day
+    
+    def _is_valid_date(self, year: int, month: int, day: int) -> bool:
+        """Check if the given Hijri date is valid."""
+        if not (1 <= month <= 12):
+            return False
+        if not (1 <= day <= 30):
+            return False
+        # Add more sophisticated validation here
+        return True
+    
+    def __repr__(self) -> str:
+        return f"HijriDate({self.year}, {self.month}, {self.day})"
+    
+    def __str__(self) -> str:
+        return f"{self.year:04d}-{self.month:02d}-{self.day:02d}"
+    
+    @property
+    def month_name(self) -> str:
+        """Get the name of the Hijri month."""
+        return HIJRI_MONTHS[self.month - 1]
+    
+    def to_gregorian(self) -> date:
+        """Convert to Gregorian date."""
+        from .converter import hijri_to_gregorian
+        return hijri_to_gregorian(self)
+    
+    def to_jalali(self):
+        """Convert to Jalali date."""
+        from .converter import hijri_to_jalali
+        return hijri_to_jalali(self)
+
+
+class HijriDateTime:
+    """Represents a Hijri calendar datetime."""
+    
+    def __init__(self, year: int, month: int, day: int, 
+                 hour: int = 0, minute: int = 0, second: int = 0):
+        """Initialize a Hijri datetime."""
+        self.date = HijriDate(year, month, day)
+        self.time = HijriTime(hour, minute, second)
+    
+    @property
+    def year(self) -> int:
+        return self.date.year
+    
+    @property
+    def month(self) -> int:
+        return self.date.month
+    
+    @property
+    def day(self) -> int:
+        return self.date.day
+    
+    def __repr__(self) -> str:
+        return f"HijriDateTime({self.year}, {self.month}, {self.day}, {self.time.hour}, {self.time.minute}, {self.time.second})"
+
+
+class HijriTime:
+    """Represents a time in the Hijri calendar context."""
+    
+    def __init__(self, hour: int = 0, minute: int = 0, second: int = 0):
+        """Initialize a Hijri time."""
+        if not (0 <= hour <= 23):
+            raise ValueError("Hour must be between 0 and 23")
+        if not (0 <= minute <= 59):
+            raise ValueError("Minute must be between 0 and 59")
+        if not (0 <= second <= 59):
+            raise ValueError("Second must be between 0 and 59")
+            
+        self.hour = hour
+        self.minute = minute
+        self.second = second
+
+
+class HijriDateRange:
+    """Represents a range of Hijri dates."""
+    
+    def __init__(self, start: HijriDate, end: HijriDate):
+        """Initialize a Hijri date range."""
+        if start > end:
+            raise ValueError("Start date must be before or equal to end date")
+        self.start = start
+        self.end = end
+    
+    def __contains__(self, date: HijriDate) -> bool:
+        """Check if a date is within the range."""
+        return self.start <= date <= self.end
+    
+    def __iter__(self):
+        """Iterate over dates in the range."""
+        current = self.start
+        while current <= self.end:
+            yield current
+            # Add one day (simplified)
+            current = self._add_one_day(current)
+    
+    def _add_one_day(self, date: HijriDate) -> HijriDate:
+        """Add one day to a Hijri date (simplified implementation)."""
+        # This is a simplified version - you'd need proper calendar logic
+        if date.day < 30:  # Assuming max 30 days per month for simplicity
+            return HijriDate(date.year, date.month, date.day + 1)
+        elif date.month < 12:
+            return HijriDate(date.year, date.month + 1, 1)
+        else:
+            return HijriDate(date.year + 1, 1, 1)

hijri_datetime/exceptions.py

@@ -0,0 +1,26 @@
+"""Custom exceptions for hijri-datetime package."""
+
+
+class HijriError(Exception):
+    """Base exception for hijri-datetime package."""
+    pass
+
+
+class InvalidHijriDate(HijriError):
+    """Raised when an invalid Hijri date is provided."""
+    pass
+
+
+class ConversionError(HijriError):
+    """Raised when calendar conversion fails."""
+    pass
+
+
+class InvalidHijriTime(HijriError):
+    """Raised when an invalid Hijri time is provided."""
+    pass
+
+
+class DateRangeError(HijriError):
+    """Raised when there's an error with date ranges."""
+    pass

{hijri_datetime-0.1.0.dist-info → hijri_datetime-0.2.3.post0.dist-info}/METADATA

@@ -1,13 +1,23 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.1
 Name: hijri-datetime
-Version: 0.1.0
+Version: 0.2.3.post0
+Summary: Pythonic Hijri datetime — handle full & partial dates, ranges, and seamless Gregorian & Jalali conversion.
 Author-email: "m.lotfi" <m.lotfi@email.com>
 Maintainer-email: "m.lotfi" <m.lotfi@email.com>
-License: MIT
-Keywords: python,package,modules,portable,hijri,islamic,calendar,datetime
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Development Status :: 3 - Alpha
+License: GPL version 3
+Project-URL: Homepage, https://github.com/mlotfic/hijri-datetime
+Project-URL: Documentation, https://github.com/mlotfic/hijri-datetime#readme
+Project-URL: Repository, https://github.com/mlotfic/hijri-datetime.git
+Project-URL: Bug Tracker, https://github.com/mlotfic/hijri-datetime/issues
+Project-URL: Changelog, https://github.com/mlotfic/hijri-datetime/blob/main/CHANGELOG.md
+Project-URL: Source Code, https://github.com/mlotfic/hijri-datetime
+Project-URL: Download, https://pypi.org/project/hijri-datetime/
+Keywords: python,package,modules,portable,hijri,islamic,calendar,datetime,gregorian,jalali,conversion
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
 Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
@@ -15,13 +25,67 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Operating System :: OS Independent
-Classifier: Topic :: Software Development :: Libraries
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Classifier: Topic :: Software Development :: Internationalization
+Classifier: Topic :: Utilities
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: jdatetime>=3.0.0
+Requires-Dist: requests>=2.20.0
+Requires-Dist: numpy>=1.18.0
+Requires-Dist: pandas>=1.0.0
+Provides-Extra: all
+Requires-Dist: pytest>=6.0; extra == "all"
+Requires-Dist: pytest-cov>=2.0; extra == "all"
+Requires-Dist: pytest-mock>=3.0; extra == "all"
+Requires-Dist: black>=22.0; extra == "all"
+Requires-Dist: flake8>=4.0; extra == "all"
+Requires-Dist: mypy>=0.900; extra == "all"
+Requires-Dist: isort>=5.0; extra == "all"
+Requires-Dist: pre-commit>=2.0; extra == "all"
+Requires-Dist: tox>=3.0; extra == "all"
+Requires-Dist: build>=0.10; extra == "all"
+Requires-Dist: twine>=4.0; extra == "all"
+Requires-Dist: setuptools-scm>=6.2; extra == "all"
+Requires-Dist: setuptools>=45; extra == "all"
+Requires-Dist: wheel; extra == "all"
+Requires-Dist: sphinx>=4.0; extra == "all"
+Requires-Dist: sphinx-rtd-theme>=1.0; extra == "all"
+Requires-Dist: myst-parser>=0.17.0; extra == "all"
+Provides-Extra: dev
+Requires-Dist: pytest>=6.0; extra == "dev"
+Requires-Dist: pytest-cov>=2.0; extra == "dev"
+Requires-Dist: black>=22.0; extra == "dev"
+Requires-Dist: flake8>=4.0; extra == "dev"
+Requires-Dist: mypy>=0.900; extra == "dev"
+Requires-Dist: pre-commit>=2.0; extra == "dev"
+Requires-Dist: tox>=3.0; extra == "dev"
+Requires-Dist: build>=0.10; extra == "dev"
+Requires-Dist: twine>=4.0; extra == "dev"
+Requires-Dist: setuptools-scm>=6.2; extra == "dev"
+Requires-Dist: setuptools>=45; extra == "dev"
+Requires-Dist: wheel; extra == "dev"
+Requires-Dist: sphinx>=4.0; extra == "dev"
+Requires-Dist: sphinx-rtd-theme>=1.0; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: sphinx>=4.0; extra == "docs"
+Requires-Dist: sphinx-rtd-theme>=1.0; extra == "docs"
+Requires-Dist: myst-parser>=0.17.0; extra == "docs"
+Provides-Extra: lint
+Requires-Dist: black>=22.0; extra == "lint"
+Requires-Dist: flake8>=4.0; extra == "lint"
+Requires-Dist: mypy>=0.900; extra == "lint"
+Requires-Dist: isort>=5.0; extra == "lint"
+Provides-Extra: test
+Requires-Dist: pytest>=6.0; extra == "test"
+Requires-Dist: pytest-cov>=2.0; extra == "test"
+Requires-Dist: pytest-mock>=3.0; extra == "test"
 
 # hijri-datetime
 
+# 💡💡💡💡💡💡 **this not working yet** 💡💡💡💡
+
 📅 **Hijri (Islamic) calendar datetime library for Python**  
 A drop-in replacement for Python's built-in `datetime` module, supporting Hijri date arithmetic, formatting, conversion, partial dates, and integration with `jdatetime`.
 
@@ -97,6 +161,10 @@ print(jd)        # jdatetime.date(...)
 
 ## Partial Dates & Ranges
 
+- `HijriDate(1446)` → represents the whole year.
+- `HijriDate(1446, 2)` → represents all days of month 2.
+- Conversion to Gregorian returns ranges:
+
 * **Year only**
 
   ```python
@@ -105,7 +173,7 @@ print(jd)        # jdatetime.date(...)
   print(start, end)  # 2024-07-18 2025-07-06 (example)
   ```
 
-* **Month only**
+* **Year and Month only**
 
   ```python
   d = HijriDate(1446, 2)

hijri_datetime-0.2.3.post0.dist-info/RECORD

@@ -0,0 +1,17 @@
+hijri_datetime/__init__.py,sha256=YnOnizT1unfEZn6tmi3Dus9VQggmNGYvVlMSv2VwySw,2033
+hijri_datetime/_version.py,sha256=vqjwQ545ESEu9ocidQTg8luMMmtthTxpj1n-QHKjwpc,753
+hijri_datetime/calendar.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hijri_datetime/constants.py,sha256=kLAJLq-QsULaHd_hz0QTpFLH93McQQFI2NeBEkLIHyg,1430
+hijri_datetime/conversion.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hijri_datetime/date.py,sha256=g6wRgHZzXUmiDWHp8bHJVcbyC5nqXFvMfU5IgWPE_cQ,4519
+hijri_datetime/datetime.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hijri_datetime/exceptions.py,sha256=TAiKzltQkFydMRv9vYfdrAStgoQ6ePe_evNoSkKNGr0,574
+hijri_datetime/hello.py,sha256=PcWMF-H8OoHLsK4OW9QWYyMGnRsPz-hqLh916OLetPo,64
+hijri_datetime/range.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hijri_datetime/time.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hijri_datetime/utils.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hijri_datetime-0.2.3.post0.dist-info/LICENSE,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hijri_datetime-0.2.3.post0.dist-info/METADATA,sha256=pTwgyBFZbrEOQgS1NJgVPB82mOTLkr2MADLbyWeZR_Y,8047
+hijri_datetime-0.2.3.post0.dist-info/WHEEL,sha256=iAkIy5fosb7FzIOwONchHf19Qu7_1wCWyFNR5gu9nU0,91
+hijri_datetime-0.2.3.post0.dist-info/top_level.txt,sha256=3-byeAhSA03hoaPXanoyL76rRo5_FTCD9DIwk81fdck,15
+hijri_datetime-0.2.3.post0.dist-info/RECORD,,

{hijri_datetime-0.1.0.dist-info → hijri_datetime-0.2.3.post0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (76.1.0)
+Generator: setuptools (75.3.2)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

hijri_datetime-0.1.0.dist-info/RECORD

@@ -1,6 +0,0 @@
-hijri_datetime/__init__.py,sha256=i2SM-vSV4sCVWyVki7bQpsJSEAw-RPLMMEXV3-MCWGM,57
-hijri_datetime/hello.py,sha256=PcWMF-H8OoHLsK4OW9QWYyMGnRsPz-hqLh916OLetPo,64
-hijri_datetime-0.1.0.dist-info/METADATA,sha256=1X9y3xdHRLonNACBiJIaBx7YV5RIq8z1A2DgX9rWzXg,4780
-hijri_datetime-0.1.0.dist-info/WHEEL,sha256=beeZ86-EfXScwlR_HKu4SllMC9wUEj_8Z_4FJ3egI2w,91
-hijri_datetime-0.1.0.dist-info/top_level.txt,sha256=3-byeAhSA03hoaPXanoyL76rRo5_FTCD9DIwk81fdck,15
-hijri_datetime-0.1.0.dist-info/RECORD,,