peludna-prognoza

Start an interactive search for a city and fetch data for it

$ peludna-prognoza

$ peludna-prognoza "[city]"

$ peludna-prognoza "[city]" --[json|xml]

$ peludna-prognoza "[city]" [[-w|--web]]

peludna-prognoza [OPTIONS]
(Alternatively: python3 peludna_prognoza.py [OPTIONS])

-c, --city <city_name>
    Specifies a single city for which to retrieve pollen forecast data. For example, --city Zagreb.

-r, --regions <region1,region2,...>
    Specifies one or more regions or cities (comma-separated) for which to retrieve pollen forecast data. For example, --regions Rijeka,Split.

-j, --json
    Outputs the pollen forecast data in JSON format, facilitating programmatic consumption. By default, output is human-readable text.

-h, --help
    Displays a help message and exits, showing available options and usage examples.

The peludna-prognoza command-line tool provides up-to-date pollen forecast information for various cities and regions across Croatia. Developed as a Python script, it typically fetches data from the official website of the Teaching Institute of Public Health "Dr. Andrija Štampar" in Zagreb. This utility is particularly valuable for individuals suffering from pollen allergies, offering a quick way to check daily pollen levels directly from the terminal. It supports specifying particular locations and can output the data in human-readable text or structured JSON format, making it suitable for integration into other scripts or monitoring systems. The command streamlines access to specific regional health data.

The functionality of peludna-prognoza is heavily reliant on the structure and availability of the data source website (Teaching Institute of Public Health "Dr. Andrija Štampar"). Any changes to the website's layout, APIs, or content delivery methods could potentially break the command's ability to fetch data. Furthermore, the data provided is specific to Croatian regions and may not be applicable elsewhere, limiting its global utility.

To use peludna-prognoza, you typically need Python 3 installed. The script can be obtained by cloning its Git repository (e.g., git clone https://github.com/vujicic/peludna-prognoza.git) and then running it directly (e.g., python3 peludna_prognoza.py). It may require additional Python libraries, which can be installed via pip (e.g., pip install -r requirements.txt). For convenient command-line execution, you might need to add the script to your system's PATH or create a symbolic link.

The pollen data consumed by this command is exclusively sourced from the official website of the Nastavni zavod za javno zdravstvo "Dr. Andrija Štampar" (Teaching Institute of Public Health "Dr. Andrija Štampar") in Zagreb, Croatia. The tool processes publicly available information to present it in a convenient command-line format, acting as a direct interface to this specific data provider.

The peludna-prognoza tool emerged as a community-driven open-source project, primarily to address the need for easily accessible pollen forecast information for residents of Croatia. It was developed as a Python script, leveraging web scraping techniques to extract data from a public health institute's website. Its development reflects a common pattern in open-source where specific local data needs drive the creation of specialized command-line utilities, offering a convenient way to access public health information that might otherwise be less accessible.

curl(1), wget(1), jq(1)