# 🌤️ Sunny
An [Open-meteo API](https://open-meteo.com/) client written in Gleam.
Makes it easier to get weather forecasts, current and past weather data with different models anywhere you want !
[![Package Version](https://img.shields.io/hexpm/v/sunny)](https://hex.pm/packages/sunny)
[![Hex Docs](https://img.shields.io/badge/hex-docs-ffaff3)](https://hexdocs.pm/sunny/)
## Installation
Add this package to your gleam project (not online yet)
```sh
gleam add sunny
```
### Getting the current temperature in a city
<details open>
<summary>Example code</summary>
Here, the function `send` corresponds to a function that makes a HTTP request.
For that, you can use HTTP clients such as `gleam_httpc` or `gleam_fetch`.
```gleam
import gleam/dict
import gleam/io
import gleam/option
import sunny
import sunny/api/forecast
import sunny/api/forecast/instant
import sunny/api/geocoding
import sunny/measurement
pub fn main() {
let sunny = sunny.new()
let assert Ok(location) =
sunny
|> geocoding.get_first_location(
geocoding.params("marseille")
|> geocoding.set_language(geocoding.French),
)
// Make a HTTP request
|> send
|> geocoding.get_first_result
let assert Ok(forecast_result) =
sunny
|> forecast.get_forecast(
forecast.params(geocoding.location_to_position(location))
|> forecast.set_current([instant.Temperature2m]),
)
// Make a HTTP request
|> send
|> forecast.get_result
let assert option.Some(current_data) = forecast_result.current
let assert Ok(temperature) =
current_data.data |> dict.get(instant.Temperature2m)
io.println(
location.name
<> "'s current temperature is : "
<> measurement.to_string(temperature),
)
}
```
</details>
More examples in the `test/examples` directory
Further documentation can be found at <https://hexdocs.pm/sunny>.
## Contributing
Contributions are very welcome ! Make a fork, and once you made the changes you wanted, make a PR.
### Todo
- Historical forecast API
- Air quality API