This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
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

Release History


This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
swabbie-0.1.4.tar.gz (5.2 kB) Copy SHA256 Checksum SHA256 Source Jul 11, 2016

Supported By

WebFaction WebFaction Technical Writing 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 Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting