Skip to main content

An API wrapper for Pikud Haoref's rocket API.

Project description

PikudHaoref.py


Documentation

An unofficial API wrapper for Pikud Haoref's rocket API written in python.
The documentation is not done yet.

Credits

Features

  • Very easy to use and user-friendly.
  • Object Oriented.
  • Detect sirens in real time.
  • View city data (zone, name, countdown, location).
  • Supports many languages (English, Russian, Hebrew, Spanish, Arabic).
  • Both sync and async support. (MORE COMING SOON)

The pikudhaoref API is only accessible from Israel.

Installation

Installing pikudhaoref.py is very easy.

python -m pip install pikudhaoref.py

Examples

Siren detector example

from datetime import datetime

import pikudhaoref


client = pikudhaoref.SyncClient(update_interval=2)

history_range = client.get_history(
    date_range=pikudhaoref.Range(datetime(year=2014, month=7, day=24), datetime.now())
)
history_month = client.get_history(mode=pikudhaoref.HistoryMode.LAST_MONTH)

print(history_month)
print(history_range)
# The get_history method does not create a city object as it might take a long time.
# In case you need the city information, you can use the get_city method.

print(client.current_sirens)
# The current_sirens property returns the list of current sirens, and gets the city automatically.


@client.event()
def on_siren(sirens):
    print(f"Siren alert! started sirens: {sirens}")


@client.event()
def on_siren_end(sirens):
    print(f"Sirens {sirens} have ended.")


while True:
    pass  # To make sure the script doesnt stop

TODO

  • None

Known Issues

  • None

Incase you do find bugs, please create an issue or a PR.

Support

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pikudhaoref.py-0.0.8.tar.gz (11.8 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page