swa 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 38d68962033d474157c7cadb13472a7caa52b276
-  data.tar.gz: f0b954064b850223718f06d2310269ce81534099
+SHA256:
+  metadata.gz: b1dfb1773a649e5d9e24e8ee24739cb6b2df451bb2cd4ffdf6a9b4336c067d87
+  data.tar.gz: dc90877d13ad90f7df91dfcec228639de7dd1393b42f2378ee2236421e1d44a4
 SHA512:
-  metadata.gz: aac97d88b50058e49ce713e83628986e84e6756b5ca2f4a9804d9ee2fb81bfdb4e5199e3ced6395dbc86fb090bae020577c009f62b9057b6dbe46628f4c9800d
-  data.tar.gz: b909e0ff69d22933101c0a9e20eb4f580e6589a31992ecfb88e20cc71ccf109321ba2edb292e3da23eb3825494979406cd2f9a85bf20e28405f957389034f3f6
+  metadata.gz: 52ee4e00fd3bc9c3001d6a8168a3278f387da0a31732d9dd2bbb4a1971b9066150638ccdf757eac652ff8f6116b58d820262c030d1b018c32605b4475c59feb1
+  data.tar.gz: ec4a90e0a5a3e973c051227c33adb9d63048d82a31ca745a9c754593d738c76d0c58f3f6fbdfe75e9beae5c9dd4aa159b38016c2c444ac6ac1453aa5b3b8721f

data/README.md

@@ -76,6 +76,17 @@ The "item" sub-command can be ommitted, when it can be inferred from the resourc
     $ swa ec2 i-bcf48c2b data
     $ swa ec2 ami-1e73737d data
 
