darksky-api 0.1.3

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 7a0d324adb3f3ca70e81b924293c2ddfe13074c2f9678d4ca02dbfcc9fa505f2
+  data.tar.gz: 9a6a530b42eb6b4f5a296f18e921911803399d494d796e2a01a0c47b79670d59
+SHA512:
+  metadata.gz: e83781a530fd0aec046da02ea3ba14a7161c9048861d9a9729a1e3c74f9a8520f1aa7a6a8b7997e79f1e10fc1954b4a66ce75725da814a75f4599f3e98a50e2c
+  data.tar.gz: 1fb64f1a6fa35ce39c5f51fc9fbd0effeb6272e9270d9faed379922ab8d3aa788e0afc49a079503c7d63c6404e9f62a9cf597a0652cc03c6234b31104a03e80c

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+build

data/.rubocop.yml

@@ -0,0 +1,24 @@
+Style/ClassVars:
+  Enabled: false
+
+Style/Documentation:
+  Enabled: false
+
+Style/AsciiComments:
+  Enabled: false
+
+Naming/FileName:
+  Enabled: false
+
+Metrics/MethodLength:
+  Max: 20
+
+Metrics/LineLength:
+  # disable for comment-only lines and lines with URLs
+  IgnoredPatterns: [
+    '^(\A|\s)*#',
+    'https?://'
+  ]
+
+Metrics/ClassLength:
+  Max: 200

data/.yardopts

@@ -0,0 +1,2 @@
+--markup markdown
+--charset utf-8

data/Gemfile

@@ -0,0 +1,10 @@
+source 'https://rubygems.org'
+
+git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
+
+# Specify your gem's dependencies in darksky_api.gemspec
+gemspec
+
+# dependencies
+gem 'json', '~> 2.1'
+gem 'rest-client', '~> 2.0'

data/Gemfile.lock

@@ -0,0 +1,42 @@
+PATH
+  remote: .
+  specs:
+    darksky-api (0.1.1)
+      json (~> 2.1)
+      rest-client (~> 2.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    domain_name (0.5.20170404)
+      unf (>= 0.0.5, < 1.0.0)
+    http-cookie (1.0.3)
+      domain_name (~> 0.5)
+    json (2.1.0)
+    mime-types (3.1)
+      mime-types-data (~> 3.2015)
+    mime-types-data (3.2016.0521)
+    minitest (5.10.3)
+    netrc (0.11.0)
+    rake (10.5.0)
+    rest-client (2.0.2)
+      http-cookie (>= 1.0.2, < 2.0)
+      mime-types (>= 1.16, < 4.0)
+      netrc (~> 0.8)
+    unf (0.1.4)
+      unf_ext
+    unf_ext (0.0.7.4)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.16)
+  darksky-api!
+  json (~> 2.1)
+  minitest (~> 5.0)
+  rake (~> 10.0)
+  rest-client (~> 2.0)
+
+BUNDLED WITH
+   1.16.0

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 Jacob Pratt
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,106 @@
+# DarkSky
+
+Disclaimer: This gem has no affiliation with DarkSky. It is an independent way to interact with its API.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'darksky-api'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install darksky-api
+
+## Usage
+
+### DarkSky
+
+After importing DarkSky (`require 'darksky-api'`), you will need to configure it with some settings. All arguments are keyword arguments.
+
+To configure DarkSky, you'll need to call `DarkSky.confg` with the kwargs below.
+
+**Current kwargs**
+
+| kwarg | purpose                 | default    |
+|-------|-------------------------|------------|
+| key   | secret key from DarkSky | *required* |
+
+### DarkSky::Location
+
+This library stores data *by location*. As such, you'll need to instantiate the `Location` class for each place you want data from. The required parameter is an array of the latitude and longitude.
+
+To instantiate a Location: `loc = DarkSky::Location.new [lat, long]`
+
+Optional kwargs:
+
+| kwarg            | options                                         | default |
+|------------------|-------------------------------------------------|---------|
+| `cache_duration` | any positive number (in seconds)                | 300     |
+| `units`          | `:auto`<br>`:si`<br>`:us`<br>`:uk`<br>`:canada` | `:auto` |
+| `language`       | any supported by DarkSky                        | `en`    |
+
+After you've configured `DarkSky` and created a `Location`, you're all set to start using the data! By default, the cache duration is 5 minutes, so anything you do within that timeframe only results in a single request.
+
+To get data about the current time, use the `current` namespace. Here's all the operations defined in that namespace:
+
+    apparent_temperature (aliased as wind_chill, heat_index, feels_like)
+    clear?
+    cloud_cover
+    cloudy?
+    dew_point
+    foggy?
+    humidity
+    icon
+    nearest_storm_bearing
+    nearest_storm_bearing_text
+    nearest_storm_distance
+    ozone
+    precip_intensity
+    precip_intensity_text
+    precip_probability
+    precip_type
+    pressure
+    rainy?
+    sleet?
+    snowy?
+    summary
+    temperature
+    uv_index
+    visibility
+    wind_bearing
+    wind_bearing_text
+    wind_gust
+    wind_speed
+    windy?
+
+Example: How do you get the current temperature (actual and apparent) in New York City?
+
+```ruby
+require 'darksky-api'
+DarkSky.config 'KEY-VALUE'
+
+nyc = DarkSky::Location.new [40.7828687, -73.9675438]
+puts "temperature: #{nyc.current.temperature}" # actual air temperature
+puts "feels like: #{nyc.current.feels_like}" # apparent temperature
+```
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at [jhpratt/darksky-api](https://github.com/jhpratt/darksky-api). Creating a pull request implies you are releasing you code under the license stated below.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,10 @@
+require 'bundler/gem_tasks'
+require 'rake/testtask'
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'test'
+  t.libs << 'lib'
+  t.test_files = FileList['test/**/*_test.rb']
+end
+
+task default: :test

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require 'bundler/setup'
+require 'darksky-api'
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require 'irb'
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/darksky-api.gemspec

@@ -0,0 +1,28 @@
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'darksky-api/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'darksky-api'
+  spec.version       = DarkSky::VERSION
+  spec.authors       = ['Jacob Pratt']
+  spec.email         = ['the.z.cuber@gmail.com']
+
+  spec.summary       = 'Library for the public API on DarkSky.net'
+  spec.homepage      = 'https://github.com/jhpratt/darksky-api'
+  spec.license       = 'MIT'
+
+  spec.files = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_dependency 'json', '~> 2.1'
+  spec.add_dependency 'rest-client', '~> 2.0'
+
+  spec.add_development_dependency 'bundler', '~> 1.16'
+  spec.add_development_dependency 'minitest', '~> 5.0'
+  spec.add_development_dependency 'rake', '~> 10.0'
+end

data/lib/darksky-api.rb

@@ -0,0 +1,10 @@
+require 'darksky-api/version'
+require 'darksky-api/config'
+require 'darksky-api/location'
+require 'darksky-api/current'
+require 'darksky-api/day'
+
+# @author Jacob Pratt <the.z.cuber@gmail.com>
+# @version 0.1.3
+module DarkSky
+end

data/lib/darksky-api/config.rb

@@ -0,0 +1,30 @@
+module DarkSky
+  # set required and optional class variables
+  #
+  # keyword arguments:
+  # - **`key`** [required] ─ API key from [DarkSky](https://darksky.net/dev/account)
+  # - **`warnings`** [optional] ─ whether or not warnings are printed (default `true`)
+  #
+  # @since 0.1.0
+  # @return [void]
+  def self.config(opts)
+    defaults = {
+      units: :si
+    }
+    opts = defaults.merge opts
+
+    # required parameters
+    @@key = opts.fetch(:key)
+
+    # optional parameters
+    @@units = opts[:units]
+  end
+
+  # @example
+  #   DarkSky.key #=> '0f1e2d3c4b5a6978'
+  # @since 0.1.0
+  # @return [String] API key that was set by `.config()`
+  def self.key
+    @@key
+  end
+end

data/lib/darksky-api/current.rb

@@ -0,0 +1,295 @@
+module DarkSky
+  class Location
+    class Current
+      # automatically called by `Location`
+      # @since 0.1.0
+      # @param [Location] location where to get data from
+      def initialize(location)
+        @location = location
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.current.apparent_temperature #=> apparent temperature at location
+      # @since 0.1.0
+      # @return [Numeric] current apparent temperature at location
+      def apparent_temperature
+        data[:apparentTemperature]
+      end
+      alias wind_chill apparent_temperature
+      alias heat_index apparent_temperature
+      alias feels_like apparent_temperature
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.current.cloud_cover #=> cloud cover at location
+      # @since 0.1.0
+      # @return [Numeric] current cloud cover at location
+      def cloud_cover
+        data[:cloudCover]
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.current.dew_point #=> dew point at location
+      # @since 0.1.0
+      # @return [Numeric] current dew point at location
+      def dew_point
+        data[:dewPoint]
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.current.humidity #=> humidity at location
+      # @since 0.1.0
+      # @return [Numeric] current humidity at location
+      def humidity
+        data[:humidity]
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.current.icon #=> icon representation
+      # @since 0.1.0
+      # @return [String] icon representation of current weather at location
+      def icon
+        data[:icon]
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.current.clear?
+      # @since 0.1.0
+      # @return [Boolean] if icon is 'clear' variant
+      def clear?
+        %w[clear-day clear-night].include? icon
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.current.rainy?
+      # @since 0.1.0
+      # @return [Boolean] if icon is 'rain'
+      def rainy?
+        icon == 'rain'
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.current.snowy?
+      # @since 0.1.0
+      # @return [Boolean] if icon is 'snow'
+      def snowy?
+        icon == 'snow'
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.current.sleet?
+      # @since 0.1.0
+      # @return [Boolean] if icon is 'sleet'
+      def sleet?
+        icon == 'sleet'
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.current.windy?
+      # @since 0.1.0
+      # @return [Boolean] if icon is 'wind'
+      def windy?
+        icon == 'wind'
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.current.foggy?
+      # @since 0.1.0
+      # @return [Boolean] if icon is 'fog'
+      def foggy?
+        icon == 'fog'
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.current.cloudy?
+      # @since 0.1.0
+      # @return [Boolean] if icon is 'cloudy' or variant
+      def cloudy?
+        %w[cloudy partly-cloudy-day partly-cloudy-night].include? icon
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.current.nearest_storm_bearing #=> nearest storm bearing at location
+      # @since 0.1.0
+      # @return [Numeric] nearest storm bearing at location
+      def nearest_storm_bearing
+        data[:nearestStormBearing]
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.current.nearest_storm_bearing_text #=> text representation of bearing (N, NW, etc.)
+      # @since 0.1.0
+      # @return [String] text representation of bearing
+      def nearest_storm_bearing_text
+        directions = %w[N NNE NE ENE E ESE SE SSE S SSW SW WSW W WNW NW NNW]
+        directions[nearest_storm_bearing / 22.5 + 0.5]
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.current.nearest_storm_distance #=> nearest storm distance from location
+      # @since 0.1.0
+      # @return [Numeric] nearest storm distance from location
+      def nearest_storm_distance
+        data[:nearestStormDistance]
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.current.ozone #=> ozone level at location
+      # @since 0.1.0
+      # @return [Numeric] current ozone level at location
+      def ozone
+        data[:ozone]
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.current.precip_intensity #=> precipitation intensity at location
+      # @since 0.1.0
+      # @return [Numeric] current precipitation intensity at location
+      def precip_intensity
+        data[:precipIntensity]
+      end
+
+      # @example
+      #   location = DarkSky::Locaiton.new [45, -90]
+      #   location.current.precip_intensity_text #=> text representation of precipitation intensity at location
+      # @since 0.1.0
+      # @return [String] text representation of precipitation intensity at location
+      def precip_intensity_text
+        if precip_intensity >= 0.400
+          'heavy'
+        elsif precip_intensity >= 0.100
+          'moderate'
+        elsif precip_intensity >= 0.017
+          'light'
+        elsif precip_intensity >= 0.002
+          'very light'
+        end
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.current.precip_probability #=> precipitation probability at location
+      # @since 0.1.0
+      # @return [Numeric] current precipitation probability at location
+      def precip_probability
+        data[:precipProbability]
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.current.precip_type #=> precipitation type at location
+      # @since 0.1.0
+      # @return [String | nil] current precipitation type at location
+      def precip_type
+        data[:precipType]
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.current.pressure #=> barometric pressure at location
+      # @since 0.1.0
+      # @return [Numeric] current barometric pressure at location
+      def pressure
+        data[:pressure]
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.current.summary #=> summary of weather at location
+      # @since 0.1.0
+      # @return [String] summary of weather at location
+      def summary
+        data[:summary]
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.current.temperature #=> temperature at location
+      # @since 0.1.0
+      # @return [Numeric] current temperature at location
+      def temperature
+        data[:temperature]
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.current.uv_index #=> UV index at location
+      # @since 0.1.0
+      # @return [Numeric] current UV index at location
+      def uv_index
+        data[:uvIndex]
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.current.visibility #=> visibility at location
+      # @since 0.1.0
+      # @return [Numeric] current visibility at location
+      def visibility
+        data[:visibility]
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.current.wind_bearing #=> wind bearing at location
+      # @since 0.1.0
+      # @return [Numeric] current wind bearing at location
+      def wind_bearing
+        data[:windBearing]
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.current.wind_bearing_text #=> text representation of bearing (N, NW, etc.)
+      # @since 0.1.0
+      # @return [String] text representation of bearing
+      def wind_bearing_text
+        directions = %w[N NNE NE ENE E ESE SE SSE S SSW SW WSW W WNW NW NNW]
+        directions[wind_bearing / 22.5 + 0.5]
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.current.wind_gust #=> wind gust at location
+      # @since 0.1.0
+      # @return [Numeric] current wind gust at location
+      def wind_gust
+        data[:windGust]
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.current.wind_speed #=> wind speed at location
+      # @since 0.1.0
+      # @return [Numeric] current wind speed at location
+      def wind_speed
+        data[:windSpeed]
+      end
+
+      private
+
+      # helper to avoid typing this many times over
+      # @since 0.1.3
+      # @return [Hash] full data for current time
+      def data
+        @location.full_data[:currently]
+      end
+    end
+  end
+end

data/lib/darksky-api/day.rb

@@ -0,0 +1,494 @@
+module DarkSky
+  class Location
+    class Day
+      # automatically called by `Location`
+      # @since 0.1.3
+      # @param [Location] location where to get data from
+      def initialize(location, days_from_current)
+        @location = location
+        @days_from_current = days_from_current
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.today.date #=> object for the date
+      # @since 0.1.3
+      # @return [Date] object for the day
+      def date
+        # we only want the date, so don't use `Time.at()`
+        Date.strptime data[:time].to_s, '%s'
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.today.temperature_high #=> high temperature for the day
+      # @since 0.1.3
+      # @return [Numeric] high temperature for the day
+      def temperature_high
+        data[:temperatureHigh]
+      end
+      alias high_temperature temperature_high
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.today.temperature_high_time #=> time of high temperature
+      # @since 0.1.3
+      # @return [Time] time of high temperature
+      def temperature_high_time
+        Time.at data[:temperatureHighTime]
+      end
+      alias high_temperature_time temperature_high_time
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.today.temperature_low #=> low temperature for the day
+      # @since 0.1.3
+      # @return [Numeric] low temperature for the day
+      def temperature_low
+        data[:temperatureLow]
+      end
+      alias low_temperature temperature_low
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.today.temperature_low_time #=> time of low temperature
+      # @since 0.1.3
+      # @return [Time] time of low temperature
+      def temperature_low_time
+        Time.at data[:temperatureLowTime]
+      end
+      alias low_temperature_time temperature_low_time
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.today.icon #=> icon representation
+      # @since 0.1.3
+      # @return [String] icon representation of weather on day
+      def icon
+        data[:icon]
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.today.summary #=> summary of weather
+      # @since 0.1.3
+      # @return [String] summary of weather on day
+      def summary
+        data[:summary]
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.today.sunrise_time #=> sunrise time on day
+      # @since 0.1.3
+      # @return [Time] object with sunrise timestamp
+      def sunrise_time
+        Time.at data[:sunriseTime]
+      end
+      alias sunrise sunrise_time
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.today.sunset_time #=> sunset time on day
+      # @since 0.1.3
+      # @return [Time] object with sunset timestamp
+      def sunset_time
+        Time.at data[:sunsetTime]
+      end
+      alias sunset sunset_time
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.today.moon_phase #=> moon phase on day
+      # @since 0.1.3
+      # @return [Numeric] phase of the moon (0 to 1)
+      def moon_phase
+        data[:moonPhase]
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.today.moon_phase_text #=> textual representation of moon phase
+      # @since 0.1.3
+      # @return [String] textual representation of moon phase
+      def moon_phase_text
+        # separate method for easy unit testing
+        _moon_phase_text moon_phase
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.today.precip_intensity #=> precipitation intensity on day
+      # @since 0.1.3
+      # @return [Numeric] precipitation intensity on day
+      def precip_intensity
+        data[:precipIntensity]
+      end
+
+      # @example
+      #   location = DarkSky::Locaiton.new [45, -90]
+      #   location.today.precip_intensity_text #=> text representation of precipitation intensity on day
+      # @since 0.1.3
+      # @return [String] text representation of precipitation intensity on day
+      def precip_intensity_text
+        if precip_intensity >= 0.400
+          'heavy'
+        elsif precip_intensity >= 0.100
+          'moderate'
+        elsif precip_intensity >= 0.017
+          'light'
+        elsif precip_intensity >= 0.002
+          'very light'
+        end
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.today.precip_intensity_max #=> precipitation intensity on day
+      # @since 0.1.3
+      # @return [Numeric] maximum precipitation intensity on day
+      def precip_intensity_max
+        data[:precipIntensityMax]
+      end
+
+      # @example
+      #   location = DarkSky::Locaiton.new [45, -90]
+      #   location.today.precip_intensity_max_text #=> text representation of maximum precipitation intensity on day
+      # @since 0.1.3
+      # @return [String] text representation of maximum precipitation intensity on day
+      def precip_intensity_max_text
+        if precip_intensity_max >= 0.400
+          'heavy'
+        elsif precip_intensity_max >= 0.100
+          'moderate'
+        elsif precip_intensity_max >= 0.017
+          'light'
+        elsif precip_intensity_max >= 0.002
+          'very light'
+        end
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.today.precip_intensity_max_time #=> object of max time
+      # @since 0.1.3
+      # @return [Time] time of maximum precipitation intensity
+      def precip_intensity_max_time
+        Time.at data[:precipIntensityMaxTime] if data[:precipIntensityMaxTime]
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.today.precip_probability #=> precipitation probability on day
+      # @since 0.1.3
+      # @return [Numeric] precipitation probability
+      def precip_probability
+        data[:precipProbability]
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.today.precip_type #=> precipitation type on day
+      # @since 0.1.3
+      # @return [String | nil] current precipitation type on day
+      def precip_type
+        data[:precipType]
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.today.precip_accumulation #=> precipitation accumulation on day
+      # @since 0.1.3
+      # @return [Numeric] precipitation accumulation on day
+      def precip_accumulation
+        data[:precipAccumulation]
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.today.apparent_temperature_high #=> high feels like on day
+      # @since 0.1.3
+      # @return [Numeric] high feels like on day
+      def apparent_temperature_high
+        data[:apparentTemperatureHigh]
+      end
+      alias high_apparent_temperature apparent_temperature_high
+      alias apparent_high_temperature apparent_temperature_high
+      alias high_feels_like apparent_temperature_high
+      alias feels_like_high apparent_temperature_high
+      alias high_heat_index apparent_temperature_high
+      alias heat_index_high apparent_temperature_high
+      alias high_wind_chill apparent_temperature_high
+      alias wind_chill_high apparent_temperature_high
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.today.apparent_temperature_low #=> low feels like on day
+      # @since 0.1.3
+      # @return [Numeric] low feels like on day
+      def apparent_temperature_low
+        data[:apparentTemperatureLow]
+      end
+      alias low_apparent_temperature apparent_temperature_low
+      alias apparent_low_temperature apparent_temperature_low
+      alias low_feels_like apparent_temperature_low
+      alias feels_like_low apparent_temperature_low
+      alias low_heat_index apparent_temperature_low
+      alias heat_index_low apparent_temperature_low
+      alias low_wind_chill apparent_temperature_low
+      alias wind_chill_low apparent_temperature_low
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.today.apparent_temperature_high_time #=> time of high apparent temperature
+      # @since 0.1.3
+      # @return [Numeric] time of high apparent temperature
+      def apparent_temperature_high_time
+        data[:apparentTemperatureHighTime]
+      end
+      alias high_apparent_temperature_time apparent_temperature_high_time
+      alias apparent_high_temperature_time apparent_temperature_high_time
+      alias high_feels_like_time apparent_temperature_high_time
+      alias feels_like_high_time apparent_temperature_high_time
+      alias high_heat_index_time apparent_temperature_high_time
+      alias heat_index_high_time apparent_temperature_high_time
+      alias high_wind_chill_time apparent_temperature_high_time
+      alias wind_chill_high_time apparent_temperature_high_time
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.today.apparent_temperature_low_time #=> time of low apparent temperature
+      # @since 0.1.3
+      # @return [Numeric] time of low apparent temperature
+      def apparent_temperature_low_time
+        data[:apparentTemperatureLowTime]
+      end
+      alias low_apparent_temperature_time apparent_temperature_low_time
+      alias apparent_low_temperature_time apparent_temperature_low_time
+      alias low_feels_like_time apparent_temperature_low_time
+      alias feels_like_low_time apparent_temperature_low_time
+      alias low_heat_index_time apparent_temperature_low_time
+      alias heat_index_low_time apparent_temperature_low_time
+      alias low_wind_chill_time apparent_temperature_low_time
+      alias wind_chill_low_time apparent_temperature_low_time
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.today.dew_point #=> dew point on day
+      # @since 0.1.3
+      # @return [Numeric] dew point on day
+      def dew_point
+        data[:dewPoint]
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.today.humidity #=> humidity on day
+      # @since 0.1.3
+      # @return [Numeric] humidity on day
+      def humidity
+        data[:humidity]
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.today.pressure #=> barometric pressue on day
+      # @since 0.1.3
+      # @return [Numeric] barometric pressure on day
+      def pressure
+        data[:pressure]
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.today.wind_speed #=> wind speed on day
+      # @since 0.1.3
+      # @return [Numeric] wind speed on day
+      def wind_speed
+        data[:windSpeed]
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.today.wind_gust #=> wind gust on day
+      # @since 0.1.3
+      # @return [Numeric] wind gust on day
+      def wind_gust
+        data[:windGust]
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.today.wind_gust_time #=> wind gust time on day
+      # @since 0.1.3
+      # @return [Time] wind gust time on day
+      def wind_gust_time
+        Time.at data[:windGustTime]
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.today.wind_bearing #=> wind bearing on day
+      # @since 0.1.3
+      # @return [Numeric] wind bearing on day
+      def wind_bearing
+        data[:windBearing]
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.today.cloud_cover #=> cloud cover on day
+      # @since 0.1.3
+      # @return [Numeric] cloud cover on day
+      def cloud_cover
+        data[:cloudCover]
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.today.uv_index #=> UV index on day
+      # @since 0.1.3
+      # @return [Numeric] UV index on day
+      def uv_index
+        data[:uvIndex]
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.today.uv_index_time #=> max UV index time on day
+      # @since 0.1.3
+      # @return [Time] max UV index time on day
+      def uv_index_time
+        Time.at data[:uvIndexTime]
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.today.visibility #=> visibility on day
+      # @since 0.1.3
+      # @return [Numeric] visibility on day
+      def visibility
+        data[:visibility]
+      end
+
+      # @example
+      #   location = DarkSky::Location.new [45, -90]
+      #   location.today.ozone #=> ozone on day
+      # @since 0.1.3
+      # @return [Numeric] ozone on day
+      def ozone
+        data[:ozone]
+      end
+
+      private
+
+      # helper to avoid typing this many times over
+      # @since 0.1.3
+      # @return [Hash] full data for the given day
+      def data
+        @location.full_data[:daily][:data][@days_from_current]
+      end
+
+      # convert numerical moon phase to text
+      # 10% around each phase (new, first quarter, full, last quarter)
+      # keep this a separate method for testing purposes
+      # @since 0.1.3
+      # @return [String] text representation of moon phase
+      def _moon_phase_text(phase) # rubocop:disable Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity, Metrics/LineLength
+        if phase < 0.05
+          'new moon'
+        elsif phase < 0.20
+          'waxing crescent moon'
+        elsif phase < 0.30
+          'first quarter moon'
+        elsif phase < 0.45
+          'waxing gibbous moon'
+        elsif phase < 0.55
+          'full moon'
+        elsif phase < 0.70
+          'waning gibbous moon'
+        elsif phase < 0.80
+          'last quarter moon'
+        elsif phase < 0.95
+          'waning crescent moon'
+        else
+          'new moon'
+        end
+      end
+    end
+
+    # @example
+    #   location = DarkSky::Location.new [45, -90]
+    #   location.today #=> DarkSky::Location::Day
+    # @since 0.1.3
+    # @return [Day] class containing data for given day
+    def today
+      Day.new self, 0
+    end
+    alias in_0_days today
+
+    # @example
+    #   location = DarkSky::Location.new [45, -90]
+    #   location.tomorrow #=> DarkSky::Location::Day
+    # @since 0.1.3
+    # @return [Day] class containing data for given day
+    def tomorrow
+      Day.new self, 1
+    end
+    alias in_1_day tomorrow
+
+    # @example
+    #   location = DarkSky::Location.new [45, -90]
+    #   location.in_2_days #=> DarkSky::Location::Day
+    # @since 0.1.3
+    # @return [Day] class containing data for given day
+    def in_2_days
+      Day.new self, 2
+    end
+
+    # @example
+    #   location = DarkSky::Location.new [45, -90]
+    #   location.in_3_days #=> DarkSky::Location::Day
+    # @since 0.1.3
+    # @return [Day] class containing data for given day
+    def in_3_days
+      Day.new self, 3
+    end
+
+    # @example
+    #   location = DarkSky::Location.new [45, -90]
+    #   location.in_4_days #=> DarkSky::Location::Day
+    # @since 0.1.3
+    # @return [Day] class containing data for given day
+    def in_4_days
+      Day.new self, 4
+    end
+
+    # @example
+    #   location = DarkSky::Location.new [45, -90]
+    #   location.in_5_days #=> DarkSky::Location::Day
+    # @since 0.1.3
+    # @return [Day] class containing data for given day
+    def in_5_days
+      Day.new self, 5
+    end
+
+    # @example
+    #   location = DarkSky::Location.new [45, -90]
+    #   location.in_6_days #=> DarkSky::Location::Day
+    # @since 0.1.3
+    # @return [Day] class containing data for given day
+    def in_6_days
+      Day.new self, 6
+    end
+
+    # @example
+    #   location = DarkSky::Location.new [45, -90]
+    #   location.in_7_days #=> DarkSky::Location::Day
+    # @since 0.1.3
+    # @return [Day] class containing data for given day
+    def in_7_days
+      Day.new self, 7
+    end
+  end
+end

data/lib/darksky-api/location.rb

@@ -0,0 +1,94 @@
+require 'rest-client'
+require 'json'
+
+module DarkSky
+  class Location
+    # @example
+    #   location = DarkSky::Location.new [45, -90]
+    #   location.location #=> [45, -90]
+    # @since 0.1.0
+    # @return [Array<Numeric>] coordinates of object and data
+    attr_reader :location
+
+    # @example
+    #   location = DarkSky::Location.new [45, -90]
+    #   location.current #=> DarkSky::Location::Current
+    # @since 0.1.0
+    # @return [Current] class containing data for current time and location
+    attr_reader :current
+
+    # @example
+    #   location = DarkSky::Location.new [45, -90]
+    #   location.units #=> :si
+    # @since 0.1.2
+    # @return [Symbol] what unit system is being used
+    attr_reader :units
+
+    # @example
+    #   location = DarkSky::Location.new [45, -90]
+    #   location.language #=> :en
+    # @since 0.1.2
+    # @return [Symbol] what language is used
+    attr_reader :language
+
+    # @example getter
+    #   location = DarkSky::Location.new [45, -90]
+    #   location.cache_duration #=> 300
+    # @example setter
+    #   location = DarkSky::Location.new [45, -90]
+    #   location.cache_duration = 600
+    #   location.cache_duration #=> 600
+    # @since 0.1.0
+    # @return [Numeric] how long is data valid for before a new request is made?
+    attr_accessor :cache_duration
+
+    # @param location [[Numeric, Numeric]] coordinates to get data of
+    # @param [Numeric] cache_duration requests within this many seconds will be parsed on existing data
+    # @param [Symbol | String] units what unit system to use
+    # @param [Symbol | String] language what language to return results in
+    def initialize(
+      location = [0, 0],
+      cache_duration: 300,
+      units: :auto,
+      language: :en
+    )
+      # initial value to avoid errors
+      @cache_time = 1
+
+      # initialize instance variables from args & kwargs
+      @location = location
+      @cache_duration = cache_duration # in seconds
+      @language = language.to_sym
+
+      # aliases for some unit systems
+      units = units.to_sym
+      if units == :uk
+        @units == :uk2
+      elsif units == :canada
+        @units == :ca
+      else
+        @units = units
+      end
+
+      # initialize classes for namespace
+      @current = Current.new self
+    end
+
+    # update cache if necessary and get latest data
+    # @example
+    #   location = DarkSky::Location.new
+    #   location.full_data
+    # @since 0.1.0
+    # @return [Hash] raw data (in full) from DarkSky
+    def full_data
+      if (Time.now - @cache_time).to_i >= @cache_duration
+        response = RestClient.get "https://api.darksky.net/forecast/#{DarkSky.key}/#{@location.join ','}",
+                                  units: @units,
+                                  language: @language
+        @data = JSON.parse response.body, symbolize_names: true
+        @cache_time = Time.now
+      end
+      @data
+    end
+  end
+end

data/lib/darksky-api/version.rb

@@ -0,0 +1,4 @@
+module DarkSky
+  # version of this library (follows SemVer)
+  VERSION = '0.1.3'.freeze
+end

metadata

@@ -0,0 +1,131 @@
+--- !ruby/object:Gem::Specification
+name: darksky-api
+version: !ruby/object:Gem::Version
+  version: 0.1.3
+platform: ruby
+authors:
+- Jacob Pratt
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2018-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+- !ruby/object:Gem::Dependency
+  name: rest-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+description: 
+email:
+- the.z.cuber@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rubocop.yml"
+- ".yardopts"
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- darksky-api.gemspec
+- lib/darksky-api.rb
+- lib/darksky-api/config.rb
+- lib/darksky-api/current.rb
+- lib/darksky-api/day.rb
+- lib/darksky-api/location.rb
+- lib/darksky-api/version.rb
+homepage: https://github.com/jhpratt/darksky-api
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.7.3
+signing_key: 
+specification_version: 4
+summary: Library for the public API on DarkSky.net
+test_files: []