uzver 0d7d881c70 Initial commit %!s(int64=7) %!d(string=hai) anos
..
diaspy 0d7d881c70 Initial commit %!s(int64=7) %!d(string=hai) anos
docs 0d7d881c70 Initial commit %!s(int64=7) %!d(string=hai) anos
manual 0d7d881c70 Initial commit %!s(int64=7) %!d(string=hai) anos
.gitignore 0d7d881c70 Initial commit %!s(int64=7) %!d(string=hai) anos
Changelog.markdown 0d7d881c70 Initial commit %!s(int64=7) %!d(string=hai) anos
LICENSE 0d7d881c70 Initial commit %!s(int64=7) %!d(string=hai) anos
Makefile 0d7d881c70 Initial commit %!s(int64=7) %!d(string=hai) anos
README.md 0d7d881c70 Initial commit %!s(int64=7) %!d(string=hai) anos
logger.py 0d7d881c70 Initial commit %!s(int64=7) %!d(string=hai) anos
requirements.txt 0d7d881c70 Initial commit %!s(int64=7) %!d(string=hai) anos
setup.py 0d7d881c70 Initial commit %!s(int64=7) %!d(string=hai) anos
test-image.png 0d7d881c70 Initial commit %!s(int64=7) %!d(string=hai) anos
testconf.markdown 0d7d881c70 Initial commit %!s(int64=7) %!d(string=hai) anos
tests.py 0d7d881c70 Initial commit %!s(int64=7) %!d(string=hai) anos
tox.ini 0d7d881c70 Initial commit %!s(int64=7) %!d(string=hai) anos

README.md

Unofficial Python interface for Diaspora* social network

Diaspy on PyPI

diaspy is a set of modules which form an Python interface to the API of Disapora* social network.

Test suite will cause problems when run with 2.x so testing should be done using python3 interpreter.

Object oriented design of diaspy makes it easily reusable by other developers who want to use only part of the interface and create derivative works from it.

Developrs who don't like the design of diaspy and want to create something better can use only diaspy.connection.Connection() object as it is capable of doing everything. Other modules are just layers that provide easier access to parts of the Diaspora* API.


Dependencies

List of software diaspy requires to run. Versions used by maintainer are the ones available in stock Arch x86_64 repositories.

python

Version: 3.3.3 Website

python-requests

Version: 2.1.0 Website


Quick intro

1. Posting text to your stream

You only need two objects to do this: Stream() and Connection().

>>> import diaspy
>>> c = diaspy.connection.Connection(pod='https://pod.example.com',
...                                  username='foo',
...                                  password='bar')
>>> c.login()
>>> stream = diaspy.streams.Stream(c)
>>> stream.post('Your first post')

2. Reference implementation

There is no official reference implementation of D* client using diaspy. The diaspy.client module is no longer maintained and will be removed in the future.

However, there is a small script written that uses diaspy as its backend. Look for diacli in marekjm's repositories on GitHub.


To get more information about how the code works read documentation (./doc/ directory) and manual (./manual/ directory).