burdened-acrobat 0.3.4

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: d2f6475fbd73830f64d12f22a332b99720c438b0
+  data.tar.gz: 925b341a98f9d00028314ea12d360d60f09832ee
+SHA512:
+  metadata.gz: e5614e4517497e25563c0849bfc27174e5684b3126d1d7fedf463fefe3e3e4380d79a4e3841791650e54bd1cd88b1321a0b505777ad5815bc42b910c91fba092
+  data.tar.gz: cf7ec3864f6f91c67179e6eda5a20cd8556be12d58cf497f4a700c61dedc53bde545ac3b519ad16e62fe2c7a43428b4bf0632943964408a1e967983d6f11fa50

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,93 @@
+#+TITLE: Burdened Acrobat
+#+LATEX: \pagebreak
+
+* Overview
+
+=burdened-acrobat= helps identity specific load balancers (or groups of load
+balancers), when you have an unreasonable number of them. It does this by
+treating the problem as one of set membership.
+
+* Why does this exist?
+
+Some orchestration systems create large numbers of load balancers. Eventually,
+this becomes unwieldy to manage. =burdened-acrobat= makes it simple again.
+
+* Installation
+
+#+BEGIN_SRC shell
+  gem install burdened-acrobat
+#+END_SRC
+
+* Usage
+
+#+BEGIN_SRC ruby
+  require 'burdened-acrobat'
+
+  load_balancers = BurdenedAcrobat::LoadBalancers.new
+
+  load_balancers.search do
+    tagged('KubernetesCluster') & with('subnet-abv123') & tagged('kubernetes.io/service-name', 'app/identity-service')
+  end
+#+END_SRC
+
+=burdened-acrobat= operates on two main sets of information: Load Balancers, and Tags.
+
+** Tags
+
+~LoadBalancers#tags~ returns tags.
+
+| Given these Arguments          | Expect to get a collection of...      |
+|--------------------------------+---------------------------------------|
+| None                           | All tags                              |
+| A tag name                     | All tags matching that name           |
+| A tag name, and a value        | All tags matching that name and value |
+| A collection of load balancers | The tags on those load balancers      |
+
+
+** Load Balanceers
+
+~LoadBalancers#tagged~ returns load balancers.
+
+| Given these arguments   | Expect to get a collection of...                         |
+|-------------------------+----------------------------------------------------------|
+| None                    | All load balancers with tags                             |
+| A tag name              | All load balancers with the given tag                    |
+| A tag name, and a value | All load balancers where the given tag matches the value |
+| A collection of tags    | All load balancers matching those tags                   |
+
+** Everything!
+
+~LoadBalancers#all~ returns all load balancers.
+
+** Names
+
+~LoadBalancers#names~ accepts tags or load balancers, and returns names.
+
+** Using Names
+
+~LoadBalancers#named~ accepts names, and returns load balancers.
+
+** Complex Searches
+
+Everything returned is in the form of =Sets=. This allows building complex
+filters using ~#intersection~, ~#union~, ~#difference~, and so on.
+
+** AWS-specific extras
+
+When using Amazon ELBs, =burdened-acrobat= provides additional filters.
+
+-LoadBalancers#with~ returns load balancers.
+
+| Given these arguments | Expect to get a collection of                |
+|-----------------------+----------------------------------------------|
+| A VPC                 | All load balancers in that VPC               |
+| A security group      | All load balancers using that security group |
+| A subnet              | ALl load balancers using that subnet         |
+
+* License
+
+  ~burdened-acrobat~ 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/burdened-acrobat.gemspec

@@ -0,0 +1,17 @@
+Gem::Specification.new do |gem|
+  gem.name        = 'burdened-acrobat'
+  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/burdened-acrobat'
+  gem.summary     = 'Library for finding load balancers, when you have too many'
+
+  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.3'
+  gem.add_runtime_dependency 'contracts', '~> 0.14', '>= 0.14.0'
+end

data/lib/burdened-acrobat.rb

@@ -0,0 +1,2 @@
+require_relative 'burdened-acrobat/amazon'
+require_relative 'burdened-acrobat/load_balancers'

data/lib/burdened-acrobat/amazon.rb

