apiotics_aws_iot_client 1.0.1

data/apiotics_aws_iot_client.gemspec

@@ -0,0 +1,40 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'aws_iot_device/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "apiotics_aws_iot_client"
+  spec.version       = AwsIotDevice::VERSION
+  spec.authors       = ["Mac Dougherty", "Pierre Goudet"]
+  spec.email         = ["info@apiotics.com"]
+
+  spec.summary       = %q{The ruby version of the AWS IoT Device SDK. It enables to connect to AWS IoT platform and manage Things.}
+  spec.description   = %q{The gem is using the MQTT protocol to execute the command defined by the AWS IoT platform. A default MQTT client is included in the gem, however an adapter system enables to plug another MQTT client.}
+  spec.homepage      = "https://portal.apiotics.com"
+  spec.license       = "Apache-2.0"
+
+  # Prevent pushing this gem to RubyGems.org by setting 'allowed_push_host', or
+  # delete this section to allow pushing this gem to any host.
+  if spec.respond_to?(:metadata)
+    # spec.metadata['allowed_push_host'] = "TODO: Set to 'http://mygemserver.com'"
+  else
+    raise "RubyGems 2.0 or newer is required to protect against public gem pushes."
+  end
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.10", ">= 1.10"
+  spec.add_development_dependency "pry", "~> 0.10.4", ">= 0.10.4"
+  spec.add_development_dependency "rake", "~> 10.0", ">= 1.10" 
+  spec.add_development_dependency "rspec", "~> 3.5.0", ">= 3.5.0"
+
+  #spec.add_runtime_dependency "facets", "~> 3.1.0", ">= 3.1.0"
+  spec.add_runtime_dependency "json", "~> 2.0.2", ">= 2.0.2"
+  #spec.add_runtime_dependency "paho-mqtt", "~> 1.0.0", ">= 1.0.0"
+  spec.add_runtime_dependency "apiotics-paho-mqtt", "~> 1.0.0"
+  spec.add_runtime_dependency "timers", "~> 4.1.1", ">= 4.1.1"
+end

data/bin/console

@@ -0,0 +1,11 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "aws_iot"
+
+# 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

data/bin/setup

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

data/codeclimate.yml

@@ -0,0 +1,6 @@
+languages:
+  Ruby: true
+exclude_paths:
+- "samples/"
+
+

data/lib/aws_iot_device.rb

@@ -0,0 +1,8 @@
+require "aws_iot_device/version"
+require "aws_iot_device/mqtt_adapter"
+require "aws_iot_device/mqtt_shadow_client"
+
+module AwsIotDevice
+  class Exception < ::Exception
+  end
+end

data/lib/aws_iot_device/mqtt_adapter.rb

@@ -0,0 +1,31 @@
+#require 'facets'
+require 'aws_iot_device/mqtt_adapter/client'
+
+module AwsIotDevice
+  module MqttAdapter
+    extend self
+
+    ### Return the adapter selected for the module with either a pre-setted value or a default value
+    def adapter
+      return @adapter if @adapter
+      ### Calling the setter method with the default symbol 'RubyMqttAdapter' and return it.
+      self.adapter = :paho_mqtt_adapter
+      @adapter
+    end
+
+    ### The setter of the module's adapter attributes
+    def adapter=(adapter_lib)
+      case adapter_lib
+      when Symbol, String
+        begin
+          require "aws_iot_device/mqtt_adapter/#{adapter_lib}"
+        rescue LoadError
+          raise "LoadError: Could find adapters for the lib #{adapter_lib}"
+        end
+        @adapter = MqttAdapter.const_get("#{adapter_lib.to_s.camelcase(:upper)}")
+      else
+        raise "TypeError: Library name should be a String or Symbol"
+      end
+    end
+  end
+end

data/lib/aws_iot_device/mqtt_adapter/client.rb

@@ -0,0 +1,207 @@
+module AwsIotDevice
+  module MqttAdapter
+    class Client
+
+      attr_reader :client_id
+
+      ### @adapter contains the name of the adapter that should be module as a third party librairy
+      ### The method call by the shared client are implemented by the third party or the adapter module itself.
+      ### @adapter default value is MqttShareLib::Adapters::RubyMqttAdapter
+      attr_accessor :adapter
+
+      ### @on_'event' contains the callback's [block, Proc, lambda] that should be called when 'event' is catched
+      ### Callbacks should be customized in the higher level class (ex. MqttManger or upper)
+      ### Callback should be called by some (private) handlers define in the third party librairy
+
+      ### On a MqttAdapter's create, the client adapter is set as the previously define module adapter
+      ### The client is then initialize with the client type of the third librairy of the adapter.
+      ### @client default type is MQTT::Client
+      def initialize(*args)
+        @adapter = MqttAdapter.adapter.new(*args)
+      end
+
+      def client_id
+        @adapter.client_id
+      end
+
+      ### The following method represent the basics common MQTT actions.
+      ### As possible, they should be implemented in the third party librairy
+      ### If not, the adpater should implement them or throw and excpetion
+      def connect(*args, &block)
+        @adapter.connect(*args, &block)
+      end
+
+      def publish(topic, payload='', retain=false, qos=0)
+        @adapter.publish(topic, payload, retain, qos)
+      end
+
+      def loop_start
+        @thread = @adapter.loop_start
+      end
+
+      def loop_stop
+        @adapter.loop_stop(@thread)
+      end
+
+      def loop_forever
+        @adapter.loop_forever
+      end
+
+      def mqtt_loop
+        @adapter.mqtt_loop
+      end
+      
+      def loop_read
+        @adapter.loop_read
+      end
+
+      def loop_write
+        @adapter.loop_write
+      end
+
+      def loop_misc
+        @adapter.loop_misc
+      end
+
+      def get(topic=nil, &block)
+        @adapter.get(topic, &block)
+      end
+
+      def get_packet(topic=nil, &block)
+        @adapter.get_packet(topic, &block)
+      end
+
+      def generate_client_id
+        @adapter.generate_client_id
+      end
+
+      def disconnect(send_msg=true)
+        @adapter.disconnect(send_msg)
+      end
+
+      def connected?
+        @adapter.connected?
+      end
+
+      def subscribe(topic, qos)
+        @adapter.subscribe(topic, qos)
+      end
+
+      def subscribe_bunch(*topics)
+        @adapter.subscribe_bunch(topics)
+      end
+      
+      def unsubscribe(topic)
+        @adapter.unsubscribe(topic)
+      end
+
+      def unsubscribe_bunch(*topics)
+        @adapter.unsubscribe_bunch(topics)
+      end
+
+      def set_tls_ssl_context(ca_cert, cert=nil, key=nil)
+        @adapter.set_tls_ssl_context(ca_cert, cert, key)
+      end
+
+      def add_callback_filter_topic(topic, callback=nil, &block)
+        @adapter.add_callback_filter_topic(topic, callback, &block)
+      end
+
+      def remove_callback_filter_topic(topic)
+        @adapter.remove_callback_filter_topic(topic)
+      end
+
+      def on_connack=(callback)
+        @adapter.on_connack = callback
+      end
+      
+      def on_suback=(callback)
+        @adapter.on_suback = callback
+      end
+
+      def on_unsuback=(callback)
+        @adapter.on_unsuback = callback
+      end
+
+      def on_puback=(callback)
+        @adapter.on_puback = callback
+      end
+
+      def on_pubrec=(callback)
+        @adapter.on_pubrec = callback
+      end
+
+      def on_pubrel=(callback)
+        @adapter.on_pubrel = callback
+      end
+
+      def on_pubcomp=(callback)
+        @adapter.on_pubcomp = callback
+      end
+      
+      def on_message=(callback)
+        @adapter.on_message = callback
+      end
+      
+      def on_connack(&block)
+        @adapter.on_connack(&block)
+      end
+      
+      def on_suback(&block)
+        @adapter.on_suback(&block)
+      end
+
+      def on_unsuback(&block)
+        @adapter.on_unsuback(&block)
+      end
+
+      def on_puback(&block)
+        @adapter.on_puback(&block)
+      end
+
+      def on_pubrec(&block)
+        @adapter.on_pubrec(&block)
+      end
+
+      def on_pubrel(&block)
+        @adapter.on_pubrel(&block)
+      end
+
+      def on_pubcomp(&block)
+        @adapter.on_pubcomp(&block)
+      end
+      
+      def on_message(&block)
+        @adapter.on_message(&block)
+      end
+      
+      ### The following attributes should exists in every MQTT third party librairy.
+      ### They are necessary (or really usefull and common) for the establishement of the connection and/or the basic Mqtt actions.
+      ### The setter directely change the third party client value when the getter remote the actual SharedClient instance's attribute value
+      def host
+        @adapter.host
+      end
+
+      def host=(host)
+        @adapter.host = host
+      end
+
+      def port
+        @adapter.port
+      end
+
+      def port=(port)
+        @adapter.port = port
+      end
+
+      # Boolean for the encrypted mode (true = ssl/tls | false = no encryption)
+      def ssl
+        @adapter.ssl
+      end
+
+      def ssl=(ssl)
+        @adapter.ssl = ssl
+      end
+    end
+  end
+end

