adafruit-io 3.0.0 → 4.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0d3a797bff9e66a705fc31f4572f9158dde61f9253e5e3bf501b8d59adb6df5c
-  data.tar.gz: 40ad6e3b91d36b1b977584224c7c62448aa924aa78a8dc46beda1d58368d98f4
+  metadata.gz: a1d57d2998069e7dda6fd18ab4dac69cf1ce98d67e84568046118bda4bb14bf7
+  data.tar.gz: 6d31d21c4ff9186492d93202dc27a1359b935d5e33d8ee57d0f376c63a6ea33c
 SHA512:
-  metadata.gz: 56efae94520d3ba34ab840877dfa9e16c2a6fd852bba785adec2ab24ed5c0243ab7d2aefcef4f473caf218affe11cb1f1daf519cfb34407e3a1fb8248efb827c
-  data.tar.gz: a81845c9affa024284f07203d2c6dce47d442a531b216dcb139028c1b7e6ebf1918c75a2b89e813d58d95d17c8efa6a6934c6b6f803acc6afa7eed63fdb250c3
+  metadata.gz: 61b089f5f60170a8e2133c66f6db86ab631ab2820d302ad905ec26e1a0d65b9954a02682b264063580bbd7400d6c693d0880c4b5627b7877c706c5440d0da3d3
+  data.tar.gz: f38e367aabdd8e5f86edf645aea9697dbb248e229b2f4adbb6427f984ea2da1ea837cdbc09fe935534cac505a8822b2581cbb3c2933caa15494726739b915fdf

data/adafruit-io.gemspec

@@ -18,13 +18,11 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
   spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ["lib"]
+  spec.required_ruby_version = ">= 3.3"
   spec.licenses = ['MIT']
 
   spec.add_dependency "faraday", "~> 2.14"
-  spec.add_dependency "faraday-multipart", "~> 1.0"
-  spec.add_dependency "activesupport",  "~> 8.0"
   spec.add_dependency "mqtt", "~> 0.7"
 
-  spec.add_development_dependency "bundler", "~> 2.7"
   spec.add_development_dependency "rake", "~> 13.2"
 end

data/lib/adafruit/io/arguments.rb

@@ -1,18 +1,20 @@
+require 'adafruit/io/errors'
+
 module Adafruit
   module IO
     module Arguments
-      class ArgumentError < StandardError; end
-
       # Allows us to give a username during client initialization or with a specific method.
       def extract_username(args)
         username = @username
 
         if args.last.is_a?(Hash) && args.last.has_key?(:username)
-          username = args.last.delete(:username)
+          options = args.last.dup
+          username = options.delete(:username)
+          args = args[0...-1] + [options]
         end
 
         if username.nil?
-          raise "cannot make request when username is nil"
+          raise ArgumentError.new("cannot make request when username is nil")
         end
 
         [ username, args ]
@@ -34,10 +36,11 @@ module Adafruit
           record_or_key
         elsif record_or_key.is_a?(Hash) && (record_or_key.has_key?('key') || record_or_key.has_key?(:key))
           record_or_key['key'] || record_or_key[:key]
-        elsif record_or_key.respond_to?(:key)
+        elsif !record_or_key.is_a?(Hash) && record_or_key.respond_to?(:key)
+          # Hash#key(value) exists, so plain hashes must not land here
           record_or_key.key
         else
-          raise 'unrecognized object or key value in arguments'
+          raise ArgumentError.new('unrecognized object or key value in arguments')
         end
       end
 
@@ -53,18 +56,23 @@ module Adafruit
         elsif record_or_id.respond_to?(:id)
           record_or_id.id
         else
-          raise 'unrecognized object or id value in arguments'
+          raise ArgumentError.new('unrecognized object or id value in arguments')
         end
       end
 
-      # Get a filtered list of parameters from the next argument
+      # Get a filtered list of parameters from the next argument. Accepts
+      # either symbol or string keys.
       def get_query_from_arguments(arguments, params)
         query = {}
         options = arguments.shift
         return query if options.nil?
 
         params.each do |param|
-          query[param] = options[param.to_sym] if options.has_key?(param.to_sym)
+          if options.has_key?(param.to_sym)
+            query[param] = options[param.to_sym]
+          elsif options.has_key?(param.to_s)
+            query[param] = options[param.to_s]
+          end
         end
         query
       end

data/lib/adafruit/io/client/blocks.rb

@@ -38,12 +38,17 @@ module Adafruit
           delete api_url(username, 'dashboards', dashboard_key, 'blocks', block_id)
         end
 
-        # Update a block
+        # Update a block. Attributes can be given in the same hash as
+        # dashboard_key and key, or as a separate second hash:
+        #
+        #   client.update_block(dashboard_key: 'db', key: 1, name: 'new')
+        #   client.update_block({ dashboard_key: 'db', key: 1 }, { name: 'new' })
         def update_block(*args)
           username, arguments = extract_username(args)
           dashboard_key = require_argument(arguments, :dashboard_key)
+          options = arguments.first
           block_id = get_key_from_arguments(arguments)
-          block_attrs = valid_block_attrs(arguments)
+          block_attrs = valid_block_attrs(arguments.empty? ? [options] : arguments)
 
           put api_url(username, 'dashboards', dashboard_key, 'blocks', block_id), block_attrs
         end

data/lib/adafruit/io/client/data.rb

@@ -1,3 +1,5 @@
+require 'time'
+
 module Adafruit
   module IO
     class Client
@@ -53,7 +55,7 @@ module Adafruit
           values = arguments.shift
 
           if values.nil? || !values.is_a?(Array)
-            raise "expected batch values to be an array"
+            raise Adafruit::IO::Arguments::ArgumentError.new("expected batch values to be an array")
           end
 
           if !values.first.is_a?(Hash)

data/lib/adafruit/io/client/permissions.rb

@@ -2,7 +2,7 @@ module Adafruit
   module IO
     class Client
       module Permissions
-        VALID_TYPES = %(feed group dashboard)
+        VALID_TYPES = %w(feed group dashboard).freeze
 
         # Get all permissions for a resource.
         #
@@ -25,13 +25,18 @@ module Adafruit
           get api_url(username, pluralize_type(arguments[0]), arguments[1], 'acl', arguments[2])
         end
 
+        #   client.create_permission(TYPE, KEY, { scope: 'public', mode: 'r' })
         def create_permission(*args)
           username, arguments = extract_username(args)
 
           assert_argument_size(arguments, 2)
           assert_resource_type(arguments[0])
 
-          permission_attrs = arguments.pop
+          permission_attrs = arguments[2]
+          if !permission_attrs.is_a?(Hash)
+            raise Adafruit::IO::Arguments::ArgumentError.new('create_permission requires resource type (string), resource key (string), and a Hash of permission attributes, e.g. { scope: "public", mode: "r" }')
+          end
+
           post api_url(username, pluralize_type(arguments[0]), arguments[1], 'acl'), permission_attrs
         end
 

data/lib/adafruit/io/client/tokens.rb

@@ -20,9 +20,9 @@ module Adafruit
 
         # Create a token. No attributes need to be passed in.
         def create_token(*args)
-          username, arguments = extract_username(args)
+          username, _ = extract_username(args)
 
-          post api_url(username, 'tokens')
+          post api_url(username, 'tokens'), {}
         end
 
         def delete_token(*args)

data/lib/adafruit/io/client.rb

@@ -36,9 +36,7 @@ module Adafruit
       #
       # @return [String]
       def inspect
-        inspected = super
-        inspected = inspected.gsub! @key, "#{@key[0..3]}#{'*' * (@key.size - 3)}" if @key
-        inspected
+        "#<#{self.class.name} username=#{@username.inspect} api_endpoint=#{api_endpoint.inspect} key=#{masked_key.inspect}>"
       end
 
       def last_response
@@ -58,14 +56,19 @@ module Adafruit
 
       private
 
+      def masked_key
+        return nil if @key.nil?
+        return '*' * @key.size if @key.size <= 4
+
+        "#{@key[0..3]}#{'*' * (@key.size - 4)}"
+      end
+
       def conn
-        if api_endpoint
-          url = api_endpoint
-        else
-          url = 'https://io.adafruit.com'
-        end
+        settings = [api_endpoint, @key, @debug]
+        return @conn if @conn && @conn_settings == settings
 
