VirtualBoxTools

Tools for VirtualBox to simplify manual usage and automated integration.

Setup

This section explains how to install and uninstall this project.

Install the project.

pip3 install git+https://git@github.com/FunTimeCoding/virtual-box-tools.git#egg=virtual-box-tools

Uninstall the project.

pip3 uninstall virtual-box-tools

Configuration file location: ~/.virtual-box-tools.yaml

Optional: Use a host configuration from a different location.

host_file: ~/srv/salt/pillar/host.sls

Optional: Run virtual machines as a different user.

sudo_user: vbox

Usage

This section explains how to use this project.

Run the main program.

bin/vbt

Show help.

bin/vbt --help
bin/vbt host --help
bin/vbt service --help

Development

This section explains commands to help the development of this project.

Install the project from a clone.

./setup.sh

Run tests, style check and metrics.

./run-tests.sh
./run-style-check.sh
./run-metrics.sh

Build the project.

./build.sh

Run VirtualBox commands as a different user.

sudo -u virtualbox vboxmanage showvminfo --machinereadable ${MACHINE_NAME}