hijri-datetime 0.1.1__tar.gz → 0.2.3.post0__tar.gz

hijri_datetime-0.2.3.post0/.github/workflows/release.yml

@@ -0,0 +1,45 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*.*.*'  # Matches tags like v1.2.3
+
+jobs:
+  release:
+    name: Build and Release
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.10'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install setuptools wheel twine
+
+      - run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          user: m_lotfi
+          password: ${{ secrets.PYPI_API_TOKEN }}
+
+      - name: Build package
+        run: |
+          python setup.py sdist bdist_wheel
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          generate_release_notes: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+

hijri_datetime-0.2.3.post0/.gitignore

@@ -0,0 +1,207 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+#poetry.toml
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
+#   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
+#pdm.lock
+#pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
+#pixi.lock
+#   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
+#   in the .venv directory. It is recommended not to include this directory in version control.
+.pixi
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# Abstra
+# Abstra is an AI-powered process automation framework.
+# Ignore directories containing user credentials, local state, and settings.
+# Learn more at https://abstra.io/docs
+.abstra/
+
+# Visual Studio Code
+#  Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
+#  that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#  and can be added to the global gitignore or merged into this file. However, if you prefer, 
+#  you could uncomment the following to ignore the entire vscode folder
+# .vscode/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Cursor
+#  Cursor is an AI-powered code editor. `.cursorignore` specifies files/directories to
+#  exclude from AI features like autocomplete and code analysis. Recommended for sensitive data
+#  refer to https://docs.cursor.com/context/ignore-files
+.cursorignore
+.cursorindexingignore
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/

hijri_datetime-0.2.3.post0/MANIFEST.in

@@ -0,0 +1,8 @@
+include README.md
+include CHANGELOG.md  
+include LICENSE
+include pyproject.toml
+recursive-include src *.py
+recursive-include tests *.py
+recursive-exclude * __pycache__
+recursive-exclude * *.py[co]

{hijri_datetime-0.1.1/src/hijri_datetime.egg-info → hijri_datetime-0.2.3.post0}/PKG-INFO

@@ -1,13 +1,23 @@
 Metadata-Version: 2.1
 Name: hijri-datetime
-Version: 0.1.1
+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,14 +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: 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: test
+Requires-Dist: pytest>=6.0; extra == "test"
+Requires-Dist: pytest-cov>=2.0; extra == "test"
+Requires-Dist: pytest-mock>=3.0; extra == "test"
+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: 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"
 
 # 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`.
 

{hijri_datetime-0.1.1 → hijri_datetime-0.2.3.post0}/README.md

@@ -1,5 +1,7 @@
 # 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`.
 

hijri_datetime-0.2.3.post0/clean_build_dirs.py

@@ -0,0 +1,76 @@
+import os
+import shutil
+
+def remove_egg_info_recursively(root="."):
+    """
+    Recursively remove all directories ending with `.egg-info` starting from `root`.
+    """
+    for dirpath, dirnames, _ in os.walk(root):
+        # Make a copy of dirnames because we may modify it while iterating
+        for dirname in dirnames[:]:
+            if dirname.endswith(".egg-info"):
+                full_path = os.path.join(dirpath, dirname)
+                print(f"Removing {full_path}/ ...")
+                shutil.rmtree(full_path)
+                # remove from dirnames so os.walk doesn't descend into it
+                dirnames.remove(dirname)
+
+
+def clean_build_dirs():
+    """
+    Remove build artifact directories if they exist:
+    - dist/
+    - any *.egg-info directory
+    """
+    # Always check 'dist'
+    if os.path.exists("dist"):
+        print("Removing dist/ ...")
+        shutil.rmtree("dist")
+    else:
+        print("dist/ not found, skipping.")
+
+    remove_egg_info_recursively()
+
+
+if __name__ == "__main__":
+    clean_build_dirs()
+
+
+'''
+# python -m build
+
+# twine upload --repository testpypi dist/*
+
+
+# Make a small commit (even just updating a comment)
+git add .
+git config --global --add safe.directory E:/GitHub/hijri-datetime
+git add .
+git commit -m "Bump version for new release"
+
+# Rebuild - this will create a version like 0.0.1.dev1+g1234567
+python -m build
+
+git tag v0.2.0
+git push origin v0.2.0
+python -m build
+twine upload dist/*
+
+# 5. Install development dependencies
+pip install -e ".[dev]"
+
+# 6. Set up pre-commit hooks
+pre-commit install
+
+# 7. Run initial tests
+pytest
+
+# 8. Build the package
+python -m build
+
+# 9. Check the package
+twine check dist/*
+
+
+
+'''

