vagrant-dsl 0.0.1

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Erik Hollensbe
+
+MIT License
+
+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,118 @@
+# Vagrant::DSL
+
+Tools for programmatically driving vagrant in rake and in ruby scripts.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'vagrant-dsl'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install vagrant-dsl
+
+## Usage
+
+vagrant-dsl provides several top-level primitives for use in normal scripts and
+in Rakefiles. This provides a few advantages from an application speed
+perspective over shelling out, and also provides us with a little more
+flexibility configuring metadata about each VM.
+
+Here's an example:
+
+```ruby
+#!ruby
+
+# These two are equivalent, see below
+vagrant_box 'list'
+vagrant "box", "list"
+
+#
+# This brings up a box, executes ls on a ssh into that box, and destroys a box.
+# All the vagrant chatter is presented as strings to stdout and stderr
+# respectively (which is nice if you have, say, a test suite associated with
+# this function)
+
+status = nil
+stdout, stderr = vagrant_capture do
+                   if vagrant_up
+                     status = vagrant_ssh %w[-c ls]
+                     vagrant_destroy '-f'
+                   end
+                 end
+
+# we only care about seeing output if we have a problem
+unless status == 0
+  puts "There was an error! Here's the output from vagrant:"
+  puts "--- stdout ---"
+  puts stdout
+  puts "--- stderr ---"
+  puts stderr
+end
+```
+
+In case it needs re-iterating, you can supply any one-level command as
+`vagrant_$command`, which is just sugar for `vagrant($command, *args)`. These
+are generated at require-time and will include any integrated Vagrant command
+plugins you have installed.
+
+
+## Integration
+
+Vagrant::DSL also integrates with a few external dependencies:
+
+* If Rake is already required (for example, through launching a Rakefile),
+  Vagrant::DSL will be available to task, namespace, etc.
+* Vagrant::Prison is a way to sandbox vagrant runs. You can use it with the
+  `vagrant_prison` keyword like so:
+
+```ruby
+#!ruby
+vagrant_prison do
+  configure do |config|
+    config.vm.box = "ubuntu"
+
+    config.vm.define :test, :primary => true do |test_config|
+      test_config.vm.network :hostonly, "192.168.33.10"
+    end
+  end
+  stdout, stderr = vagrant_capture do
+    vagrant_up
+    vagrant_destroy '-f'
+  end
+end
+```
+
+Note that you can use all the base DSL methods inside `vagrant_prison`.
+`vagrant_prison` takes three arguments supplied as key/value arguments:
+
+* `:dir` is a directory name that will be created, populated, and destroyed if
+  `:auto_destroy` is set.
+* If `:auto_destroy` is set to true, as soon as the prison expires (either
+  through termination of the script or garbage collection) vagrant will be
+  asked to destroy the VMs and the directory will be removed.
+* If `:ui_class` is supplied, you can drive the Vagrant user interface with
+  custom UI classes.
+
+The `configure` method is basically what you would normally put in your
+`Vagrantfile`. If you don't like the block form or would rather use a corpus of
+pre-generated content, it also accepts a string.
+
+See the docs for
+[Vagrant::Prison](http://rubydoc.info/gems/vagrant-prison/0.0.1/frames) for
+more information.
+
+If you wish to use Vagrant::DSL in your own classes/modules, just include it.
+
+## Contributing
+
+1. Fork it
+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 new Pull Request

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/lib/vagrant/dsl/version.rb

@@ -0,0 +1,5 @@
+module Vagrant
+  module DSL
+    VERSION = "0.0.1"
+  end
+end

data/lib/vagrant/dsl.rb

@@ -0,0 +1,123 @@
+require 'vagrant/dsl/version'
+require 'vagrant/prison'
+require 'stringio'
+require 'forwardable'
+
+module Vagrant
+  module UI
+    class Captured < Interface
+      include Util::SafePuts
+
+      attr_reader :stdout
+      attr_reader :stderr
+
+      def initialize(resource)
+        super
+        @stdout = StringIO.new("", 'w+')
+        @stderr = StringIO.new("", 'w+')
+      end
+
+      def ask(*args)
+        super
+        raise Errors::UIExpectsTTY
+      end
+
+      [:info, :warn, :error, :success].each do |method|
+        class_eval <<-EOF
+          def #{method}(message, *args)
+            super
+            say("#{method.to_s}", message, *args)
+          end
+        EOF
+      end
+
+      def say(type, message, opts=nil)
+        safe_puts(
+          message,
+          :io => type == :error ? @stderr : @stdout,
+          :printer => :puts
+        )
+      end
+    end
+  end
+
+  module DSL
+    module GenericMixin
+
+      attr_writer :ui_class
+      attr_accessor :env
+
+      def construct_env
+        Vagrant::Environment.new(:ui_class => ui_class)
+      end
+
+      def ui_class
+        @ui_class || Vagrant::UI::Basic
+      end
+
+      def vagrant_capture
+        old_ui_class = ui_class
+        self.ui_class = Vagrant::UI::Captured
+        self.env = construct_env
+        yield
+        stdout = env.ui.stdout.string
+        stderr = env.ui.stderr.string
+        self.ui_class = old_ui_class
+        self.env = construct_env
+
+        return stdout, stderr
+      end
+
+      def vagrant(command, *args, &block)
+        self.env ||= construct_env
+        Vagrant.commands[command.to_sym].new(args, env).execute
+      rescue SystemExit => e # vagrant calls exit a lot
+        return e.status
+      end
+
+      # some sugar to represent the commands
+      Vagrant.commands.to_hash.keys.each do |key|
+        key = key.to_s.tr('-', '_')
+        class_eval <<-EOF
+          def vagrant_#{key}(*args, &block)
+            vagrant("#{key}", *args, &block)
+          end
+        EOF
+      end
+    end
+
+    class Prison
+      extend Forwardable
+      include GenericMixin
+
+      def_delegator :@config, :configure, :configure
+
+      def initialize(args)
+        @config = Vagrant::Prison.new(args[:dir], args[:auto_destroy])
+        self.ui_class = args[:ui_class]
+        @env = nil
+      end
+
+      def construct_env
+        @config.construct(:ui_class => ui_class)
+      end
+    end
+
+    include GenericMixin
+
+    def vagrant_prison(args={}, &block)
+      prison = Vagrant::DSL::Prison.new(args)
+      prison.instance_eval(&block)
+    end
+  end
+end
+
+class << eval("self", TOPLEVEL_BINDING)
+  include Vagrant::DSL
+end
+
+if defined? Rake::DSL
+  module Rake::DSL
+    include Vagrant::DSL
+  end
+end

data/vagrant-dsl.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'vagrant/dsl/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "vagrant-dsl"
+  gem.version       = Vagrant::DSL::VERSION
+  gem.authors       = ["Erik Hollensbe"]
+  gem.email         = ["erik+github@hollensbe.org"]
+  gem.description   = %q{Tools for programmatically driving vagrant in rake and in ruby scripts}
+  gem.summary       = %q{Tools for programmatically driving vagrant in rake and in ruby scripts}
+  gem.homepage      = ""
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+
+  gem.add_dependency 'vagrant-prison', "~> 0.0.1"
+end

metadata

@@ -0,0 +1,69 @@
+--- !ruby/object:Gem::Specification
+name: vagrant-dsl
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Erik Hollensbe
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-11-06 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: vagrant-prison
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.0.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.0.1
+description: Tools for programmatically driving vagrant in rake and in ruby scripts
+email:
+- erik+github@hollensbe.org
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/vagrant/dsl.rb
+- lib/vagrant/dsl/version.rb
+- vagrant-dsl.gemspec
+homepage: ''
+licenses: []
+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: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Tools for programmatically driving vagrant in rake and in ruby scripts
+test_files: []