kinopoisk_parser 1.0.3 → 1.0.4

checksums.yaml

@@ -1,15 +1,15 @@
 ---
 !binary "U0hBMQ==":
   metadata.gz: !binary |-
-    NDFiMTk5NjRlZjk2Mjk1NjIyMzhkYWFmYzI2NWQyODgzNTkwOGUxNA==
+    MDM1MGUwYTYyZmE4OGZlOGFhOTIyZDYwYjY0N2ZjYjI0MTE0OWUyYQ==
   data.tar.gz: !binary |-
-    NzRmYzQxNjRhODRlNTFlNWQ0ZDE1ZTNiMDA2MzA0NjZhZGM1MGUwZg==
+    MmMyMzIxNzYyNzM2YzU5YzVmZmQyMTY3N2E0ZWZjNWMxODE3ZTc4NQ==
 !binary "U0hBNTEy":
   metadata.gz: !binary |-
-    ZTFhZDJlMDY5MTdlMjY3NDE2YjIxMGE0MDc5NDkzYjlhN2NkOTNlYWQxNjBj
-    MWJjMDA3MDdhMjFlZjMwZmU1ODk5MzdjMzUwNzgyNTAxZDM1MTU0YzM4MmNi
-    MTExZDdmMjFlZTdiYjRlMDViMWNkYTQ3M2Q5YWEyZDQzYzE1NzQ=
+    ZDg0YjI2YjJhYjFhZmE5MDIwNDg4N2JkMjZlNDA0NDY0NGU2ZGRmZGMxMTQy
+    ZWZlMmRkOTczYjNkYzA2MzUxZTU2NTU4ZDQ4ZDhmZjBjZTM5M2MzMDUzYzRh
+    ZGFiYTM3NDIzNjEzZmVlNmMyMjYxYzA4MDBmMTBkZjI1MjBjYWI=
   data.tar.gz: !binary |-
-    MjBhNWFiZGQ2MjRiZDE5MGUwYTk5ZjFlMDZlMThkYTJjMjcyNWZjNTRjZDY3
-    MTc0NDhmNzkwNjAzYTFhNGJhMzA5ZDllMWE3YjhiMTk1NTY2MWIxM2NhNDhj
-    NDljZDZhYjBjOTM0NzU0OTVhNzJmYzk5ODZkNThlYWUzYmU1NjQ=
+    M2E0MGQ3MDVmNmZlZmRkNjhjNDRlN2FkYTcwOTg5Njc2ZjljZWM2NjZlYWVj
+    ZjJjZmNjNDhkN2M5NDgyN2UzNmE3OGI0MTUzNTM1MDkwZWI0YjUzNDRiZDhj
+    ZmMxYjdlZDVmZTBjZWU3ODI4NjNiY2I1ODIyNzQxYjNhNDRhMTk=

data/kinopoisk_parser.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |gem|
   gem.name          = 'kinopoisk_parser'
-  gem.version       = '1.0.3'
+  gem.version       = '1.0.4'
   gem.authors       = ['RavWar']
   gem.email         = ['rav_war@mail.ru']
   gem.homepage      = 'https://github.com/RavWar/kinopoisk_parser'

data/lib/kinopoisk/movie.rb

@@ -3,7 +3,9 @@ module Kinopoisk
   class Movie
     attr_accessor :id, :url, :title
 
-    # New object can be initialized with id(integer) or title(string).
+    # New instance can be initialized with id(integer) or title(string). Second
+    # argument may also receive a string title to make it easier to
+    # differentiate Kinopoisk::Movie instances.
     #
     #   Kinopoisk::Movie.new 277537
     #   Kinopoisk::Movie.new 'Dexter'
@@ -17,115 +19,143 @@ module Kinopoisk
       @title = title
     end
 
+    # Returns an array of strings containing actor names
     def actors
       doc.search('td.actor_list div a').map{|n| n.text.gsub("\n",'').strip}
         .delete_if{|text| text=='...'}
     end
 
+    # Returns a string containing title in russian
     def title
       @title ||= doc.search('.moviename-big').xpath('text()').text.strip
     end
 
+    # Returns an integer imdb rating vote count
     def imdb_rating_count
       doc.search('div.block_2 div:last').text.gsub(/[ ()]/, '').to_i
     end
 
+    # Returns a float imdb rating
     def imdb_rating
       doc.search('div.block_2 div:last').text[/\d.\d\d/].to_f
     end
 
+    # Returns an integer release year
     def year
       doc.search("table.info a[href*='/m_act%5Byear%5D/']").text.to_i
     end
 
+    # Returns an array of strings containing countries
     def countries
       doc.search("table.info a[href*='/m_act%5Bcountry%5D/']").map(&:text)
     end
 
+    # Returns a string containing budget for the movie
     def budget
       doc.search("//td[text()='бюджет']/following-sibling::*//a").text
     end
 
-    def gross_ru
+    # Returns a string containing Russia box-office
+    def box_office_ru
       doc.search("td#div_rus_box_td2 a").text
     end
 
-    def gross_us
+    # Returns a string containing USA box-office
+    def box_office_us
       doc.search("td#div_usa_box_td2 a").text
     end
 
-    def gross_world
+    # Returns a string containing world box-office
+    def box_office_world
       doc.search("td#div_world_box_td2 a").text
     end
 
+    # Returns a url to a small sized poster
     def poster
       doc.search("img[itemprop='image']").first.attr 'src'
     end
 
+    # Returns a string containing world premiere date
     def premiere_world
       doc.search('td#div_world_prem_td2 a:first').text
     end
 
+    # Returns a string containing Russian premiere date
     def premiere_ru
       doc.search('td#div_rus_prem_td2 a:first').text
     end
 
+    # Returns a float kinopoisk rating
     def rating
       doc.search('span.rating_ball').text.to_f
     end
 
+    # Returns a url to a big sized poster
     def poster_big
       poster.gsub 'film', 'film_big'
     end
 
+    # Returns an integer length of the movie in minutes
     def length
       doc.search('td#runtime').text.to_i
     end
 
+    # Returns a string containing title in english
+    def title_en
+      search_by_itemprop 'alternativeHeadline'
+    end
+
+    # Returns a string containing movie description
+    def description
+      search_by_itemprop 'description'
+    end
+
+    # Returns an integer kinopoisk rating vote count
+    def rating_count
+      search_by_itemprop('ratingCount').to_i
+    end
+
+    # Returns an array of strings containing director names
     def directors
       to_array search_by_itemprop 'director'
     end
 
+    # Returns an array of strings containing producer names
     def producers
       to_array search_by_itemprop 'producer'
     end
 
+    # Returns an array of strings containing composer names
     def composers
       to_array search_by_itemprop 'musicBy'
     end
 
+    # Returns an array of strings containing genres
     def genres
       to_array search_by_itemprop 'genre'
     end
 
-    def title_en
-      search_by_itemprop 'alternativeHeadline'
-    end
-
-    def description
-      search_by_itemprop 'description'
-    end
-
-    def rating_count
-      search_by_itemprop('ratingCount').to_i
-    end
-
+    # Returns an array of strings containing writer names
     def writers
       to_array search_by_text 'сценарий'
     end
 
+    # Returns an array of strings containing operator names
     def operators
       to_array search_by_text 'оператор'
     end
 
+    # Returns an array of strings containing art director names
     def art_directors
       to_array search_by_text 'художник'
     end
 
+    # Returns an array of strings containing editor names
     def editors
       to_array search_by_text 'монтаж'
     end
 
+    # Returns a string containing movie slogan
     def slogan
       search_by_text 'слоган'
     end

data/lib/kinopoisk/person.rb

@@ -3,60 +3,80 @@ module Kinopoisk
   class Person
     attr_accessor :id, :url, :name
 
