taketo 0.0.1

data/Gemfile

@@ -0,0 +1,9 @@
+source :rubygems
+
+group :development do
+  gem 'rspec'
+  gem 'rake'
+  gem 'aruba'
+  gem 'simplecov', :require => false
+end
+

data/Gemfile.lock

@@ -0,0 +1,44 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    aruba (0.4.11)
+      childprocess (>= 0.2.3)
+      cucumber (>= 1.1.1)
+      ffi (>= 1.0.11)
+      rspec (>= 2.7.0)
+    builder (3.0.0)
+    childprocess (0.3.2)
+      ffi (~> 1.0.6)
+    cucumber (1.2.1)
+      builder (>= 2.1.2)
+      diff-lcs (>= 1.1.3)
+      gherkin (~> 2.11.0)
+      json (>= 1.4.6)
+    diff-lcs (1.1.3)
+    ffi (1.0.11)
+    gherkin (2.11.0)
+      json (>= 1.4.6)
+    json (1.7.3)
+    multi_json (1.3.6)
+    rake (0.9.2.2)
+    rspec (2.10.0)
+      rspec-core (~> 2.10.0)
+      rspec-expectations (~> 2.10.0)
+      rspec-mocks (~> 2.10.0)
+    rspec-core (2.10.1)
+    rspec-expectations (2.10.0)
+      diff-lcs (~> 1.1.3)
+    rspec-mocks (2.10.1)
+    simplecov (0.6.4)
+      multi_json (~> 1.0)
+      simplecov-html (~> 0.5.3)
+    simplecov-html (0.5.3)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  aruba
+  rake
+  rspec
+  simplecov

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2012 Vladimir
+
+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,42 @@
+Take Me To
+==========
+
+[![Build Status](https://secure.travis-ci.org/v-yarotsky/taketo.png)](http://travis-ci.org/v-yarotsky/taketo)
+
+A tiny helper utility to make access to servers eaiser for different projects and environments.
+
+Usage:
+------
+
+puts a config into ```~/.taketo.rc.rb```:
+
+```ruby
+  project :my_project do
+    environment :staging do
+      server :s1 do
+        host "1.2.3.4"
+        port 10001
+        user "app"
+        localtion "/var/app"
+      end
+    end
+  end
+```
+
+Then execute:
+
+```taketo my_project staging s1 [command to execute, bash by default]```
+
+To-Do:
+------
+
+* Add support for defaults
+* Add support for generating shortcuts
+
+The Changelog:
+--------------
+
+### v0.0.1 (13.06.2012) ###
+* Initial release
+* Support for simplest configs
+

data/Rakefile

@@ -0,0 +1,29 @@
+# encoding: utf-8
+require 'rubygems'
+require 'bundler'
+
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+
+require 'rake'
+require 'rake/testtask'
+require 'cucumber'
+require 'cucumber/rake/task'
+
+Rake::TestTask.new do |t|
+  t.test_files = Dir.glob('spec/**/*_spec.rb')
+  t.verbose = true
+end
+
+Cucumber::Rake::Task.new(:features) do |t|
+  t.cucumber_opts = "features --tags ~@wip --format pretty -x"
+  t.fork = false
+end
+
+task :default => [:test, :features]
+

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/bin/taketo

@@ -0,0 +1,72 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+
+begin
+  require 'taketo'
+  require 'taketo/constructs_factory'
+  require 'taketo/commands'
+  require 'optparse'
+rescue LoadError => e #development
+  $: << File.expand_path('../../lib', __FILE__)
+  require 'bundler/setup'
+  retry
+end
+
+Signal.trap("SIGINT") do
+  puts "Terminating"
+  exit 1
+end
+
+include Taketo
+
+def parse_options
+  options = { :config => File.join(ENV['HOME'], ".taketo.rc.rb") }
+
+  OptionParser.new do |opts|
+    opts.banner = <<-DESC
+  A tiny helper utility to make access to servers 
+  eaiser for different projects and environments.
+  DESC
+
+    opts.on("-c CONFIG", "--config") do |c|
+      options[:config] = c
+    end
+
+    opts.on("--dry-run") do |v|
+      options[:dry_run] = v
+    end
+  end.parse!
+
+  options
+end
+
+def parse_config(options)
+  factory = Taketo::ConstructsFactory.new
+
+  Taketo::DSL.new(factory).configure do
+    config_text = File.read(options[:config])
+    eval config_text, binding, options[:config], 1
+  end
+end
+ 
+options = parse_options
+config = parse_config(options)
+
+project, environment, server = ARGV.shift(3).map(&:to_sym)
+
+server = begin
+  config.projects.fetch(project).environments.fetch(environment).servers.fetch(server)
+rescue KeyError => e
+  raise ArgumentError, e
+end
+
+remote_command = ARGV.join(" ")
+remote_command = "bash" if remote_command.empty?
+command_to_execute = Commands::SSHCommand.new(server).render(remote_command)
+if options[:dry_run]
+  puts command_to_execute
+else
+  system command_to_execute
+end
+

data/features/connect_to_server.feature

@@ -0,0 +1,25 @@
+Feature: 
+  In order to be able to access my servers quickly
+  As a developer
+  I want to have a nifty little utility
+  configurable with simple DSL
+
+  Scenario: SSH to server
+    When I have the following config in "/tmp/taketo_test_cfg.rb"
+      """
+      project :slots do
+        environment :staging do
+          server :s1 do
+            host "1.2.3.4"
+            user "deployer"
+            location "/var/apps/slots"
+          end
+        end
+      end
+
+      """
+    And I successfully run `taketo --config=/tmp/taketo_test_cfg.rb --dry-run slots staging s1`
+    Then the output should contain
+      """
+      ssh -t "deployer"@"1.2.3.4" "cd '/var/apps/slots'; RAILS_ENV=staging bash"
+      """

data/features/step_definitions/main_steps.rb

@@ -0,0 +1,10 @@
+When /^I have the following config in "(.*?)"$/ do |path, config|
+  @config_path = path
+  File.open(path, "w") do |f|
+    f.write(config)
+  end
+end
+
+Then /^the output should contain$/ do |expected|
+  assert_partial_output(expected, all_output)
+end

data/features/support/env.rb

@@ -0,0 +1,12 @@
+require 'rubygems'
+require 'bundler/setup'
+require 'aruba/cucumber'
+require 'fileutils'
+
+ENV['PATH'] = "#{File.expand_path('../../../bin', __FILE__)}#{File::PATH_SEPARATOR}#{ENV['PATH']}"
+
+After do
+  if defined? @config_path and File.exist?(@config_path)
+    FileUtils.rm(@config_path)
+  end
+end

data/lib/taketo/commands/ssh_command.rb

@@ -0,0 +1,44 @@
+require 'forwardable'
+
+module Taketo
+  module Commands
+    class SSHCommand
+      extend Forwardable
+
+      def_delegators :@server, :host, :port, :username, :default_location
+
+      def initialize(server, options = {})
+        @server = server
+        @environment = @server.environment
+      end
+
+      def render(command = "bash")
+        %Q[ssh -t #{port} #{username}#{host} "#{[location, environment, command].compact.join(" ")}"].gsub(/ +/, " ")
+      end
+
+      def host
+        unless @server.host
+          raise ArgumentError, "host for server #{@server.name} in #{@environment.name} is not defined!"
+        end
+        %Q["#{@server.host}"]
+      end
+
+      def port
+        %Q[-p #{@server.port}] if @server.port
+      end
+
+      def username
+        %Q["#{@server.username}"@] if @server.username
+      end
+
+      def location
+        %Q[cd '#{@server.default_location}';] if @server.default_location
+      end
+
+      def environment
+        %Q[RAILS_ENV=#{@environment.name}]
+      end
+    end
+  end
+end
+

data/lib/taketo/commands.rb

@@ -0,0 +1,6 @@
+module Taketo
+  module Commands
+  end
+end
+
+Dir.glob(File.expand_path('../commands/*.rb', __FILE__)).each { |c| require c }

data/lib/taketo/constructs/config.rb

@@ -0,0 +1,16 @@
+module Taketo
+  module Constructs
+    class Config
+      attr_reader :projects
+
+      def initialize
+        @projects = {}
+      end
+
+      def append_project(project)
+        @projects[project.name] = project
+      end
+    end
+  end
+end
+

data/lib/taketo/constructs/environment.rb

@@ -0,0 +1,18 @@
+module Taketo
+  module Constructs
+    class Environment
+      attr_reader :name, :servers
+
+      def initialize(name)
+        @name = name
+        @servers = {}
+      end
+
+      def append_server(server)
+        server.environment    = self
+        @servers[server.name] = server
+      end
+    end
+  end
+end
+

data/lib/taketo/constructs/project.rb

@@ -0,0 +1,17 @@
+module Taketo
+  module Constructs
+    class Project
+      attr_reader :name, :environments
+
+      def initialize(name)
+        @name = name
+        @environments = {}
+      end
+
+      def append_environment(environment)
+        @environments[environment.name] = environment
+      end
+    end
+  end
+end
+

data/lib/taketo/constructs/server.rb

@@ -0,0 +1,13 @@
+module Taketo
+  module Constructs
+    class Server
+      attr_reader :name
+      attr_accessor :host, :port, :username, :default_location, :environment
+      
+      def initialize(name)
+        @name = name
+      end
+    end
+  end
+end
+

data/lib/taketo/constructs.rb

@@ -0,0 +1,6 @@
+module Taketo
+  module Constructs
+  end
+end
+
+Dir.glob(File.expand_path('../constructs/*.rb', __FILE__)).each { |c| require c }

data/lib/taketo/constructs_factory.rb

@@ -0,0 +1,22 @@
+require 'taketo/constructs'
+
+module Taketo
+  class ConstructsFactory
+    def create_config
+      Constructs::Config.new
+    end
+
+    def create_project(*args)
+      Constructs::Project.new(*args)
+    end
+
+    def create_environment(*args)
+      Constructs::Environment.new(*args)
+    end
+
+    def create_server(*args)
+      Constructs::Server.new(*args)
+    end
+  end
+end
+

data/lib/taketo/dsl.rb

@@ -0,0 +1,90 @@
+require 'taketo/support'
+
+module Taketo
+  class DSL
+    class ScopeError < StandardError; end
+    
+    class << self
+      def define_scope(scope, parent_scope)
+        define_method scope do |name, &block|
+          unless current_scope?(parent_scope)
+            raise ScopeError,
+              "#{scope} can't be defined in #{current_scope} scope"
+          end
+          scope_object = @factory.send("create_#{scope}", name)
+          in_scope(scope, scope_object) do
+            block.call
+          end
+        end
+      end
+
+      def define_attribute(name, parent_scope, &block)
+        define_method name do |attribute|
+          unless server_scope?
+            raise ScopeError,
+              "#{name} can't be defined in #{current_scope} scope"
+          end
+          instance_exec(attribute, &block)
+        end
+      end
+    end
+
+    attr_reader :current_scope_object, :config
+
+    def initialize(factory)
+      @factory = factory
+      @scope = [:config]
+      @config = @current_scope_object = factory.create_config
+    end
+
+    def configure(&block)
+      instance_eval(&block)
+      @config
+    end
+
+    define_scope :project, :config
+    define_scope :environment, :project
+    define_scope :server, :environment
+
+    define_attribute :host, :server do |hostname|
+      current_scope_object.host = hostname
+    end
+
+    define_attribute :port, :server do |port_number|
+      current_scope_object.port = port_number
+    end
+
+    define_attribute :user, :server do |username|
+      current_scope_object.username = username
+    end
+
+    define_attribute :location, :server do |path|
+      current_scope_object.default_location = path
+    end
+
+    private
+
+    def current_scope
+      @scope.last
+    end
+
+    def current_scope?(scope)
+      current_scope == scope
+    end
+
+    [:config, :project, :environment, :server].each do |scope|
+      define_method("#{scope}_scope?") { current_scope == scope }
+    end
+
+    def in_scope(scope, new_scope_object)
+      parent_scope_object, @current_scope_object = @current_scope_object, new_scope_object
+      @scope << scope
+      yield
+      parent_scope_object.send("append_#{scope}", current_scope_object) 
+      @scope.pop
+      @current_scope_object = parent_scope_object
+    end
+
+  end
+end
+

data/lib/taketo/support/eval_delegator.rb

@@ -0,0 +1,25 @@
+module Taketo
+  module Support
+
+    ##
+    # This module allows to use external
+    # methods in block used by instance_eval,
+    # that it effectively mimics real closure
+    #
+    module EvalDelegator
+      def evaluate(&block)
+        @external_self = eval "self", block.binding
+        self.instance_eval(&block)
+      end
+
+      def method_missing(method_name, *args, &block)
+        if @external_self.respond_to?(method_name)
+          @external_self.send(method_name, *args, &block)
+        else
+          super
+        end
+      end
+    end
+  end
+end
+

data/lib/taketo/support.rb

@@ -0,0 +1,7 @@
+module Taketo
+  module Support
+  end
+end
+
+require 'taketo/support/eval_delegator'
+

data/lib/taketo.rb

@@ -0,0 +1,9 @@
+module Taketo
+  version_file = File.expand_path('../VERSION', File.dirname(__FILE__))
+  VERSION = File.read(version_file).freeze
+end
+
+require 'taketo/support'
+require 'taketo/dsl'
+require 'taketo/commands'
+

data/spec/integration/dsl_integration_spec.rb

@@ -0,0 +1,48 @@
+require File.expand_path('../../spec_helper', __FILE__)
+require 'taketo/dsl'
+
+describe "Taketo DSL" do
+  it "should parse config and instantiate objects" do
+    factory = Taketo::ConstructsFactory.new
+    config = Taketo::DSL.new(factory).configure do
+      project :slots do
+        environment :staging do
+          server :staging do
+            host "127.0.0.2"
+            user "deployer"
+            location "/var/app"
+          end
+        end
+
+        environment :production do
+          {
+            :s1 => "127.0.0.3",
+            :s2 => "127.0.0.4",
+          }.each do |server_name, host_name|
+            server server_name do
+              host host_name
+              location "/var/app"
+            end
+          end
+        end
+      end
+    end
+
+    config.projects.length.should == 1
+    project = config.projects[:slots]
+    project.name.should == :slots
+
+    project.environments.length.should == 2
+    staging = project.environments[:staging]
+    
+    staging.servers.length.should == 1
+    staging_server = staging.servers[:staging]
+    staging_server.host.should == "127.0.0.2"
+    staging_server.username.should == "deployer"
+    staging_server.default_location.should == "/var/app"
+
+    production = project.environments[:production]
+    production.servers.length.should == 2
+  end
+end
+

data/spec/lib/commands/ssh_command_spec.rb

@@ -0,0 +1,43 @@
+require File.expand_path('../../../spec_helper', __FILE__)
+require 'taketo/commands/ssh_command'
+
+include Taketo::Commands
+
+describe "SSH Command" do
+  let(:environment) { stub(:Environment, :name => :staging) }
+  let(:server) do
+    stub(:Server, :name => :s1,
+                  :host => "1.2.3.4", 
+                  :port => 22,
+                  :username => "deployer", 
+                  :default_location => "/var/app",
+                  :environment => environment)
+  end
+
+  let(:ssh_command) { SSHCommand.new(server) }
+
+  it "should compose command based on provided server object" do
+    ssh_command.render("bash").should == %q[ssh -t -p 22 "deployer"@"1.2.3.4" "cd '/var/app'; RAILS_ENV=staging bash"]
+  end
+
+  it "should ignore absent parts" do
+    server.stub(:port => nil)
+    server.stub(:username => nil)
+    ssh_command.render("bash").should == %q[ssh -t "1.2.3.4" "cd '/var/app'; RAILS_ENV=staging bash"]
+
+    server.stub(:default_location => nil)
+    ssh_command.render("bash").should == %q[ssh -t "1.2.3.4" "RAILS_ENV=staging bash"]
+  end
+
+  it "should require host" do
+    server.stub(:host => nil)
+    expect do
+      ssh_command.render("bash")
+    end.to raise_error ArgumentError, /host/
+  end
+
+  it "should have 'bash' as command default" do
+    ssh_command.render.should =~ /bash/
+  end
+end
+

data/spec/lib/constructs/config_spec.rb

@@ -0,0 +1,17 @@
+require File.expand_path('../../../spec_helper', __FILE__)
+require 'taketo/constructs/config'
+
+include Taketo
+
+describe "Config" do
+  let(:config) { Taketo::Constructs::Config.new }
+
+  describe "#append_project" do
+    it "should add project to config's projects collection" do
+      project = stub(:name => :foo)
+      config.append_project(project)
+      config.projects[:foo].should == project
+    end
+  end
+end
+

data/spec/lib/constructs/environment_spec.rb

@@ -0,0 +1,28 @@
+require File.expand_path('../../../spec_helper', __FILE__)
+require 'taketo/constructs/environment'
+
+include Taketo
+
+describe "Environment" do
+  let(:environment) { Taketo::Constructs::Environment.new(:foo) }
+
+  it "should have name" do
+    environment.name.should == :foo
+  end
+
+  describe "#append_server" do
+    let(:server) { mock(:Server, :name => :foo).as_null_object }
+
+    it "should add a server to environment's servers collection" do
+      environment.append_server(server)
+      environment.servers[:foo].should == server
+    end
+
+    it "should set environment attribute on a server to self" do
+      server.should_receive(:environment=).with(environment)
+      environment.append_server(server)
+    end
+  end
+end
+
+

data/spec/lib/constructs/project_spec.rb

@@ -0,0 +1,21 @@
+require File.expand_path('../../../spec_helper', __FILE__)
+require 'taketo/constructs/project'
+
+include Taketo
+
+describe "Project" do
+  let(:project) { Taketo::Constructs::Project.new(:foo) }
+
+  it "should have name" do
+    project.name.should == :foo
+  end
+
+  describe "#append_environment" do
+    it "should add an environment to project's environments collection" do
+      environment = stub(:name => :foo)
+      project.append_environment(environment)
+      project.environments[:foo].should == environment
+    end
+  end
+end
+

data/spec/lib/constructs/server_spec.rb

@@ -0,0 +1,41 @@
+require File.expand_path('../../../spec_helper', __FILE__)
+require 'taketo/constructs/server'
+require 'stringio'
+
+include Taketo
+
+describe "Server" do
+  let(:server) { Taketo::Constructs::Server.new(:foo) }
+
+  it "should have name" do
+    server.name.should == :foo
+  end
+
+  it "should set host" do
+    server.host = "foo"
+    server.host.should == "foo"
+  end
+
+  it "should set port" do
+    server.port = "foo"
+    server.port.should == "foo"
+  end
+
+  it "should set username" do
+    server.username = "foo"
+    server.username.should == "foo"
+  end
+
+  it "should set default_location" do
+    server.default_location = "foo"
+    server.default_location.should == "foo"
+  end
+
+  it "should set environment" do
+    environment = stub(:Environment)
+    server.environment = environment
+    server.environment.should == environment
+  end
+end
+
+

data/spec/lib/constructs_factory_spec.rb

@@ -0,0 +1,28 @@
+require File.expand_path('../../spec_helper', __FILE__)
+require 'taketo/constructs_factory'
+
+include Taketo
+
+describe "ConstructsFactory" do
+  let(:factory) { Taketo::ConstructsFactory.new }
+
+  specify "#create_config should create a config object" do
+    factory.create_config.should be_an_instance_of(Taketo::Constructs::Config)
+  end
+
+  specify "#create_project should create a project object" do
+    project = factory.create_project(:foo)
+    project.should be_an_instance_of(Taketo::Constructs::Project)
+  end
+
+  specify "#create_environment should create an environment object" do
+    environment = factory.create_environment(:foo)
+    environment.should be_an_instance_of(Taketo::Constructs::Environment)
+  end
+
+  specify "#create_server should create a server object" do
+    server = factory.create_server(:foo)
+    server.should be_an_instance_of(Taketo::Constructs::Server)
+  end
+end
+

data/spec/lib/dsl_spec.rb

@@ -0,0 +1,108 @@
+require File.expand_path('../../spec_helper', __FILE__)
+require 'support/helpers/dsl_spec_helper'
+require 'taketo/dsl'
+
+include Taketo
+
+describe "DSL" do
+  extend DSLSpec
+  include DSLSpec
+
+  shared_examples "a scope" do |scope_name, parent_scope_name|
+    parent_scope = scopes[parent_scope_name]
+
+    it { should enclose_scope(scope_name).under(parent_scope) }
+    it { should be_appropriate_construct(scope_name, :foo).under(parent_scope) }
+
+    scopes.except(parent_scope_name).each do |inappropriate_scope|
+      it { should_not be_appropriate_construct(scope_name, :foo).under(inappropriate_scope) }
+    end
+
+    it "should create a #{scope_name} and set it as current scope object" do
+      factory.should_receive("create_#{scope_name}").with(:bar)
+      dsl(parent_scope, factory.send("create_#{parent_scope_name}")) do |c|
+        c.send(scope_name, :bar) do
+          c.current_scope_object.should == factory.send(scope_name)
+        end
+      end
+    end
+
+    it "should not leak #{scope_name} as current scope object" do
+      dsl(parent_scope, factory.send("create_#{parent_scope_name}")) do |c|
+        c.send(scope_name, :bar) {}
+        c.current_scope_object.should_not == factory.send(scope_name)
+      end
+    end
+
+    it "should add a #{scope_name} to the #{parent_scope_name}'s #{scope_name}s collection" do
+      dsl(parent_scope, factory.send("create_#{parent_scope_name}")) do |c|
+        c.current_scope_object.should_receive("append_#{scope_name}").with(factory.send("create_#{scope_name}", :bar))
+        c.send(scope_name, :bar) {}
+      end
+    end
+  end
+
+  shared_examples "an attribute" do |attribute_name, parent_scope_name, parent_scope_method, example_value|
+    parent_scope = scopes[parent_scope_name]
+
+    it { should be_appropriate_construct(attribute_name, example_value).under(parent_scope) }
+
+    scopes.except(parent_scope_name).each do |inaproppriate_scope|
+      it { should_not be_appropriate_construct(attribute_name, example_value).under(inaproppriate_scope) }
+    end
+
+    it "should set #{parent_scope_method.to_s.gsub('=', '')} attribute on current server" do
+      dsl(parent_scope, factory.send("create_#{parent_scope_name}", :foo)) do |c|
+        factory.send(parent_scope_name).should_receive(parent_scope_method).with(example_value)
+        c.send(attribute_name, example_value)
+      end
+    end
+  end
+
+  describe "#project" do
+    it_behaves_like "a scope", :project, :config
+
+    describe "#environment" do
+      it_behaves_like "a scope", :environment, :project
+
+      describe "#server" do
+        it_behaves_like "a scope", :server, :environment
+
+        describe "#host" do
+          it_behaves_like "an attribute", :host, :server, :host=, "127.0.0.2"
+        end
+
+        describe "#port" do
+          it_behaves_like "an attribute", :port, :server, :port=, 4096
+        end
+
+        describe "#user" do
+          it_behaves_like "an attribute", :user, :server, :username=, "deployer"
+        end
+
+        describe "#location" do
+          it_behaves_like "an attribute", :location, :server, :default_location=, "/var/app/"
+        end
+      end
+    end
+  end
+
+  describe "#current_scope_object" do
+    it "should be config initially" do
+      dsl do |c|
+        c.current_scope_object.should == factory.config
+      end
+    end
+
+    it "should correspond to current scope" do
+      dsl(:project, factory.create_project(:foo)) do |c|
+        c.current_scope_object.should == factory.project
+      end
+
+      dsl(:server, factory.create_server(:foo)) do |c|
+        c.current_scope_object.should == factory.server
+      end
+    end
+  end
+end
+

data/spec/lib/support/eval_delegator_spec.rb

@@ -0,0 +1,37 @@
+require File.expand_path('../../../spec_helper', __FILE__)
+require 'taketo/support/eval_delegator'
+
+class EvalDelegatorContext
+  include Taketo::Support::EvalDelegator
+  
+  def foo
+  end
+end
+
+describe Taketo::Support::EvalDelegator do
+  describe "#evaluate" do
+    it "should execute methods on context if it responds" do
+      expect do
+        EvalDelegatorContext.new.evaluate { foo }
+      end.not_to raise_error
+    end
+
+    it "should delegate unknown methods to calling context" do
+      class << self
+        define_method(:bar) {}
+      end
+
+      expect do
+        EvalDelegatorContext.new.evaluate { bar }
+      end.not_to raise_error
+    end
+
+    it "should pass local variables through the scopes" do
+      baz = :foo
+      expect do
+        EvalDelegatorContext.new.evaluate { baz }
+      end.not_to raise_error
+    end
+  end
+end
+

data/spec/spec_helper.rb

@@ -0,0 +1,17 @@
+require 'rubygems'
+require 'bundler/setup'
+
+if ENV['COVERAGE']
+  require 'simplecov'
+  SimpleCov.start
+end
+
+$: << File.expand_path('../../lib', __FILE__)
+
+require 'rspec'
+require 'rspec/autorun'
+
+require 'taketo/dsl'
+
+Dir[File.dirname(__FILE__) + "/support/matchers/*.rb"].each {|f| require f}
+

data/spec/support/helpers/dsl_spec_helper.rb

@@ -0,0 +1,59 @@
+module DSLSpec
+  class TestConstructsFactory
+    attr_reader :config, :project, :environment, :server
+
+    def create_config
+      @config ||= RSpec::Mocks::Mock.new(:Config).as_null_object
+    end
+
+    def create_project(name = :foo)
+      @project ||= RSpec::Mocks::Mock.new(:Project, :name => name).as_null_object
+    end
+
+    def create_environment(name = :foo)
+      @environment ||= RSpec::Mocks::Mock.new(:Environment, :name => name).as_null_object
+    end
+
+    def create_server(name = :foo)
+      @server ||= RSpec::Mocks::Mock.new(:Server, :name => name).as_null_object
+    end
+  end
+
+  def factory
+    @factory ||= TestConstructsFactory.new
+  end
+
+  RSpec.configure do |config|
+    config.after(:each) do
+      @factory = nil
+    end
+  end
+
+  def dsl(scope = [:config], scope_object = nil)
+    context = DSL.new(factory)
+
+    def context.set_scope(s, obj)
+      @scope = s
+      @current_scope_object = obj
+    end
+
+    context.set_scope(scope, scope_object || factory.create_config)
+
+    yield context
+  end
+
+  def scopes
+    scopes_hash = {
+      :config      => [:config],
+      :project     => [:config, :project],
+      :environment => [:config, :project, :environment],
+      :server      => [:config, :project, :environment, :server]
+    }
+
+    def scopes_hash.except(*keys)
+      self.values_at(*(self.keys - keys))
+    end
+
+    scopes_hash
+  end
+end

data/spec/support/matchers/be_appropriate_construct_matcher.rb

@@ -0,0 +1,38 @@
+require 'taketo/dsl'
+
+RSpec::Matchers.define :be_appropriate_construct do |construct, *args|
+  chain(:under) do |enclosing_scope|
+    @enclosing_scope = enclosing_scope
+  end
+
+  match do |actual|
+    unless @enclosing_scope
+      raise ArgumentError, "#under must be called to set enclosing scope"
+    end
+
+    @result = true
+    dsl(@enclosing_scope) do |c|
+      begin
+        c.send(construct, *args) {} 
+      rescue Taketo::DSL::ScopeError => e
+        @result = false
+      rescue
+        #nothing
+      end
+    end
+    @result
+  end
+
+  description do
+    "#{name_to_sentence} ##{construct}(#{args.join(", ")}) under #{@enclosing_scope.inspect}"
+  end
+
+  failure_message_for_should do |actual|
+    "expected construct #{construct} to be appropriate under #{@enclosing_scope.inspect} scope"
+  end
+
+  failure_message_for_should_not do |actual|
+    "expected construct #{construct} not to be appropriate under #{@enclosing_scope.inspect} scope"
+  end
+end
+

data/spec/support/matchers/enclose_scope_matcher.rb

@@ -0,0 +1,18 @@
+RSpec::Matchers.define :enclose_scope do |expected_scope|
+  chain(:under) do |scope|
+    @external_scope = scope
+  end
+
+  match do |actual|
+    @result = true
+    dsl(@external_scope || [:config]) do |c|
+      @result &= !c.send(:current_scope?, expected_scope)
+      c.send(expected_scope, :foo) do
+        @result &= c.send(:current_scope?, expected_scope)
+      end
+      @result &= !c.send(:current_scope?, expected_scope)
+    end
+    @result
+  end
+end
+

metadata

@@ -0,0 +1,147 @@
+--- !ruby/object:Gem::Specification
+name: taketo
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Vladimir Yarotsky
+- Maksim Yermalovich
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-06-13 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.10'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: aruba
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.4'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.6'
+description: 
+email: vladimir.yarotksy@gmail.com
+executables:
+- taketo
+extensions: []
+extra_rdoc_files: []
+files:
+- bin/taketo
+- lib/taketo/commands/ssh_command.rb
+- lib/taketo/commands.rb
+- lib/taketo/constructs/config.rb
+- lib/taketo/constructs/environment.rb
+- lib/taketo/constructs/project.rb
+- lib/taketo/constructs/server.rb
+- lib/taketo/constructs.rb
+- lib/taketo/constructs_factory.rb
+- lib/taketo/dsl.rb
+- lib/taketo/support/eval_delegator.rb
+- lib/taketo/support.rb
+- lib/taketo.rb
+- spec/integration/dsl_integration_spec.rb
+- spec/lib/commands/ssh_command_spec.rb
+- spec/lib/constructs/config_spec.rb
+- spec/lib/constructs/environment_spec.rb
+- spec/lib/constructs/project_spec.rb
+- spec/lib/constructs/server_spec.rb
+- spec/lib/constructs_factory_spec.rb
+- spec/lib/dsl_spec.rb
+- spec/lib/support/eval_delegator_spec.rb
+- spec/spec_helper.rb
+- spec/support/helpers/dsl_spec_helper.rb
+- spec/support/matchers/be_appropriate_construct_matcher.rb
+- spec/support/matchers/enclose_scope_matcher.rb
+- features/connect_to_server.feature
+- features/step_definitions/main_steps.rb
+- features/support/env.rb
+- Gemfile
+- Gemfile.lock
+- Rakefile
+- LICENSE.txt
+- README.md
+- VERSION
+homepage: http://github.com/v-yarotsky/taketo
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: 1.3.6
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.21
+signing_key: 
+specification_version: 3
+summary: A tiny helper utility to make access to servers eaiser for different projects
+  and environments
+test_files: []