Vagrant Spec

Vagrant Spec

**Work-in-progress:** This library is not ready for general use yet and is under active development. The documentation will become much better once this is more easily usable.

`vagrant-spec` is a both a specification of how Vagrant and its various components should behave as well as a library of testing helpers that let you write your own unit and acceptance tests for Vagrant.

The library provides a set of helper methods in addition to [RSpec](https://github.com/rspec/rspec) matchers and expectations to help you both unit test and acceptance test Vagrant components. The RSpec components are built on top of the helper methods so that the test library can be used with your test framework of choice, but the entire tool is geared very heavily towards RSpec.

**Table of Contents**

• Prerequisites
• Installation
  • Standalone
  • Plugin Development Environment
• Running Acceptance Tests
  • Configuration
  • Running
  • Provider's Acceptance Specs
• Writing Acceptance Tests
  • Configuring Component Paths
  • Standalone Components
  • Provider Parameterized Components
  • Helpers
    • Context: "acceptance"
    • Matcher: "exit_with"

Prerequisites

• Ruby 2.0.0 or greater

Installation

Standalone

`vagrant-spec` can be installed as a standalone tool to black-box test existing Vagrant installations (potentially with a combination of plugins). **Vagrant plugin developers** should see the next section "Plugin Development Environment" to see the proper way to test plugins in development.

To install `vagrant-spec` as a standalone tool, simply gem install it:

$ gem build vagrant-spec.gems