cloud_powers 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 403667ef1b83f93c4534a4273849b4cd471385e4
-  data.tar.gz: c233cc41bd999aaa9b0bc6cc58d1a08c1947af73
+  metadata.gz: 9cc966e1561d2a202cfa35dd2cf3147d4ef2b840
+  data.tar.gz: d371b86048fef80382f4bc6cd61a3a4a5a7d16bf
 SHA512:
-  metadata.gz: bcad8e1544017abf5b498b546271cadb8071d1c498fd599983e9d4e5d7ed391d3033e82589ddd0aec49a171cb098804dfad9d0439d19cb5fb7f10a23d80d3828
-  data.tar.gz: a95f21bad47ff61cf1175716dff63322dc20908b25d92201a59fb61d785f86121e9589b5c4ee939fa0fef02a64ad633fd247c8a0a490f7f2ba26732d27010bab
+  metadata.gz: 2125004e0684f341d86a5c04ad62edeafb44ee8de978a7487518d319594e0ac165296170cdb1930a6e1928814198c9dd67729a9d0ba8cb10d8604a072b94c78a
+  data.tar.gz: 8fc1f114aa0be9caedd619e611d3e3014ac31c3f55113b0ba661a50f1b014e3996c711c8a108601673044c0b4aca22307b2f308fae73679119a724de192c2b0d

data/.ruby-version

@@ -1 +1 @@
-2.3.1
+2.4.0

data/cloud_powers.gemspec

@@ -4,7 +4,7 @@ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 require 'cloud_powers/version'
 
 Gem::Specification.new do |spec|
-  spec.required_ruby_version  =     '~> 2.3.0'
+  spec.required_ruby_version  =     '~> 2.4.0'
   spec.name                   =     'cloud_powers'
   spec.version                =     CloudPowers::VERSION
   spec.authors                =     ['Adam Phillipps', 'Faisal Irfan', 'Gerardo Parajeles']
@@ -45,8 +45,8 @@ Gem::Specification.new do |spec|
   spec.add_runtime_dependency       'websocket-eventmachine-client'
   spec.add_runtime_dependency       'workflow'
 
-  spec.add_development_dependency   'bundler', '~> 1.13.5'
+  spec.add_development_dependency   'bundler', '~> 1.14.3'
   spec.add_development_dependency   'byebug', '~> 9'
-  spec.add_development_dependency   'rake', '~> 10.0'
-  spec.add_development_dependency   'rspec', '~> 3.0'
+  spec.add_development_dependency   'rake', '~> 12.0'
+  spec.add_development_dependency   'rspec', '~> 3.5'
 end

data/lib/cloud_powers/version.rb

@@ -1,3 +1,3 @@
 module CloudPowers
-  VERSION = '1.0.0'
+  VERSION = '1.0.1'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cloud_powers
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
 platform: ruby
 authors:
 - Adam Phillipps
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2016-12-23 00:00:00.000000000 Z
+date: 2017-02-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport-core-ext
@@ -144,14 +144,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.13.5
+        version: 1.14.3
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.13.5
+        version: 1.14.3
 - !ruby/object:Gem::Dependency
   name: byebug
   requirement: !ruby/object:Gem::Requirement
@@ -172,28 +172,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '12.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '12.0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '3.5'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '3.5'
 description: |2
       CloudPowers is a wrapper around AWS and in the future, other cloud service Providers.
       It was developed specifically for the Brain project but hopefully can be used
@@ -256,7 +256,6 @@ files:
 - lib/cloud_powers/synapse/queue.rb
 - lib/cloud_powers/synapse/queue/board.rb
 - lib/cloud_powers/synapse/queue/poller.rb
-- lib/cloud_powers/synapse/queue/queue.rb
 - lib/cloud_powers/synapse/synapse.rb
 - lib/cloud_powers/synapse/web_soc.rb
 - lib/cloud_powers/synapse/web_soc/soc_client.rb
@@ -275,7 +274,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - "~>"
     - !ruby/object:Gem::Version
-      version: 2.3.0
+      version: 2.4.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -283,7 +282,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.5.1
+rubygems_version: 2.6.8
 signing_key: 
 specification_version: 4
 summary: Cloud providers wrapper.  Currently only AWS is supported.

data/lib/cloud_powers/synapse/queue/queue.rb

