laituri — Docker Toolkit for Python

laituri is a set of Docker-related Python snippets used at Valohai. You can use it with Python >= 3.6.

Usage

Configuration

You can configure your used docker command if it is not the default docker, using laituri settings. Example:

laituri.settings.DOCKER_COMMAND = 'docker'

Docker Credential Manager

Laituri contains a docker credentials manager which can be used for example when pulling images. It logs in and out using the docker cli. Example:

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!

Development

Installing editable library version in the current virtual environment.

pip install -e '.[dev]'   # optionally replace . with the path to laituri source root
isort -y                  # automatically enforce import style rules
flake8                    # run code style checker
pydocstyle                # run documentation style checker
pytest --cov              # run unit tests and print test coverage

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

Making a Release

Bump the version number accordingly in laituri/__init__.py and then...

# `pip install twine` if you don't have it (PyPI project uploader)
# `pip install build` if you don't have it (PEP517 package builder)
# NOTE: the following will delete everything except `.idea/` in source directory but not tracked by git!
git clean -fdx -e .idea/
python -m build .
twine upload dist/*

# and update git remote
git add .
git commit -m "Bump to v***"
git push