homeaway-storm 1.0.0

data/lib/homeaway/storm/domain/client_includes.rb

@@ -0,0 +1,28 @@
+# Copyright (c) 2016 HomeAway.com, Inc.
+# All rights reserved.  http://www.homeaway.com
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'homeaway/storm/domain/topology'
+require 'homeaway/storm/domain/cluster'
+require 'homeaway/storm/domain/supervisor'
+
+module HomeAway
+  module Storm
+    class Client
+      include HomeAway::Storm::Domain::Topology
+      include HomeAway::Storm::Domain::Cluster
+      include HomeAway::Storm::Domain::Supervisor
+    end
+  end
+end

data/lib/homeaway/storm/domain/cluster.rb

@@ -0,0 +1,31 @@
+# Copyright (c) 2016 HomeAway.com, Inc.
+# All rights reserved.  http://www.homeaway.com
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+module HomeAway
+  module Storm
+    module Domain
+      module Cluster
+
+        def cluster_configuration
+          get '/api/v1/cluster/configuration'
+        end
+
+        def cluster_summary
+          get '/api/v1/cluster/summary'
+        end
+      end
+    end
+  end
+end

data/lib/homeaway/storm/domain/supervisor.rb

@@ -0,0 +1,26 @@
+# Copyright (c) 2016 HomeAway.com, Inc.
+# All rights reserved.  http://www.homeaway.com
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+module HomeAway
+  module Storm
+    module Domain
+      module Supervisor
+        def supervisor_summary
+          get '/api/v1/supervisor/summary'
+        end
+      end
+    end
+  end
+end

data/lib/homeaway/storm/domain/topology.rb

@@ -0,0 +1,52 @@
+# Copyright (c) 2016 HomeAway.com, Inc.
+# All rights reserved.  http://www.homeaway.com
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+module HomeAway
+  module Storm
+    module Domain
+      module Topology
+        def topology_summary
+          get '/api/v1/topology/summary'
+        end
+
+        def topology(id, opts={})
+          get "/api/v1/topology/#{id}", opts
+        end
+
+        def topology_component(id, component, opts={})
+          get "/api/v1/topology/#{id}/component/#{component}", opts
+        end
+
+        def topology_activate(id)
+          post "/api/v1/topology/#{id}/activate", {}
+        end
+
+        def topology_deactivate(id)
+          post "/api/v1/topology/#{id}/deactivate", {}
+        end
+
+        def topology_rebalance(id, wait_time, rebalance_opts={})
+          body = {}
+          body[:rebalanceOptions] = rebalance_opts unless rebalance_opts.empty?
+          post "/api/v1/topology/#{id}/rebalance/#{wait_time}", body
+        end
+
+        def topology_kill(id, wait_time)
+          post "/api/v1/topology/#{id}/kill/#{wait_time}", {}
+        end
+      end
+    end
+  end
+end

data/lib/homeaway/storm/errors/storm_api_errors.rb

@@ -0,0 +1,139 @@
+# Copyright (c) 2016 HomeAway.com, Inc.
+# All rights reserved.  http://www.homeaway.com
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+module HomeAway
+  module Storm
+    # a collection of error classes corresponding to various errors that might be raised by the Storm API
+    module Errors
+
+      # @private
+      class StormAPIError < StandardError
+
+        attr_reader :response
+
+        # @private
+        def initialize(response=nil)
+          @response = response
+        end
+
+        # @private
+        def to_s
+          begin
+            buf = "#{self.class.name} #{@response._metadata.status_code} "
+            @response.violations.each do |violation|
+              buf << "#{violation.description} | "
+            end
+            buf = buf[0..-3] unless @response.violations.empty?
+            return buf
+          rescue
+            if @response.nil?
+              super
+            else
+              @response.to_s
+            end
+          end
+        end
+
+        # @private
+        def self.method_missing(name, *args, &block)
+          if @response.respond_to? name
+            @response.send name
+          else
+            super
+          end
+        end
+      end
+
+      # raised when the token a client is using has become expired
+      class TokenExpiredError < StandardError
+      end
+
+      # @private
+      class ClientError < StormAPIError
+      end
+
+      # represents a HTTP 400
+      class BadRequestError < ClientError
+        CODE = 400
+      end
+
+      # represents a HTTP 500
+      class InternalServerError < StormAPIError
+        CODE = 500
+      end
+
+      # represents a HTTP 404
+      class ResourceNotFoundError < ClientError
+        CODE = 404
+      end
+
+      # represents a HTTP 401
+      class UnauthorizedError < ClientError
+        CODE = 401
+      end
+
+      # represents a HTTP 403
+      class ForbiddenError < ClientError
+        CODE = 403
+      end
+
+      # represents a HTTP 405
+      class MethodNotAllowedError < ClientError
+        CODE = 405
+      end
+
+      # represents a HTTP 429. This will be raised when a client exceeds their rate limit
+      class TooManyRequestsError < ClientError
+        CODE = 429
+      end
+
+      # represents a HTTP 503
+      class APINotAvailableError < StormAPIError
+        CODE = 503
+      end
+
+      # represents a HTTP 406
+      class NotAcceptableError < ClientError
+        CODE = 406
+      end
+
+      # represents a HTTP 409
+      class ConflictError < ClientError
+        CODE = 409
+      end
+
+      # @private
+      class ImATeapotError < ClientError
+        #hopefully this is never ever used
+        CODE = 418
+      end
+
+      # @private
+      def self.for_http_code(status_code)
+        begin
+          self.const_get(self.constants.select do |c|
+                           const = self.const_get c
+                           Class === const &&
+                               const.const_defined?(:CODE) &&
+                               const.const_get(:CODE) == status_code.to_i
+                         end.first)
+        rescue => _
+          StormAPIError
+        end
+      end
+
+    end
+  end
+end

