Simplify use of Docker containers for building software
Simple Container-Utilizing Build Apparatus
SCUBA is a simple tool that makes it easier to use Docker containers in everyday development. It is intended to be used by developers in 'make' or 'scons' based build environments, where the entire build environment is encapsulated in a Docker container.
Its purpose is to lower the barrier to using Docker for everyday builds. SCUBA keeps you from
having to remember a complex
docker run command line, and turns this
$ docker run -it --rm -v $(pwd):/build:z -w /build -u $(id -u):$(id -g) gcc:5.1 make myprogram
$ scuba make myprogram
Install via pip
Scuba is hosted at PyPI.
$ sudo pip install scuba
$ sudo pip uninstall scuba
Install from source
Scuba can be built from source on Linux only (due to the fact that
must be compiled):
./run_nosetests.pyto run the unit tests
sudo python setup.py installto install scuba
./run_full_tests.pyto test the installed version of scuba
If musl-libc is installed, it can be used to reduce the size of
by overriding the
CC environment variable in step 1:
Note that installing from source in this manner can lead to an installation with increased startup times for Scbua. See #71 for more details. This can be remedied by forcing a wheel to be installed, as such:
$ export CC=/usr/local/musl/bin/musl-gcc # (optional) $ sudo pip install wheel $ python setup.py bdist_wheel $ sudo pip install dist/scuba-<version>-py2.py3-none-any.whl
Configuration is done using a YAML file named
.scuba.yml in the root
directory of your project. It is expected that
.scuba.yml be checked in to version control.
Full documentation on
.scuba.yml can be found in
and specific examples can be found in the
.scuba.yml file might look like this:
image: gcc:5.1 aliases: build: make -j4
In this example,
scuba build foo would execute
make -j4 foo in a
This software is released under the MIT License.
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size & hash||File type||Python version||Upload date|
|scuba-2.3.0-py2.py3-none-any.whl (41.1 kB) View hashes||Wheel||py2.py3|
|scuba-2.3.0.tar.gz (21.9 kB) View hashes||Source||None|
Hashes for scuba-2.3.0-py2.py3-none-any.whl