cfncli 0.3.0

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    ZWQ3YjUwZTM2YzUyNzBlOGJjMzhjZmJjZTkxMDI1N2JhNTA3N2NmYw==
+  data.tar.gz: !binary |-
+    Yjc2NTBmY2Y5ZWY3YWZiMzNjZDdlMDdkYjI3NWY3ZjJkNmU2YWE4Mg==
+SHA512:
+  metadata.gz: !binary |-
+    NjFlMTEzZWQ4ZDgxN2YzN2RlZDdmZDY1NzRhY2E4YWUyOGI4M2IwYTc0Yzg2
+    YWFkYjA3MTRjZGVlZmI4N2MxZDFlNjM2YjZkYTE3YjYwMTc4MWMzZjg0ZTFj
+    YTBkZmI0NDE0MWM4NTAyNjY1ZjU5Njk1ZmM2Zjk0YmE3OWU3M2Q=
+  data.tar.gz: !binary |-
+    YjgzNmY4N2QzNjQ5MDliOTRjYWIzNjM0ZjE2MjIyODFhN2EzYmFmYmVkYTBi
+    YTQzZmFhMTkyMGNkOTRlODk0ZDM3NDljMTY0NDBhYmFmYjBhNjQ0YjE3YzA5
+    MDc0YzU5ZjNjYzQ4MmFkZDRiNTE4NmQ0OWU3Njk0OWMyYzZkY2E=

data/.gitignore

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

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.travis.yml

@@ -0,0 +1,18 @@
+language: ruby
+rvm:
+  - 2.2
+sudo: false
+before_install:
+  - gem install bundler -v '~> 1.10'
+script:
+  - bundle exec rake spec
+deploy:
+  provider: rubygems
+  api_key:
+    secure:  "qDh1BOlLLokI/gU/5HkAmbsAEE5A384IketR+BB4Pal8BsGGnxnbbSUU79pEU94wCHhUFYDnzq7DbkxbvuBYl2R1y98iq7SkLvLD2XWr6zAYwWM3oQOrv3NTWi3hc93Mz8YxVJ6GFzyKBFf4SmYjf18OkpOHuxKSAF95T6LcSKaVljM3Vy49FOE6DsStcgHs4U7kgjQMFiaN4WI8ul7XrmsC9zLrmMG7EH6ktTcpE0TuLrpmtq4Y1dmDGLA55yEDfnYZVz/TgDpkcCAMNGC92P/3EgW6nsYAb3LJ/LD5qbbMdnMUVwKx9lOyiYkTKM9QtPoEhAxtn5I0DiWgQ+UI1MQAmdiqYScjhle8DpaRhYCSz+WDQc3MDHPEZQsKksA92Cs26Np6JRLDkpAYw2MKjLMnqFe1mDxr9UpnEJbxZJtsV+N6zgEwDMh/rwJXVdns4wIDveOT5rFP9VCfsJxn25In+DNhmeiBhLYMTeUfOPP9+SrH2xLiVnHk0OPy/IDrYTEd0BkGAPQQDQ45MCT0TOoF/bpTFQ8NREOXndTP9RyHS442eIHiQ5+kv4P/kwhBEjebhzIT4W5LYsYOBv2ZInTP2xKoHXveyVaIwMyKc0VwNluCi/xVnc/NpVhiRxgr57drW6z/Piy2uxs26VVfcve+9+EoO+qP2fBhtQ5YOWA="
+  on:
+    tags: true
+addons:
+    code_climate:
+        repo_token: 
+          secure: "AKrgx5PtDa5/pek0hLgtk55SEE4DzCBM1li4eVCPK4CWfo7WgiODN51rnE7uhnABdaeI82t/YuJIyLE37PnsU4dqkXVBXtPmijBkbZy1SZ/bmTsSnOFoMTVWkaCb/iAcr+i5yqJ16bSGLV/t3K80ksyH80WgZTdzmh75pEDKaOBDLI42mgBf/eXkLZ68iuotatLnuLFwVa4mGW79yiJYBxHNstYHEBd0B4Ahutz3BMGFUiwCBx0wer+nVf+RxN+RKkiXRLnOeucwVEcbOOHbm1nkLDhL8U1KQ8lnWNV+RSUPNoOJNoMcgMRKMavDj6TC29e2pO44PWNgICCkUqbvc9Otrac5HG566ZsYZ0gp9BhQxEIpeYkzEUh7a/znLGiQYylrohIf9gsWz3KLGOPD68y4DZfmKgQDZG8ag1ErKmIv1Cna1PmsFA/lXUrZ60hIzgc0Vdw2jb7Ww2GHK35h8kSOCuDOOgmDpLhESvPVb7PPL2ftTLwSH6FT/P7wyfoeSqgotZTKZCw6JZAnV+HjwWB1uzR7dlt/H0qjduCVekWcK7Pq4lnlNI8S4tcAYiJSaL6EcCvrQ2qUAlw2xXYar0ouRgOQgM4H3HCleqkNIZwHxc3GYgdyhhPYqBr8Uq1ziT7NnQ4X94cCu9tuAcvKoqvQiJOKc4HUGCzgPnJiqL8="

