pareidolia 0.14.6

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 3dedcb75f8608a1e6925b2ead8e0801c3f8ebfc1
+  data.tar.gz: 5182c8a05251d0e4ed397c256895034e2568f63d
+SHA512:
+  metadata.gz: 8a0972727f7f7eb95a37099937def133de9bb42f4f3c8abe19956d8b2f5bae72605078b0840d0cc850d00e8fb18e395f634c7131d4700b3a2c3d1fb2a6dbfd4f
+  data.tar.gz: 6fb32ae0c98e13426e4af6982b24a34675357d4a998859107e1d99bca6115b9e54ec03e49d846682869bfcd68bb51babf7acb8749f770190328bb4583934c252

data/.gitignore

@@ -0,0 +1,54 @@
+
+# Created by https://www.gitignore.io/api/ruby
+
+### Ruby ###
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/spec/examples.txt
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+# Used by dotenv library to load environment variables.
+# .env
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+*.bridgesupport
+build-iPhoneOS/
+build-iPhoneSimulator/
+
+## Specific to RubyMotion (use of CocoaPods):
+#
+# We recommend against adding the Pods directory to your .gitignore. However
+# you should judge for yourself, the pros and cons are mentioned at:
+# https://guides.cocoapods.org/using/using-cocoapods.html#should-i-check-the-pods-directory-into-source-control
+#
+# vendor/Pods/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalization:
+/.bundle/
+/vendor/bundle
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+# Gemfile.lock
+# .ruby-version
+# .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc

data/LICENSE.txt

@@ -0,0 +1,21 @@
+
+The MIT License (MIT)
+Copyright © 2016 Chris Olstrom <chris@olstrom.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the “Software”), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.org

