cfer 0.1.1

data/lib/cfer/core/stack.rb

@@ -0,0 +1,170 @@
+module Cfer::Core
+
+  # Defines the structure of a CloudFormation stack
+  class Stack < Cfer::Block
+    include Cfer::Core
+    include Cfer::Cfn
+
+    attr_reader :parameters
+    attr_reader :options
+    attr_reader :git
+
+    def converge!
+      if @options[:client]
+        @options[:client].converge self
+      end
+    end
+
+    def tail!(&block)
+      if @options[:client]
+        @options[:client].tail self, &block
+      end
+    end
+
+    def resolve(val)
+      @options[:client] ? @options[:client].resolve(val) : val
+    end
+
+    def initialize(options = {})
+      self[:AWSTemplateFormatVersion] = '2010-09-09'
+      self[:Description] = ''
+
+      @options = options
+      @git = Rugged::Repository.discover('.')
+
+      self[:Parameters] = {}
+      self[:Mappings] = {}
+      self[:Conditions] = {}
+      self[:Resources] = {}
+      self[:Outputs] = {}
+
+      @parameters = HashWithIndifferentAccess.new
+
+      if options[:parameters]
+        options[:parameters].each do |key, val|
+          @parameters[key] = resolve(val)
+        end
+      end
+    end
+
+    def pre_block
+    end
+
+    # Sets the description for this CloudFormation stack
+    def description(desc)
+      self[:Description] = desc
+    end
+
+    # Declares a CloudFormation parameter
+    #
+    # @param name [String] The parameter name
+    # @param options [Hash]
+    # @option options [String] :type The type for the CloudFormation parameter
+    # @option options [String] :default A value of the appropriate type for the template to use if no value is specified when a stack is created. If you define constraints for the parameter, you must specify a value that adheres to those constraints.
+    # @option options [String] :no_echo Whether to mask the parameter value whenever anyone makes a call that describes the stack. If you set the value to `true`, the parameter value is masked with asterisks (*****).
+    # @option options [String] :allowed_values An array containing the list of values allowed for the parameter.
+    # @option options [String] :allowed_pattern A regular expression that represents the patterns you want to allow for String types.
+    # @option options [Number] :max_length An integer value that determines the largest number of characters you want to allow for String types.
+    # @option options [Number] :min_length An integer value that determines the smallest number of characters you want to allow for String types.
+    # @option options [Number] :max_value A numeric value that determines the largest numeric value you want to allow for Number types.
+    # @option options [Number] :min_value A numeric value that determines the smallest numeric value you want to allow for Number types.
+    # @option options [String] :description A string of up to 4000 characters that describes the parameter.
+    # @option options [String] :constraint_description A string that explains the constraint when the constraint is violated. For example, without a constraint description, a parameter that has an allowed pattern of `[A-Za-z0-9]+` displays the following error message when the user specifies an invalid value:
+    #
+    #     ```Malformed input-Parameter MyParameter must match pattern [A-Za-z0-9]+```
+    #
+    #     By adding a constraint description, such as must only contain upper- and lowercase letters, and numbers, you can display a customized error message:
+    #
+    #     ```Malformed input-Parameter MyParameter must only contain upper and lower case letters and numbers```
+    def parameter(name, options = {})
+      param = {}
+      options.each do |key, v|
+        k = key.to_s.camelize.to_sym
+        param[k] =
+          case k
+          when :AllowedValues
+            str_list = v.join(',')
+            verify_param(name, "Parameter #{name} must be one of: #{str_list}") { |input_val| str_list.include?(input_val) }
+            str_list
+          when :AllowedPattern
+            if v.class == Regexp
+              verify_param(name, "Parameter #{name} must match /#{v.source}/") { |input_val| v =~ input_val }
+              v.source
+            else
+              verify_param(name, "Parameter #{name} must match /#{v}/") { |input_val| Regexp.new(v) =~ input_val }
+              v
+            end
+          when :MaxLength
+            verify_param(name, "Parameter #{name} must have length <= #{v}") { |input_val| input_val.length <= v.to_i }
+            v
+          when :MinLength
+            verify_param(name, "Parameter #{name} must have length >= #{v}") { |input_val| input_val.length >= v.to_i }
+            v
+          when :MaxValue
+            verify_param(name, "Parameter #{name} must be <= #{v}") { |input_val| input_val.to_i <= v.to_i }
+            v
+          when :MinValue
+            verify_param(name, "Parameter #{name} must be >= #{v}") { |input_val| input_val.to_i >= v.to_i }
+            v
+          when :Description
+            Preconditions.check_argument(v.length <= 4000, "#{key} must be <= 4000 characters")
+            v
+          when :Default
+            @parameters[name] ||= resolve(v)
+          end
+        param[k] ||= v
+      end
+      param[:Type] ||= 'String'
+      self[:Parameters][name] = param
+    end
+
+    # Sets the mappings block for this stack. See [The CloudFormation Documentation](http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/mappings-section-structure.html) for more details
+    def mappings(mappings)
+      self[:Mappings] = mappings
+    end
+
+    # Adds a condition to the template.
+    # @param name [String] The name of the condition.
+    # @param expr [Hash] The CloudFormation condition to add. See [The Cloudformation Documentation](http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/conditions-section-structure.html) for more details
+    def condition(name, expr)
+      self[:Conditions][name] = expr
+    end
+
+    # Creates a CloudFormation resource
+    # @param name [String] The name of the resource (must be alphanumeric)
+    # @param type [String] The type of CloudFormation resource to create.
+    # @param options [Hash] Additional attributes to add to the resource block (such as the `UpdatePolicy` for an `AWS::AutoScaling::AutoScalingGroup`)
+    def resource(name, type, options = {}, &block)
+      Preconditions.check_argument(/[[:alnum:]]+/ =~ name, "Resource name must be alphanumeric")
+
+      clazz = "CferExt::#{type}".split('::').inject(Object) { |o, c| o.const_get c if o && o.const_defined?(c) } || Cfer::Cfn::Resource
+      Preconditions.check_argument clazz <= Cfer::Cfn::Resource, "#{type} is not a valid resource type because CferExt::#{type} does not inherit from `Cfer::Cfn::Resource`"
+
+      rc = clazz.new(name, type, options, &block)
+
+      self[:Resources][name] = rc
+      rc
+    end
+
+    # Adds an output to the CloudFormation stack.
+    # @param name [String] The Logical ID of the output parameter
+    # @param value [String] Value to return
+    # @param options [Hash] Extra options for this output parameter
+    # @option options [String] :Description Informationa bout the value
+    def output(name, value, options = {})
+      self[:Outputs][name] = options.merge('Value' => value)
+    end
+
+    # Renders the stack into a CloudFormation template.
+    # @return [String] The final template
+    def to_cfn
+      to_h.to_json
+    end
+
+    private
+    def verify_param(param_name, err_msg)
+      raise Cfer::Util::CferError, err_msg if (@parameters[param_name] && !yield(@parameters[param_name].to_s))
+    end
+  end
+
+end

