Skip to content

Latest commit

 

History

History
32 lines (19 loc) · 1.69 KB

README.md

File metadata and controls

32 lines (19 loc) · 1.69 KB

StormGlassKit

A pure Swift SDK for consuming the official StormGlass API

Note

Currently only the Global & Marine Weather APIs are supported.

Installation

StormGlassKit is available through Swift Package Manager, a dependency manager built into Xcode.

If you are using Xcode 11 or higher, go to File / Swift Packages / Add Package Dependency... and enter package repository URL https://github.com/StarLard/StormGlassKit.git, then follow the instructions.

To remove the dependency, select the project and open Swift Packages (which is next to Build Settings). You can add and remove packages from this tab.

Swift Package Manager can also be used from the command line.

Usage

  1. In your application's application(_:didFinishLaunchingWithOptions:) method, configure StormGlassKit using one of the following methods:
    • Add a StormGlassKit-Configuration.plist file to your project that includes an "API_KEY" key with your API key as the value. You may then call StormGlassKit.configure().
    • Create and configure a custom StormGlassKit.Configuration and use it to call StormGlassKit.configure(with:).
  2. Get weather forcasts using the StormGlassKit.fetchWeather(...) method. StormGlassKit provides APIs for both Combine and Swift concurrency's async/await pattern. The returned value will contain a Weather type which contains the requested forecast, organized by hour, and the associated meta data.

Author

@StarLard

License

StormGlassKit is available under the Apache 2.0 license. See the LICENSE file for more info.