Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

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.

Release History

This version
History Node


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
(5.2 kB) Copy SHA256 Hash SHA256
Source None Jul 11, 2016

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers DreamHost DreamHost Log Hosting