bora 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a3bef88ac6bd7773175b02930da53efe7de03ec7
-  data.tar.gz: 450388c3e3ffc40c353ed09af8a79b8bf2223c13
+  metadata.gz: c1bb37a94a96c16d392746dd4b9fde60bf77f598
+  data.tar.gz: 33b5fa1b0aefa84de3bffaaba26ca7868381e7ee
 SHA512:
-  metadata.gz: 0b7cc4b0e82bf2eb5c9ba59e95600f890296b7dcb1409177dccff2373a7b99b74c5664b95bacc96a3d597ff1cdfa477164489b623a05d8a20972f9e9e9abe142
-  data.tar.gz: 770f772c1df360fc90dfe7bb1efa031e537aa110a11638fb3bda947dc3c08a45b48810e28f4598bcd7ea7efc169ed35a395530c6545fbfd0a0925706af01a285
+  metadata.gz: bd85e49e097d8aa0519601152b6e342d391012c6d6b70d02eae06dd3073382c760d0adb5cdc5ae5e2973b1b5278f697b3fe1f5e4512157cd2d37d989f6b8d33d
+  data.tar.gz: 3f91f89e9fdd73faba4a40b8da1df84d2f70254efb3de207c31b9004d62cd0ee7f9f376a3ed642f4cf444d4b23745da9e1428d35f4c84fecc80ebcd664c65e92

data/README.md

@@ -1,11 +1,7 @@
 # Bora
 
