:mod:`movie_query` -- Get Actor/Movie Information
==================================================================

.. module:: movie_query
   :platform: Ubuntu Linux
   :synopsis: Query a locally stored database of Movie/Actor
	      information.
.. moduleauthor:: Scotty Smith <chssmith@roanoke.edu>
.. function:: get_movies_for_actor(actor_name)

   How to find out what movies in which an actor starred.  For
   example, to query for the movies of **Billy Dee Williams**::

      movie_query.get_movies_for_actor("Billy Dee Williams")


   Would return the following data::

      ['Lady Sings the Blues', 'Classic Creatures: Return of the
      Jedi', 'Robot Chicken: Star Wars Episode III', 'The Final
      Comedown', 'The Jacksons: An American Dream', 'Hit!', 'Number
      One with a Bullet', "Brian's Song", 'Mask of Death', 'Oceans of
      Fire', 'Fear Runs Silent', 'The Bingo Long Traveling All-Stars &
      Motor Kings', 'Batman', 'Fear City', 'Driving Me Crazy 1991',
      'The Ladies Man', 'Chiefs', 'Fanboys', 'Courage', 'Secret Agent
      00 Soul', 'Scott Joplin', 'Star Wars: Episode V - The Empire
      Strikes Back', 'Marked for Murder', 'Black Brigade', 'Moving
      Target', 'Time Bomb', 'Nighthawks', 'Triplecross', 'Epoch:
      Evolution', 'Falling For You', 'Deadly Illusion', 'Mahogany',
      'Star Wars: Episode VI - Return of the Jedi', 'Alien Intruder',
      'Steel Sharks', 'Star Wars: Episode VII', 'The Contract',
      'Constellation']
      

   :param string actor_name: The name of an actor.
   :returns: A list of movies in which specified actor starred. 

.. function:: get_actors_for_movie(movie_title)

   How to find out what actors starred in a movie.  For example, to
   query for the actors of the upcoming **Star Wars VII** movie::
     
     movie_query.get_actors_for_movie("Star Wars VII")

   Would return the following data::

     ['Harrison Ford', 'Carrie Fisher', 'Mark Hamill', 'Billy Dee
     Williams', 'Anthony Daniels']


   :param string movie_title: The title of a movie.
   :returns: A list of actors that starred in the specified movie.

.. function:: get_actors()

   Get a list of all actors stored in the database.

   :returns: A list of actors, as strings.

.. function:: get_movies()

   Get a list of all movies stored in the database.

   :returns: A list of movies, as strings.