|pypi| |pyversions| |license| |travis|
.. |pypi| image:: https://img.shields.io/pypi/v/imdbpy.svg?style=flat-square
:target: https://pypi.org/project/imdbpy/
:alt: PyPI version.
.. |pyversions| image:: https://img.shields.io/pypi/pyversions/imdbpy.svg?style=flat-square
:target: https://pypi.org/project/imdbpy/
:alt: Supported Python versions.
.. |license| image:: https://img.shields.io/pypi/l/imdbpy.svg?style=flat-square
:target: https://github.com/alberanid/imdbpy/blob/master/LICENSE.txt
:alt: Project license.
.. |travis| image:: https://travis-ci.org/alberanid/imdbpy.svg?branch=master
:target: https://travis-ci.org/alberanid/imdbpy
:alt: Travis CI build status.
IMDbPY is a Python package for retrieving and managing the data
of the IMDb_ movie database about movies, people and companies.
.. admonition:: Revamp notice
:class: note
Starting on November 2017, many things were improved and simplified:
- moved the package to Python 3 (compatible with Python 2.7)
- removed dependencies: SQLObject, C compiler, BeautifulSoup
- removed the "mobile" and "httpThin" parsers
- introduced a test suite (
please help with it!_)
Main features
-
written in Python 3 (compatible with Python 2.7)
-
platform-independent
-
can retrieve data from both the IMDb's web server, or a local copy
of the database -
simple and complete API
-
released under the terms of the GPL 2 license
IMDbPY powers many other software and has been used in various research papers.
Curious about that_?
Installation
Whenever possible, please use the latest version from the repository::
pip install git+https://github.com/alberanid/imdbpy
But if you want, you can also install the latest release from PyPI::
pip install imdbpy
Example
Here's an example that demonstrates how to use IMDbPY:
.. code-block:: python
from imdb import IMDb
create an instance of the IMDb class
ia = IMDb()
get a movie
movie = ia.get_movie('0133093')
print the names of the directors of the movie
print('Directors:')
for director in movie['directors']:
print(director['name'])
print the genres of the movie
print('Genres:')
for genre in movie['genres']:
print(genre)
# search for a person name
people = ia.search_person('Mel Gibson')
for person in people:
print(person.personID, person['name'])
Getting help
Please refer to the support_ page on the project homepage_
and to the the online documentation on Read The Docs_.
The sources are available on GitHub_.
License
Copyright (C) 2004-2019 Davide Alberani <da --> mimante.net> et al.
IMDbPY is released under the GPL license, version 2 or later.
Read the included LICENSE.txt_ file for details.
NOTE: For a list of persons who share the copyright over specific portions of code, see the CONTRIBUTORS.txt_ file.
NOTE: See also the recommendations in the DISCLAIMER.txt_ file.
.. _IMDb: https://www.imdb.com/
.. _please help with it!: http://imdbpy.readthedocs.io/en/latest/devel/test.html
.. _Curious about that: https://imdbpy.github.io/ecosystem/
.. _project homepage: https://imdbpy.github.io/
.. _support: https://imdbpy.github.io/support/
.. _Read The Docs: https://imdbpy.readthedocs.io/
.. _GitHub: https://github.com/alberanid/imdbpy
.. _LICENSE.txt: https://raw.githubusercontent.com/alberanid/imdbpy/master/LICENSE.txt
.. _CONTRIBUTORS.txt: https://raw.githubusercontent.com/alberanid/imdbpy/master/CONTRIBUTORS.txt
.. _DISCLAIMER.txt: https://raw.githubusercontent.com/alberanid/imdbpy/master/DISCLAIMER.txt