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,
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
and substantially modified to suit the Anglican calendar.
The output of this module is compared against the Church of England Lectionary, which is taken to be the canonical source.
Installation
This library is published on PyPI.
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.
# Get info for today
$ liturgical_calendar
name :
prec : 1
season : Lent
season_url : https://en.wikipedia.org/wiki/Lent
week : Lent 1
date : 2025-03-13
colour : purple
colourcode : #664fa6
ember : 0
# 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
type_url : https://en.wikipedia.org/wiki/Festival_(Church_of_England)
season : Epiphany
season_url : https://en.wikipedia.org/wiki/Epiphany_season
week : Epiphany 3
date : 2023-01-25
colour : white
colourcode : #fffff6
ember : 0
Usage, as a library
# 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'])
Development
This Python project is managed with Poetry. For local testing without installing, run
poetry run liturgical_calendar
Issues
If you find bugs (either in the code or in the calendar data), please create an issue on GitHub.
Pull requests are always welcome, either to address bugs or add new features.
1 maintainer
Metadata
1 maintainer
Release files for liturgical-calendar 0.5.9
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| liturgical_calendar-0.5.9.tar.gz | 12.4 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| liturgical_calendar-0.5.9-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 25.6 kB
Release files / liturgical_calendar-0.5.9.tar.gz
| Download URL | liturgical_calendar-0.5.9.tar.gz |
|---|---|
| Size | 12.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e3d490e8127ec5aae71b5fba246040ed14cacfe91774b96c816657bc4d9a7037
|
|
BLAKE2b-256 checksum How to use checksums |
ae92b63d47ec04e53c66e25a815652a47d27c94fb57600ac3c8c180457f847a7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
poetry/2.3.3 CPython/3.11.15 Linux/6.17.0-1008-azure
|
Release files / liturgical_calendar-0.5.9-py3-none-any.whl
| Download URL | liturgical_calendar-0.5.9-py3-none-any.whl |
|---|---|
| Size | 13.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
307fd2e239d636102804ef2292d3eb767905247993808a60f5d6b4e2449b7d16
|
|
BLAKE2b-256 checksum How to use checksums |
37109d1e90bb2d550b4145f9b74bcf4576d260c466193656f49523ca858539d3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
poetry/2.3.3 CPython/3.11.15 Linux/6.17.0-1008-azure
|
Security for liturgical-calendar 0.5.9
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
