stackup 1.1.3 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 8d9136bd380d1644176d3b65c7ee93315016d455
-  data.tar.gz: ea8bdd9c6766e6f581557073a2afb5134efd3902
+  metadata.gz: f0711fc64ee45d78fe5e7d71ab1afff01906ceb1
+  data.tar.gz: b7374819ee928e7c3147980b88a2ef5b70c84c67
 SHA512:
-  metadata.gz: 3f9a13acc03300f01506f109ae336c794e49753ef592e630462faa89fa39f6e858e43fe56c33c3c03c59ded1132e063a1eb7c2431005b674ee6f43d39a6749d4
-  data.tar.gz: 48b38607b8e0ee0015ab1fd81e049e62c9b53ab7338b005be51e15a9fcf8e573bbde69cd9352fec2688111ae2c1b60492234dacaed56d25cfdab9bfaa2610dde
+  metadata.gz: a4574add771970c33b04d0b1cd60007b1e72f03863241e69912b880ec6b77d5f55149cfaafffe823a88a5c017097df05b2047981ed05c2bf4abdb93707e827bb
+  data.tar.gz: e1ba38d93f94fd8081884c2d01d9568c9572eba7ea38b0be5213607709b123ac2008aa91cbfe9aff8a6ece7978c20636ad2519a819a543dbcf87f1e90de6558e

data/CHANGES.md

@@ -1,3 +1,7 @@
+## 1.2.0 (2017-10-24)
+
+* Add support for change-sets.
+
 ## 1.1.3 (2017-05-01)
 
 * Fix #39: parse error when JSON-like text is embedded in YAML.

data/README.md