hijri_datetime-0.2.3.post0/pyproject.toml

@@ -0,0 +1,230 @@
+# -----------------------------
+# Build System (required)
+# -----------------------------
+[build-system]
+requires = ["setuptools>=45", "wheel", "setuptools_scm[toml]>=6.2"]
+build-backend = "setuptools.build_meta"
+
+# -----------------------------
+# Project Metadata
+# -----------------------------
+[project]
+name = "hijri-datetime"
+dynamic = ["version"]
+requires-python = ">=3.8"
+authors = [
+    { name = "m.lotfi", email = "m.lotfi@email.com" },
+]
+maintainers = [
+    { name = "m.lotfi", email = "m.lotfi@email.com" },
+]
+description = "Pythonic Hijri datetime — handle full & partial dates, ranges, and seamless Gregorian & Jalali conversion."
+readme = { file = "README.md", content-type = "text/markdown" }
+license = { text = "GPL version 3" }
+
+keywords = [
+    "python", "package", "modules", "portable",
+    "hijri", "islamic", "calendar", "datetime",
+    "gregorian", "jalali", "conversion"
+]
+
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)",
+    "Intended Audience :: Developers",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Operating System :: OS Independent",
+    "Topic :: Scientific/Engineering :: Information Analysis",
+    "Topic :: Software Development :: Internationalization",
+    "Topic :: Utilities",
+]
+
+# -----------------------------
+# Runtime dependencies
+# -----------------------------
+dependencies = [
+    "jdatetime>=3.0.0",
+    "requests>=2.20.0",
+    "numpy>=1.18.0",
+    "pandas>=1.0.0"
+]
+
+# -----------------------------
+# Optional dependencies
+# -----------------------------
+[project.optional-dependencies]
+dev = [
+    "pytest>=6.0",
+    "pytest-cov>=2.0",
+    "black>=22.0",
+    "flake8>=4.0",
+    "mypy>=0.900",
+    "pre-commit>=2.0",
+    "tox>=3.0",
+    "build>=0.10",
+    "twine>=4.0",
+    "setuptools_scm>=6.2",
+    "setuptools>=45",
+    "wheel",
+    "sphinx>=4.0",
+    "sphinx-rtd-theme>=1.0",
+]
+
+test = [
+    "pytest>=6.0",
+    "pytest-cov>=2.0",
+    "pytest-mock>=3.0",
+]
+
+docs = [
+    "sphinx>=4.0",
+    "sphinx-rtd-theme>=1.0",
+    "myst-parser>=0.17.0",
+]
+
+lint = [
+    "black>=22.0",
+    "flake8>=4.0",
+    "mypy>=0.900",
+    "isort>=5.0",
+]
+
+all = [
+    "pytest>=6.0",
+    "pytest-cov>=2.0",
+    "pytest-mock>=3.0",
+    "black>=22.0",
+    "flake8>=4.0",
+    "mypy>=0.900",
+    "isort>=5.0",
+    "pre-commit>=2.0",
+    "tox>=3.0",
+    "build>=0.10",
+    "twine>=4.0",
+    "setuptools_scm>=6.2",
+    "setuptools>=45",
+    "wheel",
+    "sphinx>=4.0",
+    "sphinx-rtd-theme>=1.0",
+    "myst-parser>=0.17.0",
+]
+
+# -----------------------------
+# Project URLs
+# -----------------------------
+[project.urls]
+Homepage = "https://github.com/mlotfic/hijri-datetime"
+Documentation = "https://github.com/mlotfic/hijri-datetime#readme"
+Repository = "https://github.com/mlotfic/hijri-datetime.git"
+"Bug Tracker" = "https://github.com/mlotfic/hijri-datetime/issues"
+Changelog = "https://github.com/mlotfic/hijri-datetime/blob/main/CHANGELOG.md"
+"Source Code" = "https://github.com/mlotfic/hijri-datetime"
+"Download" = "https://pypi.org/project/hijri-datetime/"
+
+# -----------------------------
+# setuptools configuration
+# -----------------------------
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["hijri_datetime*"]
+exclude = ["tests*"]
+
+# -----------------------------
+# setuptools_scm configuration
+# -----------------------------
+[tool.setuptools_scm]
+write_to = "src/hijri_datetime/_version.py"
+version_scheme = "post-release"
+local_scheme = "no-local-version"
+
+# -----------------------------
+# Tool configurations
+# -----------------------------
+
+[tool.black]
+line-length = 88
+target-version = ['py38']
+include = '\.pyi?$'
+extend-exclude = '''
+/(
+  \.eggs
+  | \.git
+  | \.hg
+  | \.mypy_cache
+  | \.tox
+  | \.venv
+  | build
+  | dist
+)/
+'''
+
+[tool.isort]
+profile = "black"
+multi_line_output = 3
+line_length = 88
+known_first_party = ["hijri_datetime"]
+
+[tool.pytest.ini_options]
+minversion = "6.0"
+addopts = [
+    "-ra",
+    "--strict-markers",
+    "--strict-config",
+    "--cov=hijri_datetime",
+    "--cov-report=term-missing",
+    "--cov-report=html",
+    "--cov-report=xml",
+]
+testpaths = ["tests"]
+python_files = ["test_*.py", "*_test.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+
+[tool.coverage.run]
+source = ["src"]
+branch = true
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "def __repr__",
+    "if self.debug:",
+    "if settings.DEBUG",
+    "raise AssertionError",
+    "raise NotImplementedError",
+    "if 0:",
+    "if __name__ == .__main__.:",
+    "class .*\bProtocol\\):",
+    "@(abc\\.)?abstractmethod",
+]
+
+[tool.mypy]
+python_version = "3.8"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+disallow_incomplete_defs = true
+check_untyped_defs = true
+disallow_untyped_decorators = true
+no_implicit_optional = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+warn_no_return = true
+warn_unreachable = true
+strict_equality = true
+show_error_codes = true
+
+[[tool.mypy.overrides]]
+module = [
+    "jdatetime.*",
+    "numpy.*",
+    "pandas.*",
+]
+ignore_missing_imports = true

