yen

你需要的最后一个Python环境管理器。

图片来源：xkcd.com/1987

我们终于要结束这个XKCD了。

那么`yen`能做什么呢？

只需一个命令即可立即运行任何Python版本：

$ python
'python'：找不到命令

$ yen exec --python 3.12
正在下载3.12.3 ━━━━━━━━━━━━━━━━━━━━━━━━━ 100.0% • 17.4/17.4 MB • 29.1 MB/s
Python 3.12.3 (main, 2024年4月15日, 17:43:11) [Clang 17.0.6 ] on darwin
输入"help"、"copyright"、"credits"或"license"以获取更多信息。
>>> exit()

$ yen exec --python 3.12  # 后续使用时已缓存：
Python 3.12.3 (main, 2024年4月15日, 17:43:11) [Clang 17.0.6 ] on darwin
输入"help"、"copyright"、"credits"或"license"以获取更多信息。
>>>

适用于Windows、MacOS和Linux（libc和musl），支持Intel和ARM芯片。

快速创建venv：得益于microvenv，yen可以比内置的venv模块更快地创建虚拟环境：
```
$ yen create venv -p 3.9
已使用Python 3.9.18创建venv ✨

$ source venv/bin/activate

(venv) $ python --version
Python 3.9.18
```
注意：目前速度还不是很快，因为我发现了一个bug。正在修复中。
零依赖：无需安装Python，无需查看apt、homebrew等，只需运行一个shell命令即可在本地设置yen。
Python脚本管理：再也不用在全局Python环境中运行pip install来获取ruff、awscli等工具。

本质上，yen让你可以用一个静态二进制文件替代各种Python环境管理工具，如pyenv、pipx和virtualenv。

在任何机器上运行Python代码从未如此简单。

安装

运行以下命令获取yen：

MacOS / Linux：
```
curl -L yen.tushar.lol/install.sh | sh
```

Windows：

使用cmd：

curl -L yen.tushar.lol/install.bat -o yen-install.bat
yen-install.bat

或使用Powershell：

curl yen.tushar.lol/install.ps1 | Invoke-Expression

或者如果你喜欢，可以通过pip获取：

pip install yen

或pipx：

pipx run yen

是的，如果你已经有了yen，你可以执行yen run yen，这也是可行的。但不要这么做。

你也可以从GitHub releases下载二进制文件。

使用方法

$ yen list
可用的Python版本：
3.12.3
3.11.9
3.10.14
3.9.19
3.8.19

$ yen create venv -p 3.12
正在下载3.12.3 ━━━━━━━━━━━━━━━━━━━━━━━━━ 100.0% • 17.4/17.4 MB • 12.4 MB/s
已使用Python 3.12.3创建venv ✨

$ yen install meowsay
已使用Python 3.12.3安装meowsay包 ✨

$ meowsay hello!
 ________
< hello! >
 --------
        \      |\---/|
         \     | ,_, |
                \_`_/-..----.
             ___/ `   ' ,\"\"+ \  sk
            (__...'   __\    |`.___.';
              (_,...'(_,.`__)/'.....+

$ yen run --python 3.9 wttr
天气报告：米兰，意大利

     \  /       局部多云
   _ /"".-.     20 °C
     \_(   ).   ↑ 4 km/h
     /(___(__)  10 km
                0.0 mm

$ wttr paris
天气报告：巴黎

      \   /     晴朗
       .-.      +22(25) °C
    ― (   ) ―   ↓ 7 km/h
       `-'      10 km
      /   \     0.0 mm

默认情况下，Python会被下载到~/.yen_pythons。你可以通过设置YEN_PYTHONS_PATH环境变量来更改此位置。

本地开发 / 测试

运行yen create venv和venv/bin/activate
运行pip install -r requirements-dev.txt进行可编辑安装

验证你现在指向正确的yen：

$ which yen
/home/your_name/code/yen/venv/bin/yen

运行pytest来执行测试

要运行Rust测试：

编译Rust项目：cd yen-rs && cargo build
运行export YEN_RUST_PATH=./yen-rs/target/debug/yen-rs
运行pytest，确保测试数量已翻倍。

`microvenv.py`和`userpath.pyz`

这两个文件被yen使用，并由yen安装脚本下载。

microvenv.py只是这个文件的重命名。
userpath.pyz是通过在这个userpath分支中运行./build-standalone.sh创建的。

类型检查

运行mypy .

创建并上传包到PyPI

确保在setup.cfg中更新版本号。

然后运行以下命令：

pip install setuptools wheel twine
rm -rf build dist
python setup.py sdist bdist_wheel

然后使用twine上传到PyPI：

twine upload dist/*

yen

yen

那么yen能做什么呢？