+    # New instance can be initialized with id(string or integer) and an optional
+    # name to make it easier to differentiate Kinopoisk::Person instances.
+    #
+    #   Kinopoisk::Person.new 13180
+    #
+    # Request to kinopoisk is made once and on the first access to a remote data.
+    #
     def initialize(id, name=nil)
       @id   = id
       @url  = "http://www.kinopoisk.ru/name/#{id}/"
       @name = name
     end
 
+    # Returns a url to a poster
     def poster
       doc.search('img.people_thumbnail').first.attr 'src'
     end
 
+    # Returns a string containing name in russian
     def name
       @name ||= doc.search('.moviename-big').text
     end
 
+    # Returns a string containing name in english
     def name_en
       doc.search("//tr[./td/h1[@class='moviename-big']]/following-sibling::tr//span").text
     end
 
+    # Returns a string containing partner's name
     def partner
       doc.search("//td[@class='type'][contains(text(),'супруг')]/following-sibling::*").text
     end
 
+    # Returns a birthdate date object
     def birthdate
       Date.strptime doc.search("td.birth").first.attr 'birthdate'
     end
 
+    # Returns a string containing birthplace
     def birthplace
       search_by_text('место рождения').split(', ').first
     end
 
+    # Returns an array of strings containing genres
     def genres
       search_by_text('жанры').split(', ')
     end
 
+    # Returns an array of strings containing career professions
     def career
       search_by_text('карьера').split(', ')
     end
 
+    # Returns an integer total movie count
     def total_movies
       search_by_text('всего фильмов').to_i
     end
 
+    # Returns an array of strings containing best movie titles
     def best_movies
       doc.search('td.actor_list a').map(&:text)
     end
 
+    # Returns a string containing year of first movie
     def first_movie
       search_by_text 'первый фильм'
     end
 
+    # Returns a string containing year of last movie
     def last_movie
       search_by_text 'последний фильм'
     end
 
+    # Returns a string containing height
     def height
       search_by_text 'рост'
     end

data/lib/kinopoisk/search.rb

@@ -8,10 +8,12 @@ module Kinopoisk
       @url   = SEARCH_URL + query.to_s
     end
 
+    # Returns an array containing Kinopoisk::Movie instances
     def movies
       find_nodes('film').map{|n| new_movie n }
     end
 
+    # Returns an array containing Kinopoisk::Person instances
     def people
       find_nodes('people').map{|n| new_person n }
     end

data/lib/kinopoisk_parser.rb

@@ -13,6 +13,7 @@ module Kinopoisk
     HTTPClient.new.get url, nil, { 'User-Agent'=>'a', 'Accept-Encoding'=>'a' }
   end
 
+  # Returns a nokogiri document or an error if fetch response status is not 200
   def self.parse(url)
     p = fetch url
     p.status==200 ? Nokogiri::HTML(p.body.encode('utf-8')) : raise(NotFound)

data/spec/kinopoisk/movie_spec.rb

@@ -29,11 +29,11 @@ describe Kinopoisk::Movie, vcr: { cassette_name: 'movies' } do
   it { dexter.imdb_rating.should be_a(Float) }
   it { dexter.rating_count.should be_a(Integer) }
   it { dexter.rating.should be_a(Float) }
-  it { dexter.gross_ru.should eq('') }
+  it { dexter.box_office_ru.should eq('') }
 
-  it { avatar.gross_world.should match('[$\d]') }
-  it { avatar.gross_ru.should match('[$\d]') }
-  it { avatar.gross_us.should match('[$\d]') }
+  it { avatar.box_office_world.should match('[$\d]') }
+  it { avatar.box_office_ru.should match('[$\d]') }
+  it { avatar.box_office_us.should match('[$\d]') }
   it { avatar.budget.should eq("$237 000 000") }
   it { avatar.length.should eq(162) }
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kinopoisk_parser
 version: !ruby/object:Gem::Version
-  version: 1.0.3
+  version: 1.0.4
 platform: ruby
 authors:
 - RavWar