hijri_datetime-0.2.3.post0/src/hijri_datetime/__init__.py

@@ -0,0 +1,97 @@
+"""
+hijri-datetime: Pythonic Hijri datetime operations.
+
+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-0.2.3.post0/src/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 = 'ga003af89c'

hijri_datetime-0.2.3.post0/src/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-0.2.3.post0/src/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-0.2.3.post0/src/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.1 → hijri_datetime-0.2.3.post0/src/hijri_datetime.egg-info}/PKG-INFO

@@ -1,13 +1,23 @@
 Metadata-Version: 2.1
 Name: hijri-datetime
-Version: 0.1.1
+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,14 +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: 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: test
+Requires-Dist: pytest>=6.0; extra == "test"
+Requires-Dist: pytest-cov>=2.0; extra == "test"
+Requires-Dist: pytest-mock>=3.0; extra == "test"
+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: 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"
 
 # 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`.
 

{hijri_datetime-0.1.1 → hijri_datetime-0.2.3.post0}/src/hijri_datetime.egg-info/SOURCES.txt

@@ -1,16 +1,26 @@
+.gitignore
+CHANGELOG.md
 LICENSE
+MANIFEST.in
 README.md
+clean_build_dirs.py
 pyproject.toml
+.github/workflows/release.yml
 src/hijri_datetime/__init__.py
+src/hijri_datetime/_version.py
 src/hijri_datetime/calendar.py
+src/hijri_datetime/constants.py
 src/hijri_datetime/conversion.py
 src/hijri_datetime/date.py
 src/hijri_datetime/datetime.py
+src/hijri_datetime/exceptions.py
 src/hijri_datetime/hello.py
 src/hijri_datetime/range.py
+src/hijri_datetime/time.py
 src/hijri_datetime/utils.py
 src/hijri_datetime.egg-info/PKG-INFO
 src/hijri_datetime.egg-info/SOURCES.txt
 src/hijri_datetime.egg-info/dependency_links.txt
+src/hijri_datetime.egg-info/requires.txt
 src/hijri_datetime.egg-info/top_level.txt
-tests/test_hello.py
+tests/conftest.py

hijri_datetime-0.2.3.post0/src/hijri_datetime.egg-info/requires.txt

@@ -0,0 +1,55 @@
+jdatetime>=3.0.0
+requests>=2.20.0
+numpy>=1.18.0
+pandas>=1.0.0
+
+[all]
+pytest>=6.0
+pytest-cov>=2.0
+pytest-mock>=3.0
+black>=22.0
+flake8>=4.0
+mypy>=0.900
+isort>=5.0
+pre-commit>=2.0
+tox>=3.0
+build>=0.10
+twine>=4.0
+setuptools_scm>=6.2
+setuptools>=45
+wheel
+sphinx>=4.0
+sphinx-rtd-theme>=1.0
+myst-parser>=0.17.0
+
+[dev]
+pytest>=6.0
+pytest-cov>=2.0
+black>=22.0
+flake8>=4.0
+mypy>=0.900
+pre-commit>=2.0
+tox>=3.0
+build>=0.10
+twine>=4.0
+setuptools_scm>=6.2
+setuptools>=45
+wheel
+sphinx>=4.0
+sphinx-rtd-theme>=1.0
+
+[docs]
+sphinx>=4.0
+sphinx-rtd-theme>=1.0
+myst-parser>=0.17.0
+
+[lint]
+black>=22.0
+flake8>=4.0
+mypy>=0.900
+isort>=5.0
+
+[test]
+pytest>=6.0
+pytest-cov>=2.0
+pytest-mock>=3.0

hijri_datetime-0.2.3.post0/tests/conftest.py

@@ -0,0 +1,23 @@
+"""Pytest configuration and fixtures."""
+
+import pytest
+from datetime import date
+from hijri_datetime import HijriDate, HijriDateTime
+
+
+@pytest.fixture
+def sample_hijri_date():
+    """Sample Hijri date for testing."""
+    return HijriDate(1445, 5, 15)
+
+
+@pytest.fixture
+def sample_hijri_datetime():
+    """Sample Hijri datetime for testing."""
+    return HijriDateTime(1445, 5, 15, 14, 30, 0)
+
+
+@pytest.fixture
+def sample_gregorian_date():
+    """Sample Gregorian date for testing."""
+    return date(2023, 11, 28)

hijri_datetime-0.1.1/pyproject.toml

@@ -1,45 +0,0 @@
-# -----------------------------
-# Build System (required)
-# -----------------------------
-[build-system]
-requires = ["setuptools<77", "wheel", "setuptools_scm[toml]>=6.2"]
-build-backend = "setuptools.build_meta"
-
-[project]
-name = "hijri-datetime"
-version = "0.1.1"
-license = { text = "MIT" }  # old-style, accepted
-classifiers = [
-    "License :: OSI Approved :: MIT License",
-    "Development Status :: 3 - Alpha",
-    "Intended Audience :: Developers",
-    "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.8",
-    "Programming Language :: Python :: 3.9",
-    "Programming Language :: Python :: 3.10",
-    "Programming Language :: Python :: 3.11",
-    "Programming Language :: Python :: 3.12",
-    "Operating System :: OS Independent",
-    "Topic :: Software Development :: Libraries",
-    "Topic :: Software Development :: Libraries :: Python Modules",
-]
-
-authors = [
-    { name = "m.lotfi", email = "m.lotfi@email.com" },
-]
-maintainers = [
-    { name = "m.lotfi", email = "m.lotfi@email.com" },
-]
-
-keywords = [
-    "python", "package", "modules", "portable",
-    "hijri", "islamic", "calendar", "datetime"
-]
-readme = { file = "README.md", content-type = "text/markdown" }
-requires-python = ">=3.8"
-
-
-    
-
-[tool.setuptools.packages.find]
-where = ["src"]

hijri_datetime-0.1.1/src/hijri_datetime/__init__.py

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

hijri_datetime-0.1.1/tests/test_hello.py

@@ -1,4 +0,0 @@
-from hijri_datetime import say_hello
-
-def test_say_hello():
-    assert say_hello("World") == "Hello, World!"