Adds a 'labels' property to the image model

Signed-off-by: Frank Sachsenheim <funkyfuture@riseup.net>

docker/models/images.py

@@ -15,6 +15,14 @@ class Image(Model):
     def __repr__(self):
         return "<%s: '%s'>" % (self.__class__.__name__, "', '".join(self.tags))
 
+    @property
+    def labels(self):
+        """
+        The labels of an image as dictionary.
+        """
+        result = self.attrs['Config'].get('Labels')
+        return result or {}
+
     @property
     def short_id(self):
         """

docs/images.rst

@@ -29,6 +29,7 @@ Image objects
   .. autoattribute:: id
   .. autoattribute:: short_id
   .. autoattribute:: tags
+  .. autoattribute:: labels
   .. py:attribute:: attrs
 
     The raw representation of this object from the server.

tests/unit/fake_api.py

@@ -158,6 +158,7 @@ def get_fake_inspect_image():
         'Parent': "27cf784147099545",
         'Created': "2013-03-23T22:24:18.818426-07:00",
         'Container': FAKE_CONTAINER_ID,
+        'Config': {'Labels': {'bar': 'foo'}},
         'ContainerConfig':
         {
             "Hostname": "",

tests/unit/models_images_test.py

@@ -21,6 +21,11 @@ class ImageCollectionTest(unittest.TestCase):
         assert isinstance(image, Image)
         assert image.id == FAKE_IMAGE_ID
 
+    def test_labels(self):
+        client = make_fake_client()
+        image = client.images.get(FAKE_IMAGE_ID)
+        assert image.labels == {'bar': 'foo'}
+
     def test_list(self):
         client = make_fake_client()
         images = client.images.list(all=True)