peerreach 0.1

peerreach

peerreach is a python library to access the api from http://peerreach.com

For more infor about the api go to http://peerreach.com/api/overview

The last source code ant hte bugtracking is at http://bitbucket.org/ferranp/peerreach

Install

Install using pip:

pip install peerreach

or using easy_install:

easy_install peerreach

Usage

By now the api does not requre authentiation, so to use is:

import peerreach

api = peerreach.Api()

# lookup one user by screen name userdata = api.lookup_user(screen_name=”user”)

# lookup one user by user_id userdata = api.lookup_user(user_id=12345)

# lookup various users by screen name usersdata = api.lookup_user(screen_names=(“user1”, “user2”))

# lookup various users by user_ids usersdata = api.lookup_user(user_ids=(12345, 54321))

The data returned is a dictionary containing the data returned by the api. You can change the deserializer to get the raw api response or the response as an object:

import peerreach

# with raw data api = peerreach.Api(parser=peerreach.RawPArser()) rawdata = api.lookup_user(screen_name=”user”)

# with object api = peerreach.Api(parser=peerreach.ObjectPArser()) objectdata = api.lookup_user(screen_name=”user”)

Command Line

The package also includes a command line tool to test the api:

$ peerreach –help Usage: peerreach [options] screen_name [screen_name…]

Options:

--version

show program’s version number and exit

-h, --help

show this help message and exit

-i, --ids

Use twitter ids instead of screen name

-r, --raw

Show raw peerreach api output