docker-pyo3 0.3.2

Python bindings to the docker-api-rs crate
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155

import docker_pyo3
from docker_pyo3.image import Images,Image
import pytest
import os
# Images Endpoints


here = os.path.abspath(os.path.dirname(__file__))

def test_images_init(docker):
    """images collection accessor"""
    x = docker.images()
    assert isinstance(x,Images)
    pass

def test_images_pull(docker):
    """pull an image from a remote"""
    x = docker.images().pull(image='busybox')
    assert isinstance(x,list)

def test_images_pull_bad(docker):
    """pulling a bad image fails with SystemError"""
    with pytest.raises(SystemError):
        docker.images().pull(image="asldfkjasd;lfk")

def test_images_list(docker, image_pull):
    """we can list images"""
    local_images = docker.images().list()
    assert isinstance(local_images, list)
    assert len(local_images) > 0
    pass


def test_images_prune(image_pull,docker):
    """prune dangling images"""
    start_images = docker.images().list()
    docker.images().prune()
    pass

def test_images_build(docker):
    """ we can build an image"""

    path =  os.path.join(here,'Dockerfile')

    with open(path,'w') as f:
        print("FROM busybox",file=f)
        print("COPY conftest.py /", file=f)

    try:
        x = docker.images().build(path=here,dockerfile='Dockerfile',tag='test-image')
    except Exception as e:
        raise(e)
    finally:
        os.unlink(path)
        docker.images().get('test-image').delete()

def test_images_build_with_labels(docker):
    """we can build images with labels"""
    path = os.path.join(here,'Dockerfile')

    with open(path,'w') as f:
        print("FROM busybox",file=f)
        print("COPY conftest.py /", file=f)

    labels = {"version": "1.0", "environment": "test"}
    try:
        x = docker.images().build(path=here, dockerfile='Dockerfile', tag='test-image-labels', labels=labels)
        image = docker.images().get('test-image-labels')
        info = image.inspect()
        assert info["Config"]["Labels"]["version"] == "1.0"
        assert info["Config"]["Labels"]["environment"] == "test"
    except Exception as e:
        raise(e)
    finally:
        os.unlink(path)
        docker.images().get('test-image-labels').delete()

def test_images_get(image_pull, docker):
    """we can get and inspect images by Id and name"""
    x = docker.images().list();
    image = docker.images().get(x[0].get('Id'))
    assert isinstance(image, Image)
    image.inspect()
    
    image = docker.images().get('busybox')
    assert isinstance(image, Image)
    
    image.inspect()
    pass

def test_images_get_bad(docker):
    """non existent image interface fails"""
    
    image = docker.images().get("DSDFLKJ")
    with pytest.raises(SystemError):
        image.inspect()
        


def test_image_name(docker, image_pull):
    """images have a name"""
    try:
        image = docker.images().get('busybox')
        assert image.name() == 'busybox'
    except Exception as e:
        raise e



# def test_image_delete(docker):
#     """we can delete images"""    
#     try:
#         docker.images().pull('busybox')
#         image = docker.images().get('busybox')
#         image.delete()
#         with pytest.raises(SystemError):
#             image.inspect()
#     except Exception as e:
#         raise e
        

def test_image_export(docker, image_pull):
    """we can export images"""
    
    
    try:
        image = docker.images().get('busybox')
        image.export(path="busybox.tar")
        assert os.path.exists("busybox.tar")
    except Exception as e:
        raise e
    finally: 
        os.unlink("busybox.tar")

    
def test_image_tag(docker, image_pull):
    """we can tag images"""
    
    try:
        image = docker.images().get('busybox')    
        image.tag("test_tag")
    except Exception as e:
        raise e
    finally:
        docker.images().get("test_tag").delete()