Skip to content

Latest commit

 

History

History
87 lines (62 loc) · 2.84 KB

README.md

File metadata and controls

87 lines (62 loc) · 2.84 KB

DarkSkyKit: DarkSkyKit API Client in Swift

Build Status CocoaPods Compatible codecov

DarkSky.net API client written in Swift.

Usage

import DarkSkyKit

Init

Basic Configuration

Init the DarkSkyKit client using only the api token.

let forecastClient = DarkSkyKit(apiToken: "AAA")

Extended Configuration

Init the DarkSkyKit client using a custom configuration. Check out the darksky.net documentation to know more about these properties (units, exclude, extend & language).

let c = Configuration(token: "AAA", units: .si, exclude: .alerts, lang: "ES")
let forecastClient = DarkSkyKit(configuration: c)

Fetch

DarkSkt.net API provides 2 ways of fetch weather data: current and time machine.

Current

Fetch current weather conditions based on a given location.

forecastClient.current(latitude: 0.34565, longitude: 1.64559) { result in
  switch result {
    case .success(let forecast):
      // Manage weather data using the Forecast model. Ex:
      if let current = forecast.currently {
        let t = current.temperature
      }
    case .failure(let error):
      // Manage error case
  }
}

Time Machine

Fetch weather conditions based on a given date and location.

let d = NSDate(timeIntervalSinceNow: timestamp)
forecastClient.current(latitude: 0.34565, longitude: 1.64559, date: d) { result in
  // Manage result
}

Requirements

  • iOS 8.0+ / Mac OS X 10.9+ / tvOS 9.0+ / watchOS 2.0+
  • Xcode 7.3+

Installation

To install it, simply add the following line to your Podfile:

pod "DarkSkyKit"

About

This project is funded and maintained by Caramba. We 💛 open source software!

Check out our other open source projects, read our blog or say 👋 on twitter @carambalabs.

Contribute

Contributions are welcome 🤘 We encourage developers like you to help us improve the projects we've shared with the community. Please see the Contributing Guide and the Code of Conduct.

License

DarkSkyKit is available under the MIT license. See the LICENSE file for more info.