plat 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 22aa294b39be25aa3af50dce5a548a997dae3aa2
+  data.tar.gz: 00ce314ddc57be79128f9d88f934ba7255f1f8f3
+SHA512:
+  metadata.gz: 2ec467cb2a730bc6d8654c90a24e7a9abafe7530d94d4deacc3311fc815101e459707bc00e90ab7ca3828bd7450553f4b9bf22e80e84a77a1f419ef3a9c2f7ca
+  data.tar.gz: 5219323fef1e6930b3695acfef6c7afe7a90011c88ab95a1c5c4c0d4e88eace509cc4f9cf9b2a591fe9198d1b42a82c2fffdd79bfa1d1095b7f11892e9944c7a

data/.coveralls.yml

@@ -0,0 +1 @@
+service_name: travis-ci

data/.gitignore

@@ -0,0 +1,25 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+.env
+.rspec
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log
+**/.DS_Store

data/.travis.yml

@@ -0,0 +1,15 @@
+language: ruby
+cache: bundler
+
+rvm:
+  - 2.1.2
+
+branches:
+  only:
+    - master
+
+script: STUB_AWS=1 bundle exec rake travis
+
+before_install:
+  - gem update --system
+  - gem --version

data/CONTRIBUTORS.md

@@ -0,0 +1 @@
+* Andrey Pronin <moonfly.msk@gmail.com> aka moonfly (https://github.com/moonfly)

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in plat.gemspec
+gemspec

data/LICENSE.md

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2014 [CONTRIBUTORS.md](https://github.com/moonfly/plat/master/CONTRIBUTORS.md)
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,55 @@
+# Plat
+
+NOT FOR PUBLIC USE YET. ACTIVE INITIAL DEVELOPMENT IS IN PROGRESS.
+
+DevOps platform management. Makes most deployment headaches go away and greatly speeds up the initial phase of a new app development.
+
+TODO: Describe the problem & the solution
+
+[![Build Status](https://travis-ci.org/moonfly/plat.svg?branch=master)](https://travis-ci.org/moonfly/plat)
+[![Coverage Status](https://img.shields.io/coveralls/moonfly/plat.svg)](https://coveralls.io/r/moonfly/plat?branch=master)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'plat'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install plat
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Versioning
+
+Semantic versioning (http://semver.org/spec/v2.0.0.html) is used. 
+
+For a version number MAJOR.MINOR.PATCH, unless MAJOR is 0:
+
+1. MAJOR version is incremented when incompatible API changes are made,
+2. MINOR version is incremented when functionality is added in a backwards-compatible manner, 
+3. PATCH version is incremented when backwards-compatible bug fixes are made.
+
+Major version "zero" (0.y.z) is for initial development. Anything may change at any time. 
+The public API should not be considered stable. 
+Furthermore, version "double-zero" (0.0.x) is not intended for public use, 
+as even minimal functionality is not guaranteed to be implemented yet.
+
+## Dependencies
+
+TODO: List gem dependencies here
+
+## Contributing
+
+1. Fork it ( https://github.com/moonfly/plat/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Rakefile

@@ -0,0 +1,16 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+require 'dotenv/tasks'
+
+# Default directory to look in is `/specs`
+# Run with `rake spec`
+desc "Run RSpec tests (use rake spec SPEC_OPTS='...' to pass rspec options)"
+RSpec::Core::RakeTask.new(:spec)
+
+desc "Run RSpec tests in Travis CI environment"
+RSpec::Core::RakeTask.new(:travis) do |t|
+  t.rspec_opts = '--tag ~live_aws' # skip the tests that require connection to unstubbed live AWS
+end
+
+task :default => :spec
+

data/bin/plat

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+require 'bundler/setup'
+require 'plat'
+
+puts 'Under development...'

data/lib/plat.rb

@@ -0,0 +1,3 @@
+require 'plat/version'
+require 'plat/layout'
+require 'plat/role'

data/lib/plat/layout.rb

@@ -0,0 +1,15 @@
+require 'plat/layout/configuration'
+require 'plat/layout/aws'
+
+module Plat
+  class Layout
+    def initialize(options={},&block)
+      configure(options,&block)
+      configuration.lock
+    end
+    
+    def inspect
+      "<#{self.class} #{configuration.to_s}>"
+    end
+  end
+end

data/lib/plat/layout/aws.rb

@@ -0,0 +1,34 @@
+module Plat
+  class Layout
+    %w(aws_access_key_id aws_secret_access_key).each do |name|
+      def_config_param name, make_string: true, lockable: true, not_empty: true, default: (ENV[name.upcase] || '???')
+    end
+    def_config_param :env, make_string: true, lockable: true, not_empty: true, default: '' # production, development, test, ...
+    def_config_param :name_prefix, make_string: true, lockable: true, default: ''
+    def_config_param :app_name, make_string: true, lockable: true, default: ''
+  end
+end
+
+module Plat
+  class Layout
+    def aws_options
+      @aws_options ||= 
+      {
+        access_key_id: configuration.aws_access_key_id,
+        secret_access_key: configuration.aws_secret_access_key
+      }
+    end
+    
+    def aws_role_name_prefix(role)
+      @aws_role_name_prefix ||= {}
+      @aws_role_name_prefix[role] ||= 
+        [ configuration.name_prefix, 
+          configuration.app_name, 
+          configuration.env, 
+          role ].map(&:to_s).delete_if{|s| s==''}.join('-').gsub(/\s/,'_')
+    end
+    def aws_resource_name(role,id=0)
+      aws_role_name_prefix(role)+'-'+id.to_s
+    end
+  end
+end

data/lib/plat/layout/configuration.rb

@@ -0,0 +1,8 @@
+require 'configuru'
+
+module Plat
+  class Layout
+    include Configuru::Configurable
+    provide_configuration :instance
+  end
+end

data/lib/plat/role.rb

@@ -0,0 +1,64 @@
+require 'yaml'
+
+module Plat
+  class Layout
+    def convert_roles(roles_def)
+      case roles_def
+        when Hash then roles_def
+        when Array 
+          roles_def.inject({}) do |result,elem|
+            result.merge! convert_roles(elem)
+          end
+        when IO, StringIO, Tempfile then YAML.load(roles_def)
+        when String, Pathname
+          output = {}
+          File.open(roles_def,"r") { |f| output = YAML.load(f) }
+          output
+        else
+          raise ArgumentError.new("Wrong class for 'roles' value: #{roles_def.class}")
+      end
+    end
+    def_config_param :roles, lockable: true, default: Hash.new, convert: :convert_roles
+  end
+end
+
+module Plat
+  class Layout
+    def roles
+      @roles ||= begin
+        configuration.roles.map do |role,options|
+          [ role, Plat::Role.create(self,role,options) ]
+        end.to_h
+      end
+    end
+  end
+end
+
+module Plat
+  module Role
+    def self.registered_types
+      @registered_types ||= {}
+    end
+    def self.register(type,cname)
+      registered_types[type] = cname
+    end
+
+    def self.create(layout,role,options)
+      if type = options[:type]
+        raise ArgumentError.new "Wrong type for role #{@role}: #{options[:type]}" unless registered_types.member?(type)
+      else
+        rtype = role.downcase.to_sym
+        type = registered_types.member?(rtype) ? rtype : :cpu
+      end
+      registered_types[type].new(layout,role,options)
+    end
+  end
+end
+
+require 'plat/role/basic' # require first to make available for the rest
+
+require 'plat/role/cpu'
+require 'plat/role/db'
+require 'plat/role/cache'
+require 'plat/role/files'
+require 'plat/role/mail'

data/lib/plat/role/basic.rb

@@ -0,0 +1,50 @@
+require 'aws-sdk'
+require 'plat/role/iam_role'
+
+module Plat
+  module Role
+    class Basic
+      extend Forwardable
+      attr_reader :layout, :role, :options
+      def_delegators :@layout, :configuration
+      def_delegators :configuration, :env
+      
+      def initialize(layout,role,options)
+        @layout = layout
+        @role = role
+        @options = options.
+                    merge(Hash(options[:default])).
+                    merge(Hash(options["default"])).
+                    merge(Hash(options[env.to_sym])).
+                    merge(Hash(options[env.to_s]))
+      end
+      def count
+        @count ||= begin
+          value = options.fetch(:count) { 1 }.to_i
+          raise ArgumentError.new "Wrong count for role #{@role}: #{options[:count]}" if value < 1
+          value
+        end
+      end
+      def type
+        Plat::Role.registered_types.find(->{[nil]}) { |elem| elem[1] == self.class }.first
+      end
+
+      def resource_name(id=0)
+        layout.aws_resource_name(role,id)
+      end
+
+      def inspect
+        "<#{self.class} role='#{self.role}'>"
+      end
+      def to_s
+        { role => Hash(options) }.to_s
+      end
+      
+      def allow_access(policy,access_type)
+        # TODO
+        # policy.allow
+      end
+    end
+  end
+end
+

data/lib/plat/role/cache.rb

@@ -0,0 +1,9 @@
+module Plat
+  module Role
+    class Cache < Plat::Role::Basic
+    end
+  end
+end
+
+Plat::Role.register :cache, Plat::Role::Cache
+  

data/lib/plat/role/cpu.rb

@@ -0,0 +1,15 @@
+module Plat
+  module Role
+    class Cpu < Plat::Role::Basic
+      def ec2
+        @ec2 ||= AWS::EC2.new(layout.aws_options)
+      end
+      def iam_role
+        @iam_role ||= Plat::Role::IAMRole.new(self)
+      end
+    end
+  end
+end
+
+Plat::Role.register :cpu, Plat::Role::Cpu
+  

data/lib/plat/role/db.rb

@@ -0,0 +1,9 @@
+module Plat
+  module Role
+    class Db < Plat::Role::Basic
+    end
+  end
+end
+
+Plat::Role.register :db, Plat::Role::Db
+  

data/lib/plat/role/files.rb

@@ -0,0 +1,9 @@
+module Plat
+  module Role
+    class Files < Plat::Role::Basic
+    end
+  end
+end
+
+Plat::Role.register :files, Plat::Role::Files
+  

data/lib/plat/role/iam_role.rb

@@ -0,0 +1,56 @@
+module Plat
+  module Role
+    class IAMRole
+      extend Forwardable
+      attr_reader :cpu_role
+      def_delegators :@cpu_role, :layout, :options
+      
+      ACCESS_TYPES = [ :read, :write, :full ]
+
+      def initialize(cpu_role)
+        @cpu_role = cpu_role
+      end
+      
+      def all_roles
+        @all_roles ||= layout.roles.keys
+      end
+      
+      def accessible_roles
+        if access_options = options[:access]
+          if (access_options.keys & ACCESS_TYPES).empty?
+            roles_with_access access_options, :full
+          else
+            ACCESS_TYPES.map do |access_type|
+              access_options[access_type] ? roles_with_access(access_options[access_type],access_type) : {}
+            end.collect(&:+)
+          end
+        else
+          roles_with_access all_roles, :full 
+        end
+      end
+      def roles_with_access(access_options,access_type)
+        roles = all_roles
+        if access_options.is_a? Hash
+          if access_options[:only]
+            roles &= Array(access_options[:only])
+          end
+          if access_options[:except]
+            roles -= Array(access_options[:except])
+          end
+        else
+          roles &= Array(access_options)
+        end
+        roles.map { |role| [role,access_type] }.to_hash
+      end
+
+      def aws_policy
+        @aws_policy ||= AWS::IAM::Policy.new do |policy|
+          accessible_roles.each_pair do |role,access_type|
+            role.allow_access(policy,access_type)
+          end
+        end
+      end
+    
+    end
+  end
+end

data/lib/plat/role/mail.rb

@@ -0,0 +1,9 @@
+module Plat
+  module Role
+    class Mail < Plat::Role::Basic
+    end
+  end
+end
+
+Plat::Role.register :mail, Plat::Role::Mail
+  

data/lib/plat/version.rb

@@ -0,0 +1,3 @@
+module Plat
+  VERSION = '0.0.1'
+end

data/plat.gemspec

@@ -0,0 +1,34 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'plat/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'plat'
+  spec.version       = Plat::VERSION
+  spec.authors       = ['moonfly (Andrey Pronin)']
+  spec.email         = ['moonfly.msk@gmail.com']
+  spec.summary       = %q{DevOps platform management}
+  spec.description   = %q{Makes most deployment headaches go away and greatly speeds up the initial phase of a new app development.}
+  spec.homepage      = 'https://github.com/moonfly/plat'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ['lib']
+  
+  spec.rdoc_options = ['--charset=UTF-8']
+  spec.extra_rdoc_files = %w[README.md CONTRIBUTORS.md LICENSE.md]
+  
+  spec.required_ruby_version = '>= 2.1.0'
+  
+  spec.add_dependency 'aws-sdk', '~> 1.51.0'
+  spec.add_dependency 'configuru'
+
+  spec.add_development_dependency 'bundler', '>= 1.6'
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+  spec.add_development_dependency 'coveralls'
+  spec.add_development_dependency 'dotenv'
+end

data/spec/layout/aws_spec.rb

@@ -0,0 +1,46 @@
+require 'spec_helper'
+
+describe Plat::Layout do
+  it 'specifies options for AWS' do
+    layout = Plat::Layout.new do |config|
+      config.aws_access_key_id = "key-id"
+      config.aws_secret_access_key = "big-secret"
+    end
+    expect(layout.aws_options).to be_a Hash
+    expect(layout.aws_options.size).to eq 2
+    expect(layout.aws_options[:access_key_id]).to eq "key-id"
+    expect(layout.aws_options[:secret_access_key]).to eq "big-secret"
+  end
+  
+  it 'builds AWS resource names' do
+    layout1 = Plat::Layout.new do |config|
+      config.app_name = "Super App"
+      config.name_prefix = "ThePrefix"
+      config.env = "My Env"
+    end
+    expect(layout1.aws_resource_name("NumbersCruncher",997)).to eq "ThePrefix-Super_App-My_Env-NumbersCruncher-997"
+    
+    layout2 = Plat::Layout.new # use defaults
+    expect(layout2.aws_resource_name("Database")).to eq "Database-0"
+  end
+end
+
+describe Plat::Layout do
+  let(:subject) { Plat::Layout.new }
+  it 'has required AWS configuration variables with correct default values' do
+    expect(subject.configuration.param_names).to include :aws_access_key_id, :aws_secret_access_key, :env, :name_prefix, :app_name
+    
+    expect(subject.configuration.aws_access_key_id).to eq (ENV["AWS_ACCESS_KEY_ID"] || '???')
+    expect(subject.configuration.aws_secret_access_key).to eq (ENV["AWS_SECRET_ACCESS_KEY"] || '???')
+    expect(subject.configuration.env).to eq ''
+    expect(subject.configuration.name_prefix).to eq ''
+    expect(subject.configuration.app_name).to eq ''
+  end
+  it 'does not allow changing AWS configuration variables after initialization' do
+    expect{subject.configuration.aws_access_key_id="new-id"}.to raise_error
+    expect{subject.configuration.secret_access_key="new-secret"}.to raise_error
+    expect{subject.configuration.env="new-env"}.to raise_error
+    expect{subject.configuration.name_prefix="new-prefix"}.to raise_error
+    expect{subject.configuration.app_name="new-name"}.to raise_error
+  end
+end

data/spec/layout/configuration_spec.rb

@@ -0,0 +1,11 @@
+require 'spec_helper'
+
+describe Plat::Layout do
+  it 'can be configured (smoke test)' do
+    layout = Plat::Layout.new(env: :my_special_env) do |cfg|
+      cfg.app_name = 'someAwesomeApp'
+    end
+    expect(layout.configuration.env).to eq 'my_special_env'
+    expect(layout.configuration.app_name).to eq 'someAwesomeApp'
+  end
+end

data/spec/plat_spec.rb

@@ -0,0 +1,7 @@
+require 'spec_helper'
+
+describe Plat do
+  it 'has version (smoke test)' do
+    expect(Plat::VERSION).to be_a(String)
+  end
+end

data/spec/role/basic_spec.rb

@@ -0,0 +1,74 @@
+require 'spec_helper'
+
+require 'spec_helper'
+
+describe Plat::Role::Basic do
+  before(:each) do
+    class TestRole < Plat::Role::Basic
+    end
+    Plat::Role.register :testtesttest, TestRole
+  end
+  let(:the_layout) { Plat::Layout.new( env: 'test') }
+  it 'stores passed parameters' do
+    role = Plat::Role.create(the_layout, "some role", { type: :testtesttest, x: 78 })
+    expect(role).to be_a TestRole
+    expect(role.type).to eq :testtesttest
+    expect(role.layout).to eq the_layout
+    expect(role.role).to eq "some role"
+    expect(role.options[:x]).to eq 78
+  end
+  it 'picks parameters for the right environment' do
+    role = Plat::Role.create(the_layout, "some role", { type: :testtesttest, x: 78, default: { x: 99 } })
+    expect(role.options[:x]).to eq 99
+    role = Plat::Role.create(the_layout, "some role", { type: :testtesttest, x: 78, "default" => { x: 93 } })
+    expect(role.options[:x]).to eq 93
+    role = Plat::Role.create(the_layout, "some role", { type: :testtesttest, x: 78, default: { x: 99 }, test: { x: 15 } })
+    expect(role.options[:x]).to eq 15
+    role = Plat::Role.create(the_layout, "some role", { type: :testtesttest, x: 78, "default" => { x: 93 }, "test" => { x: 21 } })
+    expect(role.options[:x]).to eq 21
+  end
+  it 'uses explicitly passed count' do
+    role = Plat::Role.create(the_layout, "testtesttest", { count: 732 })
+    expect(role.count).to eq 732
+  end
+  it 'converts count from strings and floats' do
+    [
+      Plat::Role.create(the_layout, "testtesttest", { count: "681" }),
+      Plat::Role.create(the_layout, "testtesttest", { count: 681.7 }),
+      Plat::Role.create(the_layout, "testtesttest", { count: "681.7" })
+    ].each do |role|
+      expect(role.count).to eq 681
+    end
+  end
+  it 'sets count to 1 by default' do
+    role = Plat::Role.create(the_layout, "testtesttest", {})
+    expect(role.count).to eq 1
+  end
+  it 'does not allow incorrectly specified counts' do
+    [
+      Plat::Role.create(the_layout, "testtesttest", { count: 0 }),
+      Plat::Role.create(the_layout, "testtesttest", { count: -1 }),
+      Plat::Role.create(the_layout, "testtesttest", { count: Float::INFINITY }),
+      Plat::Role.create(the_layout, "testtesttest", { count: [] }),
+      Plat::Role.create(the_layout, "testtesttest", { count: {} }),
+      Plat::Role.create(the_layout, "testtesttest", { count: { value: 100 } }),
+      Plat::Role.create(the_layout, "testtesttest", { count: "one" }),
+      Plat::Role.create(the_layout, "testtesttest", { count: nil })
+    ].each do |role|
+      expect{role.count}.to raise_error
+    end
+  end
+  it 'prints role in inspect' do
+    role = Plat::Role.create(the_layout, "some role", { type: :testtesttest, x: 78 })
+    expect(role.inspect).to include "role='some role'"
+  end
+  it 'prints itself as hash in to_s' do
+    role = Plat::Role.create(the_layout, "some role", { type: :testtesttest, x: 78 })
+    template = { "some role" => { type: :testtesttest, x: 78 } }
+    expect(role.to_s).to eq template.to_s
+  end
+  it 'uses the correct resource name' do
+    role = Plat::Role.create(the_layout, "some role", { type: :testtesttest, x: 78 })
+    expect(role.resource_name(17)).to eq the_layout.aws_resource_name("some role",17)
+  end
+end

data/spec/role/cpu_spec.rb

@@ -0,0 +1,11 @@
+require 'spec_helper'
+
+describe Plat::Role::Cpu do
+  let(:default_options) { Hash.new }
+  let(:layout) { Plat::Layout.new }
+  let(:subject) { Plat::Role.create(layout,:cpu,default_options) }
+  
+  it 'reaches AWS EC2 (smoke test)' do
+    expect{subject.ec2.instances.to_a}.not_to raise_error
+  end
+end

data/spec/role/iam_role.rb

@@ -0,0 +1,5 @@
+require 'spec_helper'
+
+describe Plat::Role::IAMRole do
+  # TODO
+end

data/spec/role_spec.rb

@@ -0,0 +1,95 @@
+require 'spec_helper'
+require 'tempfile'
+
+describe Plat::Role do
+  before(:each) do
+    class TestRole < Plat::Role::Basic
+    end
+    Plat::Role.register :testtesttest, TestRole
+  end
+  let(:the_layout) { Plat::Layout.new }
+  it 'allows registering role classes' do
+    expect(Plat::Role.registered_types[:testtesttest]).to eq TestRole
+  end
+  it 'creates correct role instances' do
+    {
+      "some role" => Plat::Role.create( the_layout, "some role", { type: :testtesttest }), # explicit type specification
+      "testtesttest" => Plat::Role.create( the_layout, "testtesttest", {})                 # implicit type from role
+    }.each_pair do |role_name, role|
+      expect(role).to be_a TestRole
+      expect(role.type).to eq :testtesttest
+      expect(role.role).to eq role_name
+    end
+  end
+  it 'creates CPU role instance by default' do
+    layout = Plat::Layout.new
+    role = Plat::Role.create layout, "some role", {}
+    expect(role.type).to eq :cpu
+    expect(role.role).to eq "some role"
+  end
+end
+
+describe Plat::Layout do
+  let(:roles_spec) { Hash("cpu" => { count: 10 }, "db" => { count: 20 }) }
+  let(:roles_sio) { StringIO.new(roles_spec.to_yaml) }
+
+  it 'allows loading roles from hash' do
+    layout = Plat::Layout.new( roles: roles_spec )
+    expect(layout.roles["cpu"]).to be_a Plat::Role::Cpu
+    expect(layout.roles["cpu"].count).to eq 10
+    expect(layout.roles["db"]).to be_a Plat::Role::Db
+    expect(layout.roles["db"].count).to eq 20
+  end
+
+  it 'allows loading roles from StringIO' do
+    layout = Plat::Layout.new( roles: roles_sio )
+    expect(layout.roles["cpu"]).to be_a Plat::Role::Cpu
+    expect(layout.roles["cpu"].count).to eq 10
+    expect(layout.roles["db"]).to be_a Plat::Role::Db
+    expect(layout.roles["db"].count).to eq 20
+  end
+  
+  it 'allows loading roles from an array of sources, later sources take precendence' do
+    roles_spec1 = roles_spec.clone
+    roles_spec1.delete("cpu")
+    roles_spec1["db"][:count] = 40
+
+    layout = Plat::Layout.new( roles: [roles_sio, roles_spec1] )
+    expect(layout.roles["cpu"]).to be_a Plat::Role::Cpu
+    expect(layout.roles["cpu"].count).to eq 10
+    expect(layout.roles["db"]).to be_a Plat::Role::Db
+    expect(layout.roles["db"].count).to eq 40
+  end
+
+  it 'allows loading roles from File/IO' do
+    layout1 = nil
+    layout2 = nil
+    layout3 = nil
+    f = Tempfile.new("test_roles.yaml")
+    begin
+      f << roles_spec.to_yaml
+      f.open
+      layout1 = Plat::Layout.new( roles: f )
+      layout2 = Plat::Layout.new( roles: f.path )
+      File.open( f.path ) do |real_f|
+        layout3 = Plat::Layout.new( roles: real_f )
+      end
+    ensure
+      f.close
+      f.unlink
+    end
+    expect(layout1).not_to be_nil
+    expect(layout2).not_to be_nil
+    expect(layout3).not_to be_nil
+    [ 
+      layout1,
+      layout2,
+      layout3
+    ].each do |layout|
+      expect(layout.roles["cpu"]).to be_a Plat::Role::Cpu
+      expect(layout.roles["cpu"].count).to eq 10
+      expect(layout.roles["db"]).to be_a Plat::Role::Db
+      expect(layout.roles["db"].count).to eq 20
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,36 @@
+require 'coveralls'
+Coveralls.wear!
+
+require 'dotenv'
+Dotenv.load
+
+if ENV.has_key?("STUB_AWS") || 
+  !ENV.has_key?("AWS_ACCESS_KEY_ID") || 
+  !ENV.has_key?("AWS_SECRET_ACCESS_KEY")
+  # Test in the environment when AWS credentials are not provided
+  require 'aws-sdk'
+  puts "Stubbing AWS (#{ENV.has_key?("STUB_AWS") ? "forced" : "no keys"})"
+  
+  RSpec.configure do |c|
+    c.filter_run_excluding :live_aws
+  end
+  
+  AWS.stub! # see https://forums.aws.amazon.com/thread.jspa?threadID=114617
+  #
+  # Further capabilities:
+  # ec2.client.stub_for(:describe_instances)[:reservation_set] = 'my-data'
+  # resp = ec2.client.describe_instances
+  # #=> {:reservation_set=>'my-data', :reservation_index=>{}, :instance_index=>{}}
+  #
+  # resp1 = ec2.client.new_stub_for(:describe_instances)
+  # resp2 = ec2.client.new_stub_for(:describe_instances)
+  # resp1[:called] = 1
+  # resp2[:called] = 2
+  # ec2.client.stub(:describe_instances).and_return(resp1, resp2)
+  # ec2.describe_instances
+  # #=> {:reservation_set=>[], :reservation_index=>{}, :instance_index=>{}, :call => 1}
+  # ec2.describe_instances
+  # #=> {:reservation_set=>[], :reservation_index=>{}, :instance_index=>{}, :call => 2}
+end  
+
+require 'plat'

metadata

@@ -0,0 +1,188 @@
+--- !ruby/object:Gem::Specification
+name: plat
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- moonfly (Andrey Pronin)
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-09-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: aws-sdk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.51.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.51.0
+- !ruby/object:Gem::Dependency
+  name: configuru
+  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: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: rake
+  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
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: coveralls
+  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: dotenv
+  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: Makes most deployment headaches go away and greatly speeds up the initial
+  phase of a new app development.
+email:
+- moonfly.msk@gmail.com
+executables:
+- plat
+extensions: []
+extra_rdoc_files:
+- README.md
+- CONTRIBUTORS.md
+- LICENSE.md
+files:
+- ".coveralls.yml"
+- ".gitignore"
+- ".travis.yml"
+- CHANGELOG.md
+- CONTRIBUTORS.md
+- Gemfile
+- LICENSE.md
+- README.md
+- Rakefile
+- bin/plat
+- lib/plat.rb
+- lib/plat/layout.rb
+- lib/plat/layout/aws.rb
+- lib/plat/layout/configuration.rb
+- lib/plat/role.rb
+- lib/plat/role/basic.rb
+- lib/plat/role/cache.rb
+- lib/plat/role/cpu.rb
+- lib/plat/role/db.rb
+- lib/plat/role/files.rb
+- lib/plat/role/iam_role.rb
+- lib/plat/role/mail.rb
+- lib/plat/version.rb
+- plat.gemspec
+- spec/layout/aws_spec.rb
+- spec/layout/configuration_spec.rb
+- spec/plat_spec.rb
+- spec/role/basic_spec.rb
+- spec/role/cpu_spec.rb
+- spec/role/iam_role.rb
+- spec/role_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/moonfly/plat
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options:
+- "--charset=UTF-8"
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: DevOps platform management
+test_files:
+- spec/layout/aws_spec.rb
+- spec/layout/configuration_spec.rb
+- spec/plat_spec.rb
+- spec/role/basic_spec.rb
+- spec/role/cpu_spec.rb
+- spec/role/iam_role.rb
+- spec/role_spec.rb
+- spec/spec_helper.rb