py-soocial 0.2.1

简介

此软件包提供了一个Python包装器，用于Soocial开发者API。 Soocial 是一个网络服务，通过跨多个设备同步来简化联系人管理。

基本用法

导入Soocial并为其提供Soocial电子邮件和密码

>>> from soocial import Soocial
>>> myemail = 'me@foo.com'
>>> mypassword '***'
>>> soo = Soocial(myemail, mypassword)

您有以下API可用

• def __contains__(id)：id为id的联系人是否存在？

• def __iter__()：for联系人 in soo: # 使用联系人进行操作

• def __len__()：联系人数量 = len(soo)

• def __nonzero__()：if soo: # 进行操作

• def __getitem__(id)：mycontact = soo[id]

• def __setitem__(id, postdata)：soo[id] = {…} # 注意：目前相当有限

• def __delitem__(id)：del soo[id]

• def add(postdata)：soo.add({…}) # 有限

• def get_all_vcards(parse=True)：获取所有联系人为vcard列表

• def get_vcard(id, parse=True)：获取联系人作为vcard

• def get_phones(id)：获取联系人的电话号码列表

• def get_emails(id): 获取联系人邮箱列表

• def get_urls(id): 获取联系人网址列表

• def get_addresses(id): 获取联系人地址列表

• def get_organisations(id): 获取联系人所属组织列表

• def get_user(): 获取少量用户数据

• def get_connection_phones(): 获取用户联系人的电话号码

示例用法

参见 soocial.client.Soocial.__doc__.

测试

要运行测试，创建一个空的soocial账户，临时将您的邮箱和密码写入.client.Soocial的文档字符串，然后运行

$ python setup.py nosetests --with-doctest

然后也许可以从文档字符串中删除您的邮箱和密码 ;)

注意

• API不支持< span class="docutils literal">HEAD请求，这对于检查存在性而不会产生额外的请求大小开销是有用的

• /contact* REST似乎是错误的方向：使用< span class="docutils literal">POST进行添加，使用< span class="docutils literal">PUT进行编辑

• 参数名称与返回的XML元素名称不对应（即：< span class="docutils literal">first_name变为< span class="docutils literal">given-name）

• 联系人包含的元素（邮箱、网址、电话等）的写访问似乎没有按文档工作；实际上，有一些关于正确URL和正确参数的文档将是有用的