@@ -0,0 +1,65 @@
+#+TITLE: Pareidolia - A Library for Clouding Coherently
+#+LATEX: \pagebreak
+
+* Overview
+
+=pareidolia= makes aws-sdk seem more consistent than actually it is.
+
+* Why does this exist?
+
+=aws-sdk= is an excellent gem, but there are a lot of places where the
+inconsistencies of the API show through. =pareidolia= is a thin layer on top of
+this, providing the missing consistency.
+
+* Installation
+
+  #+BEGIN_SRC shell
+    gem install pareidolia
+  #+END_SRC
+
+* Enhancements
+
+** Handles Rate Limiting
+   
+   Rate Limit errors are handled by retrying after a randomized delay of between
+   =1.0= and =4.0= seconds.
+
+** Caching
+
+   Responses are cached by default, using simple memoization. Every method
+   includes a ~!~ variant that ignores the cache (and updates it with the
+   response).
+
+** Straightforward Response Payloads
+
+   Most AWS calls return an envelope of sorts. More confusingly, the
+   envelope is not consistently shaped.
+   
+   - =describe_vpcs= returns a =Struct= with a =vpcs= field.
+   - =describe_instances= returns a =Struct= with a =reservations= field, that
+     in turn contains an =Array= of =Structs= with an =instances= field.
+   - =describe_moving_addresses= returns a =Struct= with a
+     =moving_address_statuses= field.
+   - =describe_volume_status= returns a =Struct= with a =volume_statuses= field.
+   - and so on.
+
+   =pareidolia= returns the *contents* of the envelope, instead.
+
+   - =vpcs= returns an =Array= of =VPC=.
+   - =instances= returns an =Array= of =Instance=.
+   - =moving_address_statuses= returns an =Array= of =MovingAddressStatus=.
+   - =volume_statuses= returns an =Array= of =VolumeStatus=.
+
+** Consistent Method Names
+
+   - =reservations= returns an =Array= of =Reservation=.
+   - =moving_address_statuses= is an alias for =moving_addresses=
+   - =instance_statuses= is an alias for =instance_status=
+
+* License
+
+  ~pareidolia~ is available under the [[https://tldrlegal.com/license/mit-license][MIT License]]. See ~LICENSE.txt~ for the full text.
+
+* Contributors
+
+  - [[https://colstrom.github.io/][Chris Olstrom]] | [[mailto:chris@olstrom.com][e-mail]] | [[https://twitter.com/ChrisOlstrom][Twitter]]

data/lib/pareidolia/aws/ec2/client.rb

@@ -0,0 +1,198 @@
+require 'aws-sdk'
+
+module Pareidolia
+  module Aws
+    module EC2
+      class Client
+        METHODS = ::Aws::EC2::Client.public_instance_methods(false)
+        DESCRIBE_METHODS = METHODS.select { |m| m.to_s.start_with? 'describe' }
+
+        def initialize(**options)
+          @options = options
+          self
+        end
+
+        def classic_link_instances!
+          @classic_link_instances = describe_classic_link_instances.instances
+        end
+
+        def host_reservations!
+          @host_reservations = describe_host_reservations.host_reservation_set
+        end
+
+        def id_format!
+          @id_format = describe_id_format.statuses
+        end
+
+        def image_attribute!(**options)
+          describe_image_attribute options
+        end
+
+        alias image_attribute image_attribute!
+
+        def instance_attribute!(**options)
+          describe_instance_attribute options
+        end
+
+        alias instance_attribute instance_attribute!
+
+        def instance_status!
+          @instance_status = describe_instance_status.instance_statuses
+        end
+
+        def instance_status
+          @instance_status ||= instance_status!
+        end
+
+        alias instance_statuses! instance_status!
+        alias instance_statuses instance_status
+
+        def reservations!
+          @reservations = describe_instances.reservations
+        end
+
+        def reservations
+          @reservations ||= reservations!
+        end
+
+        def instances!
+          @instances = reservations!.flat_map(&:instances)
+        end
+
+        def moving_addresses!
+          @moving_addresses = describe_moving_addresses.moving_address_statuses
+        end
+
+        def moving_addresses
+          @moving_addresses ||= moving_addresses!
+        end
+
+        alias moving_address_statuses! moving_addresses!
+        alias moving_address_statuses moving_addresses
+
+        def network_interface_attribute!(**options)
+          describe_network_interface_attribute options
+        end
+
+        alias network_interface_attribute network_interface_attribute!
+
+        def scheduled_instance_availability!(**options)
+          describe_scheduled_instance_availability options
+        end
+
+        alias scheduled_instance_availability scheduled_instance_availability!
+
+        def scheduled_instances!
+          @scheduled_instances = describe_scheduled_instances.scheduled_instance_set
+        end
+
+        def security_group_references!(**options)
+          describe_security_group_references(options).security_group_reference_set
+        end
+
+        alias security_group_references security_group_references!
+
+        def snapshot_attribute!(**options)
+          describe_snapshot_attribute options
+        end
+
+        alias snapshot_attribute snapshot_attribute!
+
+        def spot_fleet_instances!(**options)
+          describe_spot_fleet_instances options
+        end
+
+        alias spot_fleet_instances spot_fleet_instances!
+
+        def spot_fleet_request_history!(**options)
+          describe_spot_fleet_request_history options
+        end
+
+        alias spot_fleet_request_history spot_fleet_request_history!
+
+        def spot_fleet_requests!
+          @spot_fleet_requests = describe_spot_fleet_requests.spot_fleet_request_configs
+        end
+
+        def stale_security_groups!(**options)
+          describe_stale_security_groups options
+        end
+
+        alias stale_security_groups stale_security_groups!
+
+        def volume_attribute!(**options)
+          describe_volume_attribute options
+        end
+
+        alias volume_attribute volume_attribute!
+
+        def volume_status!
+          @volume_status = describe_volume_status.volume_statuses
+        end
+
+        def volume_status
+          @volume_status ||= volume_status!
+        end
+
+        alias volume_statuses! volume_status!
+        alias volume_statuses volume_status
+
+        def vpc_attribute!(**options)
+          describe_vpc_attribute options
+        end
+
+        alias vpc_attribute vpc_attribute!
+
+        def vpc_classic_link!
+          @vpc_classic_link = describe_vpc_classic_link.vpcs
+        end
+
+        def vpc_classic_link_dns_support!
+          @vpc_classic_link_dns_support = describe_vpc_classic_link_dns_support.vpcs
+        end
+
+        def vpc_endpoint_services!
+          @vpc_endpoint_services = describe_vpc_endpoint_services.service_names
+        end
+
+        DESCRIBE_METHODS.each do |method|
+          name = method.to_s.split('_').drop(1).join('_')
+          raw = [name, '!'].join
+          var = ['@', name].join
+
+          define_method(raw) do |*args|
+            r = send(method, *args)
+            instance_variable_set var, (r.respond_to?(name) ? r.send(name) : r)
+          end unless method_defined?(raw)
+
+          define_method(name) do |*args|
+            if instance_variable_defined? var
+              instance_variable_get var
+            else
+              send(raw, *args)
+            end
+          end unless method_defined?(name)
+        end
+
+        private
+
+        def ec2
+          @ec2 ||= ::Aws::EC2::Client.new @options
+        end
+
+        def method_missing(method, *args)
+          return super unless respond_to? method
+
+          ec2.public_send(method, *args)
+        rescue ::Aws::EC2::Errors::RequestLimitExceeded
+          sleep rand 1..4.0
+          retry
+        end
+
+        def respond_to?(method)
+          ec2.respond_to?(method) || super
+        end
+      end
+    end
+  end
+end

data/lib/pareidolia/aws/ec2.rb

@@ -0,0 +1 @@
+require_relative 'ec2/client'

data/lib/pareidolia/aws.rb

@@ -0,0 +1 @@
+require_relative 'aws/ec2'

data/lib/pareidolia.rb

@@ -0,0 +1 @@
+require_relative 'pareidolia/aws'

data/pareidolia.gemspec

@@ -0,0 +1,16 @@
+Gem::Specification.new do |gem|
+  gem.name        = 'pareidolia'
+  gem.version     = `git describe --tags --abbrev=0`.chomp
+  gem.licenses    = 'MIT'
+  gem.authors     = ['Chris Olstrom']
+  gem.email       = 'chris@olstrom.com'
+  gem.homepage    = 'https://github.com/colstrom/pareidolia'
+  gem.summary     = 'Clouding Coherently'
+
+  gem.files         = `git ls-files`.split("\n")
+  gem.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  gem.executables   = `git ls-files -- bin/*`.split("\n").map { |f| File.basename(f) }
+  gem.require_paths = ['lib']
+
+  gem.add_runtime_dependency 'aws-sdk', '~> 2.6', '>= 2.6.0'
+end

metadata

@@ -0,0 +1,71 @@
+--- !ruby/object:Gem::Specification
+name: pareidolia
+version: !ruby/object:Gem::Version
+  version: 0.14.6
+platform: ruby
+authors:
+- Chris Olstrom
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-10-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: aws-sdk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.6.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.6'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.6.0
+description: 
+email: chris@olstrom.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- LICENSE.txt
+- README.org
+- lib/pareidolia.rb
+- lib/pareidolia/aws.rb
+- lib/pareidolia/aws/ec2.rb
+- lib/pareidolia/aws/ec2/client.rb
+- pareidolia.gemspec
+homepage: https://github.com/colstrom/pareidolia
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.7
+signing_key: 
+specification_version: 4
+summary: Clouding Coherently
+test_files: []