-        Faraday.new(:url => url) do |c|
+        @conn_settings = settings
+        @conn = Faraday.new(:url => api_endpoint) do |c|
           c.headers['X-AIO-Key'] = @key
           c.headers['Accept'] = 'application/json'
           c.headers['User-Agent'] = "AdafruitIO-Ruby/#{VERSION} (#{RUBY_PLATFORM})"

data/lib/adafruit/io/errors.rb

@@ -0,0 +1,18 @@
+module Adafruit
+  module IO
+    class Error < StandardError; end
+
+    class RequestError < Error
+      attr_reader :response
+
+      def initialize(message, response)
+        super(message)
+        @response = response
+      end
+    end
+
+    module Arguments
+      class ArgumentError < Adafruit::IO::Error; end
+    end
+  end
+end

data/lib/adafruit/io/mqtt.rb

@@ -1,4 +1,5 @@
 require 'mqtt'
+require 'adafruit/io/errors'
 
 #
 # Adafruit::IO::MQTT provides a simple Adafruit IO aware wrapper around the
@@ -65,7 +66,7 @@ module Adafruit
 
       # Publish value to feed with given key
       def publish(key, value, location={})
-        raise 'client is not connected' unless @client.connected?
+        raise Adafruit::IO::Error.new('client is not connected') unless @client.connected?
 
         topic = key_to_feed_topic(key)
         location = indifferent_keys(location)
@@ -83,8 +84,8 @@ module Adafruit
       #   location data for this publish event.
       #
       def publish_group(key, values, location={})
-        raise 'client is not connected' unless @client.connected?
-        raise 'values must be a hash' unless values.is_a?(Hash)
+        raise Adafruit::IO::Error.new('client is not connected') unless @client.connected?
+        raise Adafruit::IO::Arguments::ArgumentError.new('values must be a hash') unless values.is_a?(Hash)
 
         topic = key_to_group_topic(key, false)
         location = indifferent_keys(location)
@@ -99,7 +100,7 @@ module Adafruit
       # Include the { last_value: true } option if you'd like the feed to
       # receive the last value immediately. (like MQTT retain)
       def subscribe(key, options={})
-        raise 'client is not connected' unless @client.connected?
+        raise Adafruit::IO::Error.new('client is not connected') unless @client.connected?
 
         topic = key_to_feed_topic(key)
         @client.subscribe(topic)
@@ -110,7 +111,7 @@ module Adafruit
       end
 
       def unsubscribe(key)
-        raise 'client is not connected' unless @client.connected?
+        raise Adafruit::IO::Error.new('client is not connected') unless @client.connected?
 
         topic = key_to_feed_topic(key)
         @client.unsubscribe(topic)
@@ -123,7 +124,7 @@ module Adafruit
       # JSON object whose keys are feed keys and whose values are the last
       # value received for that feed.
       def subscribe_group(key)
-        raise 'client is not connected' unless @client.connected?
+        raise Adafruit::IO::Error.new('client is not connected') unless @client.connected?
 
         topic = key_to_group_topic(key)
         @client.subscribe(topic)
@@ -176,7 +177,7 @@ module Adafruit
       def payload_from_value_with_location(value, location)
         payload = { value: value.to_s }
 
-        if location.has_key?('lat') && location.has_key?['lon']
+        if location.has_key?('lat') && location.has_key?('lon')
           %w(lat lon ele).each do |f|
             payload[f] = location[f]
           end
@@ -188,7 +189,7 @@ module Adafruit
       def payload_from_values_with_location(values, location)
         payload = { feeds: values }
 
-        if location.has_key?('lat') && location.has_key?['lon']
+        if location.has_key?('lat') && location.has_key?('lon')
           payload[:location] = {}
 
           %w(lat lon ele).each do |f|

data/lib/adafruit/io/request_handler.rb

@@ -1,21 +1,13 @@
-require 'open-uri'
+require 'adafruit/io/errors'
 
 module Adafruit
   module IO
-    class RequestError < StandardError
-      attr_reader :response
-
-      def initialize(message, response)
-        super(message)
-        @response = response
-      end
-    end
-
     module RequestHandler
 
       attr_reader :last_response, :pagination
 
-      def request(method, url, data = nil, options = nil)
+      def request(method, url, data = nil)
+        @pagination = nil
         @last_response = send(method, url, data)
       end
 
@@ -23,15 +15,15 @@ module Adafruit
         request(:handle_get, url, options)
       end
 
-      def post(url, data, options = {})
-        request :handle_post, url, data, options
+      def post(url, data)
+        request :handle_post, url, data
       end
 
-      def put(url, data, options = {})
-        request :handle_put, url, data, options
+      def put(url, data)
+        request :handle_put, url, data
       end
 
-      def delete(url, options = {})
+      def delete(url)
         request :handle_delete, url
       end
 
@@ -44,27 +36,25 @@ module Adafruit
       def update_pagination(response)
         @pagination = nil
 
-        if pagination_keys = response.headers.keys.grep(/x-pagination-/i)
-          @pagination = {}
-          pagination_keys.each do |k|
-            @pagination[k.gsub(/x-pagination-/i, '')] = response.headers[k]
-          end
+        pagination_keys = response.headers.keys.grep(/x-pagination-/i)
+        return if pagination_keys.empty?
+
+        @pagination = {}
+        pagination_keys.each do |k|
+          @pagination[k.gsub(/x-pagination-/i, '')] = response.headers[k]
         end
       end
 
+      # Faraday's :json middleware already parses responses with a JSON
+      # content type. Only try to parse bodies it left as strings.
       def parsed_response(response)
-        if response.respond_to?(:data)
-          response.data
-        else
-          begin
-            json = JSON.parse(response.body)
-          rescue => ex
-            if @debug
-              puts "ERROR PARSING JSON: #{ex.message}"
-              puts ex.backtrace[0..5].join("\n")
-            end
-            response.body
-          end
+        body = response.body
+        return body unless body.is_a?(String)
+
+        begin
+          JSON.parse(body)
+        rescue JSON::ParserError
+          body
         end
       end
 
@@ -85,7 +75,7 @@ module Adafruit
         end
       end
 
-      def handle_post(url, data, options = {})
+      def handle_post(url, data)
         response = conn.post do |req|
           req.url url
           req.body = data
@@ -98,7 +88,7 @@ module Adafruit
         end
       end
 
-      def handle_put(url, data, options = {})
+      def handle_put(url, data)
         response = conn.put do |req|
           req.url url
           req.body = data
@@ -111,17 +101,13 @@ module Adafruit
         end
       end
 
-      def handle_delete(url, options = {})
+      def handle_delete(url, _data = nil)
         response = conn.delete do |req|
           req.url url
         end
 
         if response.status < 200 || response.status > 299
-          if response.status === 404
-            nil
-          else
-            raise Adafruit::IO::RequestError.new("DELETE error: #{ response.body }", response)
-          end
+          raise Adafruit::IO::RequestError.new("DELETE error: #{ response.body }", response)
         else
           parsed_response response
         end

data/lib/adafruit/io/version.rb

@@ -1,5 +1,5 @@
 module Adafruit
   module IO
-    VERSION = "3.0.0"
+    VERSION = "4.0.0"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: adafruit-io
 version: !ruby/object:Gem::Version
-  version: 3.0.0
+  version: 4.0.0
 platform: ruby
 authors:
 - Justin Cooper
 - Adam Bachman
 bindir: bin
 cert_chain: []
-date: 2025-11-10 00:00:00.000000000 Z
+date: 2026-11-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -24,34 +24,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.14'
-- !ruby/object:Gem::Dependency
-  name: faraday-multipart
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.0'
-- !ruby/object:Gem::Dependency
-  name: activesupport
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '8.0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '8.0'
 - !ruby/object:Gem::Dependency
   name: mqtt
   requirement: !ruby/object:Gem::Requirement
@@ -66,20 +38,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.7'
-- !ruby/object:Gem::Dependency
-  name: bundler
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.7'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.7'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -119,6 +77,7 @@ files:
 - lib/adafruit/io/client/triggers.rb
 - lib/adafruit/io/client/user.rb
 - lib/adafruit/io/configurable.rb
+- lib/adafruit/io/errors.rb
 - lib/adafruit/io/mqtt.rb
 - lib/adafruit/io/request_handler.rb
 - lib/adafruit/io/version.rb
@@ -133,7 +92,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '3.3'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="