The Whos

Instalacion

Instalar a través de Rubygems

gem install the_whos

Accede a la biblioteca en Ruby:

require 'the_whos'

Api Key IMDB

Para poder realizar llamadas se requiere ingresar la clave de la api de IMDB, para obtener una clave gratuita tiene que registrase en el sitio de la API, IMDB API, las cuentas gratuitas tienen un límite de 100 consultas por día. Pará poder utilizar la clave se tiene que pasar el valor en la línea de comandos antes de ejecutar el script.

$ ruby example.rb  k_12345678

Class Title

Esta clase se encarga de almacenar la información de la llamada de los títulos. Pará instancia el objeto se puede hacer a través de Title.new o TheWhos.create pasando como parámetro el ID de el título de IMDB.

movie = Title.new('tt0088763')

movie = TheWhos.create('tt0088763')

Método id

Devuelve el ID del título.

movie = Title.new('tt0088763')
movie.id

# => "tt0088763"

Método title

Devuelve el título.

movie = Title.new('tt0088763')
movie.title

# => "Back to the Future"

Método cast

Devuelve un array con los 10 actores principales

movie = Title.new('tt0088763')
movie.cast

Método fullcast

Devuelve un array con el reparto completo del título.

movie = Title.new('tt0088763')
movie.fullcast

Método plot

Devuelve la sinopsis del título, se puede pasar como valor el idioma en el que se desee la respuesta, el valor por defecto es en inglés.

movie = Title.new('tt0088763')
movie.plot('es')

Class Actor

Esta clase se encarga de almacenar la información de la llamada de los actores. Pará instancia el objeto se puede hacer a través de Actor.new o TheWhos.create pasando como parámetro el ID de el actor de IMDB.

fox = Actor.new('nm0000150')

fox = TheWhos.create('nm0000150')

Método id

Devuelve el ID del actor.

fox = Actor.new('nm0000150')
fox.id

# => "nm0000150"

Método name

Devuelve el nombre del actor.

fox = Actor.new('nm0000150')
fox.name

# => "Michael J. Fox"

Método known

Devuelve un array de las películas mas conocidas del actor.

fox = Actor.new('nm0000150')
fox.known

Método cast

Devuelve todas las películas en las que el actor a participado.

fox = Actor.new('nm0000150')
fox.cast

Class TheWhos

Está es la clase principal para trabajar con la información obtenida de las consultas la api de IMDB.

Método create

Con este método se puede instanciar un objeto, detecta automáticamente si es una película o un actor y crea la clase correspondiente.

movie = TheWhos.create('tt0088763')
fox = TheWhos.create('nm0000150')

Método search_title

Devuelve un array con el ID y título de la películas que coincidan con el parámetro.

rest = TheWhos.search_title('back to the future')

Método search_actor

Devuelve un array con el ID y nombre del actor que coincida con el parámetro.

rest = TheWhos.search_actor('michael fox')

Método match_actor

Devuelve un array con el ID y nombre de los actores que coincidan entre dos películas, si es que lo hay, se puede pasar como parámetro el ID del título de IMDB o un objeto ya instansiado de una película.

match = TheWhos.match_actor ('tt0088763','tt0101272')

Método match_title

Devuelve un array con el ID y nombre de las películas que coincidan entre dos actores, si es que lo hay, se puede pasar como parámetro el ID del actor de IMDB o un objeto ya instanciado de un actor.

match = TheWhos.match_title ('nm0000150', 'nm0000502')

Método who

Devuelve el personaje que interpreta un actor en una película, si es que actúa en esa película, se puede pasar como parámetros los ID de IMDB o los objetos ya instanciados.

charater = TheWhos.who ('tt0088763', 'nm0000150')

# => "Marty McFly"