@@ -0,0 +1,3 @@
+require_relative 'amazon/contracts'
+require_relative 'amazon/elb'
+require_relative 'amazon/mixins'

data/lib/burdened-acrobat/amazon/contracts.rb

@@ -0,0 +1,17 @@
+require 'aws-sdk'
+require 'contracts'
+
+module BurdenedAcrobat
+  module Amazon
+    module Contracts
+      include ::Contracts::Core
+      include ::Contracts::Builtin
+
+      LoadBalancerDescription = ::Aws::ElasticLoadBalancing::Types::LoadBalancerDescription
+      LoadBalancerDescriptions = Or[SetOf[LoadBalancerDescription], ArrayOf[LoadBalancerDescription]]
+
+      TagDescription = ::Aws::ElasticLoadBalancing::Types::TagDescription
+      TagDescriptions = Or[SetOf[TagDescription], ArrayOf[TagDescription]]
+    end
+  end
+end

data/lib/burdened-acrobat/amazon/elb.rb

@@ -0,0 +1,51 @@
+require 'aws-sdk'
+require_relative 'contracts'
+
+module BurdenedAcrobat
+  module Amazon
+    class ELB
+      include ::Contracts::Core
+      include ::Contracts::Builtin
+      include Contracts
+
+      Contract Maybe[HashOf[Symbol, Any]] => ELB
+      def initialize(**options)
+        @options = options
+        self
+      end
+
+      Contract None => ArrayOf[LoadBalancerDescription]
+      def load_balancers
+        @load_balancers ||= load_balancers!
+      end
+
+      Contract None => ArrayOf[LoadBalancerDescription]
+      def load_balancers!
+        @load_balancers = provider.describe_load_balancers.load_balancer_descriptions
+      end
+
+      Contract None => ArrayOf[String]
+      def names
+        load_balancers.map(&:load_balancer_name)
+      end
+
+      Contract None => ArrayOf[TagDescription]
+      def tags
+        @tags ||= tags!
+      end
+
+      Contract None => ArrayOf[TagDescription]
+      def tags!
+        @tags = names.each_slice(20).flat_map do |slice|
+          provider.describe_tags(load_balancer_names: slice).tag_descriptions
+        end
+      end
+
+      private
+
+      def provider
+        @provider ||= ::Aws::ElasticLoadBalancing::Client.new @options
+      end
+    end
+  end
+end

data/lib/burdened-acrobat/amazon/mixins.rb

@@ -0,0 +1,31 @@
+require 'contracts'
+require_relative 'contracts'
+
+module BurdenedAcrobat
+  module Amazon
+    module Mixins
+      include ::Contracts::Core
+      include ::Contracts::Builtin
+      include Contracts
+
+      VPCIdentifier = /vpc-[[:xdigit:]]+/
+      SubnetIdentifier = /subnet-[[:xdigit:]]+/
+      SecurityGroupIdentifier = /sg-[[:xdigit:]]+/
+
+      Contract VPCIdentifier => SetOf[LoadBalancerDescription]
+      def with(vpc)
+        Set.new all.select { |lb| lb.vpc_id == vpc }
+      end
+
+      Contract SubnetIdentifier => SetOf[LoadBalancerDescription]
+      def with(subnet)
+        Set.new all.select { |lb| lb.subnets.include? subnet }
+      end
+
+      Contract SecurityGroupIdentifier => SetOf[LoadBalancerDescription]
+      def with(security_group)
+        Set.new all.select { |lb| lb.security_groups.include? security_group }
+      end
+    end
+  end
+end

data/lib/burdened-acrobat/contracts.rb

@@ -0,0 +1,19 @@
+require 'contracts'
+
+module BurdenedAcrobat
+  module Contracts
+    include ::Contracts::Core
+    include ::Contracts::Builtin
+
+    Key = Or[String, Symbol]
+    Value = Or[String, Symbol]
+
+    Name = Or[String, Symbol]
+    Names = Or[SetOf[Name], ArrayOf[Name]]
+
+    Named = RespondTo[:load_balancer_name]
+    NamedCollection = Or[SetOf[Named], ArrayOf[Named]]
+
+    Service = RespondTo[:load_balancers, :load_balancers!, :tags, :tags!]
+  end
+end

