============================================ Python client library for Docker Registry v2

.. image:: https://travis-ci.org/dohnto/pydor.svg?branch=master

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

.. code:: python

#!/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