vagrant

https://github.com/mitchellh/vagrant

Ruby

Vagrant is a tool for building and distributing development environments.

Vagrant::BoxCollection#add

This adds a new box to the system.

There are some exceptional cases:
* BoxAlreadyExists - The box you're attempting to add already exists.
* BoxProviderDoesntMatch - If the given box provider doesn't match the
  actual box provider in the untarred box.
* BoxUnpackageFailure - An invalid tar file.

Preconditions:
* File given in `path` must exist.

Source | Google | Stack overflow

Edit

git clone [email protected]:mitchellh/vagrant.git

cd vagrant

open lib/vagrant/box_collection.rb

Contribute

# Make a new branch

git checkout -b -your-name--update-docs-Vagrant--BoxCollection-add-for-pr

# Commit to git

git add lib/vagrant/box_collection.rbgit commit -m "better docs for Vagrant::BoxCollection#add"

# Open pull request

gem install hub # on a mac you can `brew install hub`

hub fork

git push <your name> -your-name--update-docs-Vagrant--BoxCollection-add-for-pr

hub pull-request

# Celebrate!