homie-mqtt 1.4.1 → 1.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 000cc1744d0e9520830ebd44954dd56f68e571803bf82539f3ca47a1d89c6bdf
-  data.tar.gz: 28c8a7530bda1c962c30918c13bdf9cffa71a99f070833959541dfde9806802b
+  metadata.gz: 8552d2aca44043208c3b3cd06fff9d5376515103d7de423926713441acecd6e0
+  data.tar.gz: a27b5fe2fe50e2975708c308ed9a0f9b5b7d2469667741fe092210adcda8582a
 SHA512:
-  metadata.gz: '02591ff555e0ff41b4b5476bef010da8b5ff6e3e5d665c1f22c6a5b02f85e023ad53f243d04748dd4a186c4e212b81071b89925f1a0932dac7fb1098657e1843'
-  data.tar.gz: 873266a8d592ad4bc47b4e2a4639b599709c0a98b22756477f9683b4a7450b54ebf3f1b60380a1462d5176749ea56cdd69367c7e086b74cb8173910bac7dde57
+  metadata.gz: b10c773d61781b4fb2e5595056e1b5e41373ec579bcf0a152f0c5dc763c3973ad09914964caaaf9c619b079e6cf15f4dc923122caf214f571741b8b6934a8317
+  data.tar.gz: dd8069070124dea54d81f3fc0095b9cce1d28d77ed655d7162182c0a11cdfecbb93cc40c97ea3778b3ebd35508cf960fdfcdd2594cac87f3621fdf11e64845c0

data/lib/homie-mqtt.rb

@@ -4,13 +4,13 @@ module MQTT
   module Homie
     class << self
       def escape_id(id)
-        id.downcase.gsub(/[^a-z0-9\-]/, '-').sub(/^[^a-z0-9]+/, '')
+        id.downcase.gsub(/[^a-z0-9\-]/, "-").sub(/^[^a-z0-9]+/, "")
       end
     end
   end
 end
 
-require 'mqtt/homie/base'
-require 'mqtt/homie/device'
-require 'mqtt/homie/node'
-require 'mqtt/homie/property'
+require "mqtt/homie/base"
+require "mqtt/homie/device"
+require "mqtt/homie/node"
+require "mqtt/homie/property"

data/lib/mqtt/homie/base.rb

@@ -9,18 +9,19 @@ module MQTT
 
       def initialize(id, name)
         raise ArgumentError, "Invalid Homie ID '#{id}'" unless id.is_a?(String) && id =~ Regexp.new("^#{REGEX}$")
+
         @id = id
         @name = name
       end
 
       def name=(value)
-        if name != value
-          name = value
-          if @published
-            device.init do
-              mqtt.publish("#{topic}/$name", name, retain: true, qos: 1)
-            end
-          end
+        return if name == value
+
+        name = value
+        return unless @published
+
+        device.init do
+          mqtt.publish("#{topic}/$name", name, retain: true, qos: 1)
         end
       end
     end

data/lib/mqtt/homie/device.rb

@@ -1,28 +1,31 @@
 # frozen_string_literal: true
 
-require 'mqtt'
+require "mqtt"
+require "ruby2_keywords"
 
 module MQTT
   module Homie
     class Device < Base
+      # the Homie spec version
+      VERSION = "4.0.0"
+
       attr_reader :root_topic, :state, :mqtt
+      attr_accessor :logger, :out_of_band_topic_proc
 
       def initialize(id, name, root_topic: nil, mqtt: nil, clear_topics: true, &block)
         super(id, name)
-        @root_topic = @root_topic || "homie"
+        @root_topic = root_topic || "homie"
         @state = :init
         @nodes = {}
         @published = false
-        @block = block
+        @out_of_band_topic_proc = block
         mqtt = MQTT::Client.new(mqtt) if mqtt.is_a?(String)
         @mqtt = mqtt || MQTT::Client.new
         @mqtt.set_will("#{topic}/$state", "lost", retain: true, qos: 1)
 
         @mqtt.on_reconnect do
           each do |node|
-            node.each do |property|
-              property.subscribe
-            end
+            node.each(&:subscribe)
           end
           mqtt.publish("#{topic}/$state", :init, retain: true, qos: 1)
           mqtt.publish("#{topic}/$state", state, retain: true, qos: 1) unless state == :init
@@ -32,6 +35,10 @@ module MQTT
         self.clear_topics if clear_topics
       end
 
+      def inspect
+        "#<MQTT::Homie::Device #{topic} name=#{name.inspect}, $state=#{state.inspect}>"
+      end
+
       def device
         self
       end
@@ -40,11 +47,11 @@ module MQTT
         "#{root_topic}/#{id}"
       end
 
-      def node(id, *args, **kwargs)
+      ruby2_keywords def node(id, *args)
         raise ArgumentError, "Node '#{id}' already exists" if @nodes.key?(id)
 
         init do |prior_state|
-          node = Node.new(self, id, *args, **kwargs)
+          node = Node.new(self, id, *args)
 
           @nodes[id] = node
           yield node if block_given?
@@ -58,6 +65,7 @@ module MQTT
 
       def remove_node(id)
         return false unless (node = @nodes[id])
+
         init do
           node.unpublish
           @nodes.delete(id)
@@ -74,11 +82,15 @@ module MQTT
         @nodes.each_value(&block)
       end
 
+      def count
+        @nodes.count
+      end
+
       def publish
         return if @published
 
         mqtt.batch_publish do
-          mqtt.publish("#{topic}/$homie", "4.0.0", retain: true, qos: 1)
+          mqtt.publish("#{topic}/$homie", VERSION, retain: true, qos: 1)
           mqtt.publish("#{topic}/$name", name, retain: true, qos: 1)
           mqtt.publish("#{topic}/$state", @state.to_s, retain: true, qos: 1)
 
@@ -87,12 +99,13 @@ module MQTT
             Thread.current.report_on_exception = false
 
             mqtt.get do |packet|
+              logger&.debug("received packet at #{packet.topic} with payload #{packet.payload.inspect}")
               match = packet.topic.match(topic_regex)
               node = @nodes[match[:node]] if match
               property = node[match[:property]] if node
 
               unless property&.settable?
-                @block&.call(topic, packet.payload)
+                @out_of_band_topic_proc&.call(packet.topic, packet.payload)
                 next
               end
 
@@ -102,6 +115,9 @@ module MQTT
 
           mqtt.publish("#{topic}/$nodes", @nodes.keys.join(","), retain: true, qos: 1)
           @nodes.each_value(&:publish)
+
+          yield if block_given?
+
           mqtt.publish("#{topic}/$state", (@state = :ready).to_s, retain: true, qos: 1)
         end
 
@@ -122,17 +138,15 @@ module MQTT
       end
 
       def init
-        if state == :init
-          return yield state
-        end
+        return yield state if state == :init
 
         prior_state = state
-        mqtt.publish("#{topic}/$state", (state = :init).to_s, retain: true, qos: 1)
+        mqtt.publish("#{topic}/$state", (self.state = :init).to_s, retain: true, qos: 1)
         result = nil
         mqtt.batch_publish do
           result = yield prior_state
         end
-        mqtt.publish("#{topic}/$state", (state = :ready).to_s, retain: true, qos: 1)
+        mqtt.publish("#{topic}/$state", (self.state = :ready).to_s, retain: true, qos: 1)
         result
       end
 
@@ -141,7 +155,7 @@ module MQTT
 
         @mqtt.subscribe("#{topic}/#")
         @mqtt.unsubscribe("#{topic}/#", wait_for_ack: true)
-        while !@mqtt.queue_empty?
+        until @mqtt.queue_empty?
           packet = @mqtt.get
           @mqtt.publish(packet.topic, retain: true, qos: 0)
         end

data/lib/mqtt/homie/node.rb

@@ -13,14 +13,25 @@ module MQTT
         @published = false
       end
 
+      def inspect
+        "#<MQTT::Homie::Node #{topic} name=#{full_name.inspect}, type=#{type.inspect}>"
+      end
+
+      def full_name
+        return name if device.count == 1
+
+        "#{device.name} #{name}"
+      end
+
       def topic
         "#{device.topic}/#{id}"
       end
 
-      def property(*args, **kwargs, &block)
+      ruby2_keywords def property(*args, &block)
         device.init do |prior_state|
-          property = Property.new(self, *args, **kwargs, &block)
+          property = Property.new(self, *args, &block)
           raise ArgumentError, "Property '#{property.id}' already exists on '#{id}'" if @properties.key?(property.id)
+
           @properties[property.id] = property
           property.publish if prior_state == :ready
           property
@@ -29,6 +40,7 @@ module MQTT
 
       def remove_property(id)
         return false unless (property = @properties[id])
+
         init do
           property.unpublish
           @properties.delete(id)
@@ -73,6 +85,7 @@ module MQTT
 
       def unpublish
         return unless @published
+
         @published = false
 
         mqtt.publish("#{topic}/$name", retain: true, qos: 0)

data/lib/mqtt/homie/property.rb

@@ -6,19 +6,26 @@ module MQTT
       attr_reader :node, :datatype, :format, :unit, :value
 
       def initialize(node, id, name, datatype, value = nil, format: nil, retained: true, unit: nil, &block)
-        raise ArgumentError, "Invalid Homie datatype" unless %i[string integer float boolean enum color datetime duration].include?(datatype)
+        raise ArgumentError, "Invalid Homie datatype" unless %i[string integer float boolean enum color datetime
+                                                                duration].include?(datatype)
         raise ArgumentError, "retained must be boolean" unless [true, false].include?(retained)
+
         format = format.join(",") if format.is_a?(Array) && datatype == :enum
-        if %i{integer float}.include?(datatype) && format.is_a?(Range)
+        if %i[integer float].include?(datatype) && format.is_a?(Range)
           raise ArgumentError "only inclusive ranges are supported" if format.exclude_end?
+
           format = "#{format.begin}:#{format.end}"
         end
         raise ArgumentError, "format must be nil or a string" unless format.nil? || format.is_a?(String)
         raise ArgumentError, "unit must be nil or a string" unless unit.nil? || unit.is_a?(String)
         raise ArgumentError, "format is required for enums" if datatype == :enum && format.nil?
         raise ArgumentError, "format is required for colors" if datatype == :color && format.nil?
-        raise ArgumentError, "format must be either rgb or hsv for colors" if datatype == :color && !%w{rgb hsv}.include?(format.to_s)
-        raise ArgumentError, "an initial value cannot be provided for a non-retained property" if !value.nil? && !retained
+        if datatype == :color && !%w[rgb hsv].include?(format.to_s)
+          raise ArgumentError, "format must be either rgb or hsv for colors"
+        end
+        if !value.nil? && !retained
+          raise ArgumentError, "an initial value cannot be provided for a non-retained property"
+        end
 
         super(id, name)
 
@@ -32,6 +39,24 @@ module MQTT
         @block = block
       end
 
+      def inspect
+        result = +"#<MQTT::Homie::Property #{topic} name=#{full_name.inspect}, datatype=#{datatype.inspect}"
+        result << ", format=#{format.inspect}" if format
+        result << ", unit=#{unit.inspect}" if unit
+        result << ", settable=true" if settable?
+        result << if retained?
+                    ", value=#{value.inspect}"
+                  else
+                    ", retained=false"
+                  end
+        result << ">"
+        result.freeze
+      end
+
+      def full_name
+        "#{node.full_name} #{name}"
+      end
+
       def device
         node.device
       end
@@ -49,39 +74,41 @@ module MQTT
       end
 
       def value=(value)
-        if @value != value
-          @value = value if retained?
-          publish_value if @published
-        end
+        return if @value == value
+
+        @value = value if retained?
+        publish_value if @published
       end
 
       def unit=(unit)
-        if unit != @unit
-          @unit = unit
-          if @published
-            device.init do
-              mqtt.publish("#{topic}/$unit", unit.to_s, retain: true, qos: 1)
-            end
-          end
+        return if unit == @unit
+
+        @unit = unit
+        return unless @published
+
+        device.init do
+          mqtt.publish("#{topic}/$unit", unit.to_s, retain: true, qos: 1)
         end
       end
 
       def format=(format)
-        if format != @format
-          @format = format
-          if @published
-            device.init do
-              mqtt.publish("#{topic}/$format", format.to_s, retain: true, qos: 1)
-            end
-          end
+        return if format == @format
+
+        @format = format
+        return unless @published
+
+        device.init do
+          mqtt.publish("#{topic}/$format", format.to_s, retain: true, qos: 1)
         end
       end
 
       def range
+        return nil unless format
+
         case datatype
-        when :enum; format.split(',')
-        when :integer; Range.new(*format.split(':').map(&:to_i))
-        when :float; Range.new(*format.split(':').map(&:to_f))
+        when :enum then format.split(",")
+        when :integer then Range.new(*format.split(":").map(&:to_i))
+        when :float then Range.new(*format.split(":").map(&:to_f))
         else; raise MethodNotImplemented
         end
       end
@@ -89,24 +116,29 @@ module MQTT
       def set(value)
         case datatype
         when :boolean
-          return unless %w{true false}.include?(value)
-          value = value == 'true'
+          return unless %w[true false].include?(value)
+
+          value = value == "true"
         when :integer
-          return unless value =~ /^-?\d+$/
+          return unless /^-?\d+$/.match?(value)
+
           value = value.to_i
-          return unless range.include?(value) if format
+          return if format && !range.include?(value)
         when :float
-          return unless value =~ /^-?(?:\d+|\d+\.|\.\d+|\d+\.\d+)(?:[eE]-?\d+)?$/
+          return unless /^-?(?:\d+|\d+\.|\.\d+|\d+\.\d+)(?:[eE]-?\d+)?$/.match?(value)
+
           value = value.to_f
-          return unless range.include?(value) if format
+          return if format && !range.include?(value)
         when :enum
           return unless range.include?(value)
         when :color
-          return unless value =~ /^\d{1,3},\d{1,3},\d{1,3}$/
-          value = value.split(',').map(&:to_i)
-          if format == 'rgb'
+          return unless /^\d{1,3},\d{1,3},\d{1,3}$/.match?(value)
+
+          value = value.split(",").map(&:to_i)
+          case format
+          when "rgb"
             return if value.max > 255
-          elsif format == 'hsv'
+          when "hsv"
             return if value.first > 360 || value[1..2].max > 100
           end
         when :datetime
@@ -153,6 +185,7 @@ module MQTT
 
       def unpublish
         return unless @published
+
         @published = false
 
         mqtt.publish("#{topic}/$name", retain: true, qos: 0)
@@ -170,8 +203,10 @@ module MQTT
       def publish_value
         serialized = value
         serialized = serialized&.iso8601 if %i[datetime duration].include?(datatype)
+        serialized = serialized.to_s
 
-        mqtt.publish(topic, serialized.to_s, retain: retained?, qos: 1)
+        node.device.logger&.debug("publishing #{serialized.inspect} to #{topic}")
+        mqtt.publish(topic, serialized, retain: retained?, qos: 1)
       end
     end
   end

data/lib/mqtt/homie/version.rb

@@ -2,6 +2,6 @@
 
 module MQTT
   module Homie
-    VERSION = '1.4.1'
+    VERSION = "1.5.0"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: homie-mqtt
 version: !ruby/object:Gem::Version
-  version: 1.4.1
+  version: 1.5.0
 platform: ruby
 authors:
 - Cody Cutrer
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-07-30 00:00:00.000000000 Z
+date: 2021-12-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: mqtt-ccutrer
@@ -17,6 +17,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -24,6 +27,23 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.1
+- !ruby/object:Gem::Dependency
+  name: ruby2_keywords
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.0.5
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.0.5
 - !ruby/object:Gem::Dependency
   name: byebug
   requirement: !ruby/object:Gem::Requirement
@@ -52,6 +72,48 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.23'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.23'
+- !ruby/object:Gem::Dependency
+  name: rubocop-performance
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.12'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
 description: 
 email: cody@cutrer.com'
 executables: []
@@ -67,7 +129,8 @@ files:
 homepage: https://github.com/ccutrer/homie-mqtt
 licenses:
 - MIT
-metadata: {}
+metadata:
+  rubygems_mfa_required: 'true'
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -76,7 +139,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '2.5'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="