Skip to main content

Expand system variables Unix style

Project description


Expand system variables Unix style

PyPI version CircleCI codecov


This module is inspired by GNU bash's variable expansion features. It can be used as an alternative to Python's os.path.expandvars function.

A good use case is reading config files with the flexibility of reading values from environment variables using advanced features like returning a default value if some variable is not defined. For example:

my_secret_access_code = "${ACCESS_CODE:-default_access_code}"

NOTE: Although it copies most of the common behaviours, it doesn't follow it strictly. For example, it doesn't work with arrays.


from expandvars import expandvars

# /bin:/sbin:/usr/bin:/usr/sbin:/home/you/bin:/default/path


For now, refer to the test cases to see how it behaves.


To contribute, setup environment following way:

# Clone repo
git clone && cd expandvars

# Create virtualenv
virtualenv .venv && source .venv/bin/activate

# Install library in edit mode along with other handy dev tools
pip install -r dev-requirements.txt
  • Follow general git guidelines.
  • Keep it simple. Use black to format code.
  • Test your changes locally by running pytest.
  • If you are familiar with tox, you may want to use it for testing in different python versions.

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 expandvars, version 0.4
Filename, size File type Python version Upload date Hashes
Filename, size expandvars-0.4-py3.6.egg (7.1 kB) File type Egg Python version 3.6 Upload date Hashes View hashes
Filename, size expandvars-0.4-py3-none-any.whl (5.1 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size expandvars-0.4.tar.gz (4.4 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page