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!

Source env.bash script to update environment

Project Description

Python module for sourcing a bash script to augment the environment. Supports Python 2.7 and 3.3+


12-factor apps require configuration loaded from the environment.

That’s easy on a platform like Heroku, where the environment is preset by the user with commands like heroku config:set. But it’s messier in development and non-Heroku deployments, where the environment might need to be loaded from a file.

This package provides a mechanism for sourcing a Bash script to update Python’s environment (os.environ). There are reasons for using a Bash script instead of another configuration language:

  1. Environment variable keys and values should always be strings. Using a Bash script to update the environment enforces that restriction, so there won’t be surprises when you deploy into something like Heroku later on.
  2. Using a script means that the values can be sourced into a Bash shell, something that’s non-trivial if you use a different config language.
  3. For better or worse, using a script means that environment variables can be set using the full power of the shell, including reading from other files.

Commonly the external file is called env.bash, hence the name of this project.


Install from PyPI:

pip install envbash


Call load_envbash to source a Bash script into the current Python process. Any variables that are set in the script, regardless of whether they are explicitly exported, will be added to the process environment.

For example, given env.bash with the following content:

FOO='bar baz qux'

This can be loaded into Python:

import os
from envbash import load_envbash


print(os.environ['FOO'])  #=> prints BAR

Release History

This version
History Node


History Node


History Node


Download Files

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

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(3.8 kB) Copy SHA256 Hash SHA256
Source None Feb 8, 2017

Supported By

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 Google Google Cloud Servers DreamHost DreamHost Log Hosting