mediacloud 3.6.5

mediacloud python api客户端

这是一个用于访问MediaCloud API v2的python客户机。 我们支持python版本2.7和3.6。

用法

第一个sign up for an API key。然后

pip install mediacloud

查看CHANGELOG.md以获取详细的更改历史记录。

示例

了解去年美国顶级在线新闻网站中提到“津巴布韦”的报道有多少：

importmediacloud.apimc=mediacloud.api.MediaCloud('MY_API_KEY')res=mc.storyCount('zimbabwe AND president AND tags_id_media:58722749','publish_date:[NOW-1YEAR TO NOW]')print(res['count'])# prints the number of stories found

从纽约时报获取有关2018年某个主题的2000篇报道，并将输出转储到json:

importmediacloud.api,json,datetimemc=mediacloud.api.MediaCloud('MY_API_KEY')fetch_size=500stories=[]last_processed_stories_id=0whilelen(stories)<2000:fetched_stories=mc.storyList('trump AND "north korea" AND media_id:1',solr_filter=mc.publish_date_query(datetime.date(2018,1,1),datetime.date(2019,1,1)),last_processed_stories_id=last_processed_stories_id,rows=fetch_size)stories.extend(fetched_stories)iflen(fetched_stories)<fetch_size:breaklast_processed_stories_id=stories[-1]['processed_stories_id']print(json.dumps(stories))

在2013年提到“津巴布韦”和“总统”的美国顶级在线新闻网站的报道中找到最常用的词汇：

importmediacloud.api,datetimemc=mediacloud.api.MediaCloud('MY_API_KEY')words=mc.wordCount('zimbabwe AND president AND tags_id_media:58722749',mc.publish_date_query(datetime.date(2013,1,1),datetime.date(2014,1,1)))print(words[0])# prints the most common word

按ID查找有关某个特定故事的所有详细信息：

importmediacloud.apimc=mediacloud.api.MediaCloud('MY_API_KEY')story=mc.story(169440976)print(story['url'])# prints the url the story came from

将前100篇文章从一天中保存到数据库：

importmediacloud.api,datetimemc=mediacloud.api.MediaCloud('MY_API_KEY')db=mediacloud.storage.MongoStoryDatabase('one_day')stories=mc.storyList('*',mc.publish_date_query(datetime.date(2014,01,01),datetime.date(2014,01,02)),last_processed_stories_id=0,rows=100)[db.addStory(s)forsinstories]print(db.storyCount())

查看mediacloud/test/模块中的测试以获取更详细的示例。

开发

如果您对向该模块添加代码感兴趣，请首先克隆the GitHub repository。

测试

您需要创建一个MC_API_KEY环境变量并将其设置为您的api密钥（我们使用^{}）。 然后运行make test。我们运行持续集成（通过Travis）， 所以每次推送都会运行整个测试套件（我们也每晚在prs上这样做）。

分发新版本

如果需要，请设置twin's keyring integration以避免键入您的pypi 密码一遍又一遍。

1. 运行make test以确保所有测试通过
2. 更新mediacloud/__init__.py中的版本号
3. 在changelog.md中简要记录更改内容
4. 运行make build-release创建安装包
5. 运行make release-test将其上载到pypi的测试平台
6. 运行make release将其上载到pypi

标签：

• key
• api
• id
• 客户端
• datetime
• date
• mc
• 媒体
• stories
• mediacloud

欢迎加入QQ群-->： 979659372

推荐PyPI第三方库

• Attic

  重复数据消除备份

• django-tasker-account

  django tasker帐户-django的扩展用户系统

• chaim-cli

  Centrica Chaim AWS账户

• python-printer-escpos

  用于escpos打印机的python接口

• epic-theme

  史诗管理主题

• docassemble.webapp

  docassemble系统的web应用程序组件。

• whichp

  蟒当量

• django-cmskit

  一个用户电脑扩展收藏。

• ikalman

  Ikalman C库的Python绑定

• django-apiblueprint-tests

  django rest framework测试生成器基于api blueprint（https://apilueprint.org/）文档。

• liboidcagent

  用于从oidc代理请求openid connect访问令牌的python库。

• Flask-Coffee

  把你的酒瓶装满咖啡。

• yaycl-crypt

  yaml配置自动加载程序加密支持

• tm.mio.reader.ctm

  主题地图包的压缩主题地图（CTM）阅读器

• proliphix

  Proliphix NT10e网络恒温器的API。