Softlayer Object Storage client bindings for python.
Project description
SoftLayer Object Storage Python Client
======================================
Python bindings for SoftLayer Object Storage
Installation
------------
Download source and run:
```
python setup.py install
```
To build the documentation (requires sphinx):
```
python setup.py build_sphinx
```
Basic Usage
-----------
```python
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
------------
```python
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)]}
```
Developement
------------
Follow the [Fork and Pull Request workflow](https://github.com/sevntu-checkstyle/sevntu.checkstyle/wiki/Fork-and-Pull-Request-workflow
). 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
```
* Fetch from upstream
* ```
git fetch upstream
```
======================================
Python bindings for SoftLayer Object Storage
Installation
------------
Download source and run:
```
python setup.py install
```
To build the documentation (requires sphinx):
```
python setup.py build_sphinx
```
Basic Usage
-----------
```python
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
------------
```python
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)]}
```
Developement
------------
Follow the [Fork and Pull Request workflow](https://github.com/sevntu-checkstyle/sevntu.checkstyle/wiki/Fork-and-Pull-Request-workflow
). 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
```
* Fetch from upstream
* ```
git fetch upstream
```
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Close
Hashes for softlayer-object-storage-0.4.3.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | d8c14b35dfce6aa7bc9715948994fc2b3f6ef434e0810dd133ed6ffc54bc6943 |
|
MD5 | 1e599a2a15d5a681a502f892378b6efa |
|
BLAKE2b-256 | 9844d4c046e34713b24255220ba709fc6dd01b8663f5b6600ee50492766c5bed |