Update save / export methods to return data generators1774-export-methods

Signed-off-by: Joffrey F <joffrey@docker.com>

1 files changed, 5 insertions, 7 deletions

diff --git a/docker/models/images.py b/docker/models/images.py
index dcdeac9..8229cfc 100644
--- a/docker/models/images.py
+++ b/docker/models/images.py
@@ -61,8 +61,7 @@ class Image(Model):
         Get a tarball of an image. Similar to the ``docker save`` command.
 
         Returns:
-            (urllib3.response.HTTPResponse object): The response from the
-            daemon.
+            (generator): A stream of raw archive data.
 
         Raises:
             :py:class:`docker.errors.APIError`
@@ -70,11 +69,10 @@ class Image(Model):
 
         Example:
 
-            >>> image = cli.images.get("fedora:latest")
-            >>> resp = image.save()
-            >>> f = open('/tmp/fedora-latest.tar', 'w')
-            >>> for chunk in resp.stream():
-            >>>     f.write(chunk)
+            >>> image = cli.get_image("busybox:latest")
+            >>> f = open('/tmp/busybox-latest.tar', 'w')
+            >>> for chunk in image:
+            >>>   f.write(chunk)
             >>> f.close()
         """
         return self.client.api.get_image(self.id)