Docker Registry Client
|Build Status| |pypi|
A Python REST client for the Docker Registry
It's useful for automating image tagging and untagging
.. |Build Status| image:: https://travis-ci.org/yodle/docker-registry-client.svg?branch=master
:target: https://travis-ci.org/yodle/docker-registry-client
:alt: Build status
.. |pypi| image:: https://img.shields.io/pypi/v/docker-registry-client/0.5.1.svg
:target: https://pypi.python.org/pypi/docker-registry-client
:alt: Latest version released on PyPI
Usage
The API provides several classes: DockerRegistryClient
, Repository
, and Image
.
DockerRegistryClient
has the following methods:
namespaces()
-> a list of all namespaces in the registryrepository(repository_name, namespace)
-> the corresponding repository objectrepositories()
-> all repositories in the registry
Repository
has the following methods:
tags()
-> a list of all tags in the repositorydata(tag)
-> json data associated with tag
image(tag)
-> the image associated with tag
untag(tag)
-> remove tag
from the repositorytag(tag, image_id)
-> apply tag
to image_id
Image
has the following methods:
get_layer()
-> binary layer data for imageget_json()
-> json metadata for imageget_data(field)
-> single field from json dataancestry()
-> ids for image ancestors
Alternatives
python-dxf <https://pypi.python.org/pypi/python-dxf>
_ (only supports V2)
0.5.2 (2017-06-16)
- Fix for "AttributeError: 'list' object has no attribute 'keys'"
(
Issue #41 <https://github.com/yodle/docker-registry-client/pull/41>
_) - Added usage docs inside README.rst
(
Issue #39 <https://github.com/yodle/docker-registry-client/pull/39>
)
(Issue #45 <https://github.com/yodle/docker-registry-client/pull/45>
) - Remove error logging when exception raised.
(
Issue #37 <https://github.com/yodle/docker-registry-client/pull/37>
_)
0.5.1 (2017-01-12)
- Fixes to release process with zest
0.5.0 (2017-01-12)
- First version of docker-registry-client with changelog
- Support get and push manifest on protocol v2, schema v1.
(
Issue #33 <https://github.com/yodle/docker-registry-client/pull/33>
_)