Skip to content

Latest commit

 

History

History
138 lines (102 loc) · 4.79 KB

README.md

File metadata and controls

138 lines (102 loc) · 4.79 KB
Raw

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 PDM for build environment and install dependencies: pdm 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