Name | liturgical-calendar JSON |
Version |
0.4.0
JSON |
| download |
home_page | None |
Summary | Library to determine liturgical dates and colours for the Anglican Church of England |
upload_time | 2024-04-29 15:38:37 |
maintainer | None |
docs_url | None |
author | Jonathan Gazeley |
requires_python | <4.0,>=3.11 |
license | None |
keywords |
|
VCS |
|
bugtrack_url |
|
requirements |
No requirements were recorded.
|
Travis-CI |
No Travis.
|
coveralls test coverage |
No coveralls.
|
# Liturgical Calendar
This Python module will return the name, season, week number and liturgical
colour for any day in the Gregorian calendar, according to the Anglican
tradition of the Church of England.
This module's algorithm is a direct port to Python of
[`DateTime::Calendar::Liturgical::Christian`](https://github.com/gitpan/DateTime-Calendar-Liturgical-Christian),
which was originally written in Perl and loaded with the calendar of the Episcopal
Church of the USA. It has now been fed with data from the Church of England's
[Calendar of saints](https://en.wikipedia.org/wiki/Calendar_of_saints_(Church_of_England))
and substantially modified to suit the Anglican calendar.
The output of this module is compared against the
[Church of England Lectionary](https://www.chpublishing.co.uk/features/lectionary),
which is taken to be the canonical source.
## Background
Some churches use a special church calendar. Days and seasons within the year
may be either "fasts" (solemn times) or "feasts" (joyful times). The year is
structured around the greatest feast in the calendar, the festival of the
Resurrection of Jesus, known as Easter, and the second greatest feast, the
festival of the Nativity of Jesus, known as Christmas. Before Christmas and
Easter there are solemn fast seasons known as Advent and Lent respectively.
After Christmas comes the feast of Epiphany, and after Easter comes the feast
of Pentecost. These days have the adjacent seasons named after them.
The church's new year falls on Advent Sunday, which occurs around the start of
December. Then follows the four-week fast season of Advent, then comes the
Christmas season, which lasts twelve days; then comes Epiphany, then the
forty days of Lent. Then comes Easter, then the long season of Pentecost
(which some churches call Trinity, after the feast which falls soon after
Pentecost). Then the next year begins and we return to Advent again.
Along with all these, the church remembers the women and men who have made
a positive difference in church history by designating feast days for them,
usually on the anniversary of their death. For example, we remember St. Andrew
on the 30th day of November in the Western churches. Every Sunday is the feast
day of Jesus, and if it has no other name is numbered according to the
season in which it falls. So, for example, the third Sunday in Pentecost
season would be called Pentecost 3.
Seasons are traditionally assigned colours, which are used for clothing and
other materials. The major feasts are coloured white or gold. Fasts are
purple. Feasts for martyrs (people who died for their faith) are red.
Other days are green.
## Installation
```console
pip install liturgical-calendar
```
## Usage, as a command
Once installed, this can be run at the command line. Currently it prints
an object with various attributes. This portion of the module needs
improvement, although it is probably more useful as a library.
Specify the date in YYYY-MM-DD format, or leave blank to return info
for today.
```console
# Get info for today
$ liturgical_calendar
name :
prec : 1
season : Advent
weekno : 4
date : 2023-12-21
colour : purple
colourcode : #ad099a
# Get info for an arbitrary date
$ liturgical_calendar 2023-01-25
name : The Conversion of Paul
url : https://en.wikipedia.org/wiki/Conversion_of_Paul
prec : 7
type : Festival
season : Epiphany
weekno : 3
date : 2023-01-25
colour : white
colourcode : #ffffff
```
## Usage, as a library
```py
# Get info for today
dayinfo = liturgical_calendar()
# Get info for an arbitrary date
# Date can be expressed as a string in YYYY-MM-DD format, a Datetime object, or a Date object
dayinfo = liturgical_calendar('YYYY-MM-DD')
# Access the attributes individually
print(dayinfo['colour'])
```
## Issues
If you find bugs (either in the code or in the calendar), please
[create an issue on GitHub](https://github.com/liturgical-app/calendar/issues).
Pull requests are always welcome, either to address bugs or add new features.
## Example
There is a sample app which uses this library called
[Liturgical Colour App](https://github.com/djjudas21/liturgical-colour-app).
Raw data
{
"_id": null,
"home_page": null,
"name": "liturgical-calendar",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.11",
"maintainer_email": null,
"keywords": null,
"author": "Jonathan Gazeley",
"author_email": "me@jonathangazeley.com",
"download_url": "https://files.pythonhosted.org/packages/6f/4d/51a6269e10116d677e21ed691eff0481f2ed1e0321f3fbec6051f229285f/liturgical_calendar-0.4.0.tar.gz",
"platform": null,
"description": "# Liturgical Calendar\n\nThis Python module will return the name, season, week number and liturgical\ncolour for any day in the Gregorian calendar, according to the Anglican\ntradition of the Church of England.\n\nThis module's algorithm is a direct port to Python of\n[`DateTime::Calendar::Liturgical::Christian`](https://github.com/gitpan/DateTime-Calendar-Liturgical-Christian),\nwhich was originally written in Perl and loaded with the calendar of the Episcopal\nChurch of the USA. It has now been fed with data from the Church of England's\n[Calendar of saints](https://en.wikipedia.org/wiki/Calendar_of_saints_(Church_of_England))\nand substantially modified to suit the Anglican calendar.\n\nThe output of this module is compared against the\n[Church of England Lectionary](https://www.chpublishing.co.uk/features/lectionary),\nwhich is taken to be the canonical source.\n\n## Background\n\nSome churches use a special church calendar. Days and seasons within the year\nmay be either \"fasts\" (solemn times) or \"feasts\" (joyful times). The year is\nstructured around the greatest feast in the calendar, the festival of the\nResurrection of Jesus, known as Easter, and the second greatest feast, the\nfestival of the Nativity of Jesus, known as Christmas. Before Christmas and\nEaster there are solemn fast seasons known as Advent and Lent respectively.\nAfter Christmas comes the feast of Epiphany, and after Easter comes the feast\nof Pentecost. These days have the adjacent seasons named after them.\n\nThe church's new year falls on Advent Sunday, which occurs around the start of\nDecember. Then follows the four-week fast season of Advent, then comes the\nChristmas season, which lasts twelve days; then comes Epiphany, then the\nforty days of Lent. Then comes Easter, then the long season of Pentecost\n(which some churches call Trinity, after the feast which falls soon after\nPentecost). Then the next year begins and we return to Advent again.\n\nAlong with all these, the church remembers the women and men who have made\na positive difference in church history by designating feast days for them,\nusually on the anniversary of their death. For example, we remember St. Andrew\non the 30th day of November in the Western churches. Every Sunday is the feast\nday of Jesus, and if it has no other name is numbered according to the\nseason in which it falls. So, for example, the third Sunday in Pentecost\nseason would be called Pentecost 3.\n\nSeasons are traditionally assigned colours, which are used for clothing and\nother materials. The major feasts are coloured white or gold. Fasts are\npurple. Feasts for martyrs (people who died for their faith) are red.\nOther days are green.\n\n## Installation\n\n```console\npip install liturgical-calendar\n```\n\n## Usage, as a command\n\nOnce installed, this can be run at the command line. Currently it prints\nan object with various attributes. This portion of the module needs\nimprovement, although it is probably more useful as a library.\n\nSpecify the date in YYYY-MM-DD format, or leave blank to return info\nfor today.\n\n```console\n# Get info for today\n$ liturgical_calendar\nname : \nprec : 1\nseason : Advent\nweekno : 4\ndate : 2023-12-21\ncolour : purple\ncolourcode : #ad099a\n\n# Get info for an arbitrary date\n$ liturgical_calendar 2023-01-25\nname : The Conversion of Paul\nurl : https://en.wikipedia.org/wiki/Conversion_of_Paul\nprec : 7\ntype : Festival\nseason : Epiphany\nweekno : 3\ndate : 2023-01-25\ncolour : white\ncolourcode : #ffffff\n```\n\n## Usage, as a library\n\n```py\n# Get info for today\ndayinfo = liturgical_calendar()\n\n# Get info for an arbitrary date\n# Date can be expressed as a string in YYYY-MM-DD format, a Datetime object, or a Date object\ndayinfo = liturgical_calendar('YYYY-MM-DD')\n\n# Access the attributes individually\nprint(dayinfo['colour'])\n```\n\n## Issues\n\nIf you find bugs (either in the code or in the calendar), please\n[create an issue on GitHub](https://github.com/liturgical-app/calendar/issues).\n\nPull requests are always welcome, either to address bugs or add new features.\n\n## Example\n\nThere is a sample app which uses this library called\n[Liturgical Colour App](https://github.com/djjudas21/liturgical-colour-app).\n",
"bugtrack_url": null,
"license": null,
"summary": "Library to determine liturgical dates and colours for the Anglican Church of England",
"version": "0.4.0",
"project_urls": null,
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "4ee14c92ac02712393e7c915b199c326647a18d5484aad1c4576c7f14f073098",
"md5": "152a16109673d4e7b2869439a09ee8a0",
"sha256": "39e8cfe2b0efa047258679bfae34dfb309e0bd5f32bafb0fe8096b83f04d9e58"
},
"downloads": -1,
"filename": "liturgical_calendar-0.4.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "152a16109673d4e7b2869439a09ee8a0",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.11",
"size": 13004,
"upload_time": "2024-04-29T15:38:36",
"upload_time_iso_8601": "2024-04-29T15:38:36.586851Z",
"url": "https://files.pythonhosted.org/packages/4e/e1/4c92ac02712393e7c915b199c326647a18d5484aad1c4576c7f14f073098/liturgical_calendar-0.4.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "6f4d51a6269e10116d677e21ed691eff0481f2ed1e0321f3fbec6051f229285f",
"md5": "f5bfff584599f8ce672d3d597d148f37",
"sha256": "17ba65a1a2499cf2b58fd28a04dfff588ee2b3dfdb31a5c2da104397dbbcce29"
},
"downloads": -1,
"filename": "liturgical_calendar-0.4.0.tar.gz",
"has_sig": false,
"md5_digest": "f5bfff584599f8ce672d3d597d148f37",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.11",
"size": 13145,
"upload_time": "2024-04-29T15:38:37",
"upload_time_iso_8601": "2024-04-29T15:38:37.443507Z",
"url": "https://files.pythonhosted.org/packages/6f/4d/51a6269e10116d677e21ed691eff0481f2ed1e0321f3fbec6051f229285f/liturgical_calendar-0.4.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-29 15:38:37",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "liturgical-calendar"
}