@@ -1,282 +0,0 @@
-require 'uri'
-require_relative 'board'
-
-module Smash
-  module CloudPowers
-    module Synapse
-      module Queue
-        include Smash::CloudPowers::AwsResources
-        include Smash::CloudPowers::Helper
-
-        # A simple Struct that acts as a Name to URL map
-        #
-        # Parameters
-        # * :set_name +String+ (optional) - An optional name.  It should be the same name as the
-        #   the Board and/or Queue you're working with, or else this Struct isn't that useful
-        # * :set_url +String+ (optional) - An optional URL.  It should be the same URL as the
-        #   the Board and/or Queue you're working with, or else this Struct isn't that useful
-        #
-        # Attributes
-        # * name +String+ - the +:set_name+ or parse the +#address()+ for the name
-        # * url +String+ - the +:set_url+ or add the name to the end of a best guess at the URL
-        #
-        # Example
-        #   name_url_map = NUMap.new(nil, 'https://sqs.us-west-53.amazonaws.com/001101010010/fooBar')
-        #   name_url_map.name
-        #   # => 'fooBar'
-        #
-        #   # and now in reverse
-        #   url_name_map = NUMap.new('snargleBargle')
-        #   url_name_map.address
-        #   # => 'https://sqs.us-west-53.amazonaws.com/001101010010/snargleBargle'
-        NUMap = Struct.new(:set_name, :set_url) do
-          # Gives you back the name, even if it hasn't been set
-          #
-          # Returns
-          # +String+
-          def name
-            set_name || url.split('/').last # Queue names are last in the URL path
-          end
-
-          # Gives you back the URL, even if it hasn't been set
-          #
-          # Returns
-          # +String+
-          def url
-            set_url || Smash::CloudPowers::Queue::Board.new(name).best_guess_address
-          end
-        end
-
-        # This method can be used to parse a queue name from its address.  It can be handy if you need the name
-        # of a queue but you don't want the overhead of creating a Board object.
-        #
-        # Parameters
-        # * url +String+
-        #
-        # Returns
-        # +String+
-        #
-        # Example
-        #   board_name('https://sqs.us-west-53.amazonaws.com/001101010010/fooBar')
-        #   => fooBar
-        def board_name(url)
-          url.to_s.split('/').last
-        end
-
-        # This method builds a Queue::Board object for you to use but doesn't
-        # invoke the <tt>#create!()</tt> method, so no API call is made to create the Queue
-        # on SQS.  This can be used if the Board and/or Queue already exists.
-        #
-        # Parameters
-        # * name +String+ - name of the Queue you want to interact with
-        #
-        # Returns
-        # Queue::Board
-        #
-        # Example
-        #   queue_object = build_queue('exampleQueue')
-        #   queue_object.address
-        #   => https://sqs.us-west-2.amazonaws.com/81234567/exampleQueue
-        def build_queue(name)
-          Smash::CloudPowers::Queue::Board.build(to_camel(name), sqs)
-        end
-
-        # This method allows you to create a queue on SQS without explicitly creating a Board object
-        #
-        # Parameters
-        # * name +String+ - The name of the Queue to be created
-        #
-        # Returns
-        # Queue::Board
-        #
-        # Example
-        #   create_queue('exampleQueue')
-        #   get_queue_message_count
-        def create_queue!(name)
-          begin
-            Smash::CloudPowers::Queue::Board.create!(to_camel(name), sqs)
-          rescue Aws::SQS::Errors::QueueDeletedRecently
-            sleep 5
-            retry
-          end
-        end
-
-        # Deletes a queue message without caring about reading/interacting with the message.
-        # This is usually used for progress tracking, ie; a Neuron takes a message from the Backlog, moves it to
-        # WIP and deletes it from Backlog.  Then repeats these steps for the remaining States in the Workflow
-        #
-        # Parameters
-        # * queue +String+ - queue is the name of the +Queue+ to interact with
-        # * opts +Hash+ (optional) - a configuration +Hash+ for the +SQS::QueuePoller+
-        #
-        # Notes
-        # * throws :stop_polling after the message is deleted
-        #
-        # Example
-        #   get_queue_message_count('exampleQueue')
-        #   # => n
-        #   delete_queue_message('exampleQueue')
-        #   get_queue_message_count('exampleQueue')
-        #   # => n-1
-        def delete_queue_message(queue, opts = {})
-          poll(queue, opts) do |msg, stats|
-            poller(queue).delete_message(msg)
-            throw :stop_polling
-          end
-        end
-
-        # This method is used to get the approximate count of messages in a given queue
-        #
-        # Parameters
-        # * board_url +String+ - the URL for the board you need to get a count from
-        #
-        # Returns
-        # +Float+
-        #
-        # Example
-        #   get_queue_message_count('exampleQueue')
-        #   # => n
-        #   delete_queue_message('exampleQueue')
-        #   get_queue_message_count('exampleQueue')
-        #   # => n-1
-        def get_queue_message_count(board_url)
-          sqs.get_queue_attributes(
-            queue_url: board_url,
-            attribute_names: ['ApproximateNumberOfMessages']
-          ).attributes['ApproximateNumberOfMessages'].to_f
-        end
-
-        # Get a message from a Queue
-        #
-        # Parameters
-        # * board<String|symbol>: The name of the board
-        #
-        # Returns
-        # * +String+ if +msg.body+ is not valid JSON
-        # * +Hash+ if +msg.body+ is valid JSON
-        #
-        # Example
-        #   # msg.body == 'Hey' # +String+
-        #   pluck_queue_message('exampleQueue')
-        #   # => 'Hey' # +String+
-        #
-        #   # msg.body == "\{"tally":"ho"\}" # +JSON+
-        #   pluck_queue_message('exampleQueue')
-        #   # => { 'tally' => 'ho' } # +Hash+
-        def pluck_queue_message(board)
-          poll(board) do |msg, poller|
-            poller.delete_message(msg)
-            return valid_json?(msg.body) ? JSON.parse(msg.body) : msg.body
-          end
-        end
-
-        # Polls the given board with the given options hash and a block that interacts with
-        # the message that is retrieved from the queue
-        #
-        # Parameters
-        # * +board+ +String+ - the name of the queue you want to poll
-        # * +opts+ +Hash+ - costomizes the Aws::SQS::QueuePoller's <tt>#poll(<b>opts</b>)</tt> method
-        # and can have any +AWS::SQS:QueuePoller+ polling configuration option(s)
-        # * +block+ is the block that is used to interact with the message that was retrieved
-        #
-        # Returns
-        # the results from the +message+ and the +block+ that interacts with the +message(s)+
-        #
-        # Example
-        #   # continuously run jobs from messages in the Queue and leaves the message in the queue
-        #   # using the +:skip_delete+ parameter
-        #   poll(:backlog, :skip_delete) do |msg|
-        #     demo_job = Job.new(msg.body)
-        #     demo_job.run
-        #   end
-        def poll(board_name, opts = {})
-          this_poller = queue_poller(board_name)
-          results = nil
-          this_poller.poll(opts) do |msg|
-            results = yield msg, this_poller if block_given?
-            this_poller.delete_message(msg)
-            throw :stop_polling
-          end
-          results
-        end
-
-        # This method can be used to gain a SQS::QueuePoller.  It creates a Board object,
-        # the Board then sends the API call to SQS to create the queue and sets an instance
-        # variable, using the board's name, to the Board object itself
-        #
-        # Parameters
-        # * board_name +String+ - name of the Queue you want to gain a QueuePoller for
-        #
-        # Returns
-        # <tt>board_name:Queue::Board</tt>
-        #
-        # Notes
-        # * An instance variable is set with this method, if one doesn't exist for the board
-        # The instance variable that is created/used is named the same name that was given as
-        # a parameter.
-        #
-        # Example
-        #   # these are equivalent after @exp_queue_poller is set but before it is set,
-        #   # exp_queue_poller
-        #   queue_poller('exampleQueue').poll { |msg| Job.new(msg.body).run }
-        #   @example_queue.poll { |msg| Job.new(msg.body).run }
-        def queue_poller(board_name)
-          board = Smash::CloudPowers::Queue::Board.create!(board_name, sqs)
-
-          unless instance_variable_defined?(board.i_var)
-            instance_variable_set(board.i_var, board)
-          end
-          instance_variable_get(board.i_var).poller
-        end
-
-        # Checks SQS for the existence of this queue using the <tt>#queue_search()</tt> method
-        #
-        # Parameters
-        # * name +String+
-        #
-        # Returns
-        # Boolean
-        #
-        # Notes
-        #   * see <tt>#queue_search()</tt>
-        def queue_exists?(name)
-          !queue_search(name).empty?
-        end
-
-        # Searches for a queue based on the name
-        #
-        # Parameters
-        # name +String+
-        #
-        # Returns
-        # queue_urls +String+
-        #
-        # Example
-        #   results = queue_search('exampleQueue') # returns related URLs
-        #   results.first =~ /exampleQueue/ # regex match against the URL
-        def queue_search(name)
-          sqs.list_queues(queue_name_prefix: name).queue_urls
-        end
-
-        # Sends a given message to a given queue
-        #
-        # Parameters
-        # * address +String+ - address of the Queue you want to interact with
-        # * message +String+ - message to be sent
-        #
-        # Returns
-        # <tt>Array<String></tt> - Array of URLs
-        #
-        # Example
-        #   legit_address = 'https://sqs.us-west-2.amazonaws.com/12345678/exampleQueue'
-        #   random_message = 'Wowza, this is pretty easy.'
-        #   resp = send_queue_message(legit_address, random_message))
-        #   resp.message_id
-        #   => 'some message id'
-        def send_queue_message(address, message, this_sqs = sqs)
-          this_sqs.send_message(queue_url: address, message_body: message)
-        end
-      end
-    end
-  end
-end