data/lib/cfer/util/error.rb

@@ -0,0 +1,31 @@
+module Cfer::Util
+  require 'highline/import'
+  class CferError < StandardError
+  end
+
+  class StackExistsError < CferError
+  end
+
+  class TemplateError < CferError
+    attr_reader :template_backtrace
+
+    def initialize(template_backtrace)
+      @template_backtrace = template_backtrace
+      super
+    end
+  end
+
+  def self.bug_report(e)
+    gather_report e
+    transmit_report if agree('Would you like to send this information in a bug report? (type yes/no)')
+  end
+
+  private
+  def self.gather_report(e)
+    puts e
+  end
+
+  def self.transmit_report
+    puts "Sending report."
+  end
+end

data/lib/cfer/version.rb

@@ -0,0 +1,3 @@
+module Cfer
+  VERSION = "0.1.1"
+end

data/lib/cferext/aws/ec2/instance.rb

@@ -0,0 +1,12 @@
+require 'cferext/provisioning'
+
+module CferExt::AWS::EC2
+  class Instance < Cfer::Cfn::Resource
+    include CferExt::Provisioning
+
+    def initialize(name, type, options = {}, &block)
+      options[:Metadata] ||= {}
+      super(name, type, options, &block)
+    end
+  end
+end

data/lib/cferext/provisioning.rb

@@ -0,0 +1,6 @@
+module CferExt::Provisioning
+  def cloud_init(doc)
+    userdata doc
+  end
+end
+

metadata

@@ -0,0 +1,271 @@
+--- !ruby/object:Gem::Specification
+name: cfer
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Sean Edwards
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-06-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: docile
+  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: 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: activesupport
+  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: '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-resources
+  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: preconditions
+  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: semantic
+  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: rainbow
+  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: highline
+  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: rugged
+  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: table_print
+  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: rake
+  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: bundler
+  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: yard
+  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'
+description: Toolkit for automating infrastructure using AWS CloudFormation
+email:
+- stedwards87+git@gmail.com
+executables:
+- cfer
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .travis.yml
+- .yardopts
+- CODE_OF_CONDUCT.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/cfer
+- bin/cfer-dbg
+- bin/console
+- bin/setup
+- cfer-demo.gif
+- cfer.gemspec
+- examples/instance.rb
+- examples/vpc.rb
+- lib/cfer.rb
+- lib/cfer/block.rb
+- lib/cfer/cfn/aws.rb
+- lib/cfer/cfn/client.rb
+- lib/cfer/cli.rb
+- lib/cfer/core/client.rb
+- lib/cfer/core/fn.rb
+- lib/cfer/core/resource.rb
+- lib/cfer/core/stack.rb
+- lib/cfer/util/error.rb
+- lib/cfer/version.rb
+- lib/cferext/aws/ec2/instance.rb
+- lib/cferext/provisioning.rb
+homepage: https://github.com/seanedwards/cfer
+licenses:
+- MIT
+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: Toolkit for automating infrastructure using AWS CloudFormation
+test_files: []