README.md

   1 #### Unofficial Python interface for Diaspora\* social network
   2
   3 `diaspy` is a set of modules which form an Python interface to the API of
   4 Disapora\* social network.
   5
   6 Test suite will cause problems when run with 2.x so testing should be done
   7 using python3 interpreter.
   8
   9 Object oriented design of `diaspy` makes it easily reusable by other
  10 developers who want to use only part of the interface and create derivative
  11 works from it.
  12
  13 Developrs who don't like the design of `diaspy` and want to create something better
  14 can use only `diaspy.connection.Connection()` object as it is capable of
  15 doing everything. Other modules are just layers that provide easier access to
  16 parts of the Diaspora\* API.
  17
  18 ----
  19
  20 #### Quick intro
  21
  22 #### 1. Posting text to your stream
  23
  24 You only need two objects to do this: `Stream()` and `Connection()`.
  25
  26     >>> import diaspy
  27     >>> c = diaspy.connection.Connection(pod='https://pod.example.com',
  28     ...                                  username='foo',
  29     ...                                  password='bar')
  30     >>> c.login()
  31     >>> stream = diaspy.models.Stream(c)
  32     >>> stream.post('Your first post')
  33
  34
  35 #### 2. Reference implementation
  36
  37 There is no official reference implementation of D\* client using `diaspy`.
  38 The `diaspy.client` module is no longer maintained and will be removed in the future.
  39
  40 However, there is a small script written that uses `diaspy` as its backend.
  41 Look for `diacli` in marekjm's repositories on GitHub.
  42
  43 ----
  44
  45 To get more information about how the code works read
  46 documentation (`./doc/` directory) and manual (`./manual/` directory).