上一节中创建了一个initclient包，封装了授权的过程，通过获取的myAPIClient对象可以直接调用API接口进行微博操作，上一节中就调用了发微博的接口发了一条新微博。这一节还是直接使用initclient包，调用获取关注好友或粉丝的API来获取好友数据，并将实现的获取好友信息的功能封装在getfriends.py中，然后实现了main.py调用了其中的接口，获取了好友信息并打印出来，运行的结果如图1所示。

图1

【说明】：

(1)可以看出，授权过程跟上一节完全一样，是从文件中读取的上一次成功授权的access_token，没有重新进行授权；

(2)以列表的形式输出了好友的几项主要信息：uid，性别，屏幕名称和个人描述。

下面看一下getfriends.py的源码：

#! /usr/bin/python

import time

PAGE_SIZE = 200

def print_users_list(ul):

"""

打印用户列表的详细信息

"""

index = 0

for user in ul:

uid = user["id"]

ugen = user["gender"]

uname = user["screen_name"]

#uloc = user["location"]

udesc = user["description"]

print "%-6d%-12d%-3s%s%s" % (index, uid, ugen, uname.ljust(20), udesc.ljust(40))

index += 1

def get_friends(client, uid=None, maxlen=0):

"""

读取uid用户的关注用户列表，默认uid=None，此时uid赋值为client.uid，而client.uid表示的是当前授权用户的uid.

"""

if not uid:

uid = client.uid

return get_users(client, False, uid, maxlen)

def get_followers(client, uid=None, maxlen=0):

"""

读取uid用户的粉丝列表，默认uid=None，此时uid赋值为client.uid，而client.uid表示的是当前授权用户的uid.

"""

if not uid:

uid = client.uid

return get_users(client, True, uid, maxlen)

def get_users(client, followersorfriends, uid, maxlen):

"""

调用API读取uid用户的关注用户列表或者粉丝列表，followersorfriends为True读取粉丝列表，为False读取关注好友列表，

参数maxlen设置要获取的好友列表的最大长度，为0表示没有设置最大长度，此时会尝试读取整个好友列表，但是API对于读取的

好友列表的长度会有限制，测试等级最大只能获取一个用户的5000条好友信息。

"""

fl = []

next_cursor = 0

while True:

if followersorfriends:

raw_fl = client.friendships.followers.get(uid=uid, cursor=next_cursor, count=PAGE_SIZE)

else:

raw_fl = client.friendships.friends.get(uid=uid, cursor=next_cursor, count=PAGE_SIZE)

fl.extend(raw_fl["users"])

next_cursor = raw_fl["next_cursor"]

if not next_cursor:

break

if maxlen and len(fl) >= maxlen:

break

time.sleep(1)

return fl

【说明】：

(1)该模块中一共4个函数，get_friends和get_followers分别为获取关注好友和粉丝的接口，print_users_list为打印好友详细信息的接口。get_users为调用API的实现函数；

(2)获取关注好友和获取粉丝的API非常相似，前者是client.friendships.friends.get，后者是client.friendships.followers.get，所以我二者封装在get_users函数中，通过参数followersorfriends表示要获取的类型，接口get_followers和get_friends调用该函数，分别传入True和False；

(3)get_users函数的最后一个参数maxlen设置要获取的好友列表的最大长度，因为用户的好友列表有可能非常长，不需要全部获取时就可以设置maxlen。如果maxlen为0表示没有设置最大长度，此时会尝试读取整个好友列表，为什么说是“尝试”呢？因为API对于好友列表的获取时有限制的，测试等级最大只能获取一个用户的5000条好友信息(这个在官方文档中有说明)；

(4)调用API时有一个参数count=PAGE_SIZE，因为该API读取好友列表时是按页读取的，该参数表示页的大小(即好友信息条数)，默认为50，最大为200，这里设置为200，这些官方文档中都有详细说明；

(5)调用API时有一个参数cursor，表示要读取下一页的首条记录序号，每成功读取一页数据，数据中都包含了next_cursor属性，下次继续读取时从next_cursor开始读，关于cursor的详细情况可以阅读官方的API手册；

(6)print_users_list打印好友详细信息，其实详细信息项目非常的多，这里只是打印了其中的几项，可以根据自己的需要修改。

下面看一下main.py的源代码：

#! /usr/bin/python

from initclient import initclient

import getfriends

APP_KEY = '2024******'

APP_SECRET = '91a57*************************'

CALLBACK = 'http://bingbingrobot.sinaapp.com/'

def main():

client = initclient.get_client(APP_KEY, APP_SECRET, CALLBACK)

print "===> creat client successfully, authorised uid is : ", client.uid

print "============================== users ==========================="

#读取当前授权用户的粉丝列表

fl = getfriends.get_followers(client)

#读取当前授权用户的关注好友列表

#fl = getfriends.get_friends(client)

#读取uid为‘1497035431’的用户的粉丝列表

#uid = '1497035431'#梁斌penny

#fl = getfriends.get_followers(client, uid=uid)

getfriends.print_users_list(fl)

if __name__ == '__main__':

main()

【说明】：

有了授权模块initclient和获取好友模块getfriends.py，main.py的内容就非常简单了。创建myAPIClient对象，调用getfriends模块的get_friends或get_followers接口获取好友数据，然后调用print_users_lis接口打印。非常简单，不在啰嗦了！

【总结】：

这两节中创建的initclient模块和getfriends模块都可以复用，开发其他功能时都可以直接使用，例如要对好友信息进行统计(如统计男女比例、兴趣分布、地区分布等)时，先用getfriends模块获取好友列表。

By: