[![Tests](https://github.com/matthiasgi/directorium/workflows/Testing%20code/badge.svg)](https://github.com/matthiasgi/directorium/actions?query=workflow:"Testing+code")
[![Build documentation](https://github.com/MatthiasGi/directorium/actions/workflows/docs.yml/badge.svg)](https://github.com/MatthiasGi/directorium/actions/workflows/docs.yml)
[![Publish Package](https://github.com/matthiasgi/directorium/workflows/Upload%20Python%20Package/badge.svg)](https://github.com/matthiasgi/directorium/actions?query=workflow:"Upload+Python+Package")
[![GitHub release](https://img.shields.io/github/release/matthiasgi/directorium?include_prereleases=&sort=semver&color=blue)](https://github.com/matthiasgi/directorium/releases/)
[![License](https://img.shields.io/badge/License-MIT-blue)](#license)
[![issues - directorium](https://img.shields.io/github/issues/matthiasgi/directorium)](https://github.com/matthiasgi/directorium/issues)
# directorium
A wrapper package for the public API of https://eucharistiefeier.de/lk/. It is able to provide information from the liturgical calendar such as liturgical color and lectures. To start with the package just run:
```shell
pip install directorium
```
## Getting started
A sample usage would be:
```python
from datetime import date
from directorium import Directorium
directorium = Directorium.from_request()
today = date.today()
events = directorium.get(today)
print(events)
```
## Documentation
An automatically created documentation is available on [the GitHub Pages of this project](https://matthiasgi.github.io/directorium/).
## Contributing
You're more than invited to contribute to this project. Any kind of help is appreciated. Just open an issue or a pull request.
1. Fork the project
2. Add a python environment with `python -m venv .venv`
3. Activate the environment with `source .venv/bin/activate`
4. Install the development dependencies with `pip install -e .[development]`
5. Install the pre-commit hooks with `pre-commit install`
6. Create a new branch
7. Make your changes (remember to add tests!) and commit them
8. Install the test dependencies with `pip install -e .[test]`
9. Run the tests with `pytest`
10. Push your changes and open a pull request
## Acknowledgments
Thanks a lot to the [Salesians of Don Bosco](https://www.donbosco.de/) for providing the API!
## License
Released under [MIT](/LICENSE) by [@matthiasgi](https://github.com/matthiasgi).
Raw data
{
"_id": null,
"home_page": null,
"name": "directorium",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "catholic, church, eucharistiefeier, liturgy, mass",
"author": null,
"author_email": "Matthias Gianfelice <matthias@gianfelice.de>",
"download_url": "https://files.pythonhosted.org/packages/e1/c9/f3b0610cfd7510b5dffd04be98784ca0d168345af4a749a2af5e4daed0a4/directorium-0.2.0.tar.gz",
"platform": null,
"description": "[![Tests](https://github.com/matthiasgi/directorium/workflows/Testing%20code/badge.svg)](https://github.com/matthiasgi/directorium/actions?query=workflow:\"Testing+code\")\n[![Build documentation](https://github.com/MatthiasGi/directorium/actions/workflows/docs.yml/badge.svg)](https://github.com/MatthiasGi/directorium/actions/workflows/docs.yml)\n[![Publish Package](https://github.com/matthiasgi/directorium/workflows/Upload%20Python%20Package/badge.svg)](https://github.com/matthiasgi/directorium/actions?query=workflow:\"Upload+Python+Package\")\n\n[![GitHub release](https://img.shields.io/github/release/matthiasgi/directorium?include_prereleases=&sort=semver&color=blue)](https://github.com/matthiasgi/directorium/releases/)\n[![License](https://img.shields.io/badge/License-MIT-blue)](#license)\n[![issues - directorium](https://img.shields.io/github/issues/matthiasgi/directorium)](https://github.com/matthiasgi/directorium/issues)\n\n# directorium\n\nA wrapper package for the public API of https://eucharistiefeier.de/lk/. It is able to provide information from the liturgical calendar such as liturgical color and lectures. To start with the package just run:\n```shell\npip install directorium\n```\n\n## Getting started\n\nA sample usage would be:\n```python\nfrom datetime import date\nfrom directorium import Directorium\n\ndirectorium = Directorium.from_request()\ntoday = date.today()\nevents = directorium.get(today)\nprint(events)\n```\n\n## Documentation\n\nAn automatically created documentation is available on [the GitHub Pages of this project](https://matthiasgi.github.io/directorium/).\n\n## Contributing\nYou're more than invited to contribute to this project. Any kind of help is appreciated. Just open an issue or a pull request.\n\n1. Fork the project\n2. Add a python environment with `python -m venv .venv`\n3. Activate the environment with `source .venv/bin/activate`\n4. Install the development dependencies with `pip install -e .[development]`\n5. Install the pre-commit hooks with `pre-commit install`\n6. Create a new branch\n7. Make your changes (remember to add tests!) and commit them\n8. Install the test dependencies with `pip install -e .[test]`\n9. Run the tests with `pytest`\n10. Push your changes and open a pull request\n\n## Acknowledgments\nThanks a lot to the [Salesians of Don Bosco](https://www.donbosco.de/) for providing the API!\n\n## License\n\nReleased under [MIT](/LICENSE) by [@matthiasgi](https://github.com/matthiasgi).\n",
"bugtrack_url": null,
"license": null,
"summary": "Wrapper for the public API of https://eucharistiefeier.de/lk/",
"version": "0.2.0",
"project_urls": {
"Documentation": "https://matthiasgi.github.io/directorium/directorium.html",
"Issues": "https://github.com/MatthiasGi/directorium/issues",
"Repository": "https://github.com/MatthiasGi/directorium"
},
"split_keywords": [
"catholic",
" church",
" eucharistiefeier",
" liturgy",
" mass"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "1fabe802f5f73c814a47de0e25596f1e4c9e6954ee4c235b0217c5d7b1df6efe",
"md5": "d0537d88e77e71545f13100e152f17d7",
"sha256": "7977c6549ab3bc7ab23e8fdaa94941c1408e413c2b60d68356d9593687d7378e"
},
"downloads": -1,
"filename": "directorium-0.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d0537d88e77e71545f13100e152f17d7",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 9575,
"upload_time": "2024-10-16T17:37:57",
"upload_time_iso_8601": "2024-10-16T17:37:57.077865Z",
"url": "https://files.pythonhosted.org/packages/1f/ab/e802f5f73c814a47de0e25596f1e4c9e6954ee4c235b0217c5d7b1df6efe/directorium-0.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "e1c9f3b0610cfd7510b5dffd04be98784ca0d168345af4a749a2af5e4daed0a4",
"md5": "cb84b99ddce3fdc2a608115fbf55800e",
"sha256": "fbd80a2c8773df2d7c049622fdac867ea398faf41faf282e9691774dda1ca925"
},
"downloads": -1,
"filename": "directorium-0.2.0.tar.gz",
"has_sig": false,
"md5_digest": "cb84b99ddce3fdc2a608115fbf55800e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 67496,
"upload_time": "2024-10-16T17:37:58",
"upload_time_iso_8601": "2024-10-16T17:37:58.246341Z",
"url": "https://files.pythonhosted.org/packages/e1/c9/f3b0610cfd7510b5dffd04be98784ca0d168345af4a749a2af5e4daed0a4/directorium-0.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-16 17:37:58",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "MatthiasGi",
"github_project": "directorium",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "directorium"
}