data/lib/burdened-acrobat/load_balancers.rb

@@ -0,0 +1,101 @@
+require_relative 'amazon/contracts'
+require_relative 'amazon/elb'
+require_relative 'contracts'
+
+module BurdenedAcrobat
+  class LoadBalancers
+    include ::Contracts::Core
+    include ::Contracts::Builtin
+    include Contracts
+    include Amazon::Contracts
+    include Amazon::Mixins
+
+    Contract KeywordArgs[:service => Optional[Service]] => LoadBalancers
+    def initialize(**options)
+      @options = options
+      refresh!
+      self
+    end
+
+    Contract None => nil
+    def refresh!
+      nil.tap do
+        all!
+        tags!
+      end
+    end
+
+    def search(&block)
+      self.instance_eval(&block)
+    end
+
+    Contract None => SetOf[LoadBalancerDescription]
+    def all
+      @all ||= all!
+    end
+
+    Contract None => SetOf[TagDescription]
+    def tags
+      @tags ||= tags!
+    end
+
+    Contract Key => SetOf[TagDescription]
+    def tags(key)
+      Set.new tags.select { |lb| lb.tags.any? { |tag| tag.key == key.to_s } }
+    end
+
+    Contract Key, Value => SetOf[TagDescription]
+    def tags(key, value)
+      Set.new tags(key).select { |lb| lb.tags.any? { |tag| tag.value == value.to_s } }
+    end
+
+    Contract LoadBalancerDescriptions => SetOf[TagDescription]
+    def tags(load_balancers)
+      Set.new tags.select { |tag| names(load_balancers).include? tag.load_balancer_name }
+    end
+
+    Contract None => SetOf[LoadBalancerDescription]
+    def tagged
+      Set.new all.select { |lb| names(tags).include? lb.load_balancer_name }
+    end
+
+    Contract Key => SetOf[LoadBalancerDescription]
+    def tagged(key)
+      Set.new all.select { |lb| names(tags(key)).include? lb.load_balancer_name }
+    end
+
+    Contract Key, Value => SetOf[LoadBalancerDescription]
+    def tagged(key, value)
+      Set.new all.select { |lb| names(tags(key, value)).include? lb.load_balancer_name }
+    end
+
+    Contract TagDescriptions => SetOf[LoadBalancerDescription]
+    def tagged(tags)
+      Set.new all.select { |lb| names(tags).include? lb.load_balancer_name }
+    end
+
+    Contract NamedCollection => SetOf[String]
+    def names(load_balancers)
+      Set.new load_balancers.map(&:load_balancer_name)
+    end
+
+    Contract Names => SetOf[LoadBalancerDescription]
+    def named(names)
+      Set.new names.map { |name| all.find { |lb| lb.load_balancer_name == name } }
+    end
+
+    private
+
+    def service
+      @service = @options.fetch(:service) { Amazon::ELB.new }
+    end
+
+    def all!
+      @all = Set.new service.load_balancers!
+    end
+
+    def tags!
+      @tags = Set.new service.tags!
+    end
+  end
+end

metadata

@@ -0,0 +1,93 @@
+--- !ruby/object:Gem::Specification
+name: burdened-acrobat
+version: !ruby/object:Gem::Version
+  version: 0.3.4
+platform: ruby
+authors:
+- Chris Olstrom
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-09-27 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.3
+  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.3
+- !ruby/object:Gem::Dependency
+  name: contracts
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.14'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.14.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.14'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.14.0
+description: 
+email: chris@olstrom.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- README.org
+- burdened-acrobat.gemspec
+- lib/burdened-acrobat.rb
+- lib/burdened-acrobat/amazon.rb
+- lib/burdened-acrobat/amazon/contracts.rb
+- lib/burdened-acrobat/amazon/elb.rb
+- lib/burdened-acrobat/amazon/mixins.rb
+- lib/burdened-acrobat/contracts.rb
+- lib/burdened-acrobat/load_balancers.rb
+homepage: https://github.com/colstrom/burdened-acrobat
+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.5.1
+signing_key: 
+specification_version: 4
+summary: Library for finding load balancers, when you have too many
+test_files: []