vrun 0.3

Adds Python's bin/Scripts directory to PATH before executing a command. Primarily used with Python virtual environments.

vrun

Adds Python’s bin/Scripts directory to PATH before executing a command. Primarily used with Python virtual environments.

Overview

A small Python helper tool that will modify the PATH in the environment before executing the executable provided as the first argument. This is useful when programs expect certain binaries to be available in PATH so they can execute them using os.popen() and friends or even for shell scripts that are executing Python tools that one would prefer to not globally install.

Scripts may detect that vrun has been used by looking for the environment variable VRUN_ACTIVATED which is set to 1 when run. It is not recommended that script writers do this.

Use

On macOS/FreeBSD/Linux/Unix:

$ python3 -mvenv ./env/
$ ./env/bin/pip install vrun
$ ./env/bin/vrun /bin/bash -c 'echo $PATH'

On Windows:

C:\> python3.exe -mvenv env
C:\> env\Scripts\pip.exe install vrun
C:\> env\Scripts\vrun.exe python -c "import os; print(os.environ['PATH'])"

If for example there is a script that executes pip without explicitly providing a PATH that includes a virtual environment the system installed pip may accidentally be invoked instead. With vrun the virtual environment will come first in the search path and thus pip will be safely executed within the context of the virtual environment.

Such as a shell script:

$ ./env/bin/vrun ./myscript.sh

Or executing a Windows batch script:

C:\> env\Scripts\vrun.exe script.bat

vrun or vexec

vrun installs itself as both vrun and vexec. The later may be typed with the left hand only and is slightly faster to roll off the keyboard!

License

Please see the LICENSE file in the source code repository

0.3 (2017-06-13)

• Adds Windows support, so now you can use:

  Script\vrun.exe python -c "import os; print(os.environ['PATH'])"

  To run Windows binaries with their %PATH% modified.

  vrun will also automatically add the .exe when passing the name of a script that exists in the Scripts folder.

  So the following are the same:

  Script\vrun.exe python

  and:

  Script\vrun.exe python.exe

0.2 (2017-06-08)

• Also export the environment variable VIRTUAL_ENV pointing to the virtual environment.

0.1 (2017-06-08)

• Initial release and implementation of the vrun functionality