movie_searcher 0.0.1 → 0.0.4

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    MovieSearcher (0.0.1)
+    movie_searcher (0.0.2)
       httparty
       levenshtein
 
@@ -26,7 +26,5 @@ PLATFORMS
   ruby
 
 DEPENDENCIES
-  MovieSearcher!
-  httparty
-  levenshtein
+  movie_searcher!
   rspec

data/README.md

@@ -1,26 +1,101 @@
-# ImdbParty!
+# MovieSearcher - *the almighty movie search gem*
 
-## How To Use
+## What is MovieSearcher
 
-### Create an instance
+MovieSearcher makes it possible to get information about a movie.
+It uses IMDB's API that their iPhone applications rely on.
 
-    imdb = ImdbParty::Imdb.new
-### Search for a movie by title
+It's build on top of [maddox's](https://github.com/maddox) [imdb-party](https://github.com/maddox/imdb-party) but adds some extra functionality and bugs fixes.
+
+## What makes this gem so awesome?
+MovieSearcher has a really cool feature (*method*) called `find_by_release_name` that makes it possible to search for a movie based on the release name.
+You can for example specify ***Heartbreaker 2010 LIMITED DVDRip XviD-SUBMERGE*** and it will return the not to good [*Heartbreaker*](http://www.imdb.com/title/tt1465487/) by [*Pascal Chaumeil*](http://www.imdb.com/name/nm0154312/)
+
+## So how do I use it?
 
-    imdb.find_by_title("The Dark Knight") => [{:title => "The Dark Knight", :year => "2008", :imdb_id => "tt0468569"}, {:title => "Batman Unmasked", ...}]
+### Start by installing the gem
+
+    sudo gem install movie_searcher
+Start `irb` and include the gem, `require 'movie_searcher'`
+
+### Search for a movie by title
 
-### Get a movie by its imdb_id
+    $ MovieSearcher.find_by_title("The Dark Knight")
+    => [#<ImdbParty::Movie:0x1012a5858 @imdb_id="tt0468569", @year="2008", @title="The Dark Knight" ... >, ...]
 
-    movie = imdb.find_movie_by_id("tt0468569")
+### Get a movie by its imdb id
 
-    movie.title => "The Dark Knight"
-    movie.rating => 8.1
-    movie.certification => "PG-13"
+    $ movie = MovieSearcher.find_movie_by_id("tt0468569")
+    $ movie.title 
+    => "The Dark Knight"
+    $ movie.rating 
+    => 8.9
+    $ movie.certification 
+    => "PG-13"
 
 ### Find the top 250 movies of all time
 
-    imdb.top_250 => [{:title => "Shawshank Redemption", :year => "1994", :imdb_id => "tt0111161"}, {:title => "The Godfather", ...}]
+    $ MovieSearcher.top_250 
+    => [#<ImdbParty::Movie:0x10178ef68 @imdb_id="tt0111161", @poster_url="http://ia.media-imdb.com/images/M/MV5BMTM2NjEyNzk2OF5BMl5BanBnXkFtZTcwNjcxNjUyMQ@@._V1_.jpg" ... >, ...]
 
 ### Get the currently popular tv shows
 
-    imdb.popular_shows => [{:title => "Glee", :year => "2009", :imdb_id => "tt1327801"}, {:title => "Dexter", ...}]
+    $ MovieSearcher.popular_shows 
+    => [#<ImdbParty::Movie:0x101ff2858 @imdb_id="tt1327801", @poster_url="http://ia.media-imdb.com/images/M/MV5BMTYxMjYxNjQxNl5BMl5BanBnXkFtZTcwNTU5Nzk4Mw@@._V1_.jpg", @year="2009", @title="Glee">, ... ]
+    
+### Search for a release name
+    
+    $ MovieSearcher.find_by_release_name("Heartbreaker 2010 LIMITED DVDRip XviD-SUBMERGE").imdb_id 
+    => tt1465487
+
+### Some configure alternatives
+You can pass some options to the `find_by_release_name` method to specify how it should behave.
+
+Here is an example.
+
+    $ MovieSearcher.find_by_release_name("Heartbreaker 2010 LIMITED DVDRip XviD-SUBMERGE", :options => {:limit => 0.1, :details => true}) 
+
+- ** :limit ** (Float) It defines how sensitive the parsing algorithm should be. Where 0.0 is super sensitive and 1.0 is don't care. The default value is 0.4 and workes in most cases. If you dont get any hits at all, try a large value.
+- ** :details ** (Boolean) By default, the `find_by_release_name` only returns the most basic information about a movie, like *imdb_id*, *title* and *year*. If you set this to true, it will do another request to IMDB and get the casts, actors, rating and so on.
+
+** The option param can't be passed to `find_by_title` **
+
+** `find_movie_by_id` don't require that you pass the `:details` option to get all data **
+
+## What is being returned?
+
+The `find_by_title` method returns an `Array` of `ImdbParty::Movie` objects.
+
+These are the accessors of `ImdbParty::Movie`
+
+- **imdb_id** (String) The imdb id of the movie.
+- **title** (String) The title of the movie.
+- **directors** (Array) Related directors.
+- **writers** (Array) Related writers.
+- **tagline** (String) The movie tagline.
+- **company** (String) Company who made the movie.
+- **runtime** (String) The length of the movie, `120 min` for example.
+- **rating** (Float) The movie rating, from 0 to 10.
+- **poster_url** (String) Movie poster. **Beaware**, this image might expire. Use [tmdb_party](https://github.com/jduff/tmdb_party) if you want posters and images.
+- **release_date** (Date) The release date of the movie.
+- **certification** (String) The certification of the movie, *R* for example.
+- **genres** (Array) The most relevant generes for the movie.
+- **actors** (Array) Related actors.
+- **trailers** (Hash) Related trailers. The key defines the quality of the trailer, like `H.264 480x360` and the value specify the url.
+
+The `actors`, `writers` and `directors` accessors returns an `ImdbParty::Person` object that has the following accessors.
+
+- **imdb_id** (String) The imdb id of the person.
+- **role** (String) What role did the actor have in the movie. This is only set when working with an actor.
+- **name** (String) The actual name of the actor.
+
+## This sounds supr, how do I help?
+
+- Start by copying the project or make your own branch.
+- Navigate to the root path of the project and run `bundle`.
+- Start by running all tests using rspec, `rspec spec/movie_searcher_spec.rb`.
+- Implement your own code, write some tests, commit and do a pull request.
+
+## Requirements
+
+The gem is tested in OS X 10.6.6 using Ruby 1.8.7.

data/lib/{movie_searcher/movie_searcher.rb → movie_searcher.rb}

@@ -1,7 +1,9 @@
-require "#{File.dirname(__FILE__)}/../imdb_party.rb"
+require "imdb_party"
 require 'levenshtein'
 
 class MovieSearcher
+  attr_accessor :options
+  
   def initialize(args)
     args.keys.each { |name| instance_variable_set "@" + name.to_s, args[name] unless name == :options }
     
@@ -19,7 +21,11 @@ class MovieSearcher
     this = MovieSearcher.new(options.merge(:search_value => search_value.to_s))
     return if this.to_long?
     
-    return this.find_the_movie!
+    movie = this.find_the_movie!
+    return if movie.nil?
+    
+    # If the user wants for information about the movie, the {options[:details]} option should be true
+    this.options[:details] ? self.find_movie_by_id(movie.imdb_id) : movie
   end
   
   def to_long?
@@ -55,8 +61,8 @@ class MovieSearcher
     return ImdbParty::Movie.new(movie.first)
   end
   
-  def self.method_missing(m, *args, &block)  
-    result = ImdbParty::Imdb.new.send(m, *args)
+  def self.method_missing(method, *args, &block)  
+    result = ImdbParty::Imdb.new.send(method, *args)
     return if result.nil?
     result.class == Array ? result.map{|r| ImdbParty::Movie.new(r)} : result
   end

data/movie_searcher.gemspec

@@ -3,11 +3,11 @@ $:.push File.expand_path("../lib", __FILE__)
 
 Gem::Specification.new do |s|
   s.name        = "movie_searcher"
-  s.version     = "0.0.1"
+  s.version     = "0.0.4"
   s.platform    = Gem::Platform::RUBY
   s.authors     = ["Linus Oleander", "Jon Maddox"]
   s.email       = ["linus@oleander.nu", "jon@mustacheinc.com"]
-  s.homepage    = "https://github.com/oleander/Undertexter"
+  s.homepage    = "http://github.com/oleander/MovieSearcher"
   s.summary     = %q{IMDB client using the IMDB API that their iPhone app uses}
   s.description = %q{IMDB client using the IMDB API that their iPhone app uses. It can also figure out what movie you are looking for just by looking at the release name of the movie}
 

data/spec/movie_searcher_spec.rb

@@ -42,6 +42,14 @@ describe MovieSearcher do
   it "should return nil if nil is being passed to it" do
     MovieSearcher.find_by_release_name(nil).should be_nil
   end
+  
+  it "should not have a rating if the details option isn't being passed" do
+    MovieSearcher.find_by_release_name('Paranormal Activity 2 2010 UNRATED DVDRip XviD-Larceny').rating.should be_nil
+  end
+  
+  it "should return a rating if the detail option is being passed" do
+    MovieSearcher.find_by_release_name('Paranormal Activity 2 2010 UNRATED DVDRip XviD-Larceny', :options => {:details => true}).rating.should_not be_nil
+  end
 end
 
 describe MovieSearcher, "should work as before" do

data/spec/spec_helper.rb

@@ -1,5 +1,5 @@
 require 'rspec'
-require "#{File.dirname(__FILE__)}/../lib/movie_searcher/movie_searcher.rb"
+require "#{File.dirname(__FILE__)}/../lib/movie_searcher.rb"
 
 RSpec.configure do |config|
   config.mock_with :rspec

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: movie_searcher
 version: !ruby/object:Gem::Version 
-  hash: 29
-  prerelease: false
+  hash: 23
+  prerelease: 
   segments: 
   - 0
   - 0
-  - 1
-  version: 0.0.1
+  - 4
+  version: 0.0.4
 platform: ruby
 authors: 
 - Linus Oleander
@@ -86,12 +86,12 @@ files:
 - lib/imdb_party/imdb.rb
 - lib/imdb_party/movie.rb
 - lib/imdb_party/person.rb
-- lib/movie_searcher/movie_searcher.rb
+- lib/movie_searcher.rb
 - movie_searcher.gemspec
 - spec/movie_searcher_spec.rb
 - spec/spec_helper.rb
 has_rdoc: true
-homepage: https://github.com/oleander/Undertexter
+homepage: http://github.com/oleander/MovieSearcher
 licenses: []
 
 post_install_message: 
@@ -120,7 +120,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: 
-rubygems_version: 1.3.7
+rubygems_version: 1.4.2
 signing_key: 
 specification_version: 3
 summary: IMDB client using the IMDB API that their iPhone app uses