aws_clim 1.0.2 → 1.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c71eb36c809ad34e0682ed8f122ececc8f6a71532d6256c78670cba5ee4c13a8
-  data.tar.gz: 66d93e4023fdd715499e17ffa9fb47f47b6676af933bfcfc7c1427008b2d59cd
+  metadata.gz: b58d1cc08420aea4f5c6c34a6f27272e07d743b80f9a6714bc6be584b602424a
+  data.tar.gz: 36946a492c1ef267ae6c410bffaaffb0441f9d5ba92c1c4d67af6b6330fb5e0b
 SHA512:
-  metadata.gz: cba3ede4804d99f587ad7c1bda529b16ff752df71aea77497590b697f2787b4b1b03cc51dd7eadd23818b2cc1e0af56e41e1791e357f215814cf50921e0b5dcb
-  data.tar.gz: 65545875d1c30f02c09e34638e40865606f40de82ff9f4885b5dfe4c2741b78f42fdcf0590c2b95bb530fdd02b81ca3dea9a75ab28feb9f9f93248e84f400ec9
+  metadata.gz: 7f5153c491f9aa5f7a21f9750d73f6d85e271114f18aac33767e15f86f120f21cb6b0d40bc88f2e272f67c379580f81343c716d9b120639dfeeecd8f2b1c9955
+  data.tar.gz: 398d78d972a507dbc1ec1068b6ecfcce5f2a3a9becef69ab68aee237092aec535b93c8780b350c8531974eb32abaf92db3af81ef2a24696ba633b94e8f393865

data/README.md

@@ -1,8 +1,14 @@
 # AwsClim
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/aws_clim`. To experiment with that code, run `bin/console` for an interactive prompt.
+AwsClim is a light wrapper around `aws cli` tool. it adds some convenience when calling the command and
+dealing with the results.
 
-TODO: Delete this and the text above, and describe your gem
+  - Maps all aws services as a method on AwsClim instance.
+  - Set format as JSON as default.
+  - Deals with arguments as Array, Hash or simply string
+  - Parses all results as JSON
+  - Returns an `OpenStruct.new(error: true, success: false, data: err)` when error happens.
+  - Returns an `OpenStruct.new(error: false, success: true, data: JSON.parse(out, object_class: OpenStruct))` when command returns successfuly.
 
 ## Installation
 
@@ -22,6 +28,17 @@ Or install it yourself as:
 
 ## Usage
 
+```
+aws = AwsClim.new()
+```
+
+By calling new without parameters AwsClim uses the profile `default`(see https://docs.aws.amazon.com/sdk-for-php/v3/developer-guide/guide_credentials_profiles.html to learn about aws profiles).
+To set a different profile use profile argument on new.
+
+```
+aws = AwsClim.new(profile: 'other-profile')
+```
+
 With a instance of AwsClim call aws services by its name and pass subcommands and options:
 
 Examples:

data/lib/aws_clim/version.rb

@@ -1,3 +1,3 @@
 module AwsClim
-  VERSION = "1.0.2"
+  VERSION = "1.0.4"
 end

data/lib/aws_clim.rb

@@ -3,7 +3,7 @@ require 'json'
 require 'open3'
 
 class AwsClim
-  def initialize(profile = 'default', global_options = {})
+  def initialize(profile: 'default', global_options: {})
     @profile = profile
     @global_options = global_options
   end
@@ -330,6 +330,10 @@ class AwsClim
     define_method service_name do |*ps|
       execute(service_name, ps)
     end
+
+    define_method "#{service_name}_help" do
+      execute(service_name, 'help').data
+    end
   end
 
   def execute(service, options)
@@ -338,7 +342,14 @@ class AwsClim
     out, err, status = Open3.capture3(cmd)
 
     if status.success?
-      OpenStruct.new(success?: true, error?: false, data: OpenStruct.new(JSON.parse(out)))
+      data =
+        begin
+          JSON.parse(out, object_class: OpenStruct)
+        rescue JSON::ParserError => e
+          out
+        end
+
+      OpenStruct.new(success?: true, error?: false, data: data)
     else
       OpenStruct.new(success?: false, error?: true, data: err)
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws_clim
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 1.0.4
 platform: ruby
 authors:
 - Andrew S Aguiar