Skip to main content

Helps manage your docker environment

Project description


Swabbie is a command-line utility designed to help you manage your docker images and containers.

Swabbie can clean up your dangling containers and images, restore docker to a fresh install, and keep track of containers and images more efficiently.

By using swabbie, you remove the need for shell scripts and bash aliases to manage docker images and containers. Let swabbie keep track of those commands for you!


Currently, to install swabbie as a package, download swabbie by cloning this repo, create a virtualenv, and run

pip install --editable .

on the command line from inside the main swabbie folder.


swabbie will list all of the commands that swabbie supports, which are currently:

  • list: lists images and containers (all or only running containers and correctly built images)
  • count: tallies the total number of images and containers, as well as those that are functional
  • clean: removes all dangling images and exited containers
  • nuke: removes all images and containers; resets docker to fresh install state
  • shell: reference guide for container and image access commands; has sub-arguments


To add features to swabbie, set up your virtualenv and run

pip install -r requirements.txt

To install swabbie as a local package so that it will update automatically during development, run

pip install --editable .

from the main folder.


Swabbie uses nose for unit testing, so run nosetests from the main folder to execute the test suite.

To install dependencies for running the tests, use

pip install -r requirements-test.txt


Swabbie uses the bumpversion package for versioning. The bumpversion.cfg file contains the necessary information for updating the version, so just run

bumpversion <major/minor/patch>

and bumpversion will do the rest.

Updating README

The readme is provided in both markdown and rst. One approach is to write the readme in markdown, and then use pandoc to convert to rst:

pandoc --from=markdown --to=rst --output=README.rst


MIT license, see LICENSE.txt.

Project details

Release history Release notifications

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
swabbie-0.1.4.tar.gz (5.2 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page