AurelienAVZN.OpenWeather.Client 0.0.1

☁️ OpenWeather Client for .NET

A strongly-typed C# client library for the OpenWeather API, built on .NET 10.

📦 Packages

Package	Description	NuGet
AurelienAVZN.OpenWeather.Client	Main client library
AurelienAvzn.OpenWeather.Client.Core	Core logic & configuration
AurelienAVZN.OpenWeather.Client.Bundles	DTOs, forms & result models

✨ Supported APIs

• 🌤️ Current Weather
• 📅 Hourly Forecast (5 days / 3 hours)
• 🗓️ Climatic Forecast (30 days)
• 🛣️ Road Risk
• ☀️ Solar Radiation
• 🗺️ Weather Maps 2.0
• 📍 Geocoding
• 🔄 One Call 4.0
• 📜 Weather History

🚀 Getting Started

Prerequisites

• .NET 10 SDK
• An OpenWeather API key

Installation

dotnet add package AurelienAVZN.OpenWeather.Client

Configuration

using AurelienAVZN.OpenWeather.Client.Core;

var config = new OpenWeatherConfig
{
    ApiKey = "YOUR_API_KEY",
    Urls = new OpenWeatherUrls() // default URLs are pre-configured
};

Usage Example

using AurelienAVZN.OpenWeather.Client.Bundles;

// Build a request for current weather (Paris, France)
var form = new CurrentWeatherForm
{
    Lat = 48,
    Lon = 2,
    AppId = config.ApiKey,
    Units = "metric",
    Lang = "fr"
};

🏗️ Project Structure

openweather.client.csharp/
├── AurelienAVZN.OpenWeather.Client.Bundles/   # DTOs & models
│   ├── Forms/                                 # Request models
│   │   ├── Common/                            #   Shared form base
│   │   └── CurrentForecast/                   #   Weather & road risk forms
│   └── Results/                               # Response models
│       └── Json/                              #   JSON deserialization models
│           ├── Common/                        #     Shared result base
│           └── CurrentForecast/               #     Weather & forecast results
├── AurelienAvzn.OpenWeather.Client.Core/      # Core logic & config
│   └── Config/                                #   OpenWeatherConfig & URLs
├── OpenWeather.Client/                        # Main client library
├── .gitlab-ci.yml                             # CI/CD pipeline
└── OpenWeather.slnx                           # Solution file

⚙️ CI/CD

The project uses GitLab CI/CD with automatic publishing:

1. Create a tag following the pattern vX.Y.Z (e.g., v1.0.0)
2. The pipeline automatically:
   • ✅ Builds the solution
   • 📦 Packs all NuGet packages
   • 🚀 Publishes to NuGet.org
   • 🏷️ Creates a GitLab Release

git tag v1.0.0
git push origin v1.0.0

🤝 Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/my-feature)
3. Commit your changes (git commit -m 'Add my feature')
4. Push to the branch (git push origin feature/my-feature)
5. Open a Merge Request

📄 License

This project is licensed under the MIT License — see the LICENSE file for details.

🔗 Links

• 📦 NuGet Packages
• 📖 OpenWeather API Documentation
• 🐛 Issue Tracker