cloudster 2.14.1 → 2.15.0

data/VERSION

@@ -1 +1 @@
-2.14.1
+2.15.0

data/cloudster.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = "cloudster"
-  s.version = "2.14.1"
+  s.version = "2.15.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Emil Soman"]
-  s.date = "2012-12-28"
+  s.date = "2012-12-30"
   s.description = "Cloudster is a Ruby gem that was born to cut the learning curve involved \n    in writing your own CloudFormation templates. If you don't know what a CloudFormation template is, \n    but know about the AWS Cloud offerings, you can still use cloudster to provision your stack. \n    Still in infancy , cloudster can create a very basic stack like a breeze. All kinds of contribution welcome !"
   s.email = "emil.soman@gmail.com"
   s.extra_rdoc_files = [
@@ -32,6 +32,7 @@ Gem::Specification.new do |s|
     "lib/cloudster/cloud.rb",
     "lib/cloudster/deep_merge.rb",
     "lib/cloudster/ec2.rb",
+    "lib/cloudster/elasticache.rb",
     "lib/cloudster/elb.rb",
     "lib/cloudster/options_manager.rb",
     "lib/cloudster/rds.rb",
@@ -39,6 +40,7 @@ Gem::Specification.new do |s|
     "spec/chef_client_spec.rb",
     "spec/cloud_spec.rb",
     "spec/ec2_spec.rb",
+    "spec/elasticache_spec.rb",
     "spec/elb_spec.rb",
     "spec/rds_spec.rb",
     "spec/s3_spec.rb",

data/lib/cloudster.rb

@@ -9,5 +9,6 @@ require 'cloudster/ec2'
 require 'cloudster/elb'
 require 'cloudster/rds'
 require 'cloudster/s3'
+require 'cloudster/elasticache'
 require 'cloudster/cloud'
 require 'cloudster/chef_client'

data/lib/cloudster/elasticache.rb

@@ -0,0 +1,93 @@
+module Cloudster
+ #ElastiCache Resource
+ class ElastiCache
+
+   attr_accessor :name, :template
+   # Initializes an ElastiCache resource
+   #
+   # ==== Notes
+   # options parameter must include values for :node_type, :cache_security_group_names, :engine, :node_count
+   #
+   # ==== Parameters
+   # * options<~Hash>
+   #   * :name : String representing the name for the ElastiCache resource (Required)
+   #   * :node_type : String representing the compute and memory capacity of nodes in a Cache Cluster. One of : cache.t1.micro | cache.m1.small | cache.m1.medium | cache.m1.large | cache.m1.xlarge | cache.m3.xlarge | cache.m3.2xlarge | cache.m2.xlarge | cache.m2.2xlarge | cache.m2.4xlarge | cache.c1.xlarge (Required)
+   #   * :cache_security_group_names : Array of cache security group names (Required)
+   #   * :engine : String containing the name of the cache engine to be used for this cache cluster. Only 'memcached' is supported now.(Required)
+   #   * :node_count : Integer indicating number of cache nodes the cache cluster should have.(Required)
+   # ==== Examples
+   #   cache = Cloudster::ElastiCache.new(
+   #    :name => 'ElastiCacheResource',
+   #    :node_type => 'cache.t1.micro',
+   #    :cache_security_group_names => ['default'],
+   #    :engine => 'memcached',
+   #    :node_count => 3"
+   #   )
+
+   def initialize(options = {})
+     require_options(options, [:name, :node_type, :cache_security_group_names, :engine, :node_count])
+     @name = options[:name]
+     @node_type = options[:node_type]
+     @cache_security_group_names = options[:cache_security_group_names]
+     @engine = options[:engine]
+     @node_count = options[:node_count]
+   end
+
+   # Returns a Ruby hash version of the Cloud Formation template for the ElastiCache resource
+   #
+   # ==== Examples
+   #   elasticache = Cloudster::ElastiCache.new(
+   #    :name => 'ElastiCacheResource',
+   #    :node_type => 'cache.t1.micro',
+   #    :cache_security_group_names => ['default'],
+   #    :engine => 'memcached',
+   #    :node_count => 3"
+   #   )
+   #   elasticache.template
+   #
+   # ==== Returns
+   # * Ruby hash version of the Cloud Formation template for the elasticache resource
+    def template
+      @template ||= ElastiCache.template({:name => @name, :node_type => @node_type, :cache_security_group_names => @cache_security_group_names, :engine => @engine, :node_count => @node_count})
+    end
+
+    # Class method that returns a Ruby hash version of the Cloud Formation template
+    #
+    # ==== Examples
+    #   template = Cloudster::ElastiCache.template(
+    #     :name => 'ElastiCacheResource',
+    #     :node_type => 'cache.t1.micro',
+    #     :cache_security_group_names => ['default'],
+    #     :engine => 'memcached',
+    #     :node_count => 3"
+    #   )
+    #
+    # ==== Parameters
+    # * options<~Hash>
+    #   * :name : String representing the name for the ElastiCache resource (Required)
+   #   * :node_type : String representing the compute and memory capacity of nodes in a Cache Cluster. One of : cache.t1.micro | cache.m1.small | cache.m1.medium | cache.m1.large | cache.m1.xlarge | cache.m3.xlarge | cache.m3.2xlarge | cache.m2.xlarge | cache.m2.2xlarge | cache.m2.4xlarge | cache.c1.xlarge (Required)
+    #   * :cache_security_group_names : Array of cache security group names (Required)
+    #   * :engine : String containing the name of the cache engine to be used for this cache cluster. Only 'memcached' is supported now.(Required)
+    #   * :node_count : Integer indicating number of cache nodes the cache cluster should have.(Required)
+    # ==== Returns
+    # * Ruby hash version of the Cloud Formation template for ElastiCache
+    def self.template(options = {})
+      require_options(options, [:name, :node_type, :cache_security_group_names, :engine, :node_count])
+      properties = {}
+      properties.merge!({
+        "CacheNodeType" => options[:node_type],
+        "CacheSecurityGroupNames" => options[:cache_security_group_names],
+        "Engine" => options[:engine],
+        "NumCacheNodes" => options[:node_count].to_s
+      })
+      template = {'Resources' => {
+                        options[:name] => {
+                          'Type' => 'AWS::ElastiCache::CacheCluster',
+                          'Properties' => properties
+                       }
+                  }
+      }
+      return template
+    end
+ end
+end

data/lib/cloudster/s3.rb

@@ -1,41 +1,42 @@
 module Cloudster
- #S3 Resource
- class S3
- 
-   attr_accessor :name, :template
-   # Initialize a s3 bucket
-   #
-   # ==== Notes
-   # options parameter must include values for the :name
-   #
-   # ==== Parameters
-   # * options<~Hash>
-   #   * :name : String representing the bucket name (Required)
-   #   * :access_control : String consisting of one of the predefined permission value. ( Example: PublicRead )
-   #   * :website_configuration : A hash containing the name of the index document and name of the error document. ( Example: {"index_document" => "index.html", "error_document" => "error.html"} )
-   #             
-   # ==== Examples
-   #   bucket = Cloudster::S3.new(
-   #    :name => 'unique_bucket_name'
-   #   )
-    
-   def initialize(options = {})
-     require_options(options, [:name])
-     @name = options[:name]
-     @access_control = options[:access_control]
-     @website_configuration = options[:website_configuration]
-   end
+  #S3 Resource
+  class S3
 
-   # Returns a Ruby hash version of the Cloud Formation template for the s3 resource
-   #
-   # ==== Examples
-   #   s3 = Cloudster::S3.new(
-   #    :name => 'unique_bucket_name'
-   #   )
-   #   s3.template
-   #
-   # ==== Returns
-   # * Ruby hash version of the Cloud Formation template for the s3 resource
+    attr_accessor :name, :template
+    # Initialize a s3 bucket
+    #
+    # ==== Notes
+    # options parameter must include values for the :name
+    #
+    # ==== Parameters
+    # * options<~Hash>
+    #   * :name : String representing the resource name (Required)
+    #   * :access_control : String consisting of one of the predefined permission values: Private | PublicRead | PublicReadWrite | AuthenticatedRead | BucketOwnerRead | BucketOwnerFullControl
+    #   * :website_configuration : A hash containing the name of the index document and name of the error document. ( Example: {"index_document" => "index.html", "error_document" => "error.html"} )
+    #
+    # ==== Examples
+    #   bucket = Cloudster::S3.new(
+    #    :name => 'ResourceName',
+    #    :access_control => 'PublicRead'
+    #   )
+
+    def initialize(options = {})
+      require_options(options, [:name])
+      @name = options[:name]
+      @access_control = options[:access_control]
+      @website_configuration = options[:website_configuration]
+    end
+
+    # Returns a Ruby hash version of the Cloud Formation template for the s3 resource
+    #
+    # ==== Examples
+    #   s3 = Cloudster::S3.new(
+    #    :name => 'S3Resource'
+    #   )
+    #   s3.template
+    #
+    # ==== Returns
+    # * Ruby hash version of the Cloud Formation template for the s3 resource
     def template
       @template ||= S3.template({:name => @name, :access_control => @access_control, :website_configuration => @website_configuration})
     end
@@ -44,15 +45,15 @@ module Cloudster
     #
     # ==== Examples
     #   template = Cloudster::S3.template(
-    #    :name => 'myBucket'
+    #     :name => 'S3Resource'
     #   )
     #
     # ==== Parameters
     # * options<~Hash>
-    #   * :name : String representing the bucket name (Required)
+    #   * :name : String representing the resource name (Required)
     #   * :access_control : String consisting of one of the predefined permission value. ( Example: PublicRead )
     #   * :website_configuration : A hash containing the name of the index document and name of the error document. ( Example: {"index_document" => "index.html", "error_document" => "error.html"} )
-    #             
+    #
     # ==== Returns
     # * Ruby hash version of the Cloud Formation template for S3
     def self.template(options = {})
@@ -71,5 +72,5 @@ module Cloudster
       }
       return template
     end
