particlerb 0.0.1

data/lib/particle/error.rb

@@ -0,0 +1,83 @@
+module Particle
+  # Custom error class for rescuing from all Particle errors
+  class Error < StandardError
+
+    # Returns the appropriate Particle::Error subclass based
+    # on status and response message
+    #
+    # @param [Hash] response HTTP response
+    # @return [Particle::Error]
+    def self.from_response(response)
+      status  = response[:status].to_i
+      body    = response[:body].to_s
+
+      if klass =  case status
+                  when 400      then bad_request_error(body)
+                  when 401      then Particle::Unauthorized
+                  when 403      then Particle::Forbidden
+                  when 404      then Particle::NotFound
+                  when 408      then Particle::TimedOut
+                  when 500..599 then Particle::ServerError
+                  end
+        klass.new(response)
+      end
+    end
+
+    def initialize(response=nil)
+      @response = response
+      super(build_error_message)
+    end
+
+    attr_reader :response
+
+    private
+
+    def self.bad_request_error(body)
+      if body =~ /access token was not found/i
+        MissingTokenError
+      else
+        BadRequest
+      end
+    end
+
+    def build_error_message
+      return nil if @response.nil?
+
+      message =  "#{@response[:method].to_s.upcase} "
+      message << redact_url(@response[:url].to_s) + ": "
+      message << "#{@response[:status]} - "
+      message << "#{@response[:body]}"
+      message
+    end
+
+    def redact_url(url_string)
+      token = "access_token"
+      url_string.gsub!(/#{token}=\S+/, "#{token}=(redacted)") if url_string.include? token
+      url_string
+    end
+  end
+
+  # Raised on errors in the 400-499 range
+  class ClientError < Error; end
+
+  # Raised when no authentication token is provided
+  class MissingTokenError < Error; end
+
+  # Raised when Particle returns a 400 HTTP status code
+  class BadRequest < ClientError; end
+
+  # Raised when Particle returns a 401 HTTP status code
+  class Unauthorized < ClientError; end
+
+  # Raised when Particle returns a 403 HTTP status code
+  class Forbidden < ClientError; end
+
+  # Raised when Particle returns a 404 HTTP status code
+  class NotFound < ClientError; end
+
+  # Raised when Particle returns a 408 HTTP status code
+  class TimedOut < ClientError; end
+
+  # Raised when Particle returns a 500 HTTP status code
+  class ServerError < Error; end
+end

data/lib/particle/response/raise_error.rb

@@ -0,0 +1,21 @@
+require 'faraday'
+require 'particle/error'
+
+module Particle
+  # Faraday response middleware
+  module Response
+
+    # This class raises an Particle-flavored exception based on
+    # HTTP status codes returned by the API
+    class RaiseError < Faraday::Response::Middleware
+
+      private
+
+      def on_complete(response)
+        if error = Particle::Error.from_response(response)
+          raise error
+        end
+      end
+    end
+  end
+end

data/lib/particle/version.rb

@@ -0,0 +1,3 @@
+module Particle
+  VERSION = "0.0.1".freeze
+end

data/lib/particle.rb

@@ -0,0 +1,31 @@
+require 'particle/configurable'
+require 'particle/default'
+require 'particle/client'
+
+module Particle
+  class << self
+    include Particle::Configurable
+
+    def client
+      return @client if @client && @client.same_options?(options)
+      @client = Particle::Client.new(options)
+    end
+
+    private
+
+    def respond_to_missing?(method_name, include_private = false)
+      client.respond_to?(method_name, include_private)
+    end
+
+    def method_missing(method_name, *args, &block)
+      if client.respond_to?(method_name)
+        return client.send(method_name, *args, &block)
+      end
+
+      super
+    end
+  end
+end
+
+# Set default configuration
+Particle.reset!

data/lib/particlerb.rb

@@ -0,0 +1,2 @@
+# Allow including either "particle" or "particlerb" to load this gem
+require "particle"

data/particlerb.gemspec

@@ -0,0 +1,29 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'particle/version'
+
+Gem::Specification.new do |spec|
+  spec.authors = ["Julien Vanier"]
+  spec.summary = %q{Ruby client for the Particle.io Cloud API}
+  spec.description = %q{Ruby client for the Particle.io Cloud API}
+  spec.email = ['jvanier@gmail.com']
+  spec.files = %w(LICENSE.txt README.md Rakefile particlerb.gemspec)
+  spec.files += Dir.glob("lib/**/*.rb")
+  spec.homepage = 'https://github.com/monkbroc/particlerb'
+  spec.licenses = ['GPL-3.0']
+  spec.name = 'particlerb'
+  spec.require_paths = ['lib']
+  spec.required_ruby_version = '>= 1.9.3'
+  spec.required_rubygems_version = '>= 1.3.5'
+  spec.version = Particle::VERSION.dup
+  spec.add_dependency 'sawyer', '~> 0.6.0'
+  spec.add_development_dependency 'bundler', '~> 1.0'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'guard-rspec', '~> 4.5'
+  spec.add_development_dependency 'pry', '~> 0.10'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+  spec.add_development_dependency 'vcr', '~> 2.9'
+  spec.add_development_dependency 'webmock', '~> 1.21'
+  spec.add_development_dependency 'multi_json', '~> 1.11'
+end

metadata

@@ -0,0 +1,186 @@
+--- !ruby/object:Gem::Specification
+name: particlerb
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Julien Vanier
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-06-25 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: sawyer
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.6.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.6.0
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: guard-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.5'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.9'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.21'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.21'
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.11'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.11'
+description: Ruby client for the Particle.io Cloud API
+email:
+- jvanier@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/particle.rb
+- lib/particle/client.rb
+- lib/particle/client/devices.rb
+- lib/particle/configurable.rb
+- lib/particle/connection.rb
+- lib/particle/default.rb
+- lib/particle/device.rb
+- lib/particle/error.rb
+- lib/particle/response/raise_error.rb
+- lib/particle/version.rb
+- lib/particlerb.rb
+- particlerb.gemspec
+homepage: https://github.com/monkbroc/particlerb
+licenses:
+- GPL-3.0
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 1.9.3
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 1.3.5
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5
+signing_key: 
+specification_version: 4
+summary: Ruby client for the Particle.io Cloud API
+test_files: []
+has_rdoc: