yr/README.md
Tim Hårek Andreassen 7d256f0ca6
docs: Add package usage
Signed-off-by: Tim Hårek Andreassen <tim@harek.no>
2024-10-03 19:40:34 +02:00

1.2 KiB

yr

Get the weather delivered to your command-line, or use as a Go package.

The project uses Meteorologisk institutt's public API, LocationForecast, and OpenStreetMap's Nominatim API.

Usage

# Get help
yr --help

# Current forecast for location
yr now bergen

# Or with a space
yr now "new york"

# Forecast for multiple hours
yr forecast "new york"

# Forecast for next 5 hours
yr forecast "new york" -i 5

# Open forecast in your web browser
yr forecast "new york" --web

# Open now in your web browser
yr now "new york" --web

As a package

import "git.sr.ht/~timharek/yr/yr"

func weather() {
  y := yr.New()

  now := y.Now("bergen")

  // Use the data
}

Contributing

Anyone can contribute to yr. Please refer to the contribution guidelines.

Send patches to the mailing list, report bugs on the issue tracker.