open-meteo-cli/README.md
Jorge Bolois ccddd8484c
All checks were successful
ci/woodpecker/push/woodpecker Pipeline was successful
Adding JSON example in the README
2023-06-14 19:24:31 +02:00

82 lines
3.6 KiB
Markdown

# Open Meteo CLI
![Status](https://ci.midefos.com/api/badges/midefos/open-meteo-cli/status.svg)
CLI to extract meteorology data from Open Meteo.
## Usage
### Current Weather
Displays the current weather for your IP address automatically or for specific coordinates.
```
open-meteo-cli current-weather [FLAGS] [OPTIONS]
```
#### Options
- `-l, --latitude <latitude>`: Latitude as a decimal number.
- `-L, --longitude <longitude>`: Longitude as a decimal number.
- `--temperature-unit <temperature-unit>`: Switches between Celsius or Fahrenheit. Default value is Celsius.
- `--speed-unit <speed-unit>`: Switches between km/h, m/s, mp/h or knots. Default value is Kmh.
- `--format <format>`: Switches data format between Normal, Clean or JSON. Default value is Normal.
#### Flags
- `-a, --all`: Displays all the information.
- `-d, --is-day`: Displays if it is day or night.
- `-t, --temperature`: Displays the decimal temperature.
- `-w, --windspeed`: Displays the decimal wind speed.
- `-W, --winddirection`: Displays the wind direction, in degrees.
- `--coords`: Displays the latitude and the longitude.
- `--city`: Displays the city.
- `-c, --clean`: Displays the output separated by commas. Same as '--format clean'.
- The order of values is as follows: latitude, longitude, city, is_day, temperature, windspeed, winddirection.
- `-j, --json`: Displays the output as JSON. Same as '--format json'
#### Examples
- Standard usage: `open-meteo-cli current-weather -a`
```
┌──────────────────────────────────────────────────┐
│ │
│ === Current weather for Zaragoza === │
│ Night │
│ Temperature: 18.8°C │
│ Wind speed: 6.6 km/h │
│ Wind direction: 22° │
│ Latitude: 41.6405, Longitude: -0.8814 │
│ === Weather data by Open-Meteo.com === │
│ │
└──────────────────────────────────────────────────┘
```
- Using coordinates: `open-meteo-cli current-weather -l 12.2 -L=-0.38 -t -w`
```
┌──────────────────────────────────────────────────┐
│ │
│ === Current weather === │
│ Temperature: 32.6°C │
│ Wind speed: 12.5 km/h │
│ === Weather data by Open-Meteo.com === │
│ │
└──────────────────────────────────────────────────┘
```
- Clean: `open-meteo-cli current-weather -d -t -w -c`
```
0,18.8,6.6
```
- JSON: `open-meteo-cli current-weather -d -t -w -j`
```
{"is_day":0,"temperature":18.8,"windspeed":6.6}
```
## Attribution
The weather data used in this application is provided by [Open-Meteo.com](https://open-meteo.com/) under the [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) license.
We would like to express our gratitude to Open-Meteo.com for their contribution to this project.