Python client library for Docker Registry v2

Warning: This code is under development and will change in future version

Installation and running

From github:

$ pip install git+https://github.com/dohnto/pydor
$ pydor --help

Using docker:

$ docker run dohnto/pydor list --help
Usage: commandline.py list [OPTIONS] REGISTRY

  List repositories present in docker registry.

  Examples:

      pydor list quay.io
      pydor list --limit=0 quay.io
      pydor list --output=json quay.io

Options:
  --limit INTEGER                 Number of repositories to show. Use 0 to
                                  show all (but note that this might be very
                                  time consuming operation).  [default: 20]
  --output [json|xls|yaml|csv|dbf|tsv|html|latex|xlsx|ods|txt]
                                  Output format.  [default: txt]
  --insecure                      If set to true, the registry certificates
                                  will not be validated.  [default: False]
  --help                          Show this message and exit.

Usage

List repositories from registry quay.io:

$ pydor list quay.io
NAME
----------------------------
quay/elasticsearch
gilliam/base
gilliam/service-registry
modcloth/build-essential
...

Limit the repository list (use 0 for unlimited list):

$ pydor list --limit=1 quay.io
NAME
----------------------------
quay/elasticsearch

List repositories in different output format:

$ pydor list --output=json quay.io
[{"name": "quay/elasticsearch"}, {"name": "gilliam/base"}, ...]

Retrieve tag of image:

$ pydor tags quay.io/coreos/etcd
name
--------------
latest
test
v0.4.6
v0.4.8
v0.5.0_alpha.0
...

Retrieve labels of image:

$ pydor inspect labels quay.io/dohnto/py-registry-client-demo:labels
name      |value
----------|-----
otherlabel|bar
mylabel   |foo

You can use also digest instead of tag:

$ pydor inspect labels quay.io/dohnto/py-registry-client-demo@sha256:8f3a284c5761feb50a9b47939e492e261bde4eba1efe2e45a262d723f463a3bb
name      |value
----------|-----
otherlabel|bar
mylabel   |foo

Library usage

Basic demo usage

#!/usr/bin/env python

import registry
registry_host = "localhost:5000"

api = registry.API(registry_host, insecure=True)
for repository in api.Catalog():
    for tag in api.Tags(repository):
        print("{}/{}:{}".format(registry_host, repository, tag))

Will produce:

localhost:5000/a9:47
localhost:5000/a9:17
localhost:5000/a9:48
localhost:5000/a9:37
localhost:5000/a9:40
localhost:5000/a9:19
localhost:5000/a9:8
localhost:5000/a9:3
localhost:5000/a9:6
localhost:5000/a9:43
localhost:5000/a9:50