Skip to main content

Python environment comparison tool.

Project description

PyEnvDiff Documentation Status

Python environment comparison tool. Maximized for compatibility between versions 2.6 to 3.7, pypy, operating systems, distributions, and forks! Virtualenv, pyenv, pyvenv, conda, system!

Command Usage

From the command line, to get information on the current environment:

python -m

Serialize the information to a file…

python -m my_environment.yaml

Switch to another environment (you’ll need pyenvdiff installed in both)

python -m my_environment.yaml

Or compare two from any environment

python -m my_environment.yaml my_other_environment.yaml

Programmatic Usage

>>> from pyenvdiff import Environment

>>> e = Environment()
>>> e.to_yaml('my_env.yaml')

>>> o = Environment.from_yaml('other_env.yaml')

>>> e == o

>>> print(e)
... # prints a dump of the environment details

>>> from pyenvdiff import EnvironmentDiff
>>> ed = EnvironmentDiff(e, o)
>>> print(ed)
... # prints a diff of the two environments

Web Usage

An alpha-level web-based comparison tool is available to browse and compare. PyEnvDiff ships with a default API Key, which is severly throttled. Some jerk is likely to abuse it, but until then, try it out.

Get a free personal API Key.

Install your own API key by setting a global environment variable “PYENVDIFF_API_KEY”, set to the api key.

From any two python interpreters, you can run:

python -m --email


python -m --domain

…for more optional meta data fields:

python -m -h

Which should output… something like the below, (once for each environment you run it).

Posting environment information to
Using API KEY: ...
Successful POST, use SHA XXXX for reference or comparison.

Then, use that SHA to fill in the link below:

After you’ve collected another SHA from another environment…use the link format below, where XXXX and YYYY are two relevant SHAs.

Sooo much room for activities!

  • Compare dev, test & prod!
  • Works on my machine, strange it doesn’t work on yours
  • Confirming deployments
  • Auditing user desktops, servers, research environments & ecosystems
  • Filing (or requesting) bug reports


There are no manditory, nor automatically installing, dependencies.

pip install pyenvdiff

OR just copy & paste pyenvdiff anywhere on PYTHONPATH

There is one optional dependency. The core functionality doesn’t use it. It’s only needed for more advanced HTML-based comparison.

pip install ghdiff

Under the hood

  • Zero dependency, pure-python, harmless pip install pyenvdiff or copy anywhere on PYTHONPATH.
  • As-needed import statements, to maximize compatibility across python flavours.
  • Favours compatible python-code over succinct or newer-style python-code
  • Free software: BSD license
  • Documentation:


This package was started with Cookiecutter and the audreyr/cookiecutter-pypackage project template.


0.1.0 (2016-12-24)

  • First release on PyPI.

Project details

Download files

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

Files for pyenvdiff, version 0.1.0
Filename, size File type Python version Upload date Hashes
Filename, size (36.2 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page