rtsimple 0.9.0

腐烂番茄的包装材料api

rtsimple是用python编写的一个包装器，用于腐烂的西红柿（rt）api。通过调用rtsimple中提供的方法，您可以简化代码并轻松访问大量电影数据，包括详细的电影信息、新发行的电影和DVD列表、评论家和观众评分以及已发布的评论。要了解更多关于烂番茄api的信息，请查看欢迎页面http://developer.rottentomatoes.com和概述页面http://developer.rottentomatoes.com/docs。

功能

• 支持并在Python2.7.6、3.3.5和3.4.0下测试
• rtsimple和rt方法之间的一对一映射。
• 实现所有RT方法。
• 使用python类属性很容易访问数据。
• 很容易在python解释器中尝试rtsimple方法。
• 用unittests测试的代码，它演示了方法调用语法。

安装

rtsimple可在位于https://pypi.python.org/pypi/rtsimple的python包索引（pypi）上找到。

您可以使用以下技术之一安装rtsimple。

• 使用pip:

pip install rtsimple

• 从pypi下载.zip或.tar.gz文件并自行安装
• 下载source from Github并自行安装

如果您自己安装，也可以安装requests。

API键

你需要一个腐烂番茄的api密钥才能访问api。要获取密钥，请执行以下步骤：

1. 注册并验证account。
2. Log into你的帐户。
3. 登录后，单击指向apply for an api key的链接并按照说明进行操作。

示例

安装了rtsimple包和一个rt api密钥后，就可以开始播放数据了。

首先，导入包并分配api_密钥。

>>>importrtsimpleasrt>>>rt.API_KEY='YOUR API KEY HERE'

要与rottentomatons（rt）api通信，请创建一个对象类型的实例，调用实例上的一个方法，然后访问实例属性。使用键访问作为字典的属性值。在这个例子中，我们搜索标题中有hunger games的电影，并确定这个系列的第二部分《着火》的烂番茄id。

>>>movie=rt.Movies()>>>response=movie.search(q="Hunger Games")>>>len(movie.movies)4>>>forminmovie.movies:...print(m['title'])...TheHungerGamesTheHungerGames:CatchingFireTheHungerGames:Mockingjay-Part1TheHungerGames:Mockingjay-Part2>>>movie.movies[1]['id']'771250004'

一旦我们有了rt id，我们就可以创建一个movie实例来具体表示该movie并检查其属性。

>>>movie=rt.Movies('771250004')>>>response=movie.info()>>>movie.title'The Hunger Games: Catching Fire'>>>movie.mpaa_rating'PG-13'>>>movie.genres['Action & Adventure','Science Fiction & Fantasy']>>>movie.runtime146>>>movie.ratings['critics_score']89>>>movie.ratings['audience_score']92

为了好玩，可以为其他hunger games电影获得评分，并确定哪些电影被评论家认为是该系列中最好的。

调用其他实例方法来收集其他信息。在这个例子中，我们发现一些电影被认为类似于饥饿游戏：着火。上榜的是原版电影，这一点也不奇怪，还有一部哈利波特电影，这是一个惊喜。

>>>response=movie.similar()>>>len(movie.movies)2>>>forminmovie.movies:...print(m['title'])...TheHungerGamesHarryPotterandtheDeathlyHallows-Part1

除了提取有关特定电影的详细信息外，您还可以从rottentotherostapi中获取电影和dvd列表。假设您想知道“movies in theaters列表”是否与即将推出的“dvd列表”有任何共同之处。请注意，rt api列表是定期更新的，因此您的结果可能与下面的不同。

>>>lst=rt.Lists()>>>response=lst.movies_in_theaters()>>>lst.total127>>>forminlst.movies[:5]:...print(m['title'])...TheLegendofHerculesTheHobbit:TheDesolationOfSmaugFrozenLoneSurvivorAnchorman2:TheLegendContinues>>>response=lst.dvds_upcoming()>>>lst.total72>>>forminlst.movies[:5]:...print(m['title'])...RiddickCarrieLeeDaniels' The ButlerEnoughSaidYou're Next

对于前5个条目，似乎没有任何重叠。为了好玩，请创建影院中电影列表和即将发行的DVD列表的完整列表，并确定列表是否重叠。

请注意，您可以调用方法并获取详细信息，而无需显式实例化对象。

>>>response=rt.Movies(771250004).info()>>>response['alternate_ids']{'imdb':'1951264'}

如果您喜欢这个包装器，并且希望访问更多的电影和电视数据，请查看电影数据库api v3的包装器tmdbsimplehttps://pypi.python.org/pypi/tmdbsimple。