py-soocial 0.2.1

简介

这个包为Soocial developer API提供了一个python包装器。Soocial是一张网 通过跨多个设备同步来促进联系人管理的服务。

基本用法

导入Soocial并提供您的Soocial电子邮件和密码：

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

您可以使用以下API：

• {TT1}$：是否存在与ID^ {TT2}$的联系？
• def __iter__()：对于soo中的联系人：使用联系人进行操作
• def __len__()：没有联系人=len（soo）
• def __nonzero__()：如果soo：做事
• def __getitem__(id)：mycontact=soo[id]
• def __setitem__(id, postdata)：soo[id]={…}n.b.相当有限的ATM
• 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)：获取联系人的url列表
• 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不支持HEAD请求，这对于检查 不产生额外的请求大小开销^ ^ TT21}$
的存在性
• /contact*rest似乎是错误的：使用POST进行add和PUT进行编辑
• 参数名与返回的xml元素名不对应（即：first_name 变成given-name
• 对联系人包含的元素（电子邮件、URL、电话等）的写访问权限 似乎没有文档记录的那样工作；事实上，有一些 有关正确URL和正确参数的文档