@@ -18,6 +18,7 @@ AWS CloudFormation stacks.
 	- [Using URLs as inputs](#using-urls-as-inputs)
 	- [Stack deletion](#stack-deletion)
 	- [Stack inspection](#stack-inspection)
+	- [Change-set support](#change-set-support)
 - [Programmatic usage](#programmatic-usage)
 - [Rake integration](#rake-integration)
 - [Docker image](#docker-image)
@@ -150,6 +151,17 @@ Inspect details of a stack with:
     $ stackup myapp-test resources
     $ stackup myapp-test outputs
 
+### Change-set support
+
+You can also create, list, inspect, apply and delete [change sets](http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-changesets.html) using `stackup`.
+
+    $ stackup myapp-test change-sets
+    $ stackup myapp-test change-set create -t template.json
+    $ stackup myapp-test change-set inspect
+    $ stackup myapp-test change-set apply
+
+The change-set name defaults to "pending", but can be overridden using `--name`.
+
 ## Programmatic usage
 
 Get a handle to a `Stack` object as follows:
@@ -195,7 +207,7 @@ Parameters and tags may be specified via files, or as a Hash, e.g.
 Stackup is also published as a Docker image. Basic usage is:
 
     docker run --rm \
-        -v `pwd`:/cwd \
+        -v "`pwd`:/cwd" \
         -e AWS_ACCESS_KEY_ID -e AWS_SECRET_ACCESS_KEY -e AWS_SESSION_TOKEN \
         -e AWS_DEFAULT_REGION \
         realestate/stackup:latest ...

data/bin/stackup

@@ -129,12 +129,6 @@ Clamp do
     puts final_status unless final_status.nil?
   end
 
-  def parameters_from_files
-    parameter_sources.map { |src|
-      Stackup::Parameters.new(src.data).to_hash
-    }.inject({}, :merge)
-  end
-
   subcommand "status", "Print stack status." do
 
     def execute
@@ -143,14 +137,9 @@ Clamp do
 
   end
 
-  subcommand "up", "Create/update the stack." do
+  module HasParameters
 
-    option ["-t", "--template"], "FILE", "template source",
-           :attribute_name => :template_source,
-           &Stackup::Source.method(:new)
-
-    option ["-T", "--use-previous-template"], :flag,
-           "reuse the existing template"
+    extend Clamp::Option::Declaration
 
     option ["-p", "--parameters"], "FILE", "parameters file (last wins)",
            :multivalued => true,
@@ -161,6 +150,40 @@ Clamp do
            :multivalued => true,
            :attribute_name => :override_list
 
+    private
+
+    def parameters
+      parameters_from_files.merge(parameter_overrides)
+    end
+
+    def parameters_from_files
+      parameter_sources.map { |src|
+        Stackup::Parameters.new(src.data).to_hash
+      }.inject({}, :merge)
+    end
+
+    def parameter_overrides
+      {}.tap do |result|
+        override_list.each do |override|
+          key, value = override.split("=", 2)
+          result[key] = value
+        end
+      end
+    end
+
+  end
+
+  subcommand "up", "Create/update the stack." do
+
+    option ["-t", "--template"], "FILE", "template source",
+           :attribute_name => :template_source,
+           &Stackup::Source.method(:new)
+
+    option ["-T", "--use-previous-template"], :flag,
+           "reuse the existing template"
+
+    include HasParameters
+
     option "--tags", "FILE", "stack tags file",
            :attribute_name => :tag_source,
            &Stackup::Source.method(:new)
@@ -201,40 +224,137 @@ Clamp do
       end
     end
 
+  end
+
+  subcommand ["change-sets"], "List change-sets." do
+
+    def execute
+      stack.change_set_summaries.each do |change_set|
+        puts [
+          pad(change_set.change_set_name, 36),
+          pad(change_set.status, 20),
+          pad(change_set.execution_status, 24)
+        ].join("  ")
+      end
+    end
+
     private
 
-    def parameters
-      parameters_from_files.merge(parameter_overrides)
+    def pad(s, width)
+      (s || "").ljust(width)
     end
 
-    def parameter_overrides
-      {}.tap do |result|
-        override_list.each do |override|
-          key, value = override.split("=", 2)
-          result[key] = value
+  end
+
+  subcommand ["change-set"], "Change-set operations." do
+
+    option "--name", "NAME", "Name of change-set",
+           :attribute_name => :change_set_name,
+           :default => "pending"
+
+    subcommand "create", "Create a change-set." do
+
+      option ["-d", "--description"], "DESC",
+             "Change-set description"
+
+      option ["-t", "--template"], "FILE", "template source",
+             :attribute_name => :template_source,
+             &Stackup::Source.method(:new)
+
+      option ["-T", "--use-previous-template"], :flag,
+             "reuse the existing template"
+
+      option ["--force"], :flag,
+             "replace existing change-set of the same name"
+
+      include HasParameters
+
+      option "--tags", "FILE", "stack tags file",
+             :attribute_name => :tag_source,
+             &Stackup::Source.method(:new)
+
+      def execute
+        unless template_source || use_previous_template?
+          signal_usage_error "Specify either --template or --use-previous-template"
+        end
+        options = {}
+        if template_source
+          if template_source.s3?
+            options[:template_url] = template_source.location
+          else
+            options[:template] = template_source.data
+          end
+        end
+        options[:parameters] = parameters
+        options[:description] = description if description
+        options[:tags] = tag_source.data if tag_source
+        options[:use_previous_template] = use_previous_template?
+        options[:force] = force?
+        report_change do
+          change_set.create(options)
+        end
+      end
+
+    end
+
+    subcommand "changes", "Describe the change-set." do
+
+      def execute
+        display_data(change_set.describe.changes.map(&:to_h))
+      end
+
+    end
+
+    subcommand "inspect", "Show full change-set details." do
+
+      def execute
+        display_data(change_set.describe.to_h)
+      end
+
+    end
+
+    subcommand ["apply", "execute"], "Apply the change-set." do
+
+      def execute
+        report_change do
+          change_set.execute
         end
       end
+
+    end
+
+    subcommand "delete", "Delete the change-set." do
+
+      def execute
+        report_change do
+          change_set.delete
+        end
+      end
+
+    end
+
+    private
+
+    def change_set
+      stack.change_set(change_set_name)
     end
 
   end
 
   subcommand "diff", "Compare template/params to current stack." do
 
+    option "--diff-format", "FORMAT", "'text', 'color', or 'html'", :default => "color"
+
     option ["-t", "--template"], "FILE", "template source",
            :attribute_name => :template_source,
            &Stackup::Source.method(:new)
 
-    option ["-p", "--parameters"], "FILE", "parameters file (last wins)",
-           :multivalued => true,
-           :attribute_name => :parameter_sources,
-           &Stackup::Source.method(:new)
+    include HasParameters
 
     option "--tags", "FILE", "stack tags file",
            :attribute_name => :tag_source,
            &Stackup::Source.method(:new)
 
-    option "--diff-format", "FORMAT", "'text', 'color', or 'html'", :default => "color"
-
     def execute
       current = {}
       planned = {}
@@ -265,7 +385,7 @@ Clamp do
     end
 
     def new_parameters
-      existing_parameters.merge(parameters_from_files)
+      existing_parameters.merge(parameters)
     end
 
   end

data/lib/stackup/change_set.rb

@@ -0,0 +1,153 @@
+require "stackup/error_handling"
+
+module Stackup
+
+  # An abstraction of a CloudFormation change-set.
+  #
+  class ChangeSet
+
+    def initialize(name, stack)
+      @name = name
+      @stack = stack
+    end
+
+    attr_reader :name
+    attr_reader :stack
+
+    include ErrorHandling
+
+    # Create the change-set.
+    #
+    # Refer +Aws::CloudFormation::Client#create_change_set+
+    #   (see http://docs.aws.amazon.com/sdkforruby/api/Aws/CloudFormation/Client.html#create_change_set-instance_method)
+    #
+    # @param [Hash] options change-set options
+    # @option options [Array<String>] :capabilities (CAPABILITY_NAMED_IAM)
+    #   list of capabilities required for stack template
+    # @option options [String] :description
+    #   change-set description
+    # @option options [String] :notification_arns
+    #   ARNs for the Amazon SNS topics associated with this stack
+    # @option options [Hash, Array<Hash>] :parameters
+    #   stack parameters, either as a Hash, or an Array of
+    #   +Aws::CloudFormation::Types::Parameter+ structures
+    # @option options [Hash, Array<Hash>] :tags
+    #   stack tags, either as a Hash, or an Array of
+    #   +Aws::CloudFormation::Types::Tag+ structures
+    # @option options [Array<String>] :resource_types
+    #   resource types that you have permissions to work with
+    # @option options [Hash] :template
+    #   stack template, as Ruby data
+    # @option options [String] :template_body
+    #   stack template, as JSON or YAML
+    # @option options [String] :template_url
+    #   location of stack template
+    # @option options [boolean] :use_previous_template
+    #   if true, reuse the existing template
+    # @option options [boolean] :force
+    #   if true, delete any existing change-set of the same name
+    #
+    # @return [String] change-set id
+    # @raise [Stackup::NoSuchStack] if the stack doesn't exist
+    #
+    def create(options = {})
+      options = options.dup
+      options[:stack_name] = stack.name
+      options[:change_set_name] = name
+      options[:change_set_type] = stack.exists? ? "UPDATE" : "CREATE"
+      force = options.delete(:force)
+      if (template_data = options.delete(:template))
+        options[:template_body] = MultiJson.dump(template_data)
+      end
+      if (parameters = options[:parameters])
+        options[:parameters] = Parameters.new(parameters).to_a
+      end
+      if (tags = options[:tags])
+        options[:tags] = normalize_tags(tags)
+      end
+      options[:capabilities] ||= ["CAPABILITY_NAMED_IAM"]
+      delete if force
+      handling_cf_errors do
+        cf_client.create_change_set(options)
+        loop do
+          current = describe
+          logger.debug("change_set_status=#{current.status}")
+          case current.status
+          when /COMPLETE/
+            return current.status
+          when "FAILED"
+            logger.error(current.status_reason)
+            fail StackUpdateError, "change-set creation failed" if status == "FAILED"
+          end
+          sleep(wait_poll_interval)
+        end
+        status
+      end
+    end
+
+    # Execute the change-set.
+    #
+    # @return [String] resulting stack status
+    # @raise [Stackup::NoSuchChangeSet] if the change-set doesn't exist
+    # @raise [Stackup::NoSuchStack] if the stack doesn't exist
+    # @raise [Stackup::StackUpdateError] if operation fails
+    #
+    def execute
+      modify_stack("UPDATE_COMPLETE", "update failed") do
+        cf_client.execute_change_set(:stack_name => stack.name, :change_set_name => name)
+      end
+    end
+
+    # Delete a change-set.
+    #
+    # @raise [Stackup::NoSuchStack] if the stack doesn't exist
+    #
+    def delete
+      handling_cf_errors do
+        cf_client.delete_change_set(:stack_name => stack.name, :change_set_name => name)
+      end
+      nil
+    end
+
+    def status
+      describe.status
+    end
+
+    # Describe the change-set.
+    #
+    # Refer +Aws::CloudFormation::Client#describe_change_set+
+    #   (http://docs.aws.amazon.com/sdkforruby/api/Aws/CloudFormation/Client.html#describe_change_set-instance_method)
+    #
+    # @return change-set state, as data
+    #
+    def describe
+      handling_cf_errors do
+        cf_client.describe_change_set(:stack_name => stack.name, :change_set_name => name)
+      end
+    end
+
+    private
+
+    def cf_client
+      stack.send(:cf_client)
+    end
+
+    def modify_stack(*args, &block)
+      stack.send(:modify_stack, *args, &block)
+    end
+
+    def normalize_tags(tags)
+      stack.send(:normalize_tags, tags)
+    end
+
+    def logger
+      stack.send(:logger)
+    end
+
+    def wait_poll_interval
+      stack.send(:wait_poll_interval)
+    end
+
+  end
+
+end

data/lib/stackup/error_handling.rb

@@ -6,14 +6,15 @@ module Stackup
   #
   module ErrorHandling
 
-    # Invoke an Aws::CloudFormation operation
+    # Invoke an Aws::CloudFormation operation.
     #
-    # If a +ValidationError+ is raised, check the message; there's often
-    # useful information is hidden inside.  If that's the case, convert it to
-    # an appropriate Stackup exception.
+    # If an exception is raised, convert it to a Stackup exception,
+    # if appropriate.
     #
-    def handling_validation_error
+    def handling_cf_errors
       yield
+    rescue Aws::CloudFormation::Errors::ChangeSetNotFound => e
+      raise NoSuchChangeSet, "no such change-set"
     rescue Aws::CloudFormation::Errors::ValidationError => e
       case e.message
       when /Stack .* does not exist/

data/lib/stackup/errors.rb

@@ -6,8 +6,14 @@ module Stackup
   # Raised when something else dodgy happened
   class ValidationError < ServiceError; end
 
+  # Raised when the specified thing does not exist
+  class NoSuchThing < ValidationError; end
+
   # Raised when the specified stack does not exist
-  class NoSuchStack < ValidationError; end
+  class NoSuchStack < NoSuchThing; end
+
+  # Raised when the specified change-set does not exist
+  class NoSuchChangeSet < NoSuchThing; end
 
   # Raised if we can't perform that operation now
   class InvalidStateError < ValidationError; end

data/lib/stackup/parameters.rb

@@ -16,8 +16,12 @@ module Stackup
       def hashify(parameters)
         {}.tap do |result|
           parameters.each do |p|
-            p_struct = ParameterStruct.new(p)
-            result[p_struct.key] = p_struct.value
+            begin
+              p_struct = ParameterStruct.new(p)
+              result[p_struct.key] = p_struct.value
+            rescue ArgumentError
+              raise ArgumentError, "invalid parameter record: #{p.inspect}"
+            end
           end
         end
       end
@@ -53,7 +57,12 @@ module Stackup
         if name.respond_to?(:gsub)
           name = name.gsub(/([a-z])([A-Z])/, '\1_\2').downcase
         end
-        public_send("#{name}=", value)
+        writer = "#{name}="
+        if respond_to?(writer)
+          public_send(writer, value)
+        else
+          raise ArgumentError, "invalid attribute: #{name.inspect}"
+        end
       end
     end
 

data/lib/stackup/stack.rb

@@ -1,6 +1,7 @@
 require "aws-sdk-resources"
 require "logger"
 require "multi_json"
+require "stackup/change_set"
 require "stackup/error_handling"
 require "stackup/parameters"
 require "stackup/stack_watcher"
@@ -49,7 +50,7 @@ module Stackup
     # @raise [Stackup::NoSuchStack] if the stack doesn't exist
     #
     def status
-      handling_validation_error do
+      handling_cf_errors do
         cf_stack.stack_status
       end
     end
@@ -107,7 +108,7 @@ module Stackup
     #   stack creation timeout
     # @option options [boolean] :use_previous_template
     #   if true, reuse the existing template
-    # @return [Symbol] +:created+ or +:updated+ if successful
+    # @return [String] resulting stack status
     # @raise [Stackup::StackUpdateError] if operation fails
     #
     def create_or_update(options)
@@ -140,12 +141,12 @@ module Stackup
 
     # Delete the stack.
     #
-    # @return [Symbol] +:deleted+ if successful
+    # @return [String] "DELETE_COMPLETE"
     # @raise [Stackup::StackUpdateError] if operation fails
     #
     def delete
       begin
-        @stack_id = handling_validation_error do
+        @stack_id = handling_cf_errors do
           cf_stack.stack_id
         end
       rescue NoSuchStack
@@ -162,7 +163,7 @@ module Stackup
 
     # Cancel update in-progress.
     #
-    # @return [Symbol] +:update_cancelled+ if successful
+    # @return [String] resulting stack status
     # @raise [Stackup::StackUpdateError] if operation fails
     #
     def cancel_update
@@ -189,7 +190,7 @@ module Stackup
     # @raise [Stackup::NoSuchStack] if the stack doesn't exist
     #
     def template_body
-      handling_validation_error do
+      handling_cf_errors do
         cf_client.get_template(:stack_name => name).template_body
       end
     end
@@ -240,6 +241,26 @@ module Stackup
       extract_hash(:resource_summaries, :logical_resource_id, :physical_resource_id)
     end
 
+    # List change-sets.
+    #
+    # @return [Array<ChangeSetSummary>]
+    # @raise [Stackup::NoSuchStack] if the stack doesn't exist
+    #
+    def change_set_summaries
+      handling_cf_errors do
+        cf_client.list_change_sets(:stack_name => name).summaries
+      end
+    end
+
+    # An abstraction of a CloudFormation change-set.
+    #
+    # @param [String] name change-set name
+    # @return [ChangeSet] an handle for change-set operations
+    #
+    def change_set(name)
+      ChangeSet.new(name, self)
+    end
+
     def watch(zero = true)
       watcher = Stackup::StackWatcher.new(cf_stack)
       watcher.zero if zero
@@ -313,7 +334,7 @@ module Stackup
     #
     def modify_stack_synchronously
       watch do |watcher|
-        handling_validation_error do
+        handling_cf_errors do
           yield
         end
         loop do
@@ -331,7 +352,7 @@ module Stackup
     # @return the stack status
     #
     def modify_stack_asynchronously
-      handling_validation_error do
+      handling_cf_errors do
         yield
       end
       self.status
@@ -355,7 +376,7 @@ module Stackup
     # @return [Hash<String, String>] mapping of collection
     #
     def extract_hash(collection_name, key_name, value_name)
-      handling_validation_error do
+      handling_cf_errors do
         {}.tap do |result|
           cf_stack.public_send(collection_name).each do |item|
             key = item.public_send(key_name)

data/lib/stackup/version.rb

@@ -1,5 +1,5 @@
 module Stackup
 
-  VERSION = "1.1.3"
+  VERSION = "1.2.0"
 
 end

data/lib/stackup/yaml.rb

@@ -64,7 +64,7 @@ module Stackup
 
       def array_or_dotted_string(arg)
         if arg.respond_to?(:split)
-          arg.split(".")
+          arg.split(".", 2)
         else
           arg
         end

data/spec/spec_helper.rb

@@ -1,3 +1,4 @@
+require "byebug"
 require "console_logger"
 
 module CfStubbing

data/spec/stackup/stack_spec.rb

@@ -10,30 +10,42 @@ describe Stackup::Stack do
   let(:unique_stack_id) { "ID:#{stack_name}" }
   let(:stack_options) { {} }
 
+  let(:change_set_name) { "ch-ch-changes" }
+
   subject(:stack) { described_class.new(stack_name, cf_client, stack_options) }
 
   before do
     cf_client.stub_responses(:describe_stacks, *describe_stacks_responses)
+    cf_client.stub_responses(:describe_change_set, *describe_change_set_responses)
     allow(stack).to receive(:sleep).at_most(5).times
     # partial stubbing, to support spying
     allow(cf_client).to receive(:create_stack).and_call_original
     allow(cf_client).to receive(:delete_stack).and_call_original
     allow(cf_client).to receive(:update_stack).and_call_original
     allow(cf_client).to receive(:cancel_update_stack).and_call_original
+    allow(cf_client).to receive(:list_change_sets).and_call_original
+    allow(cf_client).to receive(:create_change_set).and_call_original
+    allow(cf_client).to receive(:execute_change_set).and_call_original
+    allow(cf_client).to receive(:delete_change_set).and_call_original
+    allow(cf_client).to receive(:describe_change_set).and_call_original
   end
 
-  def validation_error(message)
+  def error(type, message)
     {
       :status_code => 400,
       :headers => {},
       :body => [
-        "<ErrorResponse><Error><Code>ValidationError</Code><Message>",
+        "<ErrorResponse><Error><Code>#{type}</Code><Message>",
         message,
         "</Message></Error></ErrorResponse>"
       ].join
     }
   end
 
+  def validation_error(message)
+    error("ValidationError", message)
+  end
+
   def stack_description(stack_status, details = {})
     {
       :stacks => [
@@ -47,6 +59,14 @@ describe Stackup::Stack do
     }
   end
 
+  let(:describe_change_set_responses) do
+    [
+      {
+        :status => "CREATE_COMPLETE"
+      }
+    ]
+  end
+
   context "before stack exists" do
 
     let(:describe_stacks_responses) do
@@ -262,6 +282,86 @@ describe Stackup::Stack do
 
     end
 
+    describe "#change_set#create" do
+
+      let(:template) { "stack template" }
+
+      let(:options) do
+        { :template_body => template }
+      end
+
+      def create_change_set
+        stack.change_set(change_set_name).create(options)
+      end
+
+      it "calls :create_change_set" do
+        expected_args = {
+          :stack_name => stack_name,
+          :change_set_name => change_set_name,
+          :change_set_type => "CREATE",
+          :template_body => template
+        }
+        create_change_set
+        expect(cf_client).to have_received(:create_change_set)
+          .with(hash_including(expected_args))
+      end
+
+      context "with :template as data" do
+
+        let(:options) do
+          { :template => { "foo" => "bar" } }
+        end
+
+        it "converts the template to JSON" do
+          create_change_set
+          expect(cf_client).to have_received(:create_change_set)
+            .with(hash_including(:template_body))
+        end
+
+      end
+
+      context "with :parameters as Hash" do
+
+        before do
+          options[:parameters] = { "foo" => "bar" }
+        end
+
+        it "converts them to an Array" do
+          expected_parameters = [
+            {
+              :parameter_key => "foo",
+              :parameter_value => "bar"
+            }
+          ]
+          create_change_set
+          expect(cf_client).to have_received(:create_change_set) do |options|
+            expect(options[:parameters]).to eq(expected_parameters)
+          end
+        end
+
+      end
+
+      context "with :tags as Hash" do
+
+        before do
+          options[:tags] = { "foo" => "bar", "code" => 123 }
+        end
+
+        it "converts them to an Array" do
+          expected_tags = [
+            { :key => "foo", :value => "bar" },
+            { :key => "code", :value => "123" }
+          ]
+          create_change_set
+          expect(cf_client).to have_received(:create_change_set) do |options|
+            expect(options[:tags]).to eq(expected_tags)
+          end
+        end
+
+      end
+
+    end
+
   end
 
   context "with existing stack" do
@@ -426,6 +526,114 @@ describe Stackup::Stack do
 
     end
 
+    describe "#change_set_summaries" do
+
+      it "calls :list_change_sets" do
+        cf_client.stub_responses(:list_change_sets, :summaries => [
+          { :change_set_name => "take1" },
+          { :change_set_name => "take2" },
+        ])
+        summaries = stack.change_set_summaries
+        expect(summaries.map(&:change_set_name)).to eql(%w(take1 take2))
+        expect(cf_client).to have_received(:list_change_sets)
+          .with(:stack_name => stack_name)
+      end
+
+    end
+
+    describe "#change_set#create" do
+
+      let(:template) { "stack template" }
+
+      let(:options) do
+        { :template_body => template }
+      end
+
+      def create_change_set
+        stack.change_set(change_set_name).create(options)
+      end
+
+      it "calls :create_change_set" do
+        expected_args = {
+          :stack_name => stack_name,
+          :change_set_name => change_set_name,
+          :change_set_type => "UPDATE",
+          :template_body => template
+        }
+        create_change_set
+        expect(cf_client).to have_received(:create_change_set)
+          .with(hash_including(expected_args))
+      end
+
+    end
+
+    describe "#change_set#execute" do
+
+      let(:change_set_name) { "change-it" }
+
+      let(:describe_stacks_responses) do
+        [
+          stack_description("UPDATE_IN_PROGRESS"),
+          stack_description("UPDATE_COMPLETE")
+        ]
+      end
+
+      def execute_change_set
+        stack.change_set(change_set_name).execute
+      end
+
+      it "calls :execute_change_set" do
+        execute_change_set
+        expected_args = {
+          :stack_name => stack_name,
+          :change_set_name => change_set_name
+        }
+        expect(cf_client).to have_received(:execute_change_set)
+          .with(hash_including(expected_args))
+      end
+
+      it "it sleeps" do
+        execute_change_set
+        expect(stack).to have_received(:sleep).with(5)
+      end
+
+      it "returns status" do
+        expect(execute_change_set).to eq("UPDATE_COMPLETE")
+      end
+
+      context "if change-set doesn't exist" do
+
+        before do
+          cf_client.stub_responses(
+            :execute_change_set,
+            error("ChangeSetNotFound", "ChangeSet [foo] does not exist")
+          )
+        end
+
+        it "raises a NoSuchChangeSet error" do
+          expect { execute_change_set }.to raise_error(Stackup::NoSuchChangeSet)
+        end
+
+      end
+
+    end
+
+    describe "#change_set#delete" do
+
+      let(:change_set_name) { "change-it" }
+
+      it "calls :delete_change_set" do
+        stack.change_set(change_set_name).delete
+        expected_args = {
+          :stack_name => stack_name,
+          :change_set_name => change_set_name
+        }
+        expect(cf_client).to have_received(:delete_change_set)
+          .with(hash_including(expected_args))
+      end
+
+    end
+
     %w(CREATE_FAILED ROLLBACK_COMPLETE).each do |initial_status|
       context "when status is #{initial_status}" do
 

data/spec/stackup/yaml_spec.rb

@@ -100,6 +100,30 @@ describe Stackup::YAML do
 
       end
 
+      context "with a string with multiple dots" do
+
+        let(:input) do
+          <<-YAML
+          Outputs:
+            Foo: !GetAtt Bar.Baz.Some.More.Things
+          YAML
+        end
+
+        it "splits on the first dot" do
+          expect(data).to eql(
+            "Outputs" => {
+              "Foo" => {
+                "Fn::GetAtt" => [
+                  "Bar",
+                  "Baz.Some.More.Things"
+                ]
+              }
+            }
+          )
+        end
+
+      end
+
     end
 
     describe "!GetAZs" do

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: stackup
 version: !ruby/object:Gem::Version
-  version: 1.1.3
+  version: 1.2.0
 platform: ruby
 authors:
 - Mike Williams
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-05-01 00:00:00.000000000 Z
+date: 2017-10-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-resources
@@ -94,6 +94,7 @@ files:
 - README.md
 - bin/stackup
 - lib/stackup.rb
+- lib/stackup/change_set.rb
 - lib/stackup/differ.rb
 - lib/stackup/error_handling.rb
 - lib/stackup/errors.rb
@@ -133,7 +134,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.10
+rubygems_version: 2.5.1
 signing_key: 
 specification_version: 4
 summary: Manage CloudFormation stacks