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!

A recipe to provide facts about the context a buildout is running in

Project Description


This package provides information about the host you are running buildout on.

Exposed Parameters

The hostname of the machine buildout is running on, as returned by socket.gethostname()
The fully qualified domain of the machine buildout is running on, as return by socket.getfqdn(). If no fqdn is available, this will be the same as hostname.
The IP address of the network interface X.
The name of the account running buildout
The uid running buildout. Numerical.
The gid running buildout. Numerical.
The home directory of the user running buildout
The type of checkout that buildout is being run from. Supports Mercurial (‘hg’), Git (‘git’) or Subversion (‘svn’), otherwise will be ‘unknown’.
The branch or that that buildout is being run from. Will be ‘unknown’ for unsupported VCS.

Using facts

This example uses the missingbits echo recipe to print information about the current machine:

parts = echo

recipe = isotoma.recipe.facts

recipe = missingbits:echo
echo =
    The hostname is ${facts:hostname}
    The fdqn is ${facts:fdqn}
    The main IP address is ${facts:interface.eth0.address}
    The VCS type is ${facts:vcs.type} and branch is ${facts:vcs.branch}
    The user is ${} and their home dir is ${facts:user.home}


0.0.8 (2015-04-15)

  • Nothing changed yet.

0.0.7 (2014-03-12)

  • fix bug when using without any vcs [djay]
  • fix bug when interface name includes a ‘:’ [djay]

0.0.6 (2012-02-10)

  • Added support for Mercurial VCS

0.0.5 (2012-02-03)

  • Force english locale so the ‘svn info’ output is parseable everywhere

0.0.4 (2012-02-03)

  • Set lsb.codename and other lsb properties so we can make decisions base on the distro version.

0.0.3 (2011-08-30)

  • Set, user.home, user.uid and user.gid facts
  • Set vcs.branch and vcs.type even if the cwd isn’t Git or SVN.

0.0.2 (2011-08-22)

  • Add Git branch detection

0.0.1 (2011-08-11)

  • Detect information about vcs

0.0.0 (2011-08-09)

  • Initial version
  • Ability to get fqdn, hostname and ip addresses (by eth name)
Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date (9.5 kB) Copy SHA256 Checksum SHA256 Source Apr 15, 2015

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