lsaws 0.3.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fc348c9f2fd3c7a4f3159329804809b7800307aa42eedfdc01b17d9c8e220021
-  data.tar.gz: b558293f705f7df368d75aeb41a6bc133fd7bb3a366ddef2f790f99267c019c5
+  metadata.gz: e2b87621670d3747c4c1b6cb9979c7401f7e736ceb8c257819a42dc31b190471
+  data.tar.gz: ab3227e58e62f14a718858242bd2cdd5ffd8f6a5f15acc38550605a01aea2352
 SHA512:
-  metadata.gz: 2c2a9d0c17689697c13aa3be30e05b6406a7d0031102342e3bddfcd56a486b73e23c57cdfcae8fa9653443e66fefb8b5d962c57abd044f103ecf26e85a69d7a4
-  data.tar.gz: 2dc1db342c3d646d9b5e7504b01cf2fdd9f83ad9e90298bde50f69eaf9b5adffce0405a0b8b86ea7890617fb484262780397a9ee08bb0e43a9a652d22d8672e8
+  metadata.gz: 4eeb107b1267e40dadb27fccb5dc619f53807410c68c3b85cda9c5e63e3c57da9ab731b422f1c236a0b3bc7a2701e4bffee989257676a9e3cff20cfc9ce2b07c
+  data.tar.gz: a725ba9efec0bf251516ca30a8841dac825ca3dacaf2adf00dcef453f2806e22d946512a6b4f6e70bb6f72547f2204e474065f623f86bc258e0a48624c8e9aef

data/README.md

@@ -23,6 +23,88 @@ User-friendly AWS resources listing tool
         -A, --all                        List all entity types within SDK
 
 
+### Listing installed SDKs
+
+    # lsaws -L
+
+    accessanalyzer
+    account
+    acm
+    acmpca
+    alexaforbusiness
+    amplify
+    amplifybackend
+    amplifyuibuilder
+    apigateway
+    apigatewaymanagementapi
+    apigatewayv2
+    appconfig
+    appconfigdata
+    appflow
+    appintegrationsservice
+    applicationautoscaling
+    applicationcostprofiler
+    applicationdiscoveryservice
+    applicationinsights
+    appmesh
+    appregistry
+    apprunner
+    appstream
+    appsync
+    arczonalshift
+    ...
+
+
+### Listing listable entities from EC2 sdk
+
+    # lsaws ec2 -L
+
+    account_attributes
+    address_transfers
+    addresses
+    availability_zones
+    aws_network_performance_metric_subscriptions
+    bundle_tasks
+    capacity_reservation_fleets
+    capacity_reservations
+    carrier_gateways
+    classic_link_instances
+    client_vpn_endpoints
+    coip_pools
+    conversion_tasks
+    customer_gateways
+    dhcp_options
+    egress_only_internet_gateways
+    elastic_gpus
+    export_image_tasks
+    export_tasks
+    fast_launch_images
+    fast_snapshot_restores
+    fleets
+    flow_logs
+    fpga_images
+    host_reservation_offerings
+    ...
+
+
+### Listing EC2 instances
+
+    # lsaws ec2
+
+    ┌─────────────────────┬─────────────┬───────────────────────┬────────────────────┬─────────────────────────┐
+    │ instance_id         │ name        │ vpc_id                │ private_ip_address │ launch_time             │
+    ├─────────────────────┼─────────────┼───────────────────────┼────────────────────┼─────────────────────────┤
+    │ i-1234567890abcdef0 │ my-instance │ vpc-1234567890abcdef0 │ 10-0-0-157         │ 2022-11-15 10:48:59 UTC │
+    └─────────────────────┴─────────────┴───────────────────────┴────────────────────┴─────────────────────────┘
+
+### Listing specific columns of EC2 images as json-stream
+
+    # lsaws ec2 images -c image_id,creation_date -o js
+
+    {"image_id":"ami-1234e6197567838b4","creation_date":"2023-01-11T13:02:00.000Z"}
+    {"image_id":"ami-1234f58a167898416","creation_date":"2023-01-11T02:02:00.000Z"}
+    {"image_id":"ami-12341a1fd567897a8","creation_date":"2023-01-01T01:02:00.000Z"}
+
 ## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/README.md.tpl

