open_weather_client 0.1.6 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4dab7c6f40c34f79492bbb71dd0cd6257bbf42da8398975d6cf93f9ab63a4175
-  data.tar.gz: 7d3bcfafce03716cfac19f8e823ae8a7baa37a742e8cfe0c442ae4880b3cf534
+  metadata.gz: c6d4db65e59ab7bde82a64f2b3da01fbd80cc1e5f4acf7b5084d9dc7ec7db89e
+  data.tar.gz: 43b2bb7361f68e91b23e022703cf2ba436f8cea7734dd7495d9f6a31a6cc8215
 SHA512:
-  metadata.gz: 3c3cf0422a523d2979fd17d9853801a170ee3adbe2153cf78927a6bd3aa7d691119e44bc2fe152a06ca4d938285cb96b36514efed769b69e28fd837d21e905c1
-  data.tar.gz: a166b3018ef7d395216ad1cbeeabe9a50dc5899d17a98b651502219c13b409d0e523d1af8d255b24b710fa2b75d24bdeda9677e3fb472d745507b8eafd0ccd63
+  metadata.gz: 880007ce334e68cacac086112242a304c081a5535e593589e6797f48d1d3061247cc51f8663deb750e20816978e3b5947d44a466c85d3fe5145c999e5e83676a
+  data.tar.gz: f2fdabce1f5d502b41e0cc2c97c8f7efc0d0e121dd8f38fe9465008f3799436efd19bbe81a7c87dadc066e025832149923dd2b563c7a37c7e48eb41e29cd4dc2

data/.github/workflows/ruby.yml

@@ -18,7 +18,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        ruby-version: ['3.0', '3.2']
+        ruby-version: ['2.6', '2.7', '3.0', '3.2', '3.3']
 
     steps:
     - uses: actions/checkout@v3

data/.rubocop.yml

@@ -1,5 +1,5 @@
 AllCops:
-  TargetRubyVersion: 3.0
+  TargetRubyVersion: 2.6
 
 Metrics/BlockLength:
   Exclude:

data/CHANGES.md

@@ -2,6 +2,9 @@
 
 ## [Unreleased]
 
