pyluach
=======
.. image:: https://readthedocs.org/projects/pyluach/badge/?version=stable
:target: http://pyluach.readthedocs.io/en/latest/?badge=stable
:alt: Documentation Status
.. image:: https://github.com/simlist/pyluach/actions/workflows/testing-and-coverage.yml/badge.svg?branch=master
:target: https://github.com/simlist/pyluach/actions/workflows/testing-and-coverage.yml
.. image:: https://coveralls.io/repos/github/simlist/pyluach/badge.svg?branch=master
:target: https://coveralls.io/github/simlist/pyluach?branch=master
Pyluach is a Python package for dealing with Hebrew (Jewish) calendar dates.
Features
---------
* Conversion between Hebrew and Gregorian dates
* Finding the difference between two dates
* Finding a date at a given duration from the given date
* Rich comparisons between dates
* Finding the weekday of a given date
* Finding the weekly Parsha reading of a given date
* Getting the holiday occuring on a given date
* Generating html and text Hebrew calendars
Installation
-------------
Use ``pip install pyluach``.
Documentation
-------------
Documentation for pyluach can be found at https://readthedocs.org/projects/pyluach/.
Examples
------------
::
>>> from pyluach import dates, hebrewcal, parshios
>>> today = dates.HebrewDate.today()
>>> lastweek_gregorian = (today - 7).to_greg()
>>> lastweek_gregorian < today
True
>>> today - lastweek_gregorian
7
>>> greg = dates.GregorianDate(1986, 3, 21)
>>> heb = dates.HebrewDate(5746, 13, 10)
>>> greg == heb
True
>>> purim = dates.HebrewDate(5781, 12, 14)
>>> purim.hebrew_day()
'י״ד'
>>> purim.hebrew_date_string()
'י״ד אדר תשפ״א'
>>> purim.hebrew_date_string(True)
'י״ד אדר ה׳תשפ״א'
>>> rosh_hashana = dates.HebrewDate(5782, 7, 1)
>>> rosh_hashana.holiday()
'Rosh Hashana'
>>> rosh_hashana.holiday(hebrew=True)
'ראש השנה'
>>> (rosh_hashana + 3).holiday()
None
>>> month = hebrewcal.Month(5781, 10)
>>> month.month_name()
'Teves'
>>> month.month_name(True)
'טבת'
>>> month + 3
Month(5781, 1)
>>> for month in hebrewcal.Year(5774).itermonths():
... print(month.month_name())
Tishrei Cheshvan ...
>>> date = dates.GregorianDate(2010, 10, 6)
>>> parshios.getparsha(date)
[0]
>>> parshios.getparsha_string(date, israel=True)
'Beraishis'
>>> parshios.getparsha_string(date, hebrew=True)
'בראשית'
>>> new_date = dates.GregorianDate(2021, 3, 10)
>>> parshios.getparsha_string(new_date)
'Vayakhel, Pekudei'
>>> parshios.getparsha_string(new_date, hebrew=True)
'ויקהל, פקודי'
Contact
--------
For questions and comments please `raise an issue in github
<https://github.com/simlist/pyluach/issues>`_ or contact me at
simlist@gmail.com.
License
--------
Pyluach is licensed under the MIT license.
Raw data
{
"_id": null,
"home_page": null,
"name": "pyluach",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "hebrew,calendar,jewish,luach,gregorian,julian,days,dates,date,conversion,parsha,holiday",
"author": null,
"author_email": "MS List <simlist@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/eb/fc/4567068be2c78ac09339201f4a1adfd9e95f6f873f6f37f6fafb5648363e/pyluach-2.2.0.tar.gz",
"platform": null,
"description": "pyluach\n=======\n.. image:: https://readthedocs.org/projects/pyluach/badge/?version=stable\n :target: http://pyluach.readthedocs.io/en/latest/?badge=stable\n :alt: Documentation Status\n.. image:: https://github.com/simlist/pyluach/actions/workflows/testing-and-coverage.yml/badge.svg?branch=master\n :target: https://github.com/simlist/pyluach/actions/workflows/testing-and-coverage.yml\n.. image:: https://coveralls.io/repos/github/simlist/pyluach/badge.svg?branch=master\n :target: https://coveralls.io/github/simlist/pyluach?branch=master\n\nPyluach is a Python package for dealing with Hebrew (Jewish) calendar dates.\n\nFeatures\n---------\n* Conversion between Hebrew and Gregorian dates\n* Finding the difference between two dates\n* Finding a date at a given duration from the given date\n* Rich comparisons between dates\n* Finding the weekday of a given date\n* Finding the weekly Parsha reading of a given date\n* Getting the holiday occuring on a given date\n* Generating html and text Hebrew calendars\n\nInstallation\n-------------\nUse ``pip install pyluach``.\n\nDocumentation\n-------------\nDocumentation for pyluach can be found at https://readthedocs.org/projects/pyluach/.\n\nExamples\n------------\n::\n\n >>> from pyluach import dates, hebrewcal, parshios\n\n >>> today = dates.HebrewDate.today()\n >>> lastweek_gregorian = (today - 7).to_greg()\n >>> lastweek_gregorian < today\n\tTrue\n >>> today - lastweek_gregorian\n 7\n >>> greg = dates.GregorianDate(1986, 3, 21)\n >>> heb = dates.HebrewDate(5746, 13, 10)\n >>> greg == heb\n True\n\n >>> purim = dates.HebrewDate(5781, 12, 14)\n >>> purim.hebrew_day()\n '\u05d9\u05f4\u05d3'\n >>> purim.hebrew_date_string()\n '\u05d9\u05f4\u05d3 \u05d0\u05d3\u05e8 \u05ea\u05e9\u05e4\u05f4\u05d0'\n >>> purim.hebrew_date_string(True)\n '\u05d9\u05f4\u05d3 \u05d0\u05d3\u05e8 \u05d4\u05f3\u05ea\u05e9\u05e4\u05f4\u05d0'\n\n >>> rosh_hashana = dates.HebrewDate(5782, 7, 1)\n >>> rosh_hashana.holiday()\n 'Rosh Hashana'\n >>> rosh_hashana.holiday(hebrew=True)\n '\u05e8\u05d0\u05e9 \u05d4\u05e9\u05e0\u05d4'\n >>> (rosh_hashana + 3).holiday()\n None\n\n >>> month = hebrewcal.Month(5781, 10)\n >>> month.month_name()\n 'Teves'\n >>> month.month_name(True)\n '\u05d8\u05d1\u05ea'\n >>> month + 3\n Month(5781, 1)\n >>> for month in hebrewcal.Year(5774).itermonths():\n ... print(month.month_name())\n Tishrei Cheshvan ...\n\n >>> date = dates.GregorianDate(2010, 10, 6)\n >>> parshios.getparsha(date)\n [0]\n >>> parshios.getparsha_string(date, israel=True)\n 'Beraishis'\n >>> parshios.getparsha_string(date, hebrew=True)\n '\u05d1\u05e8\u05d0\u05e9\u05d9\u05ea'\n >>> new_date = dates.GregorianDate(2021, 3, 10)\n >>> parshios.getparsha_string(new_date)\n 'Vayakhel, Pekudei'\n >>> parshios.getparsha_string(new_date, hebrew=True)\n '\u05d5\u05d9\u05e7\u05d4\u05dc, \u05e4\u05e7\u05d5\u05d3\u05d9'\n\nContact\n--------\nFor questions and comments please `raise an issue in github\n<https://github.com/simlist/pyluach/issues>`_ or contact me at\nsimlist@gmail.com.\n\nLicense\n--------\nPyluach is licensed under the MIT license.",
"bugtrack_url": null,
"license": null,
"summary": "A Python package for dealing with Hebrew (Jewish) calendar dates.",
"version": "2.2.0",
"project_urls": {
"Documentation": "https://readthedocs.org/projects/pyluach/",
"Source": "https://github.com/simlist/pyluach"
},
"split_keywords": [
"hebrew",
"calendar",
"jewish",
"luach",
"gregorian",
"julian",
"days",
"dates",
"date",
"conversion",
"parsha",
"holiday"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "4f832e585d06d49e0320050b3d7d8ae0dfbd1459e976ff9f4b4d8bcca983d474",
"md5": "e2b1ce0dcbd263a645b98deec26e0225",
"sha256": "d1eb49d6292087e9290f4661ae01b60c8c933704ec8c9cef82673b349ff96adf"
},
"downloads": -1,
"filename": "pyluach-2.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e2b1ce0dcbd263a645b98deec26e0225",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 25037,
"upload_time": "2023-03-01T02:47:55",
"upload_time_iso_8601": "2023-03-01T02:47:55.882470Z",
"url": "https://files.pythonhosted.org/packages/4f/83/2e585d06d49e0320050b3d7d8ae0dfbd1459e976ff9f4b4d8bcca983d474/pyluach-2.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "ebfc4567068be2c78ac09339201f4a1adfd9e95f6f873f6f37f6fafb5648363e",
"md5": "769f1b1986fcd8dde090af903079457f",
"sha256": "9063a25387cd7624276fd0656508bada08aa8a6f22e8db352844cd858e69012b"
},
"downloads": -1,
"filename": "pyluach-2.2.0.tar.gz",
"has_sig": false,
"md5_digest": "769f1b1986fcd8dde090af903079457f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 26198,
"upload_time": "2023-03-01T02:48:07",
"upload_time_iso_8601": "2023-03-01T02:48:07.047446Z",
"url": "https://files.pythonhosted.org/packages/eb/fc/4567068be2c78ac09339201f4a1adfd9e95f6f873f6f37f6fafb5648363e/pyluach-2.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-03-01 02:48:07",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "simlist",
"github_project": "pyluach",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "alabaster",
"specs": [
[
"==",
"0.7.13"
]
]
},
{
"name": "attrs",
"specs": [
[
"==",
"22.2.0"
]
]
},
{
"name": "Babel",
"specs": [
[
"==",
"2.11.0"
]
]
},
{
"name": "beautifulsoup4",
"specs": [
[
"==",
"4.11.2"
]
]
},
{
"name": "certifi",
"specs": [
[
"==",
"2022.12.7"
]
]
},
{
"name": "charset-normalizer",
"specs": [
[
"==",
"3.0.1"
]
]
},
{
"name": "coverage",
"specs": [
[
"==",
"7.1.0"
]
]
},
{
"name": "docutils",
"specs": [
[
"==",
"0.19"
]
]
},
{
"name": "exceptiongroup",
"specs": [
[
"==",
"1.1.0"
]
]
},
{
"name": "flake8",
"specs": [
[
"==",
"6.0.0"
]
]
},
{
"name": "flit",
"specs": [
[
"==",
"3.8.0"
]
]
},
{
"name": "flit-core",
"specs": [
[
"==",
"3.8.0"
]
]
},
{
"name": "idna",
"specs": [
[
"==",
"3.4"
]
]
},
{
"name": "imagesize",
"specs": [
[
"==",
"1.4.1"
]
]
},
{
"name": "importlib-metadata",
"specs": [
[
"==",
"6.0.0"
]
]
},
{
"name": "iniconfig",
"specs": [
[
"==",
"2.0.0"
]
]
},
{
"name": "Jinja2",
"specs": [
[
"==",
"3.1.2"
]
]
},
{
"name": "MarkupSafe",
"specs": [
[
"==",
"2.1.2"
]
]
},
{
"name": "mccabe",
"specs": [
[
"==",
"0.7.0"
]
]
},
{
"name": "packaging",
"specs": [
[
"==",
"23.0"
]
]
},
{
"name": "pluggy",
"specs": [
[
"==",
"1.0.0"
]
]
},
{
"name": "pycodestyle",
"specs": [
[
"==",
"2.10.0"
]
]
},
{
"name": "pyflakes",
"specs": [
[
"==",
"3.0.1"
]
]
},
{
"name": "Pygments",
"specs": [
[
"==",
"2.14.0"
]
]
},
{
"name": "pyluach",
"specs": [
[
"==",
"2.1.0"
]
]
},
{
"name": "pytest",
"specs": [
[
"==",
"7.2.1"
]
]
},
{
"name": "pytest-cov",
"specs": [
[
"==",
"4.0.0"
]
]
},
{
"name": "pytz",
"specs": [
[
"==",
"2022.7.1"
]
]
},
{
"name": "requests",
"specs": [
[
"==",
"2.28.2"
]
]
},
{
"name": "snowballstemmer",
"specs": [
[
"==",
"2.2.0"
]
]
},
{
"name": "soupsieve",
"specs": [
[
"==",
"2.3.2.post1"
]
]
},
{
"name": "sphinx",
"specs": [
[
"==",
"6.1.3"
]
]
},
{
"name": "sphinx-rtd-theme",
"specs": [
[
"==",
"1.2.0"
]
]
},
{
"name": "sphinxcontrib-applehelp",
"specs": [
[
"==",
"1.0.4"
]
]
},
{
"name": "sphinxcontrib-devhelp",
"specs": [
[
"==",
"1.0.2"
]
]
},
{
"name": "sphinxcontrib-htmlhelp",
"specs": [
[
"==",
"2.0.1"
]
]
},
{
"name": "sphinxcontrib-jquery",
"specs": [
[
"==",
"2.0.0"
]
]
},
{
"name": "sphinxcontrib-jsmath",
"specs": [
[
"==",
"1.0.1"
]
]
},
{
"name": "sphinxcontrib-qthelp",
"specs": [
[
"==",
"1.0.3"
]
]
},
{
"name": "sphinxcontrib-serializinghtml",
"specs": [
[
"==",
"1.1.5"
]
]
},
{
"name": "tomli",
"specs": [
[
"==",
"2.0.1"
]
]
},
{
"name": "tomli-w",
"specs": [
[
"==",
"1.0.0"
]
]
},
{
"name": "urllib3",
"specs": [
[
"==",
"1.26.14"
]
]
},
{
"name": "zipp",
"specs": [
[
"==",
"3.13.0"
]
]
}
],
"lcname": "pyluach"
}
JSON