@@ -6,6 +6,32 @@ User-friendly AWS resources listing tool
 
 % lsaws
 
+### Listing installed SDKs
+
+% lsaws -L
+
+### Listing listable entities from EC2 sdk
+
+% lsaws ec2 -L
+
+### Listing EC2 instances
+
+    # lsaws ec2
+
+    ┌─────────────────────┬─────────────┬───────────────────────┬────────────────────┬─────────────────────────┐
+    │ instance_id         │ name        │ vpc_id                │ private_ip_address │ launch_time             │
+    ├─────────────────────┼─────────────┼───────────────────────┼────────────────────┼─────────────────────────┤
+    │ i-1234567890abcdef0 │ my-instance │ vpc-1234567890abcdef0 │ 10-0-0-157         │ 2022-11-15 10:48:59 UTC │
+    └─────────────────────┴─────────────┴───────────────────────┴────────────────────┴─────────────────────────┘
+
+### Listing specific columns of EC2 images as json-stream
+
+    # lsaws ec2 images -c image_id,creation_date -o js
+
+    {"image_id":"ami-0245e6197bf3138b4","creation_date":"2023-01-19T12:03:38.000Z"}
+    {"image_id":"ami-0bc3f58a172118416","creation_date":"2023-01-20T09:37:32.000Z"}
+    {"image_id":"ami-07e71a1fdf49957a8","creation_date":"2023-02-01T02:06:29.000Z"}
+
 ## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/lib/lsaws/lister.rb

@@ -15,6 +15,17 @@ module Lsaws
       @options[:max_width] = nil if @options[:max_width].to_i.zero?
     end
 
+    def _abort_with_list(sdk, type)
+      if type == "default"
+        warn "[!] no default entity type set for #{sdk.inspect} SDK"
+      else
+        warn "[!] #{sdk.inspect} SDK does not have #{type.inspect} entity type"
+      end
+      puts "Known entity types are:"
+      list_entity_types(sdk)
+      exit 1
+    end
+
     def _prepare_entities(sdk, type, &block)
       edef = Lsaws.config.dig(sdk, type)
       return _prepare_entities(sdk, edef, &block) if edef.is_a?(String) # redirect like 'default' -> 'instances'
@@ -34,16 +45,7 @@ module Lsaws
       client_class = edef["client_class"] || sdkp.client_class_name
       client = Kernel.const_get(client_class).new
       method_name = edef["method"] || sdkp.etype2method(type)
-      unless client.respond_to?(method_name)
-        if type == "default"
-          warn "[!] no default entity type set for #{sdk.inspect} SDK"
-        else
-          warn "[!] #{sdk.inspect} SDK does not have #{type.inspect} entity type"
-        end
-        puts "Known entity types are:"
-        list_entity_types(sdk)
-        exit 1
-      end
+      _abort_with_list(sdk, type) unless method_name
       warn "[d] #{method_name} #{params}" if @options[:debug]
       results = client.send(method_name, params)
 

data/lib/lsaws/sdk_parser.rb

@@ -68,7 +68,7 @@ module Lsaws
         required_params.any? || Lsaws.config.dig(@sdk, method2etype(m), "required_params")
       end
 
-      methods.map { |m| method2etype(m) }.sort
+      methods.map { |m| method2etype(m) }.uniq.sort
     end
 
     def get_method_rdoc(method)

data/lib/lsaws/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Lsaws
-  VERSION = "0.3.0"
+  VERSION = "0.3.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lsaws
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Andrey "Zed" Zaikin
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-02-12 00:00:00.000000000 Z
+date: 2023-02-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core