BoxOfficeMojoAPI

#DEPRECATED Reason: Box Office Mojo's site format changes daily, causing inconsistent data scraping from this API.

Unofficial Python API for Box Office Mojo.

NOTE: This library and its author are not endorsed by or affiliated with BoxOfficeMojo.com.

#Usage

from bom import BOM, DAILY_CHART

bom = BOM(chart=DAILY_CHART)

for movie in bom.get_chart(limit=10):
    print (movie.rank, movie.title, movie.gross)

#API ##class BOM(chart=bom.DAILY_CHART) Get list of movies from Box Office Mojo. Available charts are:

bom.DAILY_CHART
bom.WEEKEND_CHART
bom.WEEKLY_CHART

###attribute BOM.date The chart date, represented as a datetime object ###BOM.weekend_chart(limit=10) Get movies from top box office charts from the past weekend. ###BOM.daily_chart(limit=10) Get movies from top box office charts for today. ##class Movie() Movie model for Box Office Mojo ###attribute Movie.movie_id The movie's ID on Box Office Mojo ###attribute Movie.rank The movie's current rank ###attribute Movie.title The title of the movie ###attribute Movie.studio The movie's producing studio ###attribute Movie.url The movie's URL on Box Office Movie ###attribute Movie.gross The movie's gross income Note: can be either weekend or daily gross, depending on which BOM method you called ###property Movie.gross_val The movie's gross income, represented as an integer ###Movie.weekend_trend() Get the movie's weekend trend as a list of tuples ###Movie.daily_trend() Get the movie's daily trend as a list of tuples (daily trend may be unavailable)

#Unit Tests To run the test suite, fork the project and set up the run script locally.

First, you will probably need to install the dependencies:

$ pip install -r requirements.txt

Then, locally set up the run script and run:

$ chmod 777 ./runtests.sh
$ ./runtests.sh

To run individual tests:

$ python -m unittest tests.<module name>

The first time you run these tests, the test suite will create a VCR.py cassette into tests/fixtures/vcr_cassettes, which records and saves any HTTP requests stubs made by the unittests. Any subsequent test runs will use the cassette instead of make another HTTP request.

jstncno/BoxOfficeMojoAPI

BoxOfficeMojoAPI