{ "info": { "author": "Mohammed Alshehri", "author_email": "", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Programming Language :: Python", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7", "Topic :: Software Development :: Internationalization", "Topic :: Software Development :: Localization", "Topic :: Utilities" ], "description": "Hijri Converter\n===============\n\nA Python package to convert accurately between Hijri and Gregorian dates\nusing the Umm al-Qura calendar of Saudi Arabia.\n\n|travis| |codecov| |docs| |supported| |version| |license|\n\n.. |travis|\n image:: https://img.shields.io/travis/com/dralshehri/hijri-converter.svg\n :alt: Build Status\n :target: https://travis-ci.com/dralshehri/hijri-converter\n.. |codecov|\n image:: https://img.shields.io/codecov/c/github/dralshehri/hijri-converter.svg\n :alt: Coverage Status\n :target: https://codecov.io/github/dralshehri/hijri-converter\n.. |docs|\n image:: https://img.shields.io/readthedocs/hijri-converter/stable.svg\n :alt: Docs Status\n :target: https://hijri-converter.readthedocs.io/\n.. |supported|\n image:: https://img.shields.io/pypi/pyversions/hijri-converter.svg\n :alt: Python version support\n :target: https://pypi.python.org/pypi/hijri-converter\n.. |version|\n image:: https://img.shields.io/pypi/v/hijri-converter.svg\n :alt: PyPI Package version\n :target: https://pypi.python.org/pypi/hijri-converter\n.. |license|\n image:: https://img.shields.io/github/license/dralshehri/hijri-converter.svg\n :alt: License\n :target: https://github.com/dralshehri/hijri-converter/blob/master/LICENSE\n\nFeatures\n--------\n\n- Accurate and tested conversion.\n- Optimized code performance compared to similar packages.\n- Intuitive, clean, and easy-to-use interface.\n- Most of methods and formats are similar to those of standard library.\n- Multilingual representation of weekday names, months, and calendar notations.\n- Easily extendable to support other natural languages.\n- Rich comparison between dates.\n- Validation of input dates.\n- Works on Python 3.6+ with zero dependencies.\n- Thoroughly tested on all supported python versions.\n\nInstallation\n------------\n\n.. code-block:: bash\n\n $ pip install -U hijri-converter\n\nBasic Usage\n-----------\n\n.. code-block:: python\n\n from hijri_converter import convert\n\n g = convert.Hijri(1403, 2, 17).to_gregorian()\n print(g)\n # 1982-12-02\n\n h = convert.Gregorian(1982, 12, 2).to_hijri()\n print(h)\n # 1403-02-17\n\nOnline Tool\n-----------\n\nThe following is a simple online conversion tool that was developed to convert\nbetween Hijri and Gregorian dates using the latest version of *Hijri Converter*\npackage:\n\nhttps://www.dralshehri.com/hijri-converter/\n\nDocumentation\n-------------\n\nPlease see https://hijri-converter.readthedocs.io/ for full documentation of\nthis package, including overview, benchmarking, usage examples and API\nreference.\n\nContributing\n------------\n\nContributions are welcome! See\n`CONTRIBUTING.rst `__\nfor more info.\n\nAuthors\n-------\n\nThe main author is Mohammed Alshehri \u2014\n`@dralshehri `__.\n\nAcknowledgment\n--------------\n\nThanks to `R.H. van Gent `__\nfor inspiration and help.\n\nLicense\n-------\n\nThis package is distributed under an MIT license.\nSee `LICENSE `__.\n\nChange Log\n----------\n\n**2.1.0**\n\nThis version has more accurate conversion and better internal code.\nDetails are as follows:\n\n- Dropped support for the years before 1343 AH because the Umm al-Qura calendar\n was not established then.\n- Added ``validate`` parameter to Hijri object for optional disabling of\n Hijri date validation and improving performance.\n- Verified conversion against original references and updated the\n ``month_starts`` tuple for more accurate conversion.\n- Improved ``Hijri`` object rich comparison methods.\n- Improved date validation methods for better performance and readability.\n- Made the ``Hijri`` object hashable by adding a custom ``__hash__`` method.\n- Refactored many internal methods (not affecting the API).\n- Other minor fixes, enhancements and performance boost.\n\n**2.0.0**\n\nIn short, this version supports only lunar Hijri calendar on Python 3.6+, and\nthe conversion is in complete agreement with the official Umm al-Qura calendar.\nDetails are as follows:\n\n- Renamed the package to ``hijri-converter``.\n- Dropped support for the solar Hijri calendar.\n- Dropped support for Python 3.5.\n- Refactored localization and ``ummalqura.py`` module.\n- Updated ``month_starts`` tuple in alignment with the Umm al-Qura calendar.\n- Added ``fromdate()`` classmethod to ``Gregorian`` object.\n- Added ``notation()`` method to ``Hijri`` and ``Gregorian`` objects.\n- Added more methods to ``Gregorian`` object including ``slashformat()``,\n ``month_name()``, ``day_name()`` and ``to_julian()``.\n- Renamed ``month_days()`` method of ``Hijri`` object to ``month_length()``.\n- Changed formatted string to use f-strings.\n- Improved documentation and examples.\n- Updated unit tests.\n- Fixed other minor issues and typos.\n\n**1.5.0**\n\n- Added ``fromisoformat()`` classmethod to ``Hijri`` object.\n- Added support for rich comparison between Hijri dates.\n- Updated documentation and testing code.\n- Other minor fixes and enhancements.\n\n**1.4.0**\n\n- Refactored conversion methods to improve performance.\n- Changed date validation back to be the default and removed optional parameter.\n- Added ``to_julian()`` method to ``Hijri`` object.\n- Updated documentation and testing code.\n- Other minor fixes and enhancements.\n\n**1.3.3**\n\n- Fixed a bug in range validation for the Gregorian date.\n- Changed generic typing to built-in types.\n- Added more tests to cover the solar calendar.\n- Improved code structure and documentation.\n\n**1.3.2**\n\n- Improved documentation and changelog.\n\n**1.3.1**\n\n- Fixed README file.\n\n**1.3.0**\n\n- Added documentation directory with an online version.\n- Changed date input validation to be optional and disabled by default.\n- Improved code readability and performance.\n- Other minor fixes and enhancements.\n\n**1.2.0**\n\n- Added ``slashformat()`` method to ``Hijri`` object.\n- Improved date validation code.\n- Fixed some typos in documentation and docstrings.\n\n**1.0.1**\n\n- Improved examples and documentation.\n\n**1.0.0**\n\n- First release.\n\n\n", "description_content_type": "text/x-rst", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/dralshehri/hijri-converter", "keywords": "hijri gregorian date converter ummalqura saudi calendar", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "hijri-converter", "package_url": "https://pypi.org/project/hijri-converter/", "platform": "", "project_url": "https://pypi.org/project/hijri-converter/", "project_urls": { "Documentation": "https://hijri-converter.readthedocs.io/", "Homepage": "https://github.com/dralshehri/hijri-converter" }, "release_url": "https://pypi.org/project/hijri-converter/2.1.0/", "requires_dist": null, "requires_python": ">=3.6", "summary": "Accurate Hijri-Gregorian date converter based on the Umm al-Qura calendar", "version": "2.1.0" }, "last_serial": 5456831, "releases": { "2.0.0": [ { "comment_text": "", "digests": { "md5": "433f4e921439e57922730c1eb646f7a2", "sha256": "e3608f5c5eb46e25779b12f5040bd4562978c9c4e6bf46fb1fa67b43807219e2" }, "downloads": -1, "filename": "hijri_converter-2.0.0-py3-none-any.whl", "has_sig": false, "md5_digest": "433f4e921439e57922730c1eb646f7a2", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6", "size": 15060, "upload_time": "2019-06-05T11:57:45", "url": "https://files.pythonhosted.org/packages/3f/ed/51f41ba98471727ce45e593e9061a75f8227f15b52a544bd1e8d682e6df7/hijri_converter-2.0.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "202b78182cbb4d265e1d07bc01a60ee4", "sha256": "e619e905d621efe9250360ca792994dab97bf786ae475209a00aefac39988236" }, "downloads": -1, "filename": "hijri-converter-2.0.0.tar.gz", "has_sig": false, "md5_digest": "202b78182cbb4d265e1d07bc01a60ee4", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6", "size": 16947, "upload_time": "2019-06-05T11:57:47", "url": "https://files.pythonhosted.org/packages/37/bc/ce93cd74c599f3fd176086d2e6364fdcb9022c9d5ba27e6ac0fa3ff7a8cb/hijri-converter-2.0.0.tar.gz" } ], "2.1.0": [ { "comment_text": "", "digests": { "md5": "6114894c440efb9cf1a17cfbdda951cc", "sha256": "8f5d554c178ef295c319f254812a48868025fd892bbbcbc3a5c1262fc656c01e" }, "downloads": -1, "filename": "hijri_converter-2.1.0-py3-none-any.whl", "has_sig": false, "md5_digest": "6114894c440efb9cf1a17cfbdda951cc", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6", "size": 13847, "upload_time": "2019-06-16T18:24:21", "url": "https://files.pythonhosted.org/packages/60/d8/a61e73e5972a65720461434429d5cfd468609051a3d16f68cfa1cb47cbf4/hijri_converter-2.1.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "0f2fdd040cde55b2f61dc9938e0d7e98", "sha256": "7e86b77948a8f3506690ecf54e5cc3ca25792835b7ca59c779dcaa28f4c25308" }, "downloads": -1, "filename": "hijri-converter-2.1.0.tar.gz", "has_sig": false, "md5_digest": "0f2fdd040cde55b2f61dc9938e0d7e98", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6", "size": 15236, "upload_time": "2019-06-16T18:24:23", "url": "https://files.pythonhosted.org/packages/0a/7e/b215028f4f3457053219d298da15637cc5d4775f6e8b4c6fcf01f2ee4625/hijri-converter-2.1.0.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "6114894c440efb9cf1a17cfbdda951cc", "sha256": "8f5d554c178ef295c319f254812a48868025fd892bbbcbc3a5c1262fc656c01e" }, "downloads": -1, "filename": "hijri_converter-2.1.0-py3-none-any.whl", "has_sig": false, "md5_digest": "6114894c440efb9cf1a17cfbdda951cc", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6", "size": 13847, "upload_time": "2019-06-16T18:24:21", "url": "https://files.pythonhosted.org/packages/60/d8/a61e73e5972a65720461434429d5cfd468609051a3d16f68cfa1cb47cbf4/hijri_converter-2.1.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "0f2fdd040cde55b2f61dc9938e0d7e98", "sha256": "7e86b77948a8f3506690ecf54e5cc3ca25792835b7ca59c779dcaa28f4c25308" }, "downloads": -1, "filename": "hijri-converter-2.1.0.tar.gz", "has_sig": false, "md5_digest": "0f2fdd040cde55b2f61dc9938e0d7e98", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6", "size": 15236, "upload_time": "2019-06-16T18:24:23", "url": "https://files.pythonhosted.org/packages/0a/7e/b215028f4f3457053219d298da15637cc5d4775f6e8b4c6fcf01f2ee4625/hijri-converter-2.1.0.tar.gz" } ] }