python-socialtext 0.1.a1

Client library for Socialtext's ReST API

This is a client for Socialtext’s ReST API. We are currently in the alpha stage for the first release. The API only supports basic operations for a few resources, but it is a good start!

Contents:

• Requirements

• Installation

• Python API

• Contributing

Requirements

The only dependency is httplib2

Installation

You can install python-socialtext using pip or easy_install:

pip install python-socialtext

easy_install python-socialtext

The tests use nose and can be run using:

python setup.py

# or

nosetests

Python API

Quick start:

from socialtext import Socialtext

st = Socialtext(ST_URL, USERNAME, PASSWORD)

st.signals.create("This is a signal from the API!")
<Signal: 1234>

signal.delete()

st.pages.list("ws-name")
<Page: test_page>, <Page: test_page_2>, <Page: test_page_3>

ws = st.workspaces.get("ws-name")
st.pages.list(ws)
<Page: test_page>, <Page: test_page_2>, <Page: test_page_3>

Contributing

Development takes place on Github. You can file bug reports and pull requests there.