- end
+  end
 end

data/spec/elasticache_spec.rb

@@ -0,0 +1,50 @@
+require 'spec_helper'
+
+describe Cloudster::ElastiCache do
+  describe 'initialize' do
+    it "should raise argument error if no argument is provided" do
+      expect { Cloudster::ElastiCache.new() }.to raise_error(ArgumentError, 'Missing required argument: name,node_type,cache_security_group_names,engine,node_count')
+    end
+    it "should not raise argument error if all arguments are provided" do
+      expect do
+        Cloudster::ElastiCache.new(
+          :name => 'ElastiCache',
+          :node_type => 'test',
+          :cache_security_group_names => ['default'],
+          :engine => 'memcached',
+          :node_count => 3
+        )
+      end.to_not raise_error
+    end
+  end
+
+  describe '#template' do
+    it "should return a ruby hash for the resource cloudformation template with only mandatory fields" do
+      elasticache = Cloudster::ElastiCache.new(
+          :name => 'ElastiCache',
+          :node_type => 'test',
+          :cache_security_group_names => ['default'],
+          :engine => 'memcached',
+          :node_count => 3
+        )
+      elasticache.template.should == {'Resources' => {"ElastiCache"=>{"Type"=>"AWS::ElastiCache::CacheCluster", "Properties"=>{"CacheNodeType"=>"test", "CacheSecurityGroupNames"=>["default"], "Engine"=>"memcached", "NumCacheNodes"=>"3"}}}}
+    end
+  end
+
+  describe '.template' do
+    it "should raise argument error if no argument is provided" do
+      expect { Cloudster::ElastiCache.template() }.to raise_error(ArgumentError, 'Missing required argument: name,node_type,cache_security_group_names,engine,node_count')
+    end
+    it "should return a ruby hash for the resource cloudformation template" do
+      hash = Cloudster::ElastiCache.template(
+          :name => 'ElastiCache',
+          :node_type => 'test',
+          :cache_security_group_names => ['default'],
+          :engine => 'memcached',
+          :node_count => 3
+        )
+      hash.should == {'Resources' => {"ElastiCache"=>{"Type"=>"AWS::ElastiCache::CacheCluster", "Properties"=>{"CacheNodeType"=>"test", "CacheSecurityGroupNames"=>["default"], "Engine"=>"memcached", "NumCacheNodes"=>"3"}}}}
+    end
+  end
+
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cloudster
 version: !ruby/object:Gem::Version
-  version: 2.14.1
+  version: 2.15.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-12-28 00:00:00.000000000 Z
+date: 2012-12-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: fog
@@ -134,6 +134,7 @@ files:
 - lib/cloudster/cloud.rb
 - lib/cloudster/deep_merge.rb
 - lib/cloudster/ec2.rb
+- lib/cloudster/elasticache.rb
 - lib/cloudster/elb.rb
 - lib/cloudster/options_manager.rb
 - lib/cloudster/rds.rb
@@ -141,6 +142,7 @@ files:
 - spec/chef_client_spec.rb
 - spec/cloud_spec.rb
 - spec/ec2_spec.rb
+- spec/elasticache_spec.rb
 - spec/elb_spec.rb
 - spec/rds_spec.rb
 - spec/s3_spec.rb
@@ -160,7 +162,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 524787187
+      hash: 761406417
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements: