• Stars
    star
    9
  • Rank 1,939,727 (Top 39 %)
  • Language
    Python
  • License
    GNU General Publi...
  • Created over 5 years ago
  • Updated almost 2 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Simple api for all features of hebrew calendar based on fastApi and KosherJava python port

Python Coverage Contributors Forks Stargazers Issues MIT License LinkedIn

Table of Contents

About The Project

Simple high-level api for all features of hebrew calendar.
Explore the swagger ยป

Built With

Getting Started

To get a local copy up and running follow these simple steps.

Installation

Docker

  1. Run docker run -p 8000:8000 benyomin/zmanim-api:latest
  2. Open http://localhost:8000 in your browser to explore the swagger.

Python

  1. Clone/fork the repo
  2. Use poetry for build environment and install dependencies: poetry install
  3. Go to project folder: cd %repo_location%/zmanim_api
  4. Run python main.py
  5. Open http://localhost:8000 in your browser to explore the swagger

Tests

Run tests: pytest test/
Run with coverage: coverage run -m pytest -v test/ or coverage xml

Usage

Request:
GET http://localhost:8000/shabbat?cl_offset=18&lat=32.09&lng=34.86
Response:

{
  "candle_lighting": "2020-10-09T17:56:00+03:00",
  "havdala": "2020-10-10T18:50:00+03:00",
  "settings": {
    "date": "2020-10-05",
    "cl_offset": 18,
    "havdala_opinion": "tzeis_8_5_degrees",
    "coordinates": [32.09, 34.86],
    "elevation": 0
  },
  "torah_part": "shemini_atzeres",
  "late_cl_warning": false
}

For more examples, please refer to the Swagger docs

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Contact

Project Link: https://github.com/benyaming/zmanim_api