vrun 0.4

概述

这是一个小的Python辅助工具，它会在执行作为第一个参数提供的可执行文件之前修改环境中的 PATH。当程序期望某些二进制文件在 PATH 中可用以便它们可以使用 os.popen() 和相关函数执行它们，或者对于执行用户不希望全局安装的Python工具的shell脚本来说，这很有用。

脚本可以通过查找环境变量 VRUN_ACTIVATED 来检测是否使用了 vrun，当运行时该变量设置为 1。不建议脚本编写者这样做。

使用方法

在 macOS/FreeBSD/Linux/Unix 上

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

在 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'])"

例如，如果有一个脚本执行 pip 而没有明确提供包含虚拟环境的PATH，系统安装的 pip 可能会意外地被调用。使用 vrun，虚拟环境将在搜索路径中排在首位，因此 pip 将在虚拟环境的作用域中安全执行。

例如，一个shell脚本

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

或执行一个Windows批处理脚本

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

命令别名

vrun 允许你在配置文件中定义命令别名，可以是 vrun.cfg、vrun.ini 或 setup.cfg。

这些配置文件必须包含至少一个 vrun 部分，然后使用标准的 ini 格式，你可以指定键值对

[vrun]
python.version = python --version
shell = /bin/bash
echo = /bin/bash -c 'echo ${@}' _ {posargs} echo off the bare walls

现在你可以使用以下方式运行这些命令

vrun python.version

这将返回类似的结果

Python 3.6.2

然后你可以进行位置参数插值

vrun echo the soft voices

将输出

the soft voices echo off the bare walls

vrun shell -c 'echo $PATH'

/bin/bash -c 'echo $PATH'

vrun 或 vexec

vrun 同时作为 vrun 和 vexec 安装。后者可以用左手打字，并且打字速度略快！

许可证

请参阅源代码存储库中的 LICENSE 文件