Python bindings for SpinnerChief API.

Spinner Chief is an online service for spinning text (synonym substitution) that creates unique version(s) of existing text. This package provides a way to easily interact with SpinnerChief API. Usage requires an account, get one here and an api key which you get by registering a developer account.

• Source code @ GitHub

Install within virtualenv

$ virtualenv foo
$ cd foo
$ git clone https://github.com/niteoweb/spinnerchief
$ bin/pip install spinnerchief/

# running tests:
$ bin/pip install unittest2 mock
$ bin/python -m unittest discover -s spinnerchief/src/spinnerchief/tests

Buildout

$ git clone https://github.com/niteoweb/spinnerchief
$ cd spinnerchief
$ python bootstrap.py
$ bin/buildout

# running tests:
$ bin/py -m unittest discover -s src/spinnerchief/tests

# check code for imperfections
$ bin/vvv src/spinnerchief

Usage

>>> import spinnerchief
>>> sc = spinnerchief.SpinnerChief("<yourapikey>", "<yourusername>", "<yourpassword>")

>>> sc.text_with_spintax(text="My name is Ovca!")
"{I am|I'm|My friends call me|Throughout southern california|Im} Ovca!"

>>> sc.unique_variation(text="My name is Ovca!")
"Im Ovca!"

>>> print "used: %s" % sc.quota_used()
used: 2

>>> print "left: %s" % sc.quota_left()
left: 18