Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Ruby Shell Python HTML
branch: master


A Swift-All-In-One in a few easy steps.

  1. vagrant up
  2. vagrant ssh
  3. echo "awesome" > test
  4. swift upload test test
  5. swift download test test -o -

This project assumes you have Virtualbox and Vagrant.


You should be able to run most tests without too much fuss.

  1. .unittests
  2. .functests
  3. .probetests
  4. vtox -e pep8
  5. vtox -e py27
  6. vtox -e py26
  7. vtox # run all gate checks


A few things are configurable, see localrc-template.

  1. cp localrc-template localrc
  2. vi localrc
  3. source localrc
  4. vagrant provision
  5. vagrant ssh
  6. rebuildswift


A few scripts are available to make your dev life easier.

  1. vagrant up --provision will bring up your VM in working order (useful when your VM is halted)
  2. source localrc; vagrant provision on your host to push the new Chef bits in place (useful if you change localrc)
  3. rebuildswift to reapply everything like it would be at the end of Chef time (useful to revert local config changes)
  4. resetswift will wipe the drives and leave any local config changes in place (useful just to clean out Swift data)
  5. reinstallswift will make sure all of the bin scripts are installed correctly and restart the main swift processes (useful if you change branches)
  6. autodoc [swift-specs] will build the sphinx docs and watch files for changes, and upload them to a public container on your vm so you can review them
  7. vtox will hack the local tox.ini and so you can run tox tests successfully on the swift repo in the /vagrant directory
Something went wrong with that request. Please try again.