laituri — Python Docker工具包

laituri是一组用于Valohai的Docker相关Python片段。您可以使用它与Python >= 3.7。

用法

配置

您可以使用laituri设置来配置使用的Docker命令，如果它不是默认的docker。

示例

laituri.settings.DOCKER_COMMAND = 'docker'

Docker凭据管理器

Laituri包含一个docker凭据管理器，可以在拉取镜像时使用。它使用Docker CLI登录和注销。

示例

from laituri.docker.credential_manager import get_credential_manager

my_credentials = {
    'username': 'SmolShark1',
    'password': 'sharksWithLazers',
}

with get_credential_manager(
    image='python:latest',
    registry_credentials=my_credentials,
    log_status=print  # Any callable
):
    # Do your docker things!

开发

在当前虚拟环境中安装可编辑的库版本。

# install this package and all development dependencies
pip install -e . -r requirements-dev.txt pip-tools pre-commit && pre-commit install

# manually run lint and type checks
pre-commit run --all-files

# manually run tests
pytest --cov

python
>>> import laituri; print(laituri.__version__)

发布版本

当将新标签推送到仓库时，CI将发布新的版本构建。

# bump version number in "laituri/__init__.py"
vim laituri/__init__.py

# pushing a new tag will trigger a new release build
git add .
git commit -m "Become to X.Y.Z"
git tag -a vX.Y.Z -m "Version X.Y.Z"
git push --follow-tags

如果需要手动发布，可以按照上述步骤进行，然后

pip install build twine
git clean -fdx -e .idea/
python -m build .
twine upload dist/*