data/Gemfile

@@ -0,0 +1,6 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in cfncli.gemspec
+gemspec
+
+gem "codeclimate-test-reporter", group: :test, require: nil

data/Guardfile

@@ -0,0 +1,5 @@
+guard :rspec, :cmd => "bundle exec rspec --color" do 
+  watch('spec/spec_helper.rb')                                               { "spec" }
+  watch(%r{^spec/.+_spec\.rb})
+  watch(%r{^lib/(.+)\.rb})                                                   { |m| "spec/lib/#{m[1]}_spec.rb" }
+end

data/README.md

@@ -0,0 +1,44 @@
+# cfncli
+[![Code Climate](https://codeclimate.com/github/lethalpaga/cfncli/badges/gpa.svg)](https://codeclimate.com/github/lethalpaga/cfncli)
+[![Test Coverage](https://codeclimate.com/github/lethalpaga/cfncli/badges/coverage.svg)](https://codeclimate.com/github/lethalpaga/cfncli/coverage)
+
+cfncli is a command line tool that simplifies the creation of Cloudformation stacks.
+It's designed to be a very simple wrapper around the Cloudformation API, but adds the following features compared to
+the AWS cli :
+ * Can wait for the stack creation/update/deletion to be complete before returning
+ * Prints the stack events on the console
+ * Gives back a return code indicating if the operation was a success or failure
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'cfncli'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install cfncli
+
+## Usage
+
+```
+cfncli help
+cfncli help apply
+```
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/lethalpaga/cfncli.
+

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 "cfncli"
+
+# 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,7 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/cfncli.gemspec

@@ -0,0 +1,34 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'cfncli/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "cfncli"
+  spec.version       = CfnCli::VERSION
+  spec.authors       = ["lethalpaga"]
+  spec.email         = ["lethalpaga@gmail.com"]
+
+  spec.summary       = %q{Creates cloudformation stacks}
+  spec.description   = %q{Creates a Cloudformation stack synchronously}
+  spec.homepage      = "https://github.com/lethalpaga/cfncli"
+
+  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_development_dependency "bundler", "~> 1.10"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec"
+  spec.add_development_dependency "rspec-its", "~>1.2"
+  spec.add_development_dependency "cucumber", "~> 2"
+  spec.add_development_dependency "guard", "~> 2"
+  spec.add_development_dependency "guard-rspec"
+ 
+  spec.add_dependency "thor"
+  spec.add_dependency "aws-sdk", "~> 2"
+  spec.add_dependency "waiting", "~> 0"
+  spec.add_dependency "activesupport", "~> 4"
+  spec.add_dependency "colorize", "~> 0"
+end

data/exe/cfncli

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+require 'cfncli/cli'
+
+args = CfnCli::Config.load_from_file('cfncli.yml').to_thor(ARGV)
+CfnCli::Cli.start(args)

data/lib/cfncli.rb

@@ -0,0 +1,11 @@
+require "cfncli/version"
+
+require 'thor'
+
+module CfnCli
+  class Cli < Thor
+    def create
+      puts "Creating stack"
+    end
+  end
+end

data/lib/cfncli/cfn_client.rb

@@ -0,0 +1,24 @@
+require 'aws-sdk'
+
+module CfnCli
+  module CfnClient
+
+    attr_accessor :stub_responses
+
+    # CloudFormation client
+    # @see http://docs.aws.amazon.com/sdkforruby/api/Aws/CloudFormation/Client.html
+    def cfn_client
+      @@client ||= Aws::CloudFormation::Client.new(stub_responses: stub_responses || false)
+    end
+
+    # Clouformation Resource
+    # This is used to interact with the CloudFormation API
+    # @see http://docs.aws.amazon.com/sdkforruby/api/Aws/CloudFormation/Resource.html
+    # @note this uses a class variable for the client and the resource so they can share
+    # the stubbed responses in the unit tests.
+    def cfn
+      @@resource ||= Aws::CloudFormation::Resource.new(client: cfn_client)
+      @@resource
+    end
+  end
+end

data/lib/cfncli/cli.rb

@@ -0,0 +1,254 @@
+require 'thor'
+require 'aws-sdk'
+
+require 'cfncli/cloudformation'
+require 'cfncli/config'
+
+module CfnCli
+  class Cli < Thor
+
+    module ExitCode
+      OK = 0
+      STACK_ERROR = 1
+      VALIDATION_ERROR = 2
+    end
+
+    # Global options
+    class_option 'log_level',
+                  type: :numeric,
+                  default: 1,
+                  desc: 'Log level to display (0=DEBUG, 1=INFO, 2=ERROR, 3=CRITICAL)'
+
+    # Stack options
+    method_option 'stack_name',
+                  alias: '-n',
+                  type: :string,
+                  required: true,
+                  desc: 'Cloudformation stack name'
+
+    method_option 'template_body',
+                  type: :string,
+                  desc: 'JSON string or file containing the template body.' \
+                        ' This is exclusive with the template_url option. Use @filename to read' \
+                        ' the template body from a file'
+
+    method_option 'template_url',
+                  type: :string,
+                  desc: 'S3 URL to the Cloudformation template.' \
+                        ' This is exclusive with the template_body option'
+
+    method_option 'parameters',
+                  type: :hash,
+                  desc: 'Stack parameters. Pass each parameter in the form --parameters key1:value1 key2:value2 or use the @filename syntax to provide a JSON file'
+
+    method_option 'parameters_file',
+                  type: :string,
+                  desc: 'Stack parameters file. It should be a JSON file using the same syntax as for the AWS CLI'
+
+    method_option 'disable_rollback',
+                  type: :boolean,
+                  default: false,
+                  desc: 'Disable rollbacks in case of a stack update failure'\
+                        ' This is mutually exclusive with on_failure.'
+
+    method_option 'timeout_in_minutes',
+                  type: :boolean,
+                  desc: 'Stack creation timeout (in minutes)'
+
+    method_option 'notification_arns',
+                  type: :array,
+                  desc: 'List of SNS notification ARNs to publish stack related events'
+
+    method_option 'capabilities',
+                  type: :array,
+                  enum: ['CAPABILITY_IAM'],
+                  desc: 'A list of capabilities that you must specify before AWS CloudFormation can create or update certain stacks'
+
+    method_option 'resource_types',
+                  type: :array,
+                  desc: 'The template resource types that you have permissions to work with for this create stack action, such as AWS::EC2::Instance, AWS::EC2::*, or Custom::MyCustomInstance'
+
+    method_option 'on_failure',
+                  type: :string,
+                  enum: ['DO_NOTHING', 'ROLLBACK', 'DELETE'],
+                  desc: 'Determines what action will be taken if the stack creation fails.' \
+                        ' This is mutually exclusive with disable_rollback'
+
+    method_option 'stack_policy_body',
+                  type: :string,
+                  desc: 'JSON String containing the stack policy body. The @filename syntax can be used.' 
+
+    method_option 'stack_policy_url',
+                  type: :string,
+                  desc: 'S3 URL to a stack policy file.' \
+                        ' This is mutually exclusive with stack_policy_body'
+
+    method_option 'tags',
+                  type: :hash,
+                  desc: 'Key-value pairs to associate with this stack'
+
+    # Application options
+    method_option 'list_events',
+                  alias: '-l',
+                  type: :boolean,
+                  default: true,
+                  desc: 'List the stack events during the operation'
+
+    method_option 'interval',
+                  type: :numeric,
+                  default: 10,
+                  desc: 'Polling interval (in seconds) for the cloudformation events'
+
+    method_option 'timeout',
+                  type: :numeric,
+                  default: 1800,
+                  desc: 'Timeout (in seconds) for the stack creation'
+
+    method_option 'fail_on_noop',
+                  type: :boolean,
+                  default: false,
+                  desc: 'Fails if a stack has nothing to update'
+
+    desc 'apply', 'Creates a stack in Cloudformation'
+    def apply
+      opts = process_params(options)
+
+      stack_name = opts['stack_name']
+     
+      interval = consume_option(opts, 'interval')
+      timeout = consume_option(opts, 'timeout')
+      retries = timeout / interval 
+      fail_on_noop = consume_option(opts, 'fail_on_noop')
+      list_events = consume_option(opts, 'list_events')
+
+      ENV['CFNCLI_LOG_LEVEL'] = consume_option(opts, 'log_level').to_s
+
+      client_config = Config::CfnClient.new(interval, retries, fail_on_noop)
+
+      res = ExitCode::OK 
+      cfn.create_stack(opts, client_config)
+      if list_events
+        cfn.events(stack_name, client_config) 
+        res = ExitCode::STACK_ERROR unless cfn.stack_successful? stack_name
+      end
+
+      puts "Stack creation #{res == 0 ? 'successful' : 'failed'}"
+      exit res
+    rescue Aws::CloudFormation::Errors::ValidationError => e
+      puts e.message
+      exit ExitCode::VALIDATION_ERROR
+    end
+
+    method_option 'stack_name',
+                  alias: '-n',
+                  type: :string,
+                  required: true,
+                  desc: 'Name or ID of the Cloudformation stack'
+    
+    # Application options
+    method_option 'interval',
+                  type: :numeric,
+                  default: 10,
+                  desc: 'Polling interval (in seconds) for the cloudformation events'
+
+    method_option 'timeout',
+                  type: :numeric,
+                  default: 1800,
+                  desc: 'Timeout (in seconds) for the stack event listing'
+
+    desc 'events', 'Displays the events for a stack in realtime'
+    def events
+      stack_name = options['stack_name']
+      config = Config::CfnClient.new(options['interval'], options['retries'])
+      cfn.events(stack_name, config)
+    end
+
+    no_tasks do
+      # Reads an option from a hash and deletes it
+      # @param opts [Hash] Hash containing the options
+      # @param option Key to consume
+      # @return value of Key option in opts
+      def consume_option(opts, option)
+        res = opts[option]
+        opts.delete(option)
+        res
+      end
+
+      # Process the parameters to make them compliant with the Cloudformation API
+      # @param opts [Hash] Hash containing the options. The hash will not be modified
+      # @return the processed options hash
+      def process_params(opts)
+        opts = opts.dup
+        check_exclusivity(opts.keys, ['template_body', 'template_url'])
+        check_exclusivity(opts.keys, ['disable_rollback', 'on_failure'])
+        check_exclusivity(opts.keys, ['stack_policy_body', 'stack_policy_url'])
+        check_exclusivity(opts.keys, ['parameters', 'parameters_file'])
+
+        opts['template_body'] = file_or_content(opts['template_body']) if opts['template_body']
+        opts['stack_policy_body'] = file_or_content(opts['stack_policy_body']) if opts['stack_policy_body']
+        opts['parameters'] = process_stack_parameters(opts['parameters']) if opts['parameters']
+        opts['parameters'] = process_stack_parameters_file(consume_option(opts, 'parameters_file')) if opts['parameters_file']
+
+        opts
+      end
+
+      # Check if only one of the arguments is specified in the options
+      # @param options [Arrray<String>] List of available options
+      # @param exclusives [Array<String>] List of mutually exclusive options
+      def check_exclusivity(opts, exclusives)
+        exclusive_options = opts & exclusives
+        if exclusive_options.size > 1
+          fail Thor::Error, "Error: #{exclusive_options} are mutually exclusive."
+        end
+      end
+
+      # Gets the content of a string that can either be the
+      # content itself or a filename if beginning by @
+      # @param str [String] String containing either the content or the filename to read
+      def file_or_content(str)
+        return str if str.nil?
+        return str unless file_param? str
+
+        content = File.read(str[1..-1])
+        content
+      end
+
+      # Indicates if the parameter is a file (as opposed to a value)
+      # This is indicated by a leading @
+      def file_param?(param)
+        return false unless param.is_a? String
+        param.start_with? '@'
+      end
+
+      # Converts a parameter JSON file to the format expected by CloudFormation
+      # @param filename Path to the JSON file containing the parameters description
+      # @return 
+      def process_stack_parameters_file(filename)
+        content = File.read(filename)
+        return CloudFormation.parse_json_params(JSON.parse(content))
+      end
+
+      # Converts a parameters hash in the format expected by CloudFormation
+      # @param parameters [Hash] Hash containing the parameters to convert
+      def process_stack_parameters(parameters)
+        return {} unless parameters
+
+        # Returns the content of the file if parameters is a file
+        return file_or_content(parameters) if file_param? parameters
+
+        # Otherwise convert each param to the cfn structure
+        parameters.map do |key, value|
+          {
+            parameter_key: key,
+            parameter_value: value
+          }
+        end
+      end
+
+      # Cloudformation utility object
+      def cfn
+        @cfn ||= CfnCli::CloudFormation.new
+      end
+    end
+  end
+end

data/lib/cfncli/cloudformation.rb

@@ -0,0 +1,78 @@
+require 'cfncli/cfn_client'
+require 'cfncli/stack'
+require 'cfncli/logger'
+require 'cfncli/event_poller'
+
+require 'waiting'
+require 'pp'
+
+module CfnCli
+  class CloudFormation
+    include CfnClient
+    include Loggable
+
+    def initialize
+    end
+
+    # Creates a stack and wait for the creation to be finished
+    # @param options [Hash] Options for the stack creation 
+    #                       (@see http://docs.aws.amazon.com/sdkforruby/api/Aws/CloudFormation/Client.html)
+    def create_stack(options, config = nil)
+      create_or_update_stack(options, config)
+    end
+
+    # Creates a stack if it doesn't exist otherwise update it
+    def create_or_update_stack(options, config = nil)
+      opts = process_params(options.dup)
+      
+      stack_name = opts['stack_name']
+      
+      stack = create_stack_obj(stack_name, config)
+      
+      if stack.exists?
+        stack.update(opts)
+      else
+        stack.create(opts)
+      end
+      
+      stack
+    end
+
+    # List stack events
+    def events(stack_name, config)
+      stack = create_stack_obj(stack_name, config)
+      stack.list_events(EventPoller.new, config)
+    end
+
+    # Returns the stack stack
+    def stack_successful?(stack_name)
+      Stack.new(stack_name).succeeded?
+    end
+
+    # Converts the 'standard' json stack parameters format to the format
+    # expected by the API
+    # (see https://blogs.aws.amazon.com/application-management/post/Tx1A23GYVMVFKFD/Passing-Parameters-to-CloudFormation-Stacks-with-the-AWS-CLI-and-Powershell)
+    def self.parse_json_params(params)
+      params.map do |param|
+        {
+          parameter_key: param.first.first,
+          parameter_value: param.first.last
+        }
+      end
+    end
+
+    private
+
+    # Creates a new stack object
+    # Mainly useful to mock it in unit tests
+    def create_stack_obj(stack_name, config)
+      CfnCli::Stack.new(stack_name, config)
+    end
+
+    # Process the parameters
+    def process_params(opts)
+      opts.delete('disable_rollback')
+      opts
+    end
+  end
+end

data/lib/cfncli/config.rb

@@ -0,0 +1,87 @@
+require 'yaml'
+
+module CfnCli
+  module Config
+    def self.load_from_file(filename)
+      content = YAML::load_file(filename)
+      Parameters.new(content)
+    rescue Errno::ENOENT
+      nil
+    end
+  
+    class CfnClient
+      attr_accessor :interval
+      attr_accessor :retries
+      attr_accessor :fail_on_noop
+      
+      def initialize(interval = 10, retries = 30, fail_on_noop = false)
+        @interval = interval
+        @retries = retries
+        @fail_on_noop = fail_on_noop
+      end
+    end
+    
+    class Parameters
+      def initialize(content)
+        @content = content
+      end
+      
+      # Converts parameters to command-line arguments
+      def to_args(content = nil)
+        content ||= to_a
+        content.join(' ')
+      end
+      
+      # Get an array of parameters
+      def to_a
+        from_hash(@content) if @content.is_a? Hash       
+      end
+      
+      # Format parameters for thor
+      # @param given_args [Array] Optional array of existing arguments
+      def to_thor(given_args = nil)
+        args = []
+
+        if given_args
+          given_args = given_args.dup
+          args << given_args.shift
+        end
+        args += to_a
+        args += given_args if given_args
+        
+        args
+      end
+      
+      protected
+      
+      def from_hash(content)
+        args = []
+        content.each_pair do |key, value|
+          case value
+          when Hash
+            value = parse_hash(value)
+          when Array
+            value = parse_array(value)
+          end
+          
+          args += ["--#{key}", value]
+        end
+        
+        args
+      end
+      
+      def parse_hash(content)
+        args = []
+        content.each_pair do |key, value|
+          args += ["#{key}:#{value}"]
+        end
+        
+        args
+      end
+      
+      def parse_array(value)
+        "[#{value.join(',')}]"
+      end
+    end
+  end
+end

data/lib/cfncli/event.rb

@@ -0,0 +1,27 @@
+require 'cfncli/states'
+
+module CfnCli
+  class Event
+    include CfnStates
+
+    attr_reader :event
+
+    def initialize(event)
+      @event = event
+    end
+
+    def status
+      event.resource_status
+    end
+
+    def color
+      return :green if succeeded?
+      return :yellow if in_progress?
+      return :red if failed?
+    end
+
+    def to_s
+      "#{event.timestamp} #{event.resource_status} #{event.resource_type} #{event.logical_resource_id} #{event.resource_status_reason}"
+    end
+  end
+end

data/lib/cfncli/event_poller.rb

@@ -0,0 +1,17 @@
+require 'colorize'
+require 'cfncli/event'
+
+module CfnCli
+  class EventPoller
+    def initialize
+    end
+
+    def event(event)
+      colorize Event.new(event)
+    end
+
+    def colorize(event)
+      puts event.to_s.colorize(event.color)
+    end
+  end
+end

data/lib/cfncli/event_streamer.rb

@@ -0,0 +1,40 @@
+module CfnCli
+  class EventStreamer
+    attr_reader :stack
+    attr_reader :config
+
+    def initialize(stack, config = nil)
+      @stack = stack
+      @config = config || default_config
+      @seen_events = []
+    end
+
+    def default_config
+      Config::CfnClient.new
+    end
+
+    # Wait for events. This will exit when the
+    # stack reaches a finished state
+    # @yields [CfnEvent] Events for the stack
+    def each_event
+      Waiting.wait(interval: config.interval, max_attempts: config.retries) do |waiter|
+        @next_token = stack.events(@next_token).each do |event|
+          yield event unless seen?(event)
+        end
+
+        waiter.done if stack.finished?
+      end
+    end
+
+    private
+
+    attr_accessor :seen_events
+
+    # Indicates if an event has already been seen
+    def seen?(event)
+      res = seen_events.include? event.id
+      seen_events << event.id
+      res
+    end
+  end
+end

data/lib/cfncli/logger.rb

@@ -0,0 +1,53 @@
+require 'logger'
+
+module CfnCli
+  # Logger Mixin
+  module Loggable
+    # Gets the logger object
+    #
+    # By default it logs to STDOUT with the date-time format +%Y-%m-%d %H:%M:%S +
+    #
+    # @return [Logger]
+    def logger
+      if @logger.nil?
+        @logger = Logger.new(STDOUT)
+        @logger.level = ENV['CFNCLI_LOG_LEVEL'].to_i || Logger::INFO
+        @logger.formatter = proc do |severity, datetime, progname, msg|
+          severity = severity.ljust(7)
+          progname = "#{progname}: " if progname
+          "#{datetime} [ #{severity} ] #{progname}#{msg}\n"
+        end
+      end
+      @logger
+    end
+
+    # Sets the logger object
+    # @param obj [Logger]
+    def logger=(obj)
+      @logger = obj
+    end
+
+    # Gets the current log level as a symbol
+    # @return [Symbol]
+    def log_level
+      level_map = {
+        Logger::DEBUG => :debug,
+        Logger::INFO => :info,
+        Logger::WARN => :warn,
+        Logger::ERROR => :error,
+        Logger::FATAL => :fatal,
+        Logger::UNKNOWN => :unknown
+      }
+      level_map[logger.level]
+    end
+
+    # Sets the current log level
+    def log_level=(level)
+      if level.is_a?(Fixnum)
+        logger.level = level
+      else
+        logger.level = Logger.const_get(level.to_s.upcase)
+      end
+    end
+  end
+end

data/lib/cfncli/stack.rb

@@ -0,0 +1,122 @@
+require 'cfncli/cfn_client'
+require 'cfncli/logger'
+require 'cfncli/config'
+require 'cfncli/event_streamer'
+require 'cfncli/states'
+
+require 'waiting'
+
+module CfnCli
+  class Stack
+    include CfnCli::CfnClient
+    include CfnCli::CfnStates
+    include Loggable
+
+    attr_reader :stack_name
+
+    class StackNotFoundError < StandardError; end
+    
+    def initialize(stack_name, config = nil)
+      @stack = nil
+      @stack_id = nil
+      @stack_name = stack_name
+      @config = config || default_config
+    end
+
+    def default_config
+      Config::CfnClient.new
+    end
+
+    def fail_on_noop?
+      @config.fail_on_noop
+    end
+
+    def stack_id
+      @stack_id || @stack_name
+    end
+
+    def stack
+      fetch_stack
+    end
+
+    def exists?
+      stack.exists?
+    end
+
+    # Creates a new stack
+    # @param opts Hash containing the options for `create_stack`
+    #             (see http://docs.aws.amazon.com/sdkforruby/api/Aws/CloudFormation/Resource.html#create_stack-instance_method)
+    def create(opts)
+      logger.debug "Creating stack #{stack_name} (#{opts.inspect})"
+      @stack = cfn.create_stack(opts)
+      stack.wait_until_exists
+      @stack_id = stack.stack_id
+    end
+
+    # Updates an existing stack
+    # @param opts Hash containing the options for `update_stack`
+    #             (see http://docs.aws.amazon.com/sdkforruby/api/Aws/CloudFormation/Client.html#update_stack-instance_method)
+    def update(opts)
+      logger.debug "Updating stack #{stack_name} (#{opts.inspect})"
+      resp = cfn.client.update_stack(opts)
+      @stack_id = resp.stack_id
+    rescue Aws::CloudFormation::Errors::ValidationError => e
+      unless !fail_on_noop? && e.message.include?('No updates are to be performed')
+        raise e
+      end
+    end
+  
+    # Waits for a stack to be in a finished state
+    # @return A boolean indicating if the operation was succesful
+    def wait_for_completion
+      Waiting.wait(max_attempts: @config.retries, interval: @config.interval) do |waiter|
+        waiter.done if finished?
+      end
+      succeeded?
+    rescue Waiting::TimedOutError => e
+      logger.error "Timed out while waiting for the stack #{inspect} to be created(#{e.message})"
+      false
+    end
+
+    # List all events in real time
+    # @param poller [CfnCli::Poller] Poller class to display events
+    def list_events(poller, config = nil)
+      streamer = EventStreamer.new(self, config)
+      streamer.each_event do |event|
+        poller.event(event)
+      end
+    end
+     
+    # Get the events from the cfn stack
+    def events(next_token)
+      stack.events(next_token)
+    end
+
+    # Indicates if the stack is in a finished state
+    def finished?
+      return false if stack.nil?
+      finished_states.include? stack.stack_status
+    end
+
+    # Indicates if the stack is in a successful state
+    def succeeded?
+      res = success_states.include? stack.stack_status
+      return false if stack.nil?
+      res
+    end
+
+    # Indicates if the stack is in a transition state
+    def in_progress?
+      return false if stack.nil?
+      transitive_states.include? stack.stack_status
+    end
+
+    private
+
+    # Gets stack info from the cfn API
+    def fetch_stack
+      @stack = cfn.stack(stack_id)
+      @stack
+    end
+  end
+end

data/lib/cfncli/states.rb

@@ -0,0 +1,72 @@
+module CfnCli
+  module CfnStates
+    # Indicates if the state is finished
+    def finished?
+      finished_states.include? status
+    end
+
+    # Indicates if the state is successful
+    def succeeded?
+      success_states.include? status
+    end
+
+    # Indicates if the state is a transition
+    def in_progress?
+      transitive_states.include? status
+    end
+
+    # Indicates if the state is failed
+    def failed?
+      !succeeded? && !in_progress?
+    end
+
+    # List of possible states
+    def states
+      [
+        'CREATE_IN_PROGRESS',
+        'CREATE_IN_PROGRESS',
+        'CREATE_FAILED',
+        'CREATE_COMPLETE',
+        'ROLLBACK_IN_PROGRESS',
+        'ROLLBACK_FAILED',
+        'ROLLBACK_COMPLETE',
+        'DELETE_IN_PROGRESS',
+        'DELETE_FAILED',
+        'DELETE_COMPLETE',
+        'UPDATE_IN_PROGRESS',
+        'UPDATE_COMPLETE_CLEANUP_IN_PROGRESS',
+        'UPDATE_COMPLETE',
+        'UPDATE_ROLLBACK_IN_PROGRESS',
+        'UPDATE_ROLLBACK_FAILED',
+        'UPDATE_ROLLBACK_COMPLETE_CLEANUP_IN_PROGRESS',
+        'UPDATE_ROLLBACK_COMPLETE',
+      ]
+    end
+
+    # List of successful states
+    def success_states
+      [
+        'CREATE_COMPLETE',
+        'DELETE_COMPLETE',
+        'UPDATE_COMPLETE'
+      ]
+    end
+
+    # List of transitive states
+    def transitive_states
+      states.select do |state|
+        state.end_with? 'IN_PROGRESS'
+      end
+    end
+
+    # List of finished states
+    def finished_states
+      states - transitive_states
+    end
+
+    # List of failed or unknown states
+    def failed_states
+      states - success_states - transitive_states
+    end
+  end
+end

data/lib/cfncli/version.rb

@@ -0,0 +1,3 @@
+module CfnCli
+  VERSION = "0.3.0"
+end

metadata

@@ -0,0 +1,235 @@
+--- !ruby/object:Gem::Specification
+name: cfncli
+version: !ruby/object:Gem::Version
+  version: 0.3.0
+platform: ruby
+authors:
+- lethalpaga
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2016-03-04 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.10'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec-its
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: cucumber
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2'
+- !ruby/object:Gem::Dependency
+  name: guard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2'
+- !ruby/object:Gem::Dependency
+  name: guard-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: aws-sdk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2'
+- !ruby/object:Gem::Dependency
+  name: waiting
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '4'
+- !ruby/object:Gem::Dependency
+  name: colorize
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Creates a Cloudformation stack synchronously
+email:
+- lethalpaga@gmail.com
+executables:
+- cfncli
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .travis.yml
+- Gemfile
+- Guardfile
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- cfncli.gemspec
+- exe/cfncli
+- lib/cfncli.rb
+- lib/cfncli/cfn_client.rb
+- lib/cfncli/cli.rb
+- lib/cfncli/cloudformation.rb
+- lib/cfncli/config.rb
+- lib/cfncli/event.rb
+- lib/cfncli/event_poller.rb
+- lib/cfncli/event_streamer.rb
+- lib/cfncli/logger.rb
+- lib/cfncli/stack.rb
+- lib/cfncli/states.rb
+- lib/cfncli/version.rb
+homepage: https://github.com/lethalpaga/cfncli
+licenses: []
+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.4.5
+signing_key: 
+specification_version: 4
+summary: Creates cloudformation stacks
+test_files: []