kumogata2 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: e68a1cac5efe71e08f2d002ac2884c76818bb6fb
+  data.tar.gz: a6373ae6c26e04b76775d44e75d257d2be92e9eb
+SHA512:
+  metadata.gz: 8851364eb886e8254f807432d5c33c4fe26988473d094b8e8a6b5a320ed27dafdda4d75b87b75be4727f87564a938e647f5a0a9d2f29a3ee3cfabbb15369b216
+  data.tar.gz: 5c1dc3f643cf26808396fc84a7c951e72109ec1e05f0c62773a6d6a84aefb3875d8fe40e2cfba84ee7b27b626786cceb192735c1abda7717fde38015a2b9cd3a

data/.gitignore

@@ -0,0 +1,11 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.json
+test.rb

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--require spec_helper

data/.travis.yml

@@ -0,0 +1,4 @@
+language: ruby
+rvm:
+  - 2.2.4
+before_install: gem install bundler -v 1.11.2

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in kumogata2.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Genki Sugawara
+
+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.md

@@ -0,0 +1,97 @@
+# Kumogata2
+
+Kumogata2 is a tool for [AWS CloudFormation](https://aws.amazon.com/cloudformation/).
+
+This is a `format converter` + `useful tool`.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'kumogata2'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install kumogata2
+
+## Usage
+
+```
+Usage: kumogata2 <command> [args] [options]
+
+Commands:
+  create         PATH_OR_URL [STACK_NAME]   Create resources as specified in the template
+  update         PATH_OR_URL STACK_NAME     Update a stack as specified in the template
+  delete         STACK_NAME                 Delete a specified stack
+  validate       PATH_OR_URL                Validate a specified template
+  list           [STACK_NAME]               List summary information for stacks
+  export         STACK_NAME                 Export a template from a specified stack
+  convert        PATH_OR_URL                Convert a template format
+  diff           PATH_OR_URL1 PATH_OR_URL2  Compare templates logically (file, http://..., stack://...)
+  dry-run        PATH_OR_URL STACK_NAME     Create a change set and show it
+  show-events    STACK_NAME                 Show events for a specified stack
+  show-outputs   STACK_NAME                 Show outputs for a specified stack
+  show-resources STACK_NAME                 Show resources for a specified stack
+
+Support Format:
+  json, js, template
+
+Options:
+    -k, --access-key ACCESS_KEY
+    -s, --secret-key SECRET_KEY
+    -r, --region REGION
+        --profile PROFILE
+        --credentials-path PATH
+        --output-format FORMAT
+    -p, --parameters KEY_VALUES
+    -j, --json-parameters JSON
+        --[no-]deletion-policy-retain
+        --[no-]disable-rollback
+        --timeout-in-minutes TIMEOUT_IN_MINUTES
+        --notification-arns NOTIFICATION_ARNS
+        --capabilities CAPABILITIES
+        --resource-types RESOURCE_TYPES
+        --on-failure ON_FAILURE
+        --stack-policy-body STACK_POLICY_BODY
+        --stack-policy-url STACK_POLICY_URL
+        --[no-]use-previous-template
+        --stack-policy-during-update-body STACK_POLICY_DURING_UPDATE_BODY
+        --stack-policy-during-update-url STACK_POLICY_DURING_UPDATE_URL
+        --result-log PATH
+        --command-result-log PATH
+        --[no-]detach
+        --[no-]force
+        --[no-]color
+        --[no-]ignore-all-space
+        --[no-]debug
+```
+
+## Plugin
+
+Kumogata2 can be extended with plug-ins, such as the following:
+
+```ruby
+class Kumogata2::Plugin::JSON
+  Kumogata2::Plugin.register(:json, ['json', 'js', 'template'], self)
+
+  def initialize(options)
+    @options = options
+  end
+
+  def parse(str)
+    JSON.parse(str)
+  end
+
+  def dump(hash)
+    JSON.pretty_generate(hash).colorize_as(:json)
+  end
+end
+```
+
+see [kumogata2-plugin-ruby](https://github.com/winebarrel/kumogata2-plugin-ruby).

data/Rakefile

@@ -0,0 +1,6 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "kumogata2"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/exe/kumogata2

@@ -0,0 +1,42 @@
+#!/usr/bin/env ruby
+$: << File.expand_path('../../lib', __FILE__)
+require 'kumogata2'
+require 'kumogata2/cli/option_parser'
+
+Version = Kumogata2::VERSION
+
+def main(argv)
+  debug = true
+
+  begin
+    Kumogata2::Plugin.load_plugins
+
+    parsed = Kumogata2::CLI::OptionParser.parse!(argv)
+    command, arguments, options, output_result = parsed
+    debug = options.debug?
+
+    out = Kumogata2::Client.new(options).send(command, *arguments)
+
+    if [:create, :update, :delete].include?(command) and options.detach?
+      puts '[detached]'
+    elsif output_result and out
+      puts out
+    end
+  rescue => e
+    $stderr.puts("[ERROR] #{e.message}".red)
+
+    if debug
+      raise e
+    else
+      backtrace = Kumogata2::Utils.filter_backtrace(e.backtrace)
+
+      unless backtrace.empty?
+        $stderr.puts "  from #{backtrace.first}".red
+      end
+    end
+
+    exit 1
+  end
+end
+
+main(ARGV)

data/kumogata2.gemspec

@@ -0,0 +1,33 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'kumogata2/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'kumogata2'
+  spec.version       = Kumogata2::VERSION
+  spec.authors       = ['Genki Sugawara']
+  spec.email         = ['sugawara@cookpad.com']
+
+  spec.summary       = %q{Kumogata2 is a tool for AWS CloudFormation.}
+  spec.description   = %q{Kumogata2 is a tool for AWS CloudFormation.}
+  spec.homepage      = 'https://github.com/winebarrel/kumogata2'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_dependency 'aws-sdk', '~> 2.3.0'
+  spec.add_dependency 'coderay'
+  spec.add_dependency 'diffy'
+  spec.add_dependency 'hashie'
+  spec.add_dependency 'highline'
+  spec.add_dependency 'term-ansicolor'
+
+  spec.add_development_dependency 'bundler'
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+  spec.add_development_dependency 'kumogata2-plugin-ruby'
+end

data/lib/kumogata2/cli/option_parser.rb

@@ -0,0 +1,260 @@
+require 'optparse'
+require 'hashie'
+
+module Kumogata2::CLI
+  class OptionParser
+    DEFAULT_OPTIONS = {
+      result_log: File.join(Dir.pwd, 'result.json'),
+      command_result_log: File.join(Dir.pwd, 'command_result.json'),
+      color: $stdout.tty?,
+    }
+
+    COMMANDS = {
+      create: {
+        description: 'Create resources as specified in the template',
+        arguments: [:path_or_url, :stack_name?],
+        output: false,
+      },
+      update: {
+        description: 'Update a stack as specified in the template',
+        arguments: [:path_or_url, :stack_name],
+        output: false,
+      },
+      delete: {
+        description: 'Delete a specified stack',
+        arguments: [:stack_name],
+        output: false,
+      },
+      validate: {
+        description: 'Validate a specified template',
+        arguments: [:path_or_url],
+        output: false,
+      },
+      list: {
+        description: 'List summary information for stacks',
+        arguments: [:stack_name?],
+      },
+      export: {
+        description: 'Export a template from a specified stack',
+        arguments: [:stack_name],
+      },
+      convert: {
+        description: 'Convert a template format',
+        arguments: [:path_or_url],
+      },
+      diff: {
+        description: 'Compare templates logically (file, http://..., stack://...)',
+        arguments: [:path_or_url1, :path_or_url2],
+      },
+      dry_run: {
+        description: 'Create a change set and show it',
+        arguments: [:path_or_url, :stack_name],
+      },
+      show_events: {
+        description: 'Show events for a specified stack',
+        arguments: [:stack_name],
+      },
+      show_outputs: {
+        description: 'Show outputs for a specified stack',
+        arguments: [:stack_name],
+      },
+      show_resources: {
+        description: 'Show resources for a specified stack',
+        arguments: [:stack_name],
+      },
+    }
+
+    class << self
+      def parse!(argv)
+        self.new.parse!(argv)
+      end
+    end # of class methods
+
+    def parse!(argv)
+      command = nil
+      arguments = nil
+      options = {aws: {}}
+
+      opt = ::OptionParser.new
+      opt.summary_width = 65535
+      set_usage!(opt)
+
+      opt.on('-k', '--access-key ACCESS_KEY') {|v| options[:aws][:access_key_id]     = v }
+      opt.on('-s', '--secret-key SECRET_KEY') {|v| options[:aws][:secret_access_key] = v }
+      opt.on('-r', '--region REGION')         {|v| options[:aws][:region]            = v }
+
+      opt.on('', '--profile PROFILE') do |v|
+        options[:aws][:credentials] ||= {}
+        options[:aws][:credentials][:profile_name] = v
+      end
+
+      opt.on('', '--credentials-path PATH') do |v|
+        options[:aws][:credentials] ||= {}
+        options[:aws][:credentials][:path] = v
+      end
+
+      opt.on(''  , '--output-format FORMAT', Kumogata2::Plugin.plugin_exts) do |v|
+        options[:output_format] = v
+      end
+
+      opt.on('-p', '--parameters KEY_VALUES', Array) {|v| options[:parameters]              = v }
+      opt.on('-j', '--json-parameters JSON')         {|v| options[:json_parameters]         = v }
+      opt.on(''  , '--[no-]deletion-policy-retain')  {|v| options[:deletion_policy_retain]  = v }
+
+      {
+        disable_rollback: :boolean,
+        timeout_in_minutes: Integer,
+        notification_arns: Array,
+        capabilities: Array,
+        resource_types: Array,
+        on_failure: nil,
+        stack_policy_body: nil,
+        stack_policy_url: nil,
+        use_previous_template: :boolean,
+        stack_policy_during_update_body: nil,
+        stack_policy_during_update_url: nil,
+      }.each do |key, type|
+        opt_str = key.to_s.gsub('_', '-')
+        opt_val = key.to_s.upcase
+
+        case type
+        when :boolean
+          opt.on('', "--[no-]#{opt_str}") {|v| options[key] = v }
+        when nil
+          opt.on('', "--#{opt_str} #{opt_val}") {|v| options[key] = v }
+        else
+          opt.on('', "--#{opt_str} #{opt_val}", type) {|v| options[key] = v }
+        end
+      end
+
+      opt.on(''  , '--result-log PATH')         {|v| options[:result_log]       = v }
+      opt.on(''  , '--command-result-log PATH') {|v| options[:command]          = v }
+      opt.on(''  , '--[no-]detach')             {|v| options[:detach]           = v }
+      opt.on(''  , '--[no-]force')              {|v| options[:force]            = v }
+      opt.on(''  , '--[no-]color')              {|v| options[:color]            = v }
+      opt.on(''  , '--[no-]ignore-all-space')   {|v| options[:ignore_all_space] = v }
+      opt.on(''  , '--[no-]debug')              {|v| options[:debug]            = v }
+
+      opt.parse!
+
+      unless (command = argv.shift)
+        puts opt.help
+        exit_parse!(1)
+      end
+
+      orig_command = command
+      command = command.gsub('-', '_').to_sym
+
+      unless COMMANDS.has_key?(command)
+        raise "Unknown command: #{orig_command}"
+      end
+
+      arguments = argv.dup
+      validate_arguments(command, arguments)
+
+      options = DEFAULT_OPTIONS.merge(options)
+      options = Hashie::Mash.new(options)
+
+      if options[:aws][:credentials]
+        credentials = Aws::SharedCredentials.new(options[:aws][:credentials])
+        options[:aws][:credentials] = credentials
+      end
+
+      Aws.config.update(options[:aws].dup)
+      options = Hashie::Mash.new(options)
+
+      String.colorize = options.color?
+      Diffy::Diff.default_format = options.color? ? :color : :text
+
+      if options.debug?
+        Kumogata2::Logger.instance.set_debug(options.debug?)
+
+        Aws.config.update(
+          :http_wire_trace => true,
+          :logger => Kumogata2::Logger.instance
+        )
+      end
+
+      update_parameters(options)
+      output = COMMANDS.fetch(command).fetch(:output, true)
+
+      options.command = command
+      options.arguments = arguments
+      options.output_result = output
+
+      [command, arguments, options, output]
+    rescue => e
+      $stderr.puts("[ERROR] #{e.message}")
+      raise e if options[:debug]
+      exit_parse!(1)
+    end
+
+    private
+
+    def exit_parse!(exit_code)
+      exit(exit_code)
+    end
+
+    def set_usage!(opt)
+      opt.banner = "Usage: kumogata2 <command> [args] [options]"
+      opt.separator ''
+      opt.separator 'Commands:'
+
+      cmd_max_len = COMMANDS.keys.map {|i| i.to_s.length }.max
+
+      cmd_arg_descs = COMMANDS.map do |command, attributes|
+        command = command.to_s.gsub('_', '-')
+        description = attributes.fetch(:description)
+        arguments = attributes.fetch(:arguments)
+
+        [
+          '%-*s %s' % [cmd_max_len, command, arguments_to_message(arguments)],
+          description,
+        ]
+      end
+
+      cmd_arg_max_len = cmd_arg_descs.map {|i| i[0].length }.max
+
+      opt.separator(cmd_arg_descs.map {|cmd_arg, desc|
+        '  %-*s  %-s' % [cmd_arg_max_len, cmd_arg, desc]
+      }.join("\n"))
+
+      opt.separator ''
+      opt.separator 'Support Format: '
+      opt.separator '  ' + Kumogata2::Plugin.plugin_exts.join(', ')
+
+      opt.separator ''
+      opt.separator 'Options:'
+    end
+
+    def arguments_to_message(arguments)
+      arguments.map {|i| i.to_s.sub(/(.+)\?\z/) { "[#{$1}]" }.upcase }.join(' ')
+    end
+
+    def validate_arguments(command, arguments)
+      expected = COMMANDS[command][:arguments] || []
+
+      min = expected.count {|i| i.to_s !~ /\?\z/ }
+      max = expected.length
+
+      if arguments.length < min or max < arguments.length
+        raise "Usage: kumogata #{command} #{arguments_to_message(expected)} [options]"
+      end
+    end
+
+    def update_parameters(options)
+      parameters = {}
+
+      (options.parameters || []).each do |i|
+        key, value = i.split('=', 2)
+        parameters[key] = value
+      end
+
+      if options.json_parameters
+        parameters.merge!(JSON.parse(options.json_parameters))
+      end
+
+      options.parameters = parameters
+    end
+  end # OptionParser
+end # Kumogata2::CLI