用于使用类似google阅读器的api的库
librssreader的Python项目详细描述
#自述文件 librssreader基于matthew behrens的原创作品libgreader<;askedrelic@gmail.com>;。它是面向开发人员的python包。通过简单的配置更改和少量的代码,我们希望它能够支持所有google reader api,比如rss阅读器,比如‘inoreader/the old reader/feedly’等等,rss阅读器还没有死!默认情况下,库将支持inoreader,并且易于扩展以支持其他rss阅读器。
libgreader是一个基本的可配置python库,用于验证和与非官方的google reader api交互。它目前支持所有主要的用户身份验证方法(clientlogin,oauth2),旨在简化google reader提供的许多功能。
根据麻省理工学院的许可证获得许可:[http://www.opensource.org/licenses/mit-license.php](
##功能
- 支持所有谷歌推荐的身份验证方法,以便于与现有Web或桌面应用程序 集成
- 对大多数google reader api端点的解释,google从未真正开放过这些端点
- 使用这些端点的便捷功能和模型
- 一个适度的集成测试套件!
##用法
很简单:
>>> from librssreader.inoreader import RssReader, ClientAuthMethod, Item >>> auth = ClientAuthMethod('YOUR USERNAME','YOUR PASSWORD') >>> reader = RssReader(auth) >>> print reader.getUserInfo() {u'userName': u'Foo', u'userEmail': u'librssreadertest@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 librssreader
或
$ easy_install librssreader
##注意
旧的读卡器配置现在无法进行试井,可能无法工作。现在它只是一个如何将库扩展到其他rssreader的示例。如有任何贡献,将不胜感激。
##测试和贡献
想测试一下还是做些改变?
首先,分叉github上的存储库,对私有分支进行更改。 然后,使用virtualenv创建开发环境:
$ pip install virtualenvwrapper $ mkvirtualenv venv-librreader –no-site-packages
签出叉子,然后运行测试:
$ python setup.py test
现在走开!编写测试,显示错误已修复或功能按预期工作。然后发送一个pull请求并给我设置bug,直到它被合并并发布。
##谢谢
最初创建于:
[https://github.com/askedrelic/libgreader/](libgreader)
#历史记录
##v0.1.0-尚未发布 -使API域可配置 -默认情况下支持inoreader api
#libgreader的历史
##第0.8.0版- -使api端点可配置
##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并正确接收身份验证令牌。 *下拉订阅列表。