Metadata-Version: 2.1
Name: droplo
Version: 0.1.3
Summary: Official Python SDK for the Droplo content API
Home-page: https://github.com/droploio/droplo.py
Author: Droplo Inc
Author-email: contact@droplo.io
License: UNKNOWN
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Description-Content-Type: text/markdown
Requires-Dist: requests (>=2.14.0)

Python client for [droplo.io](https://droplo.io)
=========

[![Latest PyPI version](https://img.shields.io/pypi/v/droplo.svg)](https://pypi.python.org/pypi/droplo)
[![MIT License](https://img.shields.io/badge/license-MIT-brightgreen.svg)](LICENSE)
[![Circle CI](https://circleci.com/gh/droploio/droplo.py/tree/master.svg?style=shield)](https://circleci.com/gh/droploio/droplo.py)

### Getting started

#### Install the client for your project

Simply run:

```
pip install droplo
```

#### Basic example of use:
```python
>>> import droplo
>>> api = droplo.Api("YOUR_ACCESS_TOKEN")
>>> blogposts = api.get("blogposts")
>>> blogposts.files[0].name
```

#### Using Memcached (or any other cache)

By default, the kit will use Shelve to cache the requests (a file-based cache from the standard library). It is recommended to use a cache server instead, for example Memcached.

You can pass a Memcached client to the `droplo.get` call:

```python
>>> import memcache
>>> api = droplo.Api("YOUR_ACCESS_TOKEN", cache=memcache.Client(['127.0.0.1:11211']))
```

By duck typing you can pass any object that implement the `set` and `get` methods (see the `NoCache` object for the methods
to implement).

### Licence

Copyright (c) 2018 Droplo, Inc. See [LICENSE](LICENSE) for further details.


