Write a set of short scripts using the kamaki lib

Fixes grnet/kamaki#49

Changelog

@@ -18,6 +18,11 @@ Bug fixes
 * Handle SSL unicode bug with grace [grnet/kamaki#67]
 * Check server status before changing it [grnet/kamaki#57]
 
+Support
+-------
+
+* Update library documentation with examples [grnet/kamaki#49]
+
 v0.13rc5
 ========
 

docs/developers/scripts/000_init.py

+# Copyright 2014 GRNET S.A. All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or
+# without modification, are permitted provided that the following
+# conditions are met:
+#
+#   1. Redistributions of source code must retain the above
+#      copyright notice, this list of conditions and the following
+#      disclaimer.
+#
+#   2. Redistributions in binary form must reproduce the above
+#      copyright notice, this list of conditions and the following
+#      disclaimer in the documentation and/or other materials
+#      provided with the distribution.
+#
+# THIS SOFTWARE IS PROVIDED BY GRNET S.A. ``AS IS'' AND ANY EXPRESS
+# OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+# WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL GRNET S.A OR
+# CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+# USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
+# AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+# LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
+# ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+#
+# The views and conclusions contained in the software and
+# documentation are those of the authors and should not be
+# interpreted as representing official policies, either expressed
+# or implied, of GRNET S.A.
+
+from kamaki.cli.config import Config
+
+cnf = Config()
+CLOUD = cnf.get('global', 'default_cloud')
+URL = cnf.get_cloud(CLOUD, 'url')
+TOKEN = cnf.get_cloud(CLOUD, 'token')
+
+
+from kamaki.cli import logger
+
+logger.add_stream_logger('kamaki.clients.recv', fmt='< %(message)s')
+logger.add_stream_logger('kamaki.clients.send', fmt='> %(message)s')
+
+
+from kamaki.clients import astakos, pithos, cyclades, image
+from kamaki.clients.utils import https
+
+https.patch_with_certs('/etc/ssl/certs/ca-certificates.crt')
+
+identity_client = astakos.AstakosClient(URL, TOKEN)
+
+pithosURL = identity_client.get_endpoint_url(pithos.PithosClient.service_type)
+storage_client = pithos.PithosClient(pithosURL, TOKEN)
+storage_client.account = identity_client.user_info['id']
+storage_client.container = 'pithos'
+
+imageURL = identity_client.get_endpoint_url(image.ImageClient.service_type)
+image_client = image.ImageClient(imageURL, TOKEN)
+
+computeURL = identity_client.get_endpoint_url(
+    cyclades.CycladesComputeClient.service_type)
+compute_client = cyclades.CycladesComputeClient(computeURL, TOKEN)
+
+networkURL = identity_client.get_endpoint_url(
+    cyclades.CycladesNetworkClient.service_type)
+network_client = cyclades.CycladesNetworkClient(networkURL, TOKEN)
+
+volumeURL = identity_client.get_endpoint_url(
+    cyclades.CycladesBlockStorageClient.service_type)
+volume_client = cyclades.CycladesBlockStorageClient(volumeURL, TOKEN)

docs/developers/scripts/001_file_info.py

+# Copyright 2014 GRNET S.A. All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or
+# without modification, are permitted provided that the following
+# conditions are met:
+#
+#   1. Redistributions of source code must retain the above
+#      copyright notice, this list of conditions and the following
+#      disclaimer.
+#
+#   2. Redistributions in binary form must reproduce the above
+#      copyright notice, this list of conditions and the following
+#      disclaimer in the documentation and/or other materials
+#      provided with the distribution.
+#
+# THIS SOFTWARE IS PROVIDED BY GRNET S.A. ``AS IS'' AND ANY EXPRESS
+# OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+# WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL GRNET S.A OR
+# CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+# USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
+# AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+# LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
+# ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+#
+# The views and conclusions contained in the software and
+# documentation are those of the authors and should not be
+# interpreted as representing official policies, either expressed
+# or implied, of GRNET S.A.
+
+from kamaki.cli.config import Config
+from kamaki.clients import astakos, pithos, ClientError
+
+cnf = Config()
+CLOUD = cnf.get('global', 'default_cloud')
+URL = cnf.get_cloud(CLOUD, 'url')
+TOKEN = cnf.get_cloud(CLOUD, 'token')
+identity_client = astakos.AstakosClient(URL, TOKEN)
+
+pithosURL = identity_client.get_endpoint_url(pithos.PithosClient.service_type)
+storage_client = pithos.PithosClient(pithosURL, TOKEN)
+storage_client.account = identity_client.user_info['id']
+storage_client.container = 'pithos'
+
+import json
+
+names = [o['name'] for o in storage_client.list_objects()]
+print 'Remote objects:\n\t', '\n\t'.join(names)
+
+pick = raw_input('Pick one: ')
+remote_object = storage_client.get_object_info(pick)
+print json.dumps(remote_object, indent=2)

docs/developers/scripts/002_container_backup.py

+# Copyright 2014 GRNET S.A. All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or
+# without modification, are permitted provided that the following
+# conditions are met:
+#
+#   1. Redistributions of source code must retain the above
+#      copyright notice, this list of conditions and the following
+#      disclaimer.
+#
+#   2. Redistributions in binary form must reproduce the above
+#      copyright notice, this list of conditions and the following
+#      disclaimer in the documentation and/or other materials
+#      provided with the distribution.
+#
+# THIS SOFTWARE IS PROVIDED BY GRNET S.A. ``AS IS'' AND ANY EXPRESS
+# OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+# WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL GRNET S.A OR
+# CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+# USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
+# AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+# LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
+# ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+#
+# The views and conclusions contained in the software and
+# documentation are those of the authors and should not be
+# interpreted as representing official policies, either expressed
+# or implied, of GRNET S.A.
+
+from kamaki.cli.config import Config
+from kamaki.clients import astakos, pithos, ClientError
+
+cnf = Config()
+CLOUD = cnf.get('global', 'default_cloud')
+URL = cnf.get_cloud(CLOUD, 'url')
+TOKEN = cnf.get_cloud(CLOUD, 'token')
+identity_client = astakos.AstakosClient(URL, TOKEN)
+
+pithosURL = identity_client.get_endpoint_url(pithos.PithosClient.service_type)
+storage_client = pithos.PithosClient(pithosURL, TOKEN)
+storage_client.account = identity_client.user_info['id']
+storage_client.container = 'pithos'
+
+import time
+
+backup_container = 'backup_%s' % time.time()
+storage_client.create_container(backup_container)
+
+for o in storage_client.list_objects():
+    try:
+        storage_client.copy_object(
+            storage_client.container, o['name'], backup_container)
+    except ClientError as ce:
+        print "Failed to backup object %s" % o['name']
+        print ce

docs/developers/scripts/003_container_cleanup.py

+# Copyright 2014 GRNET S.A. All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or
+# without modification, are permitted provided that the following
+# conditions are met:
+#
+#   1. Redistributions of source code must retain the above
+#      copyright notice, this list of conditions and the following
+#      disclaimer.
+#
+#   2. Redistributions in binary form must reproduce the above
+#      copyright notice, this list of conditions and the following
+#      disclaimer in the documentation and/or other materials
+#      provided with the distribution.
+#
+# THIS SOFTWARE IS PROVIDED BY GRNET S.A. ``AS IS'' AND ANY EXPRESS
+# OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+# WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL GRNET S.A OR
+# CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+# USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
+# AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+# LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
+# ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+#
+# The views and conclusions contained in the software and
+# documentation are those of the authors and should not be
+# interpreted as representing official policies, either expressed
+# or implied, of GRNET S.A.
+
+from kamaki.cli.config import Config
+from kamaki.clients import astakos, pithos, ClientError
+
+cnf = Config()
+CLOUD = cnf.get('global', 'default_cloud')
+URL = cnf.get_cloud(CLOUD, 'url')
+TOKEN = cnf.get_cloud(CLOUD, 'token')
+identity_client = astakos.AstakosClient(URL, TOKEN)
+
+pithosURL = identity_client.get_endpoint_url(pithos.PithosClient.service_type)
+storage_client = pithos.PithosClient(pithosURL, TOKEN)
+storage_client.account = identity_client.user_info['id']
+storage_client.container = 'pithos'
+
+current_container = storage_client.container
+try:
+    for c in storage_client.list_containers():
+        if c['name'].startswith('backup_'):
+            storage_client.container = c['name']
+            storage_client.del_container(delimiter='/')
+            storage_client.purge_container()
+finally:
+    storage_client.container = current_container

docs/developers/scripts/004_upload_files.py

+# Copyright 2014 GRNET S.A. All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or
+# without modification, are permitted provided that the following
+# conditions are met:
+#
+#   1. Redistributions of source code must retain the above
+#      copyright notice, this list of conditions and the following
+#      disclaimer.
+#
+#   2. Redistributions in binary form must reproduce the above
+#      copyright notice, this list of conditions and the following
+#      disclaimer in the documentation and/or other materials
+#      provided with the distribution.
+#
+# THIS SOFTWARE IS PROVIDED BY GRNET S.A. ``AS IS'' AND ANY EXPRESS
+# OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+# WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL GRNET S.A OR
+# CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+# USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
+# AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+# LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
+# ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+#
+# The views and conclusions contained in the software and
+# documentation are those of the authors and should not be
+# interpreted as representing official policies, either expressed
+# or implied, of GRNET S.A.
+
+from kamaki.cli.config import Config
+from kamaki.clients import astakos, pithos, ClientError
+
+cnf = Config()
+CLOUD = cnf.get('global', 'default_cloud')
+URL = cnf.get_cloud(CLOUD, 'url')
+TOKEN = cnf.get_cloud(CLOUD, 'token')
+identity_client = astakos.AstakosClient(URL, TOKEN)
+
+pithosURL = identity_client.get_endpoint_url(pithos.PithosClient.service_type)
+storage_client = pithos.PithosClient(pithosURL, TOKEN)
+storage_client.account = identity_client.user_info['id']
+storage_client.container = 'pithos'
+
+import sys
+
+def _gen(length):
+    for i in range(length):
+        sys.stderr.write('*')
+        yield
+    yield
+
+import os.path
+
+local_file_name = raw_input('File to upload: ')
+with open(local_file_name) as f:
+    remote_object = os.path.basename(f.name)
+    storage_client.upload_object(remote_object, f, upload_cb=_gen)

docs/developers/scripts/005_download_files.py

+# Copyright 2014 GRNET S.A. All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or
+# without modification, are permitted provided that the following
+# conditions are met:
+#
+#   1. Redistributions of source code must retain the above
+#      copyright notice, this list of conditions and the following
+#      disclaimer.
+#
+#   2. Redistributions in binary form must reproduce the above
+#      copyright notice, this list of conditions and the following
+#      disclaimer in the documentation and/or other materials
+#      provided with the distribution.
+#
+# THIS SOFTWARE IS PROVIDED BY GRNET S.A. ``AS IS'' AND ANY EXPRESS
+# OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+# WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL GRNET S.A OR
+# CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+# USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
+# AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+# LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
+# ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+#
+# The views and conclusions contained in the software and
+# documentation are those of the authors and should not be
+# interpreted as representing official policies, either expressed
+# or implied, of GRNET S.A.
+
+from kamaki.cli.config import Config
+from kamaki.clients import astakos, pithos, ClientError
+
+cnf = Config()
+CLOUD = cnf.get('global', 'default_cloud')
+URL = cnf.get_cloud(CLOUD, 'url')
+TOKEN = cnf.get_cloud(CLOUD, 'token')
+identity_client = astakos.AstakosClient(URL, TOKEN)
+
+pithosURL = identity_client.get_endpoint_url(pithos.PithosClient.service_type)
+storage_client = pithos.PithosClient(pithosURL, TOKEN)
+storage_client.account = identity_client.user_info['id']
+storage_client.container = 'pithos'
+
+
+import sys
+
+def _gen(l):
+    for i in range(l):
+        sys.stderr.write('*')
+        yield
+    yield
+
+import os.path
+
+obj = raw_input('Pick remote object to download:')
+target = raw_input('Local file name: ')
+with open(target, 'w+') as f:
+    storage_client.download_object(obj, f, download_cb=_gen)

docs/developers/scripts/006_async_upload.py

+# Copyright 2014 GRNET S.A. All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or
+# without modification, are permitted provided that the following
+# conditions are met:
+#
+#   1. Redistributions of source code must retain the above
+#      copyright notice, this list of conditions and the following
+#      disclaimer.
+#
+#   2. Redistributions in binary form must reproduce the above
+#      copyright notice, this list of conditions and the following
+#      disclaimer in the documentation and/or other materials
+#      provided with the distribution.
+#
+# THIS SOFTWARE IS PROVIDED BY GRNET S.A. ``AS IS'' AND ANY EXPRESS
+# OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+# WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL GRNET S.A OR
+# CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+# USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
+# AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+# LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
+# ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+#
+# The views and conclusions contained in the software and
+# documentation are those of the authors and should not be
+# interpreted as representing official policies, either expressed
+# or implied, of GRNET S.A.
+
+from kamaki.cli.config import Config
+from kamaki.clients import astakos, pithos, ClientError
+
+cnf = Config()
+CLOUD = cnf.get('global', 'default_cloud')
+URL = cnf.get_cloud(CLOUD, 'url')
+TOKEN = cnf.get_cloud(CLOUD, 'token')
+identity_client = astakos.AstakosClient(URL, TOKEN)
+
+pithosURL = identity_client.get_endpoint_url(pithos.PithosClient.service_type)
+storage_client = pithos.PithosClient(pithosURL, TOKEN)
+storage_client.account = identity_client.user_info['id']
+storage_client.container = 'pithos'
+
+from os import walk
+
+def upload_one_file(fname):
+    with open(fname) as f:
+        storage_client.upload_object(fname, f)
+
+local_path = raw_input('Dir to upload: ')
+for top, subdirs, files in walk(local_path):
+    storage_client.async_run(upload_one_file, [dict(fname=fn) for fn in files])

docs/developers/scripts/007_container_reassign.py

+# Copyright 2014 GRNET S.A. All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or
+# without modification, are permitted provided that the following
+# conditions are met:
+#
+#   1. Redistributions of source code must retain the above
+#      copyright notice, this list of conditions and the following
+#      disclaimer.
+#
+#   2. Redistributions in binary form must reproduce the above
+#      copyright notice, this list of conditions and the following
+#      disclaimer in the documentation and/or other materials
+#      provided with the distribution.
+#
+# THIS SOFTWARE IS PROVIDED BY GRNET S.A. ``AS IS'' AND ANY EXPRESS
+# OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+# WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL GRNET S.A OR
+# CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+# USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
+# AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+# LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
+# ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+#
+# The views and conclusions contained in the software and
+# documentation are those of the authors and should not be
+# interpreted as representing official policies, either expressed
+# or implied, of GRNET S.A.
+
+from kamaki.cli.config import Config
+from kamaki.clients import astakos, pithos, ClientError
+
+cnf = Config()
+CLOUD = cnf.get('global', 'default_cloud')
+URL = cnf.get_cloud(CLOUD, 'url')
+TOKEN = cnf.get_cloud(CLOUD, 'token')
+identity_client = astakos.AstakosClient(URL, TOKEN)
+
+pithosURL = identity_client.get_endpoint_url(pithos.PithosClient.service_type)
+storage_client = pithos.PithosClient(pithosURL, TOKEN)
+storage_client.account = identity_client.user_info['id']
+storage_client.container = raw_input('Container to reassign: ')
+
+import json
+
+projects = [{p['id']: p['name']} for p in identity_client.get_projects()]
+print 'These are your projects:', json.dumps(projects, indent=2)
+storage_client.reassign_container(raw_input('Assign container to project id: '))

docs/developers/scripts/008_stream.py

+# Copyright 2014 GRNET S.A. All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or
+# without modification, are permitted provided that the following
+# conditions are met:
+#
+#   1. Redistributions of source code must retain the above
+#      copyright notice, this list of conditions and the following
+#      disclaimer.
+#
+#   2. Redistributions in binary form must reproduce the above
+#      copyright notice, this list of conditions and the following
+#      disclaimer in the documentation and/or other materials
+#      provided with the distribution.
+#
+# THIS SOFTWARE IS PROVIDED BY GRNET S.A. ``AS IS'' AND ANY EXPRESS
+# OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+# WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL GRNET S.A OR
+# CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+# USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
+# AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+# LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
+# ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+#
+# The views and conclusions contained in the software and
+# documentation are those of the authors and should not be
+# interpreted as representing official policies, either expressed
+# or implied, of GRNET S.A.
+
+from kamaki.cli.config import Config
+from kamaki.clients import astakos, pithos, ClientError
+
+cnf = Config()
+CLOUD = cnf.get('global', 'default_cloud')
+URL = cnf.get_cloud(CLOUD, 'url')
+TOKEN = cnf.get_cloud(CLOUD, 'token')
+identity_client = astakos.AstakosClient(URL, TOKEN)
+
+pithosURL = identity_client.get_endpoint_url(pithos.PithosClient.service_type)
+storage_client = pithos.PithosClient(pithosURL, TOKEN)
+storage_client.account = identity_client.user_info['id']
+storage_client.container = 'pithos'
+
+obj = raw_input('Pick object to stream: ')
+destination = raw_input('Stream it where? ')
+
+obj_size = int(storage_client.get_object_info(obj)['content-length'])
+BLOCK_SIZE = int(storage_client.get_container_info()['x-container-block-size'])
+CHUNK_SIZE = 4 * BLOCK_SIZE
+
+def stream(i, output):
+    """Stream the contents of buf[i] to output"""
+    output.write(bufs[i])
+
+from kamaki.clients import SilentEvent
+
+with open(destination, 'w+') as output:
+    event = None
+    bufs = ['', '']
+    for i in range(1 + (obj_size / CHUNK_SIZE)):
+        buf_index = i % 2
+        start, end = CHUNK_SIZE * i, min(CHUNK_SIZE * (i + 1), obj_size)
+        bufs[buf_index] = storage_client.download_to_string(
+            obj, range_str='%s-%s' % (start, end))
+        if event and not event.is_alive():
+            event.join()
+        event = SilentEvent(stream, buf_index, output)
+        event.start()

docs/developers/scripts/009_register_image.py

+# Copyright 2014 GRNET S.A. All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or
+# without modification, are permitted provided that the following
+# conditions are met:
+#
+#   1. Redistributions of source code must retain the above
+#      copyright notice, this list of conditions and the following
+#      disclaimer.
+#
+#   2. Redistributions in binary form must reproduce the above
+#      copyright notice, this list of conditions and the following
+#      disclaimer in the documentation and/or other materials
+#      provided with the distribution.
+#
+# THIS SOFTWARE IS PROVIDED BY GRNET S.A. ``AS IS'' AND ANY EXPRESS
+# OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+# WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL GRNET S.A OR
+# CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+# USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
+# AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+# LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
+# ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+#
+# The views and conclusions contained in the software and
+# documentation are those of the authors and should not be
+# interpreted as representing official policies, either expressed
+# or implied, of GRNET S.A.
+
+from kamaki.cli.config import Config
+from kamaki.clients import astakos, pithos, image, ClientError
+from kamaki.clients.utils import https
+
+https.patch_with_certs('/etc/ssl/certs/ca-certificates.crt')
+cnf = Config()
+CLOUD = cnf.get('global', 'default_cloud')
+URL = cnf.get_cloud(CLOUD, 'url')
+TOKEN = cnf.get_cloud(CLOUD, 'token')
+identity_client = astakos.CachedAstakosClient(URL, TOKEN)
+
+imageURL = identity_client.get_endpoint_url(image.ImageClient.service_type)
+image_client = image.ImageClient(imageURL, TOKEN)
+
+pithosURL = identity_client.get_endpoint_url(pithos.PithosClient.service_type)
+storage_client = pithos.PithosClient(pithosURL, TOKEN)
+storage_client.account = identity_client.user_info()['id']
+storage_client.container = 'pithos'
+
+storage_client.container, path = 'images', 'my_image.diskdump'
+with open(path) as f:
+    storage_client.upload_object(path, f)
+
+location = (identity_client.user_info()['id'], storage_client.container, path)
+properties = dict(osfamily='linux', users='root', os='debian')
+img = image_client.register('My New Image', location, properties=properties)
+
+import json
+print 'Image created sucesfully', json.dumps(img, indent=2)

docs/developers/scripts/010_find_image.py

+# Copyright 2014 GRNET S.A. All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or
+# without modification, are permitted provided that the following
+# conditions are met:
+#
+#   1. Redistributions of source code must retain the above
+#      copyright notice, this list of conditions and the following
+#      disclaimer.
+#
+#   2. Redistributions in binary form must reproduce the above
+#      copyright notice, this list of conditions and the following
+#      disclaimer in the documentation and/or other materials
+#      provided with the distribution.
+#
+# THIS SOFTWARE IS PROVIDED BY GRNET S.A. ``AS IS'' AND ANY EXPRESS
+# OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+# WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL GRNET S.A OR
+# CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+# USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
+# AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+# LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
+# ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+#
+# The views and conclusions contained in the software and
+# documentation are those of the authors and should not be