data/lib/homeaway/storm/response.rb

@@ -0,0 +1,53 @@
+# Copyright (c) 2016 HomeAway.com, Inc.
+# All rights reserved.  http://www.homeaway.com
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+module HomeAway
+  module Storm
+    # A container around the response that the Storm API returns.
+    # This object extends Hashie::Mash and can be accessed in an identical method
+    class Response < Hashie::Mash
+
+      # @private
+      def convert_key(key) #:nodoc:
+        if key.to_s.include? '_' #naive way of detecting snake case
+          HomeAway::Storm::Util::Validators.camel_case(key) #for reads
+        else
+          HomeAway::Storm::Util::Validators.snake_case(key) #for writes
+        end
+      end
+
+      # a helper method to determine if this response has
+      # any particular fields in its payload, potentially
+      # nested
+      #
+      # @param attrs [Symbol] one or more symbols to search into this response with
+      def has?(*attrs)
+        entity = self
+        attrs.each do |attr|
+          return false unless entity.has_key?(attr.to_sym)
+          entity = entity.send(attr.to_sym)
+        end
+        true
+      end
+
+      # Returns information about the request that was just made. This includes
+      # things such as connection headers and status code
+      # @return [HomeAway::Storm::Response] information about the request that was made
+      def _metadata
+        @metadata ||= HomeAway::Storm::Response.new
+      end
+    end
+  end
+end

data/lib/homeaway/storm/util/defaults.rb

@@ -0,0 +1,64 @@
+# Copyright (c) 2016 HomeAway.com, Inc.
+# All rights reserved.  http://www.homeaway.com
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'singleton'
+
+module HomeAway
+  module Storm
+    module Util
+      # @private
+      class Defaults
+        include Singleton
+
+        def port
+          '8080'
+        end
+
+        def scheme
+          :http
+        end
+
+        def logger
+          default_logger = Logger.new(STDOUT)
+          default_logger.level = Logger::WARN
+          default_logger
+        end
+
+        def cache_control
+          'max-age: 0, must-revalidate'
+        end
+
+        def connection_opts
+          {}
+        end
+
+        def adapter
+          :faraday
+        end
+
+        def to_hash
+          keys = self.class.instance_methods(false)
+          keys.delete(:to_hash)
+          hash = {}
+          keys.each do |key|
+            hash[key] = send key
+          end
+          hash
+        end
+      end.freeze
+      Defaults.instance.freeze
+    end
+  end
+end

data/lib/homeaway/storm/util/validators.rb

@@ -0,0 +1,123 @@
+# Copyright (c) 2016 HomeAway.com, Inc.
+# All rights reserved.  http://www.homeaway.com
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'cgi'
+require 'json'
+
+module HomeAway
+  module Storm
+    module Util
+
+      # @private
+      module Validators
+
+        # @private
+        def self.uri_encoded(input)
+          CGI.escape input
+        end
+
+        # @private
+        def self.date(input)
+          if input.is_a? String
+            input = Chronic.parse(input, :ambiguous_time_range => :none)
+          end
+          raise ArgumentError.new('dates must be a parseable date string or a Ruby Time object') unless input.is_a? Time
+          input.to_time.utc.iso8601
+        end
+
+        # @private
+        def self.float(input, min=nil, max=nil)
+          begin
+            input_s = input.to_s
+            !!Float(input_s)
+            f = input_s.to_f
+            unless min == nil
+              raise ArgumentError.new("Supplied argument #{f} must be greater than #{min}") if f < min
+            end
+            unless max == nil
+              raise ArgumentError.new("Supplied argument #{f} must be less than #{max}") if f > max
+            end
+            return f
+          rescue
+            raise ArgumentError.new("Supplied argument #{input} must be a valid float value")
+          end
+        end
+
+        # @private
+        def self.integer(input, min=nil, max=nil)
+          begin
+            input_s = input.to_s
+            !!Integer(input_s)
+            i = input_s.to_i
+            unless min == nil
+              raise ArgumentError.new("Supplied argument #{i} must be greater than #{min}") if i < min
+            end
+            unless max == nil
+              raise ArgumentError.new("Supplied argument #{i} must be less than #{max}") if i > max
+            end
+            return i
+          rescue
+            raise ArgumentError.new("Supplied argument #{input} must be a valid integer value")
+          end
+        end
+
+        # @private
+        def self.boolean(input)
+          input_s = input.to_s
+          return true if input_s =~ (/^(true)$/i)
+          return false if input_s.empty? || input_s =~ (/^(false)$/i)
+          raise ArgumentError.new("Supplied argument #{input} must be a valid boolean value")
+        end
+
+        # @private
+        def self.camel_case(input)
+          input.to_s.camelize(:lower)
+        end
+
+        # @private
+        def self.snake_case(input)
+          input.to_s.underscore
+        end
+
+        # @private
+        def self.query_keys(hash)
+          raise ArgumentError.new('arguments must be a hash') unless hash.is_a? Hash
+          transformed = {}
+          hash.each_key do |key|
+            transformed[self.camel_case(key)] = hash[key]
+          end
+          transformed
+        end
+
+        # @private
+        def self.uuid(input)
+          uuid_regex = /\A([0-9a-fA-F]{32}|[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})\z/
+          raise ArgumentError.new("#{uuid.to_s} must be a valid uuid") unless input.to_s =~ uuid_regex
+          input.to_s
+        end
+
+        # @private
+        def self.json(input)
+          begin
+            input = input.to_json if input.respond_to? :to_json
+            JSON.parse(input).to_json
+          rescue
+            raise ArgumentError.new('Must supply properly formed JSON')
+          end
+        end
+      end
+    end
+  end
+end