weatherkit-rs

Safe Rust bindings for Apple's WeatherKit framework on macOS 13+.

The published package is weatherkit-doomfish; the Rust library crate is imported as weatherkit.

Status: v0.2.1 covers the full non-exempt macOS WeatherKit surface, including WeatherService multi-query helpers, statistics/summaries, weather changes, historical comparisons, and enum descriptor catalogs.

Quick start

use weatherkit::prelude::*;

fn main() -> Result<(), WeatherKitError> {
    let service = WeatherService::shared();
    let location = CLLocation::new(37.3349, -122.0090);
    let current = service.current_weather(&location)?;

    println!(
        "current temperature: {:.1}°C ({:?})",
        current.temperature,
        current.condition
    );
    Ok(())
}

Highlights

WeatherService::weather, current_weather, daily_forecast, hourly_forecast, minute_forecast, weather_alerts, availability, attribution, and multi-query weather_including{2..6} / weather_including_many
DailyForecast / HourlyForecast containers with WeatherKit metadata plus DayForecast / HourForecast entries
macOS 15+ statistics and summary wrappers (DailyWeatherStatistics, DailyWeatherSummary, HourlyWeatherStatistics, MonthlyWeatherStatistics) with query enums and service helpers
WeatherChanges, HistoricalComparisons, Trend, TrendBaseline, and Percentiles for the new WeatherKit comparison/change-tracking APIs
CurrentWeather with precipitation intensity, metadata, and cloud-cover-by-altitude when available on macOS 15+
DayForecast with SunEvents, MoonEvents, UVIndex, wind, day-part forecasts, and precipitation-by-type details when available
Descriptor catalogs for WeatherAttribution, WeatherSeverity, AvailabilityKind, WeatherCondition, Precipitation, PressureTrend, MoonPhase, WindCompassDirection, UVExposureCategory, and WeatherError
Async Swift APIs bridged to synchronous Rust via DispatchSemaphore + Task, with opaque handle ownership released on the Rust side

Entitlements / caveats

WeatherKit usually requires an entitled bundle ID backed by a paid Apple Developer membership. Unsigned CLI binaries often fail with permission or bundle-configuration errors; every example in examples/ treats that as a caveat instead of a hard failure.

Examples

Each logical area has a dedicated example:

cargo run --example 01_weather_service_smoke
cargo run --example 02_current_weather_snapshot
cargo run --example 03_daily_forecast_snapshot
cargo run --example 04_hourly_forecast_snapshot
cargo run --example 05_weather_alerts_snapshot
cargo run --example 06_minute_forecast_snapshot
cargo run --example 07_availability_kind_catalog
cargo run --example 08_weather_attribution_snapshot
cargo run --example 09_sun_events_snapshot
cargo run --example 10_moon_events_snapshot
cargo run --example 11_weather_condition_catalog
cargo run --example 12_pressure_catalog
cargo run --example 13_weather_changes_snapshot
cargo run --example 14_weather_statistics_snapshot
cargo run --example 15_weather_multi_query_snapshot
cargo run --example 16_weather_enum_catalog

License