Skip to main content

Library and command-line tool for listing packages installed by setuptools, their metadata and dependencies and PyPI querying.

Project description


You can install yolk with easy_install yolk or install from the subversion repository with easy_install yolk==dev.

As of 0.0.7 yolk is in Gentoo’s Portage tree.


Yolk is a Python tool and library for obtaining information about packages installed by distutils, setuptools and easy_install and packages on PyPI (Python Package Index a.k.a. The Cheese Shop).

Yolk can list all the packages installed by setuptools on your system, show which packages are active, non-active or in development mode and show you which have newer versions available according to PyPI.

Usage Examples:

$ yolk -l
     List all installed Python packages

$ yolk -a
     List only the activated packages installed (Activated packages are normal packages on sys.path you can import)

$ yolk -n
     List only the non-activated (--multi-version) packages installed

$ yolk -l -f License,Author nose
     Show the license and author for the package `nose`

$ yolk --entry-map nose
     Show entry map for the nose package

$ yolk --entry-points nose.plugins
     Show all setuptools entry points for nose.plugins

These options query PyPI:

$ yolk -U
     Finds all packages installed via setuptools then checks PyPI for newer releases.

$ yolk -M Paste==1.0
     Show all the metadata for Paste version 1.0

$ yolk -M Paste
     Show all the metadata for each version of Paste listed on PyPi

$ yolk -D cheesecake
     Show all URL's for cheesecake packages you can download

 $ yolk -T source -D cheesecake
     Show only source code releases for cheesecake

 $ yolk -H twisted
     Launches your web browser at Twisted's home page


0.0.7: New options: –entry-map and -entry-points

Improved results with –download-links

New plugin system. First plugin available: yolk-portage for Gentoo Linux.

-v option is now –version

-v is now a new option: –verbose

Many bug fixes.

0.0.6: Fix Windows problem which showed all pkgs in develop mode

on some systems. Fix bad interpreter shebang in example Start using nose unit tests from Use restructuredtext in docstrings

0.0.5: Show packages installed in ‘development’ mode.

Improved output of -l, -n and -a. You can get the previous (<=0.0.4) output by adding ‘-f Summary’ More sanity checking for various options. Don’t throw exception if there is no package metadata

0.0.4: Added -U option to query PyPI for new versions of packages you have



setuptools elementtree (Optional, for fetching PyPI RSS feed)

Project details

Download files

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

Source Distribution

yolk-0.0.7.tar.gz (29.4 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page