hijri-datetime 0.0.0__py3-none-any.whl

hijri_datetime/__init__.py

@@ -0,0 +1,3 @@
+from .hello import say_hello
+
+__all__ = ["say_hello"]

hijri_datetime/hello.py

@@ -0,0 +1,2 @@
+def say_hello(name: str) -> str:
+    return f"Hello, {name}!"

hijri_datetime-0.0.0.dist-info/METADATA

@@ -0,0 +1,198 @@
+Metadata-Version: 2.1
+Name: hijri-datetime
+Version: 0.0.0
+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: 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
+Project-URL: Bug Tracker, https://github.com/mlotfic/hijri_datetime/issues
+Project-URL: Changelog, https://github.com/mlotfic/hijri_datetime/blob/main/CHANGELOG.md
+Keywords: python,package,modules,portable,hijri,islamic,calendar,datetime
+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 :: Build Tools
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: jdatetime
+Requires-Dist: requests
+Requires-Dist: numpy
+Requires-Dist: pandas
+
+# hijri-datetime
+
+📅 **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`.
+
+---
+
+## Features
+
+- **HijriDate / HijriDateTime classes**  
+  Drop-in replacement for `datetime.date` and `datetime.datetime`.
+
+- **Partial Dates & Ranges**  
+  Handle missing months or days gracefully:
+  - `HijriDate(1446)` → represents the full year.
+  - `HijriDate(1446, 2)` → represents all days of month 2.
+  - Arithmetic supports ranges and comparisons.
+
+- **Gregorian ↔ Hijri Conversion**  
+  - Vectorized conversion using preloaded dataset (from [Aladhan API](https://aladhan.com/islamic-calendar-api)).
+  - Accurate conversion for historical and future dates.
+  
+- **Integration with jdatetime**  
+  Convert Hijri dates to Jalali calendar easily:
+  ```python
+  import jdatetime
+  jd = hijri_date.to_jdatetime()
+  ````
+
+* **Full datetime API support**
+  Methods like `.year`, `.month`, `.day`, `.weekday()`, `.isoweekday()`, `.strftime()`, `.fromisoformat()`, `.today()`, `.now()`.
+
+* **Calendar module compatibility**
+  Leap year checks, month lengths, weekdays, etc.
+
+* **Vectorized / Bulk Conversion Support**
+  Efficient for millions of rows with pandas/numpy.
+
+---
+
+## Installation
+
+```bash
+pip install hijri-datetime
+```
+
+---
+
+## Quick Start
+
+```python
+from hijri_datetime import HijriDate, HijriDateTime
+
+# Create Hijri dates
+d1 = HijriDate(1446, 2, 15)  # Full date
+d2 = HijriDate(1446, 2)      # Day missing → treat as range
+d3 = HijriDate(1446)         # Month & day missing → full year range
+
+# Convert to Gregorian
+print(d1.to_gregorian())             # datetime.date(2025, 9, 9)
+print(d2.to_gregorian_range())       # [datetime.date(2025,9,1), datetime.date(2025,9,30)]
+print(d3.to_gregorian_range())       # full year range
+
+# Date arithmetic
+print(d1 + 10)   # Add 10 days
+print(d1 - 5)    # Subtract 5 days
+
+# jdatetime conversion
+import jdatetime
+jd = d1.to_jdatetime()
+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
+  d = HijriDate(1446)
+  start, end = d.to_gregorian_range()
+  print(start, end)  # 2024-07-18 2025-07-06 (example)
+  ```
+
+* **Year and Month only**
+
+  ```python
+  d = HijriDate(1446, 2)
+  start, end = d.to_gregorian_range()
+  print(start, end)  # 2025-09-01 2025-09-30 (example)
+  ```
+
+---
+
+## Gregorian ↔ Hijri Conversion
+
+```python
+from hijri_datetime import HijriConverter
+
+converter = HijriConverter()
+
+# Hijri → Gregorian
+greg = converter.hijri_to_gregorian(1446, 2, 15)
+print(greg)  # datetime.date(2025, 9, 9)
+
+# Gregorian → Hijri
+hijri = converter.gregorian_to_hijri(greg)
+print(hijri)  # HijriDate(1446, 2, 15)
+```
+
+---
+
+## jdatetime Integration
+
+```python
+from hijri_datetime import HijriDate
+
+d = HijriDate(1446, 2, 15)
+jd = d.to_jdatetime()
+print(jd)  # jdatetime.date(2025, 6, 16) example
+```
+
+---
+
+## Pandas / Vectorized Example
+
+```python
+import pandas as pd
+from hijri_datetime import HijriDate
+
+dates = pd.Series([HijriDate(1446, 1, 1), HijriDate(1446, 2, 10)])
+greg_dates = dates.apply(lambda x: x.to_gregorian())
+print(greg_dates)
+```
+
+---
+
+## Roadmap
+
+* [ ] Full `calendar` module API compatibility
+* [ ] Timezone-aware Hijri datetime
+* [ ] Support for Umm al-Qura, tabular, and other Hijri variants
+* [ ] Improved bulk conversion performance
+* [ ] PyPI release with automated dataset update from Aladhan API
+
+---
+
+## Contributing
+
+Pull requests are welcome! Please open an issue first to discuss major changes.
+Could you make sure tests pass before submitting PRs?
+
+---
+
+## License
+
+GNU License © 2025

hijri_datetime-0.0.0.dist-info/RECORD

@@ -0,0 +1,13 @@
+hijri_datetime/__init__.py,sha256=i2SM-vSV4sCVWyVki7bQpsJSEAw-RPLMMEXV3-MCWGM,57
+hijri_datetime/calendar.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hijri_datetime/conversion.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hijri_datetime/date.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hijri_datetime/datetime.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hijri_datetime/hello.py,sha256=PcWMF-H8OoHLsK4OW9QWYyMGnRsPz-hqLh916OLetPo,64
+hijri_datetime/range.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hijri_datetime/utils.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hijri_datetime-0.0.0.dist-info/LICENSE,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hijri_datetime-0.0.0.dist-info/METADATA,sha256=_owOHolrAL8btnyhETm11_91L-iuyOOCuonecoPdlyo,5770
+hijri_datetime-0.0.0.dist-info/WHEEL,sha256=iAkIy5fosb7FzIOwONchHf19Qu7_1wCWyFNR5gu9nU0,91
+hijri_datetime-0.0.0.dist-info/top_level.txt,sha256=3-byeAhSA03hoaPXanoyL76rRo5_FTCD9DIwk81fdck,15
+hijri_datetime-0.0.0.dist-info/RECORD,,

hijri_datetime-0.0.0.dist-info/WHEEL

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

hijri_datetime-0.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+hijri_datetime