merlin_uk 1.0.0

data/README.md

@@ -0,0 +1,157 @@
+# MerlinUk
+
+A simple gem to pull cinemas and performances from the [Merlin Cinemas website](https://www.merlincinemas.co.uk) and spit out useful formatted info.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'merlin_uk'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install merlin_uk
+
+## Usage
+
+The gem conforms to the API set down in the `cinebase` gem, [andycroll/cinebase](https://github.com/andycroll/cinebase), which provides a lot of useful base vocabulary and repetitive code for this series of cinema focussed gems.
+
+Performance titles are sanitized as much as possible, removing years, the
+Bring Your Own Baby prefix, film society and special screening prefixes, Q&A
+and "at The Ritz" suffixes, and naming National Theatre Live, Royal Ballet
+and Opera and Met Opera screenings in full.
+
+No token or setup is needed. The website has no API: each venue's home
+page lists its whole schedule in HTML. Tickets are sold through each venue's
+Admit One site.
+
+### Cinema
+
+The website lists its venues and cinema codes in a menu but gives addresses
+only on each venue's information page, and no coordinates, so the gem holds
+them: names and codes from the menu, addresses from the information pages,
+and coordinates from OpenStreetMap or, for the Ritz in Penzance, the New
+Central in Torquay and the Strand in Rhyl, which it does not map, the
+postcode. Cinema methods make no requests.
+
+``` ruby
+MerlinUk::Cinema.all
+#=> [<MerlinUk::Cinema ...>, <MerlinUk::Cinema ...>, ...]
+
+cinema = MerlinUk::Cinema.new('MER_REDR')
+#=> <MerlinUk::Cinema ...>
+
+cinema.adr
+#=> {
+  street_address:   'Fore Street',
+  extended_address: nil,
+  locality:         'Redruth',
+  region:           'Cornwall',
+  postal_code:      'TR15 2AZ',
+  country_name:     'United Kingdom'
+}
+
+cinema.brand
+#=> 'Merlin'
+
+cinema.name
+#=> 'Regal Cinema & Theatre, Redruth'
+
+cinema.full_name
+#=> 'Merlin Regal Cinema & Theatre, Redruth'
+
+cinema.id
+#=> 'MER_REDR'
+
+cinema.latitude
+#=> 50.233212
+
+cinema.url
+#=> 'https://redruth.merlincinemas.co.uk'
+```
+
+### Performances
+
+`Performance.at` returns performances for an inclusive range of showing dates,
+defaulting to today in London and the following 13 days. The venue's home
+page holds every advertised date, so any range is one request.
+
+``` ruby
+MerlinUk::Performance.at('MER_REDR', from: Date.today, to: Date.today + 2)
+#=> [<MerlinUk::Performance ...>, <MerlinUk::Performance ...>, ...]
+
+performance = MerlinUk::Performance.at('MER_REDR').first
+#=> <MerlinUk::Performance ...>
+
+performance.film_name
+#=> 'No Trees No Seas' # from 'No Trees No Seas with Q&A'
+
+performance.film_year
+#=> nil # from the title, e.g. 1960 for 'Picture House presents Psycho (1960)'
+
+performance.dimension
+#=> '2d'
+
+performance.variant
+#=> ['q&a']
+
+performance.subtitled?
+#=> false
+
+performance.starting_at
+#=> 2026-11-12 19:30:00 UTC
+
+performance.booking_url
+#=> 'https://merlinredruth.admit-one.eu/?p=tickets&perfCode=93005'
+
+performance.cinema_name
+#=> 'Regal Cinema & Theatre, Redruth'
+
+performance.cinema_id
+#=> 'MER_REDR'
+```
+
+Booking links are the website's own, to the venue's Admit One site, which
+redirects to seat selection.
+
+Variants come from each booking link's icons, the website's event cinema
+marker and titles: `arts` (event cinema: theatre, opera, ballet, concerts
+and art), `baby` (Bring Your Own Baby), `q&a`, `relaxed` (autism friendly)
+and `subtitled`. Super Saver prices, luxury seats, private boxes and
+licensed screenings are not variants.
+
+Live stage shows, which the website marks with a theatre icon, are not
+films and are left out. Mostly these are at the Regal in Redruth and the
+Ritz in Penzance.
+
+## Tests
+
+```sh
+bundle exec rake          # unit tests against fixtures
+bundle exec rake live     # live merlincinemas.co.uk
+```
+
+The fixtures in `test/fixtures` are the Redruth and Galashiels home pages,
+trimmed to a few films without the page's head and navigation.
+`test/support/page_shapes.rb` describes the markup the gem reads. The unit
+suite checks the fixtures against it and the live suite checks every
+venue's real page, held only in memory. When the website changes, update
+the shape first, then the fixtures.
+
+## Releasing
+
+Bump the version, merge, then run the **Release Gem** workflow in GitHub
+Actions. It runs the tests, tags the version and publishes the gem through
+RubyGems trusted publishing.
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/lib/merlin_uk/cinema.rb

@@ -0,0 +1,189 @@
+module MerlinUk
+  # The object representing a cinema on the Merlin Cinemas website
+  class Cinema < Cinebase::Cinema
+    # @!attribute [r] id
+    #   @return [String] the website's cinema code, e.g. 'MER_REDR'
+
+    # The website lists its venues and codes in a menu but gives addresses
+    # only on each venue's information page, and no coordinates, so the gem
+    # holds them: names and codes from the menu, addresses from the
+    # information pages, coordinates from OpenStreetMap or, where it has no
+    # venue, the postcode.
+    VENUES = {
+      'MER_BODM' => {
+        name: 'Capitol Cinema, Bodmin', subdomain: 'bodmin', street_address: 'Mount Folly Square',
+        locality: 'Bodmin', region: 'Cornwall', postal_code: 'PL31 2DB', latitude: 50.470563, longitude: -4.719178
+      },
+      'MER_HELS' => {
+        name: 'Flora Cinema, Helston', subdomain: 'helston', street_address: '17 Wendron Street',
+        locality: 'Helston', region: 'Cornwall', postal_code: 'TR13 8PT', latitude: 50.101288, longitude: -5.273108
+      },
+      'MER_FALM' => {
+        name: 'Phoenix Cinema, Falmouth', subdomain: 'falmouth', street_address: '11 Berkeley Vale',
+        locality: 'Falmouth', region: 'Cornwall', postal_code: 'TR11 3PL', latitude: 50.15405, longitude: -5.074337
+      },
+      'MER_REDR' => {
+        name: 'Regal Cinema & Theatre, Redruth', subdomain: 'redruth', street_address: 'Fore Street',
+        locality: 'Redruth', region: 'Cornwall', postal_code: 'TR15 2AZ', latitude: 50.233212, longitude: -5.229744
+      },
+      'MER_STIV' => {
+        name: 'Royal Cinema, St. Ives', subdomain: 'st-ives', street_address: 'Royal Square',
+        locality: 'St Ives', region: 'Cornwall', postal_code: 'TR26 2ND', latitude: 50.211081, longitude: -5.481897
+      },
+      'MER_PENZ' => {
+        name: 'Savoy Cinema, Penzance', subdomain: 'penzance', street_address: '16 Causewayhead',
+        locality: 'Penzance', region: 'Cornwall', postal_code: 'TR18 2SN', latitude: 50.119726, longitude: -5.538722
+      },
+      'MER_RITZ' => {
+        name: 'The Ritz, Penzance', subdomain: 'ritz', street_address: '4 Queen Street',
+        locality: 'Penzance', region: 'Cornwall', postal_code: 'TR18 4BJ', latitude: 50.117616, longitude: -5.536687
+      },
+      'MER_ILFR' => {
+        name: 'Embassy Cinema, Ilfracombe', subdomain: 'ilfracombe', street_address: '134 High Street',
+        locality: 'Ilfracombe', region: 'Devon', postal_code: 'EX34 9EZ', latitude: 51.208405, longitude: -4.121911
+      },
+      'MER_KING' => {
+        name: 'Kings Cinema, Kingsbridge', subdomain: 'kingsbridge', street_address: 'Fore Street',
+        locality: 'Kingsbridge', region: 'Devon', postal_code: 'TQ7 1PP', latitude: 50.285613, longitude: -3.778093
+      },
+      'MER_OKEH' => {
+        name: 'New Carlton Cinema, Okehampton', subdomain: 'okehampton', street_address: 'Market Street',
+        locality: 'Okehampton', region: 'Devon', postal_code: 'EX20 1HN', latitude: 50.739349, longitude: -4.003581
+      },
+      'MER_TORQ' => {
+        name: 'New Central Cinema, Torquay', subdomain: 'torquay', street_address: '90-96 Union Street',
+        locality: 'Torquay', region: 'Devon', postal_code: 'TQ2 5PY', latitude: 50.467185, longitude: -3.530679
+      },
+      'MER_TIVE' => {
+        name: 'Tivoli Cinema, Tiverton', subdomain: 'tiverton', street_address: '23 Fore Street',
+        locality: 'Tiverton', region: 'Devon', postal_code: 'EX16 6LD', latitude: 50.902181, longitude: -3.486483
+      },
+      'MER_COLE' => {
+        name: 'Studio Cinema, Coleford', subdomain: 'coleford', street_address: '14 High Street',
+        locality: 'Coleford', region: 'Gloucestershire', postal_code: 'GL16 8HF',
+        latitude: 51.792524, longitude: -2.617573
+      },
+      'MER_CROM' => {
+        name: 'Regal Movieplex, Cromer', subdomain: 'cromer', street_address: '2-4 Hans Place',
+        locality: 'Cromer', region: 'Norfolk', postal_code: 'NR27 9EQ', latitude: 52.930769, longitude: 1.300493
+      },
+      'MER_REDC' => {
+        name: 'The Regent, Redcar', subdomain: 'redcar', street_address: 'Newcomen Terrace',
+        locality: 'Redcar', region: 'North Yorkshire', postal_code: 'TS10 1AU', latitude: 54.62059, longitude: -1.07025
+      },
+      'MER_WEST' => {
+        name: 'Plaza Cinema, Weston-super-Mare', subdomain: 'wsm', street_address: 'Walliscote Road',
+        locality: 'Weston-super-Mare', region: 'Somerset', postal_code: 'BS23 1US',
+        latitude: 51.346664, longitude: -2.975809
+      },
+      'MER_WELL' => {
+        name: 'Wellesley Cinema, Wellington', subdomain: 'wellington', street_address: 'Mantle Street',
+        locality: 'Wellington', region: 'Somerset', postal_code: 'TA21 8AU', latitude: 50.975938, longitude: -3.231092
+      },
+      'MER_AYRS' => {
+        name: 'Astoria Cinema, Ayr', subdomain: 'ayr', street_address: 'Burns Statue Square',
+        locality: 'Ayr', region: 'Ayrshire', postal_code: 'KA7 1UP', latitude: 55.457617, longitude: -4.628246
+      },
+      'MER_THUR' => {
+        name: 'Merlin Cinema, Thurso', subdomain: 'thurso', street_address: 'Ormlie Road',
+        locality: 'Thurso', region: 'Caithness', postal_code: 'KW14 7QU', latitude: 58.5863, longitude: -3.536282
+      },
+      'MER_GALA' => {
+        name: 'Pavilion Cinema, Galashiels', subdomain: 'galashiels', street_address: 'Market Street',
+        locality: 'Galashiels', region: 'Scottish Borders', postal_code: 'TD1 3AF',
+        latitude: 55.61554, longitude: -2.805527
+      },
+      'MER_PRES' => {
+        name: 'Scala Cinema, Prestatyn', subdomain: 'prestatyn', street_address: '47 High Street',
+        locality: 'Prestatyn', region: 'Denbighshire', postal_code: 'LL19 9AH', latitude: 53.33545, longitude: -3.404633
+      },
+      'MER_RHYL' => {
+        name: 'Strand Cinema, Rhyl', subdomain: 'rhyl', street_address: 'West Parade', extended_address: 'The Village',
+        locality: 'Rhyl', region: 'Denbighshire', postal_code: 'LL18 1HB', latitude: 53.322014, longitude: -3.492144
+      }
+    }.freeze
+
+    ADDRESS_PARTS = %i(street_address extended_address locality region postal_code).freeze
+
+    # Constructor
+    # @param [String] id the website's cinema code, e.g. 'MER_REDR' or 'mer_redr'
+    # @return [MerlinUk::Cinema]
+    def initialize(id)
+      @id = id.to_s.upcase
+    end
+
+    # Return basic cinema information for all cinemas
+    # @return [Array<MerlinUk::Cinema>]
+    # @example
+    #   MerlinUk::Cinema.all
+    #   #=> [<MerlinUk::Cinema>, <MerlinUk::Cinema>, ...]
+    def self.all
+      VENUES.keys.map { |id| new(id) }
+    end
+
+    # @!method address
+    #   Address of the cinema
+    #   @return [Hash] of different address parts
+    #   @see #adr
+
+    # Address of the cinema
+    # @return [Hash] contains :street_address, :extended_address,
+    # :locality, :region, :postal_code, :country_name
+    # @example
+    #   cinema = MerlinUk::Cinema.new('MER_RHYL')
+    #   cinema.adr
+    #   #=> {
+    #         street_address:   'West Parade',
+    #         extended_address: 'The Village',
+    #         locality:         'Rhyl',
+    #         region:           'Denbighshire',
+    #         postal_code:      'LL18 1HB',
+    #         country_name:     'United Kingdom'
+    #       }
+    # @note Uses method naming as at http://microformats.org/wiki/adr
+    def adr
+      ADDRESS_PARTS.to_h { |part| [part, venue[part]] }.merge(country_name: 'United Kingdom')
+    end
+
+    # Brand of the cinema
+    # @return [String] which will always be 'Merlin'
+    def brand
+      'Merlin'.freeze
+    end
+
+    # @return [Float, nil]
+    def latitude
+      venue[:latitude]
+    end
+
+    # @return [Float, nil]
+    def longitude
+      venue[:longitude]
+    end
+
+    # The name of the cinema
+    # @return [String]
+    # @example
+    #   MerlinUk::Cinema.new('MER_REDR').name
+    #   #=> 'Regal Cinema & Theatre, Redruth'
+    def name
+      venue[:name].to_s
+    end
+
+    # The url of the cinema's pages on the Merlin Cinemas website
+    # @return [String]
+    # @example
+    #   MerlinUk::Cinema.new('MER_REDR').url
+    #   #=> 'https://redruth.merlincinemas.co.uk'
+    def url
+      subdomain = venue[:subdomain]
+      subdomain ? "https://#{subdomain}.merlincinemas.co.uk" : ''
+    end
+
+    private
+
+    def venue
+      VENUES.fetch(id, {})
+    end
+  end
+end

data/lib/merlin_uk/internal/http.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require 'net/http'
+
+module MerlinUk
+  # Internal utility classes: Do not use
+  # @api private
+  module Internal
+    # Requests to merlincinemas.co.uk
+    module Http
+      RETRIES = 2
+      TRANSIENT_ERRORS = [
+        EOFError, Errno::ECONNRESET, Errno::ECONNREFUSED, Net::OpenTimeout, Net::ReadTimeout, OpenSSL::SSL::SSLError
+      ].freeze
+
+      private
+
+      def get(url)
+        uri = URI(url)
+        attempts = 0
+        begin
+          response = Net::HTTP.start(uri.host, uri.port, use_ssl: true, open_timeout: 10, read_timeout: 30) do |http|
+            http.request(Net::HTTP::Get.new(uri))
+          end
+        rescue *TRANSIENT_ERRORS
+          attempts += 1
+          raise if attempts > RETRIES
+
+          sleep(attempts)
+          retry
+        end
+        # Omit response bodies from errors, and never follow redirects.
+        raise "Merlin Cinemas HTTP error #{response.code}" unless response.is_a?(Net::HTTPSuccess)
+
+        String.new(response.body, encoding: Encoding::UTF_8)
+      end
+    end
+  end
+end

data/lib/merlin_uk/internal/parser/schedule.rb

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+
+module MerlinUk
+  # @api private
+  module Internal
+    module Parser
+      # Reads the full schedule on a venue's home page: a card for each film,
+      # each with dated rows of booking links. The page also repeats the
+      # schedule day by day, which this ignores.
+      class Schedule
+        FULL = /<div data-frame="full">(.*?)(?:<div data-frame="\d|\z)/m
+        CARD = /<div class="filmCard full" data-film="[^"]*">/
+        TITLE = %r{<h2 class="overlay">([^<]*)</h2>}
+        LISTING_ICON = %r{<img src="/images/(\w+)\.png" class="live_theatre"}
+        DATE_OR_LINK = %r{<h5>([^<]*)</h5>|<a href="([^"]*perfCode=\d+[^"]*)"[^>]*>(.*?)</a>}m
+        KEY = /data-key="([^"]+)"/
+        TIME = /(\d{1,2}):(\d{2})/
+        DATE = /(\d{1,2})(?:st|nd|rd|th) (#{Date::MONTHNAMES.compact.join('|')})(?: (\d{4}))?/
+        FIRST_DAY = /<li data-date="(\d{4}-\d{2}-\d{2})"/
+
+        # The site marks live stage shows, which are not films, with this
+        # icon, and screened theatre, opera and concerts with 'event_cinema'
+        STAGE_ICON = 'theatre'
+        TIME_ZONE = 'Europe/London'
+
+        # @param [String] html a venue's home page
+        def initialize(html)
+          @html = html
+        end
+
+        # Every screening in the full schedule, leaving out live stage shows.
+        # Each once, as featured films also appear again in the list.
+        # @return [Array<MerlinUk::Internal::Parser::Showing>]
+        # @raise [RuntimeError] when the page has no full schedule
+        def showings
+          full = @html[FULL, 1]
+          if full
+            all = full.split(CARD).drop(1).flat_map do |card|
+              icon = card[LISTING_ICON, 1]
+              icon == STAGE_ICON ? [] : card_showings(card, icon)
+            end
+            all.uniq(&:booking_url)
+          else
+            raise 'Merlin Cinemas page has no full schedule'
+          end
+        end
+
+        private
+
+        def card_showings(card, icon)
+          title = CGI.unescapeHTML(card[TITLE, 1].to_s).strip
+          date = nil
+          card.scan(DATE_OR_LINK).filter_map do |heading, href, link|
+            if heading
+              date = parse_date(heading)
+              nil
+            elsif date && (time = link.match(TIME))
+              Showing.new(title: title, event_cinema: !icon.nil?, starting_at: starting_at(date, time),
+                          booking_url: CGI.unescapeHTML(href), keys: link.scan(KEY).flatten.uniq)
+            end
+          end
+        end
+
+        # The site gives the year only for dates outside its current year
+        def parse_date(heading)
+          match = heading.match(DATE)
+          if match
+            day = match[1].to_i
+            month = Date::MONTHNAMES.index(match[2])
+            if match[3]
+              Date.new(match[3].to_i, month, day)
+            else
+              nearest_date(day, month)
+            end
+          end
+        end
+
+        def nearest_date(day, month)
+          years = (first_day.year - 1)..(first_day.year + 1)
+          dates = years.filter_map { |year| Date.new(year, month, day) if Date.valid_date?(year, month, day) }
+          dates.min_by { |date| (date - first_day).abs }
+        end
+
+        def first_day
+          @first_day ||= begin
+            iso = @html[FIRST_DAY, 1]
+            if iso
+              Date.iso8601(iso)
+            else
+              raise 'Merlin Cinemas page lists no days'
+            end
+          end
+        end
+
+        def starting_at(date, time)
+          local = Time.utc(date.year, date.month, date.day, time[1].to_i, time[2].to_i)
+          TZInfo::Timezone.get(TIME_ZONE).local_to_utc(local) { |periods| periods.first }.utc
+        end
+      end
+    end
+  end
+end

data/lib/merlin_uk/internal/parser/showing.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+module MerlinUk
+  # @api private
+  module Internal
+    module Parser
+      # One screening from a venue's full schedule
+      class Showing
+        # Booking link icons and the variants they mean. Others, such as
+        # 'access', 'licensed', 'luxury', 'box' (private boxes) and 'saver'
+        # (cheap tickets), are not variants.
+        KEYS = {
+          'autism' => 'relaxed',
+          'baby' => 'baby',
+          'subtitled' => 'subtitled'
+        }.freeze
+
+        TITLES = {
+          /\ABring Your Own Baby\b/i => 'baby',
+          /\bQ&A\b/i => 'q&a'
+        }.freeze
+
+        THREE_D = /\b3D\b/i
+        LANGUAGE = /\((#{Cinebase::TitleSanitizer::LANGUAGES.join('|')})\)/i
+
+        # @return [String] the film's title as listed
+        attr_reader :title
+        # @return [Time] UTC start
+        attr_reader :starting_at
+        # @return [String] the venue's Admit One booking page
+        attr_reader :booking_url
+
+        # @param [String] title the film's title as listed
+        # @param [Boolean] event_cinema whether the site marks the film as
+        #   event cinema: screened theatre, opera, ballet, concerts or art
+        # @param [Time] starting_at UTC start
+        # @param [String] booking_url the venue's Admit One booking page
+        # @param [Array<String>] keys the booking link's icons, e.g. 'subtitled'
+        def initialize(title:, event_cinema:, starting_at:, booking_url:, keys:)
+          @title = title
+          @event_cinema = event_cinema
+          @starting_at = starting_at
+          @booking_url = booking_url
+          @keys = keys
+        end
+
+        # @return [Hash] options for MerlinUk::Performance.new
+        def to_hash
+          {
+            booking_url: @booking_url,
+            dimension: @title.match?(THREE_D) ? '3d' : '2d',
+            festival: Cinebase::Festival.from_title(@title, year: @starting_at.year),
+            film_name: TitleSanitizer.new(@title).sanitized,
+            film_year: Cinebase::TitleSanitizer.film_year(@title),
+            language: @title[LANGUAGE, 1],
+            starting_at: @starting_at,
+            variant: variant
+          }
+        end
+
+        private
+
+        def variant
+          from_titles = TITLES.filter_map { |pattern, variant| variant if @title.match?(pattern) }
+          from_keys = @keys.filter_map { |key| KEYS[key] }
+          (from_keys + from_titles + (@event_cinema ? ['arts'] : [])).uniq
+        end
+      end
+    end
+  end
+end

data/lib/merlin_uk/internal/title_sanitizer.rb

@@ -0,0 +1,39 @@
+module MerlinUk
+  # Internal utility classes: Do not use
+  # @api private
+  module Internal
+    # Sanitize and standardize film titles
+    class TitleSanitizer < Cinebase::TitleSanitizer
+      # @!method initialize(title)
+      #   Constructor
+      #   @param [String] title a film title
+      #   @return [MerlinUk::Internal::TitleSanitizer]
+
+      # @!method sanitized
+      #   sanitized and standardized title
+      #   @return [String] sanitised title
+
+      private
+
+      # strings and regex to be removed
+      def remove
+        [
+          /\ABring Your Own Baby(?: Screening)?:\s*/i,        # parent and baby screening
+          /\A(?:PFS|Picture House) presents:?\s*/i,           # film society prefix
+          /\ASpecial Screening:\s*/i,                         # special screening prefix
+          /\s+with\s+(?:Pre[- ]?)?(?:Recorded\s+)?Q&A\z/i,    # Q&A add-on
+          /\s+at\s+the\s+Ritz\.?\z/i                          # Ritz Penzance suffix
+        ] + COMMON_REMOVE
+      end
+
+      # regexes and their replacements
+      def replace
+        {
+          /\ANT Live: (.*)/i                                  => 'National Theatre Live: ',
+          /\ARBO 20\d{2}-\d{2}: MET Opera - (.*)/i            => 'Met Opera: ',
+          /\ARBO 20\d{2}-\d{2}: The Royal (?:Ballet|Opera) - (.*)/i => 'Royal Ballet and Opera: '
+        }.merge(COMMON_REPLACE)
+      end
+    end
+  end
+end

data/lib/merlin_uk/internal/website.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module MerlinUk
+  # Internal utility classes: Do not use
+  # @api private
+  module Internal
+    # Reads venue pages from merlincinemas.co.uk. Each venue has its own
+    # subdomain, whose home page holds every advertised date in its full
+    # schedule.
+    class Website
+      include Http
+
+      # @param [String] venue_url e.g. 'https://redruth.merlincinemas.co.uk'
+      # @return [String] the venue's home page
+      def home(venue_url)
+        get("#{venue_url}/")
+      end
+    end
+  end
+end