Skip to main content

Compares expected environment variables to those set in production.

Project description

Unix: Unix Build Status Windows: Windows Build StatusMetrics: Coverage Status Scrutinizer Code QualityUsage: PyPI Version


diff-env is a command-line to tool to generate reports to compare the value of environment variables in each of your environments against the defaults defined in various files. It will help you you find:

  • variables absent from production, but will be required for a new feature in test

  • production values that shouldn’t be shared to your staging environment

  • variables set that are no longer referenced in any files

This tool was built with Heroku, but should work with any infrastructure that supports running commands remotely.



  • Python 3.6+


Install env-diff with pip:

$ pip install env-diff

or directly from the source code:

$ git clone
$ cd env-diff
$ python install


Generate a sample config file:

$ env-diff --init

Customize this file to match your project:

  • sourcefiles: contain references to environment variables used in your project

    • path: relative path to source file

  • environments: the environments in which your project runs

    • name: name of the environment

    • command: command to display currently set environment variables

Generate reports to show the differences between each environment variable:

$ env-diff


Input YAML config file:


Running in a terminal:


Output (as viewed in TableTool):


Revision History

0.4 (2017-04-03)

  • Added extra context around variable use in Heroku app.json files.

0.3 (2017-03-30)

  • Added CSV report generation.

0.2 (2017-03-30)

  • Added detection of source variables matching export FOO=bar.

  • Added Markdown report generation.

0.1 (2017-03-30)

  • Initial alpha release.

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

env-diff-0.4.tar.gz (36.9 kB view hashes)

Uploaded source

Built Distribution

env_diff-0.4-py3-none-any.whl (13.9 kB view hashes)

Uploaded py3

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