Skip to content
SoftLayer Object Storage Python Client
Python
Find file
Latest commit f385b81 Apr 22, 2015 @briancline briancline Merge pull request #41 from briancline/custom-port-probz
Fixes custom port issues on chunked uploads
Failed to load latest commit information.
docs Bump version to 0.5.4 Apr 21, 2015
object_storage
tests Fixes PEP8 violations, adds 'pep8' tox test Nov 22, 2014
.gitignore
COPYING Initial Import Feb 13, 2012
README.markdown fixed spelling error in README Aug 5, 2014
setup.cfg PEP-8 Fixes Nov 22, 2013
setup.py Get our own name right Nov 22, 2014
tox.ini Fixes PEP8 violations, adds 'pep8' tox test Nov 23, 2014

README.markdown

SoftLayer Object Storage Python Client

Python bindings for SoftLayer Object Storage

Installation

Install via pip:

pip install softlayer-object-storage

Or install from source:

git clone git://github.com/softlayer/softlayer-object-storage-python.git
cd softlayer-object-storage-python
python setup.py install

To build the documentation (requires sphinx):

python setup.py build_sphinx

Basic Usage

import object_storage

sl_storage = object_storage.get_client('YOUR_USERNAME', 'YOUR_API_KEY', datacenter='dal05')

sl_storage.containers()
# []

sl_storage['foo'].create()
# Container(foo)

sl_storage.containers()
# [Container(foo)]

sl_storage['foo'].properties
# {'count': 0, 'object_count': 0, 'name': 'foo', 'size': 0.0}

sl_storage['foo']['bar.txt'].create()
# StorageObject(foo, sample_object.txt)

sl_storage['foo']['bar.txt'].send('Plain-Text Content')
# True

sl_storage['foo']['bar.txt'].read()
# 'Plain-Text Content'

sl_storage['foo'].objects()
# [StorageObject(foo, bar.txt)]

sl_storage['foo']['bar.txt'].delete()
# True

sl_storage['foo'].delete()
# True

Search Usage

sl_storage.search('foo')
# {'count': 2, 'total': 2, 'results': [Container(foo), StorageObject(bar, foo)]}

sl_storage['foo'].search('bar.txt')
# {'count': 1, 'total': 1, 'results': [StorageObject(foo, bar.txt)]}

sl_storage.search('foo', type='container')
# {'count': 1, 'total': 1, 'results': [Container(foo)]}

sl_storage.search('foo*baz')
# {'count': 1, 'total': 1, 'results': [Container(foobarbaz)]}

Development

Here's how to get started:

  • Fork repo on github
  • Clone your new repo to your local machine:

  • git clone git@github.com:username/softlayer-object-storage-python.git 
    

* Configure remote for upstream:

* ```
cd softlayer-object-storage-python
git remote add upstream git://github.com/softlayer/softlayer-object-storage-python.git
Something went wrong with that request. Please try again.