用于使用google reader api的库

libgreader的Python项目详细描述


#libgreader自述文件 libgreader是一个python库,用于验证和与非官方的google reader api交互。它目前支持所有主要的用户身份验证方法(clientlogin,oauth2),旨在简化google reader提供的许多功能。rss还没死(但google reader可能死了)!

根据麻省理工学院的许可证授权:[http://www.opensource.org/licenses/mit-license.php](

##现状 截至2013年3月,谷歌计划在2013年7月1日关闭谷歌阅读器,这使得这个库不再那么有用。

有计划在几个开源项目中重新创建google reader api,因此也许这个库可以被扩展以支持多个api。目前,作者正等待着看到事情的发展,以及什么样的行动方案最有意义。

##功能

  • 支持所有谷歌推荐的身份验证方法,以便于与现有Web或桌面应用程序
  • 集成
  • 对大多数google reader api端点的解释,google从未真正开放过这些端点
  • 使用这些端点的便捷功能和模型
  • 一个适度的集成测试套件!

##用法

很简单:

>>> from libgreader import GoogleReader, ClientAuthMethod, Feed
>>> auth = ClientAuthMethod('YOUR USERNAME','YOUR PASSWORD')
>>> reader = GoogleReader(auth)
>>> print reader.getUserInfo()
{u'userName': u'Foo', u'userEmail': u'libgreadertest@gmail.com', u'userId': u'16058940398976999581', u'userProfileId': u'100275409503040726101', u'isBloggerUser': False, u'signupTimeSec': 0, u'isMultiLoginEnabled': False}`

有关所有身份验证方法的更多示例,请参见[用法文件](https://github.com/askedrelic/libgreader/blob/master/USAGE.md)。

##安装

libgreader位于pypi上的[http://pypi.python.org/pypi/libgreader/](http://pypi.python.org/pypi/libgreader/

$ pip install libgreader

$ easy_install libgreader

##测试和贡献

想测试一下还是做些改变?

首先,分叉github上的存储库,对私有分支进行更改。 然后,使用virtualenv创建开发环境:

$ pip install virtualenvwrapper $ mkvirtualenv venv-libgreader –no-site-packages

签出叉子,然后运行测试:

$ python setup.py test

现在走开!编写测试,显示错误已修复或功能按预期工作。然后发送一个pull请求并给我设置bug,直到它被合并并发布。

##谢谢

最初是在以下位置的帮助下创建的:

[http://blog.martindoms.com/2009/08/15/using-the-google-reader-api-part-1/](

[http://code.google.com/p/pyrfeed/wiki/GoogleReaderAPI](

[http://groups.google.com/group/fougrapi](

从那时起,[许多人对libgreader的发展做出了贡献](https://github.com/askedrelic/libgreader/blob/master/AUTHORS.md)。

#历史记录

##第0.8.0版- -使api端点可配置

##V0.7.1-2013年6月14日 -由于https://github.com/stephenmcd

##V0.7.0-2013年3月18日 -现在需要请求>;1.0(请求现在用于所有http请求) -Python3.3兼容性(Python2.6、2.7和3.3的测试套件通过) -不赞成OAuth 1.0身份验证方法(Google不赞成它2012年4月20日https://developers.google.com/accounts/docs/OAuth) -翻录谷歌阅读器:(

##V0.6.3-2013年2月20日 -添加对添加/删除标记事务能力的支持,以批量编辑项目上的标记 -为许多容器调用添加since/until参数支持 -使用feed containers loaditems()调用添加对loadlimit参数的支持

##V0.6.2-2012年10月11日 -用oauth2 auth,https://github.com/askedrelic/libgreader/issues/11修复损坏的post()方法

##V0.6.1-2012年8月13日 -清除sdist包内容,不包括测试 -除非您使用的是gapdecoratorauthmethod,否则将httplib2作为必需导入删除

##V0.6.0-2012年8月10日 *OAuth2支持 *不赞成OAuth支持 *添加了对带有gapdecoratorauthmethod的google应用程序引擎的身份验证支持 *内部代码重组

##V0.5-2010年12月29日 *将项目添加到pypi,移动到真正的python项目结构 *样式清理,更多测试

##V0.4-2010年8月10日 许多改进:

  • 管理特殊订阅源(阅读列表、共享、加星、好友…)
  • 管理类别(获取所有项目,标记为已读)
  • 管理订阅源(获取项目、未读内容、标记为已读,“获取更多内容”)
  • 管理项目(获取并标记已读、星型、共享)

以及:

  • 如果不使用OAuth2,则不需要它
  • 用json替换所有xml调用

##V0.3-2010年3月7日 *所有对google的请求都使用https *已清理格式,应主要符合PEP8 *固定随机Unicode问题 *增加了许可

##V0.2-2009年10月27日 *已将所有get请求移动到私有便利方法 *增加了一些基本数据调用

##V0.1-2009年10月27日 *连接到GR并正确接收身份验证令牌。 *下拉订阅列表。

欢迎加入QQ群-->: 979659372 Python中文网_新手群

推荐PyPI第三方库


热门话题
Java中ArrayList的超简单问题   Java 8在一段时间后过期   java如何创建具有用户定义维度的矩阵,并使用从上到下、从左到右的递增值填充它?   java从JDBC重启mysql   带有sqlite的java LiveData未更新UI   带有JDialog的java小程序在Mac OSX中未正确隐藏   java ActionListener无法从公共类引用数组?   java Apache Digester:NoSuchMethodException:没有这样的可访问方法   安卓中数据库中的java数据没有以正确的格式检索   java快速排序实现:使用random pivot时几乎排序   安卓 Java:高效的ArrayList过滤?   java如何在单独的文件中制作GUI程序   jasper报告如何从JSP或Java代码在JasperReport中传递参数值?