Sha256: 7b282d46d574fd3fd42234cfbf2a017c3a2fc8a88127c8b5327bdcf114e6eefd

Contents?: true

Size: 1.97 KB

Versions: 6

Compression:

Stored size: 1.97 KB

Contents

module CineworldUk
  # The object representing a film on the Cineworld UK website
  class Film
    include Comparable

    # @return [String] the name of the film
    attr_reader :name
    # @return [String] the normalized slug derived from the film name
    attr_reader :slug

    # @param [String] name the film name
    # @return [CineworldUk::Film]
    def initialize(name)
      @name = name
      @slug = name.downcase.gsub(/[^0-9a-z ]/, '').gsub(/\s+/, '-')
    end

    # All currently listed films showing at a cinema
    # @param [Integer] cinema_id id of the cinema on the website
    # @return [Array<CineworldUk::Film>]
    def self.at(cinema_id)
      whatson_parser(cinema_id).films_with_screenings.map do |html|
        new(screenings_parser(html).film_name)
      end
    end

    # Allows sort on objects
    # @param [CineworldUk::Film] other another film object
    # @return [Integer] -1, 0 or 1
    def <=>(other)
      slug <=> other.slug
    end

    # Check an object is the same as another object.
    # @param [CineworldUk::Film] other another film
    # @return [Boolean] True if both objects are the same exact object, or if
    #   they are of the same type and share an equal slug
    # @note Guided by http://woss.name/2011/01/20/equality-comparison-and-ordering-in-ruby/
    def eql?(other)
      self.class == other.class && self == other
    end

    # Generates hash of slug in order to allow two records of the same type and
    # id to work with something like:
    #
    #   [Film.new('ABC'), Film.new('DEF')] & [Film.new('DEF'), Film.new('GHI')]
    #   #=> [ Film.new('DEF') ]
    #
    # @return [Integer] hash of slug
    # @note Guided by http://woss.name/2011/01/20/equality-comparison-and-ordering-in-ruby/
    def hash
      slug.hash
    end

    private

    def self.screenings_parser(html)
      CineworldUk::Internal::FilmWithScreeningsParser.new(html)
    end

    def self.whatson_parser(id)
      CineworldUk::Internal::WhatsonParser.new(id)
    end
  end
end

Version data entries

6 entries across 6 versions & 1 rubygems

Version Path
cineworld_uk-2.0.5 lib/cineworld_uk/film.rb
cineworld_uk-2.0.4 lib/cineworld_uk/film.rb
cineworld_uk-2.0.3 lib/cineworld_uk/film.rb
cineworld_uk-2.0.2 lib/cineworld_uk/film.rb
cineworld_uk-2.0.1 lib/cineworld_uk/film.rb
cineworld_uk-2.0.0 lib/cineworld_uk/film.rb