+## Installing it
+
+SWA is packaged as a Ruby gem, and can be installed with:
+
+    gem install swa
+
+On a Mac, I recommend [brew-gem](https://github.com/sportngin/brew-gem) for easy system-wide installation:
+
+    brew install brew-gem
+    brew gem install swa
+
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/mdub/swa.

data/lib/swa/cli/cloud_formation_command.rb

@@ -1,4 +1,4 @@
-require "aws-sdk-resources"
+require "aws-sdk-cloudformation"
 require "swa/cli/base_command"
 require "swa/cli/collection_behaviour"
 require "swa/cli/item_behaviour"

data/lib/swa/cli/collection_behaviour.rb

@@ -19,6 +19,14 @@ module Swa
 
         end
 
+        target.subcommand ["ids"], "Just print ids" do
+          def execute
+            collection.each do |i|
+              puts i.id
+            end
+          end
+        end
+
         target.subcommand ["data", "d"], "Full details" do
 
           parameter "[QUERY]", "JMESPath expression"

data/lib/swa/cli/ec2_command.rb

@@ -1,4 +1,4 @@
-require "aws-sdk-resources"
+require "aws-sdk-ec2"
 require "swa/cli/base_command"
 require "swa/cli/collection_behaviour"
 require "swa/cli/item_behaviour"
@@ -227,10 +227,25 @@ module Swa
           List key-pairs.
         EOF
 
+        option "--named", "PATTERN", "name pattern"
+
         include CollectionBehaviour
 
+        subcommand "delete", "Delete all key-pairs" do
+          def execute
+            signal_error "no key-pairs specified" unless selector.specified?
+            key_pairs.each(&:delete)
+          end
+        end
+
         private
 
+        def named=(pattern)
+          selector.add do |kp|
+            File.fnmatch(pattern, kp.name)
+          end
+        end
+
         def key_pairs
           query_for(:key_pairs, Swa::EC2::KeyPair)
         end
@@ -245,6 +260,12 @@ module Swa
 
         include ItemBehaviour
 
+        subcommand ["delete"], "Delete group" do
+          def execute
+            security_group.delete
+          end
+        end
+
         private
 
         def security_group
@@ -260,6 +281,12 @@ module Swa
         include TagFilterOptions
         include CollectionBehaviour
 
+        subcommand ["delete"], "Delete group" do
+          def execute
+            security_groups.each(&:delete)
+          end
+        end
+
         private
 
         def security_groups
@@ -302,12 +329,34 @@ module Swa
         EOF
 
         option "--owned-by", "OWNER", "with specified owner", :default => "self"
+        option ["--volume", "--of"], "VOLUME-ID", "for specified volume"
+
+        option ["--started-after", "--after"], "WHEN", "earliest start-time"
+        option ["--started-before", "--before"], "WHEN", "latest start-time"
 
         include TagFilterOptions
         include CollectionBehaviour
 
         private
 
+        def volume=(volume_id)
+          add_filter("volume-id", volume_id)
+        end
+
+        def started_after=(datetime_string)
+          min_start_time = parse_datetime(datetime_string).max
+          selector.add do |image|
+            image.start_time > min_start_time
+          end
+        end
+
+        def started_before=(datetime_string)
+          max_start_time = parse_datetime(datetime_string).min
+          selector.add do |image|
+            image.start_time < max_start_time
+          end
+        end
+
         def snapshots
           query_options[:owner_ids] = [owned_by]
           query_for(:snapshots, Swa::EC2::Snapshot)

data/lib/swa/cli/elb_command.rb

@@ -0,0 +1,53 @@
+require "aws-sdk-elasticloadbalancing"
+require "swa/cli/base_command"
+require "swa/cli/collection_behaviour"
+require "swa/cli/item_behaviour"
+require "swa/elb/load_balancer"
+
+module Swa
+  module CLI
+
+    class ElbCommand < BaseCommand
+
+      subcommand ["load-balancer", "lb"], "Show load-balancer" do
+
+        parameter "NAME", "ELB name"
+
+        include ItemBehaviour
+
+        private
+
+        def item
+          results = describe_load_balancers(:load_balancer_names => [name])
+          signal_error "No such ELB '#{name}'" unless results.any?
+          Swa::ELB::LoadBalancer.new(results.first)
+        end
+
+      end
+
+      subcommand ["load-balancers", "lbs"], "Show load-balancers" do
+
+        include CollectionBehaviour
+
+        private
+
+        def collection
+          Swa::ELB::LoadBalancer.list(describe_load_balancers)
+        end
+
+      end
+
+      protected
+
+      def elb_client
+        ::Aws::ElasticLoadBalancing::Client.new(aws_config)
+      end
+
+      def describe_load_balancers(options = {})
+        elb_client.describe_load_balancers(options).load_balancer_descriptions
+      end
+
+    end
+
+  end
+end

data/lib/swa/cli/glue_command.rb

@@ -0,0 +1,192 @@
+require "aws-sdk-glue"
+require "swa/cli/base_command"
+require "swa/cli/collection_behaviour"
+require "swa/cli/item_behaviour"
+require "swa/glue/crawler"
+require "swa/glue/database"
+require "swa/glue/job"
+require "swa/glue/job_run"
+require "swa/glue/job_bookmark_entry"
+require "swa/glue/partition"
+require "swa/glue/table"
+
+module Swa
+  module CLI
+
+    class GlueCommand < BaseCommand
+
+      subcommand ["crawler"], "Show crawler" do
+
+        parameter "NAME", "crawler name"
+
+        include ItemBehaviour
+
+        private
+
+        def item
+          Swa::Glue::Crawler.new(glue_client.get_crawler(:name => name).crawler)
+        end
+
+      end
+
+      subcommand ["crawlers"], "Show crawlers" do
+
+        include CollectionBehaviour
+
+        private
+
+        def collection
+          query_for(:get_crawlers, :crawlers, Swa::Glue::Crawler)
+        end
+
+      end
+
+      subcommand ["database"], "Show database" do
+
+        parameter "NAME", "database name"
+
+        include ItemBehaviour
+
+        private
+
+        def item
+          Swa::Glue::Database.new(glue_client.get_database(:name => name).database)
+        end
+
+        subcommand ["table"], "Show table" do
+
+          parameter "NAME", "table name", attribute_name: :table_name
+
+          include ItemBehaviour
+
+          subcommand ["partitions"], "Show partitions" do
+
+            include CollectionBehaviour
+
+            private
+
+            def collection
+              query_for(:get_partitions, :partitions, Swa::Glue::Partition, :database_name => name, :table_name => table_name)
+            end
+
+          end
+
+          private
+
+          def item
+            Swa::Glue::Table.new(glue_client.get_table(
+              :database_name => name, :name => table_name
+            ).table)
+          end
+
+        end
+
+        subcommand ["tables"], "Show tables" do
+
+          include CollectionBehaviour
+
+          private
+
+          def collection
+            query_for(:get_tables, :table_list, Swa::Glue::Table, :database_name => name)
+          end
+
+        end
+
+      end
+
+      subcommand ["databases"], "Show databases" do
+
+        include CollectionBehaviour
+
+        private
+
+        def collection
+          query_for(:get_databases, :database_list, Swa::Glue::Database)
+        end
+
+      end
+
+      subcommand ["job"], "Show job" do
+
+        parameter "NAME", "job name"
+
+        include ItemBehaviour
+
+        private
+
+        def item
+          Swa::Glue::Job.new(glue_client.get_job(:job_name => name).job)
+        end
+
+        subcommand ["run"], "Show run" do
+
+          parameter "ID", "run ID", attribute_name: :run_id
+
+          include ItemBehaviour
+
+          subcommand ["bookmark"], "Show bookmark" do
+
+            self.default_subcommand = "summary"
+
+            include ItemBehaviour
+
+            private
+
+            def item
+              Swa::Glue::JobBookmarkEntry.new(
+                glue_client.get_job_bookmark(:job_name => name, :run_id => run_id).job_bookmark_entry
+              )
+            end
+
+          end
+
+          private
+
+          def item
+            Swa::Glue::JobRun.new(glue_client.get_job_run(:job_name => name, :run_id => run_id).job_run)
+          end
+
+        end
+
+        subcommand ["runs"], "Show runs" do
+
+          include CollectionBehaviour
+
+          private
+
+          def collection
+            query_for(:get_job_runs, :job_runs, Swa::Glue::JobRun, :job_name => name)
+          end
+
+        end
+
+      end
+
+      subcommand ["jobs"], "Show jobs" do
+
+        include CollectionBehaviour
+
+        private
+
+        def collection
+          query_for(:get_jobs, :jobs, Swa::Glue::Job)
+        end
+
+      end
+
+      protected
+
+      def glue_client
+        ::Aws::Glue::Client.new(aws_config)
+      end
+
+      def query_for(query_method, response_key, model, **query_args)
+        records = glue_client.public_send(query_method, **query_args).public_send(response_key)
+        model.list(records)
+      end
+
+    end
+
+  end
+end

data/lib/swa/cli/iam_command.rb

@@ -1,8 +1,10 @@
-require "aws-sdk-resources"
+require "aws-sdk-iam"
 require "swa/cli/base_command"
 require "swa/cli/collection_behaviour"
 require "swa/cli/item_behaviour"
+require "swa/iam/credentials"
 require "swa/iam/group"
+require "swa/iam/instance_profile"
 require "swa/iam/policy"
 require "swa/iam/role"
 require "swa/iam/user"
@@ -42,6 +44,36 @@ module Swa
 
       end
 
+      subcommand ["instance-profile", "ip"], "Show instance-profile" do
+
+        parameter "NAME", "name/ARN"
+
+        include ItemBehaviour
+
+        private
+
+        def item
+          Swa::IAM::InstanceProfile.new(iam.instance_profile(File.basename(name)))
+        end
+
+      end
+
+      subcommand ["instance-profiles", "ips"], "Show instance-profiles" do
+
+        self.description = <<-EOF
+          List instance-profiles.
+        EOF
+
+        include CollectionBehaviour
+
+        private
+
+        def collection
+          query_for(:instance_profiles, Swa::IAM::InstanceProfile)
+        end
+
+      end
+
       subcommand ["policy"], "Show policy" do
 
         parameter "ARN", "policy ARN"
@@ -70,12 +102,29 @@ module Swa
           List policies.
         EOF
 
+        option "--scope", "SCOPE", "'AWS' or 'Local'" do |arg|
+          case arg.downcase
+          when "all", "*"
+            "All"
+          when "local"
+            "Local"
+          when "aws"
+            "AWS"
+          else
+            raise ArgumentError, "must be one of 'All', 'AWS' or 'Local'"
+          end
+        end
+
         include CollectionBehaviour
 
         private
 
         def collection
-          query_for(:policies, Swa::IAM::Policy)
+          query_for(:policies, Swa::IAM::Policy, query_options)
+        end
+
+        def query_options
+          { :scope => scope }.reject { |_k,v| v.nil? }
         end
 
       end
@@ -92,6 +141,41 @@ module Swa
           Swa::IAM::Role.new(iam.role(File.basename(name)))
         end
 
+        subcommand "assume", "Assume the role" do
+
+          option "--session-name", "NAME", "STS session-name",
+                 :environment_variable => "USER",
+                 :default => "swa"
+
+          parameter "[COMMAND] ...", "command to execute"
+
+          def execute
+            env = assume.to_env
+            if command_list.empty?
+              dump_env(env)
+            else
+              exec(env, *command_list)
+            end
+          end
+
+          private
+
+          def assume
+            response = sts_client.assume_role(
+              :role_arn => item.arn,
+              :role_session_name => session_name
+            )
+            Swa::IAM::Credentials.new(response.credentials.to_h)
+          end
+
+          def dump_env(env)
+            env.each do |k,v|
+              puts "#{k}=#{v}"
+            end
+          end
+
+        end
+
       end
 
       subcommand ["roles"], "Show roles" do
@@ -146,11 +230,15 @@ module Swa
         ::Aws::IAM::Resource.new(aws_config)
       end
 
-      def query_for(query_method, resource_model)
-        aws_resources = iam.public_send(query_method)
+      def query_for(query_method, resource_model, *query_args)
+        aws_resources = iam.public_send(query_method, *query_args)
         wrapped_resources = resource_model.list(aws_resources)
       end
 
+      def sts_client
+        ::Aws::STS::Client.new(aws_config)
+      end
+
     end
 
   end

data/lib/swa/cli/kms_command.rb

@@ -1,4 +1,4 @@
-require "aws-sdk-resources"
+require "aws-sdk-kms"
 require "swa/cli/base_command"
 require "swa/cli/collection_behaviour"
 require "swa/cli/item_behaviour"

data/lib/swa/cli/main_command.rb

@@ -1,6 +1,8 @@
 require "swa/cli/base_command"
 require "swa/cli/cloud_formation_command"
 require "swa/cli/ec2_command"
+require "swa/cli/elb_command"
+require "swa/cli/glue_command"
 require "swa/cli/iam_command"
 require "swa/cli/kms_command"
 require "swa/cli/s3_command"
@@ -12,6 +14,8 @@ module Swa
 
       subcommand ["cf", "cloudformation"], "CloudFormation stuff", CloudFormationCommand
       subcommand "ec2", "EC2 stuff", Ec2Command
+      subcommand "elb", "elb stuff", ElbCommand
+      subcommand "glue", "Glue stuff", GlueCommand
       subcommand "iam", "IAM stuff", IamCommand
       subcommand "kms", "KMS stuff", KmsCommand
       subcommand "s3", "S3 stuff", S3Command

data/lib/swa/cli/s3_command.rb

@@ -1,4 +1,4 @@
-require "aws-sdk-resources"
+require "aws-sdk-s3"
 require "swa/cli/base_command"
 require "swa/cli/collection_behaviour"
 require "swa/cli/item_behaviour"
@@ -82,6 +82,30 @@ module Swa
 
           end
 
+          subcommand ["version", "v"], "Show version" do
+
+            parameter "ID", "object version ID", :attribute_name => :version_id
+
+            include ItemBehaviour
+
+            subcommand "get", "GET object" do
+
+              def execute
+                IO.copy_stream(version.get_body, $stdout)
+              end
+
+            end
+
+            protected
+
+            def version
+              object.version(version_id)
+            end
+
+            alias_method :item, :version
+
+          end
+
           protected
 
           def object
@@ -137,6 +161,51 @@ module Swa
 
         end
 
+        subcommand ["object-versions", "versions", "vs"], "List object-versions" do
+
+          option "--prefix", "PREFIX", "object prefix"
+
+          self.default_subcommand = "list"
+
+          subcommand ["list", "ls"], "One-line summary" do
+
+            def execute
+              versions.each do |i|
+                puts i.summary
+              end
+            end
+
+          end
+
+          subcommand ["data", "d"], "Full details" do
+
+            parameter "[QUERY]", "JMESPath expression"
+
+            def execute
+              display_data(versions.map(&:data).to_a, query)
+            end
+
+          end
+
+          subcommand "delete-all", "Delete versions" do
+
+            def execute
+              versions.each do |v|
+                logger.info "Deleting #{v.uri} #{v.id}"
+                v.delete
+              end
+            end
+
+          end
+
+          protected
+
+          def versions
+            bucket.object_versions(:prefix => prefix)
+          end
+
+        end
+
         subcommand "policy", "print bucket policy" do
 
           def execute

data/lib/swa/cli/selector.rb

@@ -21,6 +21,10 @@ module Swa
         collection.lazy.select(&method(:call))
       end
 
+      def specified?
+        @predicates.any?
+      end
+
     end
 
   end

data/lib/swa/cloud_formation/stack.rb

@@ -7,6 +7,10 @@ module Swa
 
     class Stack < Resource
 
+      def id
+        name
+      end
+
       def summary
         [
           pad(name, 44),

data/lib/swa/ec2/image.rb

@@ -8,6 +8,10 @@ module Swa
 
       include TaggedResource
 
+      def id
+        ami.image_id
+      end
+
       def summary
         [
           field(ami, :image_id),