-> 1. A cold and often gusty katabatic wind in the Adriatic
-> 2. A tool for pushing around your cloud formations
-
 This gem contains Ruby [rake](https://github.com/ruby/rake) tasks that help you work with [CloudFormation](https://aws.amazon.com/cloudformation/) stacks.
-You don't need to use it with rake though - you can use the underlaying classes
-in any Ruby app.
+You don't need to use it with rake though - you can use the underlying classes in any Ruby app.
 
 
 ## Installation
@@ -49,6 +45,9 @@ rake stack:example:delete            # Deletes the example stack
 rake stack:example:diff              # Diffs the new template with the example stack's current template
 rake stack:example:events            # Outputs the latest events from the example stack
 rake stack:example:new_template      # Shows the new template for example stack
+rake stack:example:recreate          # Recreates (deletes then creates) the example stack
+rake stack:example:status            # Displays the current status of the example stack
+rake stack:example:validate          # Checks the example stack's template for validity
 ```
 
 You can add as many templates as you like into your Rakefile, simply define an instance of `Bora::Tasks` for each one.

data/lib/bora.rb

@@ -1,4 +1,5 @@
 require "bora/version"
+require "bora/status"
 require "bora/event"
 require "bora/stack"
 require "bora/tasks"

data/lib/bora/event.rb

@@ -1,9 +1,11 @@
 require 'colorize'
+require 'bora/status'
 
 module Bora
   class Event
     def initialize(event)
       @event = event
+      @status = Status.new(@event.resource_status)
     end
 
     def method_missing(sym, *args, &block)
@@ -11,11 +13,11 @@ module Bora
     end
 
     def status_success?
-      @event.resource_status.end_with?("_COMPLETE")
+      @status.success?
     end
 
     def status_failure?
-      @event.resource_status.end_with?("_FAILED")
+      @status.failure?
     end
 
     def status_complete?
@@ -23,14 +25,8 @@ module Bora
     end
 
     def to_s(colorize = true)
-      color = case
-        when status_success?; :green
-        when status_failure?; :red
-        else; :yellow;
-      end
-      status = colorize ? @event.resource_status.colorize(color) : @event.resource_status
       status_reason = @event.resource_status_reason ? " - #{@event.resource_status_reason}" : ""
-      "#{@event.timestamp} - #{@event.resource_type} - #{@event.logical_resource_id} - #{status}#{status_reason}"
+      "#{@event.timestamp.getlocal} - #{@event.resource_type} - #{@event.logical_resource_id} - #{@status.to_s(colorize)}#{status_reason}"
     end
   end
 end

data/lib/bora/stack.rb

@@ -1,6 +1,8 @@
 require 'set'
 require 'aws-sdk'
 require 'diffy'
+require 'bora/stack_status'
+require 'bora/event'
 
 module Bora
   class Stack
@@ -22,6 +24,11 @@ module Bora
       exists? ? update(options, &block) : create(options, &block)
     end
 
+    def recreate(options, &block)
+      delete(&block) if exists?
+      create(options, &block) if !exists?
+    end
+
     def delete(&block)
       call_cfn_action(:delete, &block)
     end
@@ -53,13 +60,26 @@ module Bora
       Diffy::Diff.new(template, new_template(options))
     end
 
+    def validate(options)
+      @cfn.validate_template(options.select { |k| [:template_body, :template_url].include?(k) })
+    end
+
+    def status
+      StackStatus.new(underlying_stack)
+    end
+
     def exists?
-      underlying_stack && underlying_stack.stack_status != 'DELETE_COMPLETE'
+      status.exists?
     end
 
 
+    # =============================================================================================
     private
 
+    def method_missing(sym, *args, &block)
+      underlying_stack ? underlying_stack.send(sym, *args, &block) : nil
+    end
+
     def call_cfn_action(action, options = {}, &block)
       underlying_stack(refresh: true)
       return true if action == :delete && !exists?
@@ -71,7 +91,7 @@ module Bora
       rescue Aws::CloudFormation::Errors::ValidationError => e
         raise e unless e.message.include?("No updates are to be performed")
       end
-      (action == :delete && !underlying_stack) || underlying_stack.stack_status.end_with?('_COMPLETE')
+      (action == :delete && !underlying_stack) || status.success?
     end
 
     def wait_for_completion

data/lib/bora/stack_status.rb

@@ -0,0 +1,29 @@
+require 'bora/status'
+
+module Bora
+  class StackStatus
+    def initialize(underlying_stack)
+      @stack = underlying_stack
+      if @stack
+        @status = Status.new(@stack.stack_status)
+      end
+    end
+
+    def exists?
+      @status && !@status.deleted?
+    end
+
+    def success?
+      @status && @status.success?
+    end
+
+    def to_s(colorize = true)
+      if @stack
+        status_reason = @stack.stack_status_reason ? " - #{@stack.stack_status_reason}" : ""
+        "#{@stack.stack_name} - #{@status.to_s(colorize)}#{status_reason}"
+      else
+        "Stack does not exist"
+      end
+    end
+  end
+end

data/lib/bora/status.rb

@@ -0,0 +1,41 @@
+require 'colorize'
+
+module Bora
+  class Status
+    def initialize(status)
+      @status = status
+    end
+
+    def success?
+      @status.end_with?("_COMPLETE") && !@status.include?("ROLLBACK")
+    end
+
+    def failure?
+      @status.end_with?("_FAILED") || @status.include?("ROLLBACK")
+    end
+
+    def deleted?
+      @status == "DELETE_COMPLETE"
+    end
+
+    def complete?
+      success? || failure?
+    end
+
+    def to_s(colorize = true)
+      colorize ? @status.colorize(color) : @status
+    end
+
+
+    private
+
+    def color
+      case
+        when success?; :green
+        when failure?; :red
+        else; :yellow;
+      end
+    end
+
+  end
+end

data/lib/bora/tasks.rb

@@ -22,6 +22,9 @@ module Bora
       define_diff_task
       define_events_task
       define_new_template_task
+      define_recreate_task
+      define_status_task
+      define_validate_task
     end
 
     def define_apply_task
@@ -84,6 +87,33 @@ module Bora
       end
     end
 
+    def define_recreate_task
+      within_namespace do
+        desc "Recreates (deletes then creates) the #{@stack_name} stack"
+        task :recreate do
+          invoke_action("recreate", stack_options)
+        end
+      end
+    end
+
+    def define_status_task
+      within_namespace do
+        desc "Displays the current status of the #{@stack_name} stack"
+        task :status do
+          puts @stack.status
+        end
+      end
+    end
+
+    def define_validate_task
+      within_namespace do
+        desc "Checks the #{@stack_name} stack's template for validity"
+        task :validate do
+          puts "Template for stack '#{@stack_name}' is valid" if @stack.validate(stack_options)
+        end
+      end
+    end
+
     def invoke_action(action, *args)
       puts "#{action.capitalize} stack #{@stack_name}"
       success = @stack.send(action, *args) { |event| puts event.to_s(colorize) }

data/lib/bora/version.rb

@@ -1,3 +1,3 @@
 module Bora
-  VERSION = "0.2.0"
+  VERSION = "0.3.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bora
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Charles Blaxland
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2016-01-15 00:00:00.000000000 Z
+date: 2016-01-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk
@@ -113,6 +113,8 @@ files:
 - lib/bora.rb
 - lib/bora/event.rb
 - lib/bora/stack.rb
+- lib/bora/stack_status.rb
+- lib/bora/status.rb
 - lib/bora/tasks.rb
 - lib/bora/version.rb
 homepage: https://github.com/ampedandwired/bora