pop-release 15.0.0

什么是POP？

本项目使用pop构建，pop是一个基于Python的插件面向编程（POP）的实现。POP旨在以新的方式结合计算历史的观点和智慧来解决现代计算问题。

更多信息

• 插件面向编程（POP）简介

• pop-awesome

• pop-create

先决条件

• Python 3.8+

• git （如果从源代码安装或为项目做出贡献）

安装

如果您想使用 pop-release，您可以通过安装 PyPI 或源代码来使用它。

# clone repo
git clone git@gitlab.com/saltstack/pop/pop-release.git
cd pop-release

# Setup venv
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

传统

在您的家目录中设置一个名为 “.pypirc” 的文件。您的用户名将是 “__token__”，您的密码将是一个 API 令牌。使用此方法，您无法在配置的配置文件之间进行选择。

~/.pypirc

[distutils]
index-servers=
    pypi

[pypi]
repository = https://upload.pypi.org/legacy/
username = __token__
password = pypi-<pypi_api_token>

设置凭据后，您可以在包含您的源代码的目录的根目录下简单地运行 pop-release 命令。您需要的唯一参数是语义版本号。

pop-release 1.0.0-alpha

高级用户

使用 acct 插件，我们可以拥有多个命名配置文件。下面的 “default” 和 “testing” 例子显示了所需的最小配置。可以用于 twine.settings.Settings 对象的任何选项都可以包含在 twine acct 配置文件中。

credentials.yaml

twine:
    default:
        username: __token__
        password: pypi-api-auth-token
        repository_name: pypi
        repository_url: https://upload.pypi.org/legacy/
    testing:
        username: __token__
        password: pypi-testing-api-auth-token
        repository_name: testpypi
        repository_url: https://test.pypi.org/legacy/
    internal:
        sign: True
        sign_with: gpg
        identity:
        username: __token__
        password: pypi-internal-api-auth-token
        comment: My project's private repository
        config_file: ~/.pypirc
        skip_existing: False
        cacert:
        client_cert:
        repository_name: internal_pypi
        repository_url: https://pypi.<my_domain>.com/api

现在使用 acct 加密您的凭据

acct encrypt credentials.yaml

如果您是第一次使用此命令，它将输出一个 fernet 密钥。将此密钥保存到环境变量中

export ACCT_KEY="i6KbvytHAYWYiWBV48x5Ao0M3xuP-7Yzyi5K5g4eRQw="

还将创建一个新的文件，称为 <credentials_file_name>.fernet。将此文件的完整路径保存到您的环境变量中

export ACCT_FILE="/home/myuser/.../credentials.yaml.fernet"

现在您可以使用加密的凭据运行 pop-release。名为 “default” 的配置文件将被隐式使用。您可以通过使用 –acct-profile 选项来选择运行 pop-release 的配置文件。

使用默认配置文件进行 PyPi 发布

pop-release 2.0.0

进行 PyPi 测试发布

pop-release 2.0.0 --acct-profile=testing