Skip to main content

A utility for validating paths in environment variables and modifying them safely

Project description


A utility for validating paths in environment variables and modifying them safely.


  • Python 3


You can install path-diag via pip:

pip3 install path-diag


Diagnose environment variable problems

Check if $PATH contains any invalid paths:

$ pathdiag

$PATH is the default variable to check.

You can specify another variable. For example:

$ pathdiag --var PYTHONPATH

You can also specify an increased verbosity which will also print the paths that are successfully checked:

$ pathdiag -v
✓ /usr/local/bin
✓ /usr/bin
✓ /bin
✓ /usr/sbin
✓ /sbin

Safely append/prepend paths to environment variables

You can use the bash functions in order to take advantage of this features by adding the following line on top of your .bashrc/.zshrc file:

source /usr/local/bin/

Then you can use the safe_append/safe_prepend functions. For example:

safe_append "/usr/local/Cellar/node/7.4.0/bin"
safe_prepend "/usr/local/opt/python/libexec/bin"

This will add /usr/local/Cellar/node/7.4.0/bin at the end of $PATH if this path passes the validation checks, and will also add /usr/local/opt/python/libexec/bin at the beginning of $PATH, again if no errors are identified.


All contributions are welcomed. Make sure your code passes flake8 checks and that is auto-formatted using black

Project details

Release history Release notifications

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
path_diag-0.0.1-py3.6.egg (8.0 kB) Copy SHA256 hash SHA256 Egg 3.6
path_diag-0.0.1-py3-none-any.whl (5.4 kB) Copy SHA256 hash SHA256 Wheel py3
path-diag-0.0.1.tar.gz (4.4 kB) Copy SHA256 hash SHA256 Source None

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 SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page