+## 0.2.0
+- Upgrade to Open Weather One Call API 3.0 through configuration option (#8)
+
 ## 0.1.6
 - Relax required Ruby Version
 

data/README.md

@@ -4,7 +4,7 @@
 ![RSpec](https://github.com/qurasoft/open_weather_client/actions/workflows/ruby.yml/badge.svg)
 
 Welcome to Open Weather Client.
-This gem allows you to easily request weather information from OpenWeatherMap.
+This gem allows you to easily request weather information from Open Weather.
 It integrates in your rails project, when you are using bundler or even in plain ruby projects.
 
 ## Installation
@@ -24,7 +24,7 @@ Or install it yourself as:
     $ gem install open_weather_client
 
 ## Usage
-During configuration the OpenWeatherMap API key must be set. Afterwards it is as simple as calling `OpenWeatherClient.current(lat:, lon:)` to get the current weather at a location.
+During configuration the Open Weather API key must be set. Afterwards it is as simple as calling `OpenWeatherClient.current(lat:, lon:)` to get the current weather at a location.
 
 ```ruby
 # OpenWeatherClient initializer
@@ -36,13 +36,32 @@ end
 OpenWeatherClient::Weather.current(lat: 50.3569, lon: 7.5890)
 ```
 
+### Used Open Weather API version
+Open Weather provides One Call API 3.0 and API 2.5, which is expected to be deprecated in June 2024.
+Until API 2.5 is deprecated it is the default. With Open Weather Client version 1.0 the default will change to One Call API 3.0.
+
+The used API version is configurable through `OpenWeatherClient.configuration.api_version`.
+
+```ruby
+# OpenWeatherClient initializer
+OpenWeatherClient.configure do |config|
+  config.api_version = :v25 # (default) also supports :v30
+end
+```
+
 ### Exceptions during requests
 When an error occurs during a request, an exception is raised.
-If the request is not authorized `OpenWeatherClient::AutheniticationError` is raied.
-When attributes like latitude or longitude are outside of the expected range a `RangeError` is raised.
+
+If the configured API version is not supported by the client, `OpenWeatherClient::APIVersionNotSupportedError` is raised.
+If the request is not authorized, `OpenWeatherClient::AutheniticationError` is raised.
+If attributes like latitude or longitude are outside of the expected range, `RangeError` is raised.
+If the time is longer in the past than one hour, `OpenWeatherClient::NotCurrentError` is raised.
 
 ### Secure Configuration
-In Rails provides the credentials functionality for [environmental security](https://edgeguides.rubyonrails.org/security.html#environmental-security). This mechanism can be used by OpenWeatherClient to load the API key from an encrypted file. This also allows easy separation of production and development channel configuration.
+Rails provides the credentials functionality for [environmental security](https://edgeguides.rubyonrails.org/security.html#environmental-security).
+This mechanism can be used by OpenWeatherClient to load the API key from an encrypted file.
+This also allows easy separation of production and development api key configuration.
+
 All settings are defined under the top-level entry `open_weather_client`.
 ```yaml
 # $ bin/rails credentials:edit
@@ -50,7 +69,7 @@ open_weather_client:
   appid: "<INSERT OPENWEATHERMAP API KEY HERE>"
 ```
 
-After configuration of the credentials you can load the settings in your initializer with `#load_from_rails_configuration`.
+After configuring the credentials, they can be loaded in the initializer with `#load_from_rails_configuration`.
 
 ```ruby
 # OpenWeatherClient initializer

data/bin/console

@@ -13,11 +13,10 @@ require 'open_weather_client'
 
 OpenWeatherClient.configure do |config|
   if File.exist?('config.yml')
-    # NOTE(Keune): The channels available in the console can be set in the file channels.yml. It contains a simple
-    # mapping of channel identifiers to webhook URLs. The channel identifier is loaded as a symbol.
+    # NOTE(Keune): The console automatically loads the appid from the config.yml file in the same directory
     #
     # Example: APPID: "<INSERT YOUR WEBHOOK URL HERE>"
-    puts 'Load channels specified by file'
+    puts 'Load appid specified by file'
 
     require 'yaml'
     settings = YAML.load_file 'config.yml'

data/lib/open_weather_client/caching/memory.rb

@@ -9,9 +9,9 @@ module OpenWeatherClient
     # When the limit is reached the least recently used entry is evicted.
     class Memory < OpenWeatherClient::Caching
       # Memory cache to store a hash of keys and request data
-      attr :memory_cache
+      attr_reader :memory_cache
       # Key registry of the memory cache. The first entry is the key of the least recently accessed data
-      attr :memory_keys
+      attr_reader :memory_keys
 
       ##
       # Initialize an empty cache

data/lib/open_weather_client/configuration.rb

@@ -4,6 +4,8 @@ module OpenWeatherClient
   ##
   # Configuratin of OpenWeatherClient
   class Configuration
+    # [String] Used api version. One of :v25, :v30. Default :v25
+    attr_accessor :api_version
     # [String] API key to access OpenWeatherMap
     attr_accessor :appid
     # Caching method. One of :none, :memory
@@ -24,6 +26,7 @@ module OpenWeatherClient
     ##
     # Initialize a new Configuration with the default settings
     def initialize
+      @api_version = :v25
       @caching = OpenWeatherClient::Caching.new
       @lang = 'de'
       @max_memory_entries = 10_000

data/lib/open_weather_client/request.rb

@@ -13,6 +13,7 @@ module OpenWeatherClient
     # @param lon[Float] longitude of the requests location
     # @param time[Time] time of the request
     #
+    # @raise [APIVersionNotSupportedError] if the configured api version is not supported
     # @raise [AuthenticationError] if the request is not authorized, e.g in case the API key is not correct
     # @raise [NotCurrentError] if the requested time is older than 1 hour
     #
@@ -21,7 +22,7 @@ module OpenWeatherClient
       raise OpenWeatherClient::NotCurrentError if time < Time.now - 1 * 60 * 60
 
       begin
-        response = connection(lat, lon).get('2.5/weather')
+        response = connection(lat, lon).get(path)
         OpenWeatherClient.cache.store(lat: lat, lon: lon, data: response.body, time: time)
       rescue Faraday::UnauthorizedError
         raise OpenWeatherClient::AuthenticationError
@@ -54,5 +55,16 @@ module OpenWeatherClient
         units: OpenWeatherClient.configuration.units
       }
     end
+
+    def self.path
+      case OpenWeatherClient.configuration.api_version
+      when :v25
+        '2.5/weather'
+      when :v30
+        '3.0/onecall'
+      else
+        raise OpenWeatherClient::APIVersionNotSupportedError
+      end
+    end
   end
 end

data/lib/open_weather_client/version.rb

@@ -3,5 +3,5 @@
 module OpenWeatherClient
   ##
   # Version of OpenWeatherClient
-  VERSION = '0.1.6'
+  VERSION = '0.2.0'
 end

data/lib/open_weather_client.rb

@@ -9,10 +9,13 @@ require 'open_weather_client/weather'
 ##
 # Get weather data from OpenWeatherMap
 module OpenWeatherClient
+  # The configured Open Weather API Version is not supported
+  class APIVersionNotSupportedError < StandardError; end
+
   # Error during authentication with the OpenWeatherMap servers
   class AuthenticationError < StandardError; end
 
-  # The rquested time is not current enough for getting weather data from the OpenWeatherMap server
+  # The requested time is not current enough for getting weather data from the OpenWeatherMap server
   class NotCurrentError < StandardError; end
 
   class << self

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: open_weather_client
 version: !ruby/object:Gem::Version
-  version: 0.1.6
+  version: 0.2.0
 platform: ruby
 authors:
 - Lucas Keune
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-03-01 00:00:00.000000000 Z
+date: 2024-04-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday