tp_link_smartplug 0.1.0.beta1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6632a7cf74131ed5ee449e11777980bfed90faf60451d2d8a2046cda4ec4dcb0
-  data.tar.gz: 2800e192dfbec13272642bd3b7eb1c7112cad55dafe2a112fbb3dcf189b7b1cb
+  metadata.gz: 2f6b7cc98865382ad2bfa186843abca5622e0e10e3bbd47b6cbbf3c053fb53fb
+  data.tar.gz: 9581643fd63749b826acc8ada7fc9eaca0392e54d4a42f647d4912023cf89a66
 SHA512:
-  metadata.gz: 12e564bf4285c62dc25eac91809137b883c0e8c314febc11cfdac4578d6242a3133c8384232f7dbc405af83a62deb1e39ab2470970603d79a793980d3d03f1b8
-  data.tar.gz: 52d5ef5eaeec2d5bc10ae2a0669156901419f7b2e205cec6bccba550a4ed96163234fe7583f76184bca94de0d15a2ec239dcefd0818faa3cdc4814ff6e535b33
+  metadata.gz: 96069bf5ff04e8774b15cf9ef12ea8fe7cf0476d44d54c3577f16acf559aa41bbca39825e2a8c1e75c52c2b0a3b54f34ddff6707144ee3653cb7bf146273fcd4
+  data.tar.gz: ffd67c8bf48cae8cc2761390cf04b01829d6f1e03808e38d80c124f61b08204805bf629399f3fa9353e1e5edccf4f3983a5093a7a7721d96594f0a1ca4605a97

data/lib/tp_link_smartplug/_base.rb

@@ -0,0 +1,17 @@
+require_relative 'helpers'
+
+module TpLinkSmartplug
+  # Base plug class.
+  #
+  # @author Ben Hughes
+  class Base
+    include TpLinkSmartplug::Helpers
+
+    def initialize; end
+  end
+
+  # Base plug error class.
+  #
+  # @author Ben Hughes
+  class BaseError < StandardError; end
+end

data/lib/tp_link_smartplug/command.rb

@@ -1,31 +1,29 @@
-# frozen_string_literal: true
-
 module TpLinkSmartplug
   # Module containing the static commands for the plug
   module Command
     # Plug information command
-    INFO = '{"system":{"get_sysinfo":{}}}'
+    INFO = '{"system":{"get_sysinfo":{}}}'.freeze
     # Plug output on command
-    ON = '{"system":{"set_relay_state":{"state":1}}}'
+    ON = '{"system":{"set_relay_state":{"state":1}}}'.freeze
     # Plug output off command
-    OFF = '{"system":{"set_relay_state":{"state":0}}}'
+    OFF = '{"system":{"set_relay_state":{"state":0}}}'.freeze
     # Plug cloud info command
-    CLOUDINFO = '{"cnCloud":{"get_info":{}}}'
+    CLOUDINFO = '{"cnCloud":{"get_info":{}}}'.freeze
     # Plug WLAN SSID scan command
-    WLANSCAN = '{"netif":{"get_scaninfo":{"refresh":0}}}'
+    WLANSCAN = '{"netif":{"get_scaninfo":{"refresh":0}}}'.freeze
     # Plug time command
-    TIME = '{"time":{"get_time":{}}}'
+    TIME = '{"time":{"get_time":{}}}'.freeze
     # Plug schedule command
-    SCHEDULE = '{"schedule":{"get_rules":{}}}'
+    SCHEDULE = '{"schedule":{"get_rules":{}}}'.freeze
     # Plug countdown command
-    COUNTDOWN = '{"count_down":{"get_rules":{}}}'
+    COUNTDOWN = '{"count_down":{"get_rules":{}}}'.freeze
     # Plug antitheft command
-    ANTITHEFT = '{"anti_theft":{"get_rules":{}}}'
+    ANTITHEFT = '{"anti_theft":{"get_rules":{}}}'.freeze
     # Plug reboot command
-    REBOOT = '{"system":{"reboot":{"delay":1}}}'
+    REBOOT = '{"system":{"reboot":{"delay":1}}}'.freeze
     # Plug reset command
-    RESET = '{"system":{"reset":{"delay":1}}}'
+    RESET = '{"system":{"reset":{"delay":1}}}'.freeze
     # Plug energy command
-    ENERGY = '{"emeter":{"get_realtime":{}}}'
+    ENERGY = '{"emeter":{"get_realtime":{}}}'.freeze
   end
 end

data/lib/tp_link_smartplug/device.rb

@@ -1,10 +1,7 @@
-# frozen_string_literal: true
-
 require 'socket'
 require 'ipaddr'
 require 'json'
-require 'tp_link_smartplug/helpers'
-require 'tp_link_smartplug/message'
+require_relative './message'
 
 module TpLinkSmartplug
   # Provides an object to represent to a plug
@@ -14,17 +11,15 @@ module TpLinkSmartplug
   # @attr [Integer] port Port to connect to on the plug
   # @attr [Integer] timeout Timeout value for connecting and sending commands to the plug
   # @attr [true, false] debug Control debug logging
-  class Device
+  class Device < TpLinkSmartplug::Base
     include TpLinkSmartplug::Helpers
     include TpLinkSmartplug::Message
 
-    attr_accessor :address
-    attr_accessor :port
-    attr_accessor :timeout
-    attr_accessor :poll_auto_close
-    attr_accessor :debug
+    attr_accessor :address, :port, :timeout, :poll_auto_close, :debug
 
     def initialize(address:, port: 9999)
+      super()
+
       @address = IPAddr.new(address, Socket::AF_INET)
       @port = port
       @timeout = 3
@@ -44,23 +39,32 @@ module TpLinkSmartplug
 
       begin
         @socket.connect_nonblock(@sockaddr)
+        debug_message('Connected') if @debug
       rescue IO::WaitWritable
-        if IO.select(nil, [@socket], nil, timeout)
+        if @socket.wait_writable(timeout)
           begin
             @socket.connect_nonblock(@sockaddr)
           rescue Errno::EISCONN
-            debug_message('Connected') if debug
+            debug_message('Connected') if @debug
+          rescue Errno::ECONNREFUSED, Errno::EHOSTUNREACH
+            @socket.close
+            raise TpLinkSmartplug::DeviceError, "Connection refused or host unreachable connecting to address #{@address}, port #{@port}!"
           rescue StandardError => e
             disconnect
-            debug_message('Unexpected exception encountered.') if debug
-            raise e
+            debug_message("Unexpected exception encountered. Error: #{e}") if @debug
+            raise
           end
         else
           @socket.close
-          raise "Connection timeout connecting to address #{@address}, port #{@port}."
+          raise TpLinkSmartplug::DeviceError, "Connection timeout connecting to address #{@address}, port #{@port}."
         end
       rescue Errno::EISCONN
-        debug_message('Connected') if debug
+        debug_message('Connected') if @debug
+      rescue Errno::EINPROGRESS
+        debug_message('Connection in progress') if @debug
+        retry
+      rescue Errno::ECONNREFUSED
+        raise TpLinkSmartplug::DeviceError, "Connection refused connecting to address #{@address}, port #{@port}."
       end
     end
 
@@ -113,11 +117,11 @@ module TpLinkSmartplug
         raise 'Error occured during disconnect' unless closed?
       end
 
-      raise 'No data received' if data.nil? || data.empty?
+      raise 'No data received' if nil_or_empty?(data)
 
-      debug_message("Received Raw: #{data}") if debug
+      debug_message("Received Raw: #{data.split('\\')}") if @debug
       data = decrypt(data[4..data.length])
-      debug_message("Received Decrypted: #{data}") if debug
+      debug_message("Received Decrypted: #{data}") if @debug
 
       data
     end
@@ -170,11 +174,13 @@ module TpLinkSmartplug
       :antitheft,
       :reboot,
       :reset,
-      :energy
+      :energy,
     ].each do |method|
       define_method method do
         JSON.parse(poll(command: TpLinkSmartplug::Command.const_get(method.upcase)))
       end
     end
   end
+
+  class DeviceError < TpLinkSmartplug::BaseError; end
 end

data/lib/tp_link_smartplug/helpers.rb

@@ -1,5 +1,3 @@
-# frozen_string_literal: true
-
 require 'time'
 
 module TpLinkSmartplug
@@ -10,7 +8,16 @@ module TpLinkSmartplug
     # @param string [String] the message to be formatted for debug output
     def debug_message(string)
       caller_method = caller_locations(1..1).first.label
-      STDOUT.puts(Time.now.strftime('%Y-%m-%d %H:%M:%S: ').concat("#{caller_method}: ").concat(string))
+      $stdout.puts(Time.now.strftime('%Y-%m-%d %H:%M:%S: ').concat("#{caller_method}: ").concat(string))
+    end
+
+    # Tests a variable for nil or empty status
+    #
+    # @param v  the variable to be tested
+    def nil_or_empty?(value)
+      return true if value.nil? || (value.respond_to?(:empty?) && value.empty?)
+
+      false
     end
   end
 end

data/lib/tp_link_smartplug/message.rb

@@ -1,5 +1,3 @@
-# frozen_string_literal: false
-
 module TpLinkSmartplug
   # Helper methods for plug communication messages
   module Message

data/lib/tp_link_smartplug/version.rb

@@ -1,7 +1,5 @@
-# frozen_string_literal: true
-
 # @author Ben Hughes
 module TpLinkSmartplug
   # Gem version
-  VERSION = '0.0.1'
+  VERSION = '0.3.0'.freeze
 end

data/lib/tp_link_smartplug.rb

@@ -1,7 +1,11 @@
-# frozen_string_literal: true
+require_relative 'tp_link_smartplug/_base'
+require_relative 'tp_link_smartplug/command'
+require_relative 'tp_link_smartplug/device'
+require_relative 'tp_link_smartplug/helpers'
+require_relative 'tp_link_smartplug/message'
+require_relative 'tp_link_smartplug/version'
 
-require 'tp_link_smartplug/command'
-require 'tp_link_smartplug/device'
-require 'tp_link_smartplug/helpers'
-require 'tp_link_smartplug/message'
-require 'tp_link_smartplug/version'
+# Top level module
+#
+# @author Ben Hughes
+module TpLinkSmartplug; end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tp_link_smartplug
 version: !ruby/object:Gem::Version
-  version: 0.1.0.beta1
+  version: 0.3.0
 platform: ruby
 authors:
 - Ben Hughes
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-06-14 00:00:00.000000000 Z
+date: 2021-10-03 00:00:00.000000000 Z
 dependencies: []
 description: Control and retrieve data from a TP-Link HS100/110 (Metered) Smartplug
 email: bmhughes@bmhughes.co.uk
@@ -17,6 +17,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - "./lib/tp_link_smartplug.rb"
+- "./lib/tp_link_smartplug/_base.rb"
 - "./lib/tp_link_smartplug/command.rb"
 - "./lib/tp_link_smartplug/device.rb"
 - "./lib/tp_link_smartplug/helpers.rb"
@@ -25,7 +26,8 @@ files:
 homepage: https://github.com/bmhughes/tp_link_smartplug
 licenses:
 - Apache-2.0
-metadata: {}
+metadata:
+  github_repo: ssh://github.com/bmhughes/tp_link_smartplug
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -37,12 +39,11 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '2.5'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.7
+rubygems_version: 3.2.22
 signing_key: 
 specification_version: 4
 summary: TP-Link HS100/110 Smart Plug interaction library