data/lib/aws_iot_device/mqtt_adapter/paho_mqtt_adapter.rb

@@ -0,0 +1,207 @@
+require 'paho-mqtt'
+
+module AwsIotDevice
+  module MqttAdapter
+    class PahoMqttAdapter
+
+      def initialize(*args)
+        @client = PahoMqtt::Client.new(*args)
+      end
+
+      def client_id
+        @client.client_id
+      end
+
+      def connect(*args, &block)
+        if args.last.is_a?(Hash)
+          attr = args.last
+          attr.each_pair do |k, v|
+            if [:host, :port, :keep_alive, :persistent].include?(k)
+              @client.send("#{k}=", v)
+            else
+              raise ArgumentError, "Parameter error, invalid paramater \"#{k}\" for connect with paho-mqtt"
+            end
+          end
+        end
+        @client.connect
+        if block_given?
+          begin
+            yield(self)
+          ensure
+            @mqtt_client.disconnect
+          end
+        end
+      end
+
+      def publish(topic, payload="", retain=false, qos=0)
+        @client.publish(topic, payload, retain, qos)
+      end
+
+      def loop_start
+        Thread.new { loop_forever }
+      end
+
+      def loop_stop(thread)
+        thread.join
+      end
+
+      def loop_forever
+        loop do
+          @client.mqtt_loop
+        end
+      end
+      
+      def mqtt_loop
+        @client.mqtt_loop
+      end
+      
+      def loop_read
+        @client.loop_read
+      end
+
+      def loop_write
+        @client.loop_write
+      end
+
+      def loop_misc
+        @client.loop_misc
+      end
+
+      def get(topic=nil, &block)
+        @client.loop_read(1)
+      end
+
+      def get_packet(topic=nil, &block)
+        @client.loop_read(1)
+      end
+
+      def generate_client_id
+        @client.generate_client_id
+      end
+
+      def disconnect(send_msg)
+        @client.disconnect(send_msg)
+      end
+
+      def connected?
+        @client.connected?
+      end
+
+      def subscribe(topic, qos)
+        @client.subscribe([topic, qos])
+      end
+
+      def subscribe_bunch(topics)
+        @client.subscribe(topics)
+      end
+      
+      def unsubscribe(topic)
+        @client.unsubscribe(topic)
+      end
+
+      def unsubscribe_bunch(topics)
+        @client.unsubscribe(topics)
+      end
+      
+      def set_tls_ssl_context(ca_cert=nil, cert=nil, key=nil)
+        @client.config_ssl_context(cert, key, ca_cert)
+      end      
+      
+      def add_callback_filter_topic(topic, callback=nil, &block)
+        @client.add_topic_callback(topic, callback, &block)
+      end
+
+      def remove_callback_filter_topic(topic)
+        @client.remove_topic_callback(topic)
+      end
+
+      def on_connack=(callback)
+        @client.on_connack = callback
+      end
+      
+      def on_suback=(callback)
+        @client.on_suback = callback
+      end
+
+      def on_unsuback=(callback)
+        @client.on_unsuback = callback
+      end
+
+      def on_puback=(callback)
+        @client.on_puback = callback
+      end
+
+      def on_pubrec=(callback)
+        @client.on_pubrec = callback
+      end
+
+      def on_pubrel=(callback)
+        @client.on_pubrel = callback 
+      end
+
+      def on_pubcomp=(callback)
+        @client.on_pubcomp = callback
+      end
+      
+      def on_message=(callback)
+        @client.on_message = callback
+      end
+      
+      def on_connack(&block)
+        @client.on_connack(&block)
+      end
+      
+      def on_suback(&block)
+        @client.on_suback(&block)
+      end
+
+      def on_unsuback(&block)
+        @client.on_unsuback(&block)
+      end
+
+      def on_puback(&block)
+        @client.on_puback(&block)
+      end
+
+      def on_pubrec(&block)
+        @client.on_pubrec(&block)
+      end
+
+      def on_pubrel(&block)
+        @client.on_pubrel(&block)
+      end
+
+      def on_pubcomp(&block)
+        @client.on_pubcomp(&block)
+      end
+      
+      def on_message(&block)
+        @client.on_message(&block)
+      end
+      
+      def host
+        @client.host
+      end
+
+      def host=(host)
+        @client.host = host
+      end
+
+      def port
+        @client.port
+      end
+
+      def port=(port)
+        @client.port = port
+      end
+
+      def ssl
+        @client.ssl
+      end
+
+      def ssl=(ssl)
+        @client.ssl = ssl
+      end
+    end
+  end
+end