https://github.com/matt-dray/weva
💻🌦️ CLI-first R package: a tiny weather report
https://github.com/matt-dray/weva
open-meteo postcodesio r-cli r-package rstats weather
Last synced: 3 months ago
JSON representation
💻🌦️ CLI-first R package: a tiny weather report
- Host: GitHub
- URL: https://github.com/matt-dray/weva
- Owner: matt-dray
- License: other
- Created: 2026-02-24T22:26:00.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-02-27T00:22:45.000Z (4 months ago)
- Last Synced: 2026-02-27T05:42:51.547Z (4 months ago)
- Topics: open-meteo, postcodesio, r-cli, r-package, rstats, weather
- Language: R
- Homepage:
- Size: 16.6 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# weva
[](https://www.repostatus.org/#concept)
[](https://github.com/matt-dray/weva/actions/workflows/R-CMD-check.yaml)
[](https://github.com/matt-dray/weva/actions/workflows/format.yaml)
[](https://github.com/matt-dray/weva/actions/workflows/lint.yaml)
[](https://www.rostrum.blog/index.html#category=weva)
An R package with a [Rapp](https://cran.r-project.org/package=Rapp)-powered command-line interface (CLI) to generate a limited and opinionated weather report for a UK postcode.
Uses data from the:
* [Open-Meteo](https://open-meteo.com) API
* [postcodes.io](https://postcodes.io/) API
## Install
You can install the package from the R console.
``` r
install.packages("pak") # if not yet installed
pak::pak("matt-dray/weva")
```
Then you can install the CLI.
``` r
weva::install_cli()
```
## Use
Run `weva` from a terminal with a valid UK postcode—the only required positional argument—to receive a tiny weather report with segments for now and later.
```bash
weva wc2n5du
```
```
now 8.2°C ☀️ | +1h 7.6°C ☀️
```
The temperature values are styled with [ANSI escape codes](https://en.wikipedia.org/wiki/ANSI_escape_code) if your terminal supports them.
You can also supply options to:
* extend the forecast by a user-supplied number of `--hours` (shortcut `-h`)
* show a segment with today's `--extremes` (`-e`) of temperature
```bash
weva "WC2N 5DU" -h 24 -e
```
```
now 8.2°C ☀️ | +24h 11.1°C ☁️ | today 6.9°C to 10.7°C
```
The Open-Meteo API returns 'current' data at the nearest 15 minutes and 'hourly' at the top of the hour.
{weva} aligns these by rounding to the nearest hour before adding the user's `--hours` input.
To give more precise time-related information, you can show interpreted `--datetimes` (`-d`) for each segment.
```bash
weva "WC2N 5DU" -h 24 -e -d
```
```
2026-02-28 20:30 8.2°C ☀️ | 2026-03-01 21:00 11.1°C ☁️ | 2026-02-28 6.9°C to 10.7°C
```
Run `weva --help` for further information.