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 details)

Uploaded Source

File details

Details for the file pikudhaoref.py-0.0.8.tar.gz.

File metadata

  • Download URL: pikudhaoref.py-0.0.8.tar.gz
  • Upload date:
  • Size: 11.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.6.0 pkginfo/1.7.0 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.61.1 CPython/3.8.6

File hashes

Hashes for pikudhaoref.py-0.0.8.tar.gz
Algorithm Hash digest
SHA256 77e2d82fa919d345d829ab8c1d286e9f9597496c469761ff7bbaced39f560d7e
MD5 b6880464aae2fb0ab0c47bfd88a11b5c
BLAKE2b-256 6cafddee6dd26d586c4533c102de881e58e1d566c37cf3d465dc9d2bc1fb18fa

See more details on using hashes here.

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