cineworld_uk 4.2.0 → 4.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 97a79daf0c192e1c7a12ab72a96c6fae42433c44761fa7a991cfb0a2d456cf51
-  data.tar.gz: dfa8faf8c393df7b2df082d458af26a63aa8171a9a6f45fb964b040b07864baa
+  metadata.gz: b966798e50231ceceb95b749b8c3e9e962db5cc12edc7fb31e98ee40e110078d
+  data.tar.gz: f26069f75b3de854af94f90758b0d479faa8ef7f2923dfb3c6ed66d16a681432
 SHA512:
-  metadata.gz: 67fcdf358e0f0764b5d0b240999fcbfd1bc313a0ce9a97eb75fc5cc5d413ca7a244c74ef9f5993249fa2496bb33a8c03a3968f048c2a6a9e28a6ba444ed14bec
-  data.tar.gz: 19641348e8182a4aefdefc2674b934a08a4a1ac0ffcf109b6c678262400dd78b451845ad807ad7a4ad54a61bce461cfb9fd3e6612a1ac4a8f419427c46925647
+  metadata.gz: 2d38f7b625fe0625160948172925120d2763ba1f9235acc683f58bf5c4b1fdeca4a6176734884e400dadfa34ed53c5d1a745af7b11ecbf52468884c1bc92d378
+  data.tar.gz: 71d23a661ac05b7eb340877e6c371ceae53cc4b757048a75d3ebfa4d713258ca7faae8cb74d7c360ecdf5da8655351c7c1167b920c10125a1dc43d6f434b2405

data/CHANGELOG.md

@@ -2,6 +2,16 @@
 All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](http://semver.org/).
 
+## 4.3.0 - 2026-10-22
+
+### Added
+- `Performance#film_year`, read from a trailing `(1996)` in the title, so a re-release gives the original year.
+- `4dx` and `screenx` variants from Vista's `4DX`, `4DX 3D` and `ScreenX` attributes.
+
+### Changed
+- Require cinebase 5.4. Titles also lose `+ ... Q&A` and `+ Discussion` add-ons, `(35mm)`, `(70mm)` and `4K` markers, and `CFF:` festival prefixes.
+- Film titles lose their year suffix and the `(4DX)`, `(ScreenX)`, `M4J:`, `£2 Family Films :`, `Horror Season 2026` and `(Re-release)` markers, and Lithuanian versions. For example `Horror Season 2026 From Dusk Till Dawn (1996)` is now `From Dusk Till Dawn` with `film_year` 1996 and the Horror Season 2026 festival. Consumers matching films by name will see these names change.
+
 ## 4.2.0 - 2026-10-22
 
 ### Added

data/README.md

@@ -177,6 +177,9 @@ performance.dimension
 performance.variant
 #=> ['audio_described']
 
+performance.film_year
+#=> 1996 # from the title, nil when it has no year
+
 performance.language
 #=> 'Tamil' # audio language, nil when the cinema does not tag one
 
@@ -226,7 +229,7 @@ To build and check just one platform on a matching host:
 
 ```sh
 bundle exec rake 'package:native[x86_64-linux-gnu]'
-CINEWORLD_PACKAGE=pkg/cineworld_uk-4.2.0-x86_64-linux-gnu.gem bundle exec ruby test/package_test.rb
+CINEWORLD_PACKAGE=pkg/cineworld_uk-4.3.0-x86_64-linux-gnu.gem bundle exec ruby test/package_test.rb
 ```
 
 Native packaging downloads pinned upstream archives at **build time**, verifies

data/cineworld_uk.gemspec

@@ -25,6 +25,6 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'simplecov', '< 1'
   spec.add_development_dependency 'webmock'
 
-  spec.add_runtime_dependency 'cinebase', '~> 5.2'
+  spec.add_runtime_dependency 'cinebase', '~> 5.4'
   spec.add_runtime_dependency 'nokogiri', '>= 1.11'
 end

data/lib/cineworld_uk/internal/api_response.rb

@@ -14,7 +14,8 @@ module CineworldUk
         "Subtitled" => "subbed", "Subtitles" => "subbed",
         "Autism Friendly" => "autism-friendly",
         "Movies for Juniors" => "junior",
-        "Unlimited Screening" => "unlimited-screening", "Q&A" => "qa"
+        "Unlimited Screening" => "unlimited-screening", "Q&A" => "qa",
+        "4DX" => "4dx", "4DX 3D" => "4dx", "ScreenX" => "screenx"
       }.freeze
       LANGUAGES = Cinebase::TitleSanitizer::LANGUAGES
 

data/lib/cineworld_uk/internal/parser/api/film.rb

@@ -27,6 +27,11 @@ module CineworldUk
             Cinebase::Festival.from_title(@data['name'] || '', year: year)
           end
 
+          # @return [Integer, nil] the year at the end of the title
+          def film_year
+            Cinebase::TitleSanitizer.film_year(@data['name'] || '')
+          end
+
           # Sanitized film name
           # @return [String]
           def name
@@ -40,11 +45,13 @@ module CineworldUk
           def variant
             attrs = @data['attributeIds'] || []
             [
+              attrs.include?('4dx') ? '4dx' : nil,
               attrs.include?('autism-friendly') ? 'autism_friendly' : nil,
               attrs.include?('imax') ? 'imax' : nil,
               attrs.include?('junior') ? 'kids' : nil,
               attrs.include?('unlimited-screening') ? 'members' : nil,
-              attrs.include?('qa') ? 'q&a' : nil
+              attrs.include?('qa') ? 'q&a' : nil,
+              attrs.include?('screenx') ? 'screenx' : nil
             ].compact
           end
         end

data/lib/cineworld_uk/internal/title_sanitizer.rb

@@ -28,6 +28,9 @@ module CineworldUk
           /\ATake 2 -/,                         # take 2
           / - (Subtitled) Movies for Juniors/i, # movies for juniors
           '(IMAX)',                             # IMAX
+          /\A\((4DX|ScreenX)\)\s*/,             # format, kept as a variant
+          /\AM4J: /,                            # movies for juniors
+          /\A£2 Family Films : /,               # family pricing
           'SciScreen: ',                        # SciScreen
           /\s(-\s)*(With)*\sLive Q And A/i,     # Live Q&A
           /(\s+\-\s+)?MOVIES FOR JUNIORS/i,     # movies for juniors

data/lib/cineworld_uk/performance.rb

@@ -80,6 +80,7 @@ module CineworldUk
           dimension: film.dimension,
           festival: film.festival(starting_at.year),
           film_name: film.name,
+          film_year: film.film_year,
           language: performance.language,
           starting_at: starting_at,
           variant: (performance.variant + film.variant).sort

data/lib/cineworld_uk/version.rb

@@ -1,6 +1,6 @@
 # Ruby interface for http://www.cineworld.co.uk
-# @version 4.2.0
+# @version 4.3.0
 module CineworldUk
   # Gem version
-  VERSION = "4.2.0".freeze
+  VERSION = "4.3.0".freeze
 end

data/test/fixtures/api/showtimes-014.json

@@ -36,6 +36,13 @@
       "attributeIds": ["A-AC"],
       "requires3dGlasses": false
     },
+    {
+      "id": "014-1007",
+      "filmId": "FILM-5",
+      "schedule": { "startsAt": "2026-10-24T21:00:00+01:00" },
+      "attributeIds": ["A-4DX"],
+      "requires3dGlasses": false
+    },
     {
       "id": "014-1006",
       "filmId": "FILM-1",
@@ -49,7 +56,8 @@
       { "id": "FILM-1", "title": { "text": "The Example Film" } },
       { "id": "FILM-2", "title": { "text": "Imaginary Picture (Tamil)" } },
       { "id": "FILM-3", "title": { "text": "Pretend Pups - Movies For Juniors" } },
-      { "id": "FILM-4", "title": { "text": "Cine-Excess 2026: Scum Of The Earth" } }
+      { "id": "FILM-4", "title": { "text": "Cine-Excess 2026: Scum Of The Earth" } },
+      { "id": "FILM-5", "title": { "text": "(4DX) Wildwood (2026)" } }
     ],
     "attributes": [
       { "id": "A-2D", "shortName": { "text": "2D" }, "name": { "text": "2D Film" } },
@@ -58,7 +66,8 @@
       { "id": "A-TAMIL", "shortName": { "text": "Tamil" }, "name": { "text": "Tamil" } },
       { "id": "A-ST", "shortName": { "text": "ST" }, "name": { "text": "Subtitled" } },
       { "id": "A-M4J", "shortName": { "text": "M4J" }, "name": { "text": "Movies for Juniors" } },
-      { "id": "A-AC", "shortName": { "text": "AC" }, "name": { "text": "Event Cinema" } }
+      { "id": "A-AC", "shortName": { "text": "AC" }, "name": { "text": "Event Cinema" } },
+      { "id": "A-4DX", "shortName": { "text": "4DX" }, "name": { "text": "4DX" } }
     ],
     "sites": [
       { "id": "014", "name": { "text": "Brighton" } }

data/test/lib/cineworld_uk/internal/parser/api/film_test.rb

@@ -47,6 +47,22 @@ class CineworldUk::Internal::Parser::Api::FilmTest < Minitest::Test
     assert_nil film.festival(2026)
   end
 
+  def test_film_year
+    assert_equal 1996, film('name' => 'Horror Season 2026 From Dusk Till Dawn (1996)').film_year
+  end
+
+  def test_film_year_without_year
+    assert_nil film.film_year
+  end
+
+  def test_variant_4dx
+    assert_includes film('attributeIds' => ['4dx']).variant, '4dx'
+  end
+
+  def test_variant_screenx
+    assert_includes film('attributeIds' => ['screenx']).variant, 'screenx'
+  end
+
   def test_variant_is_sorted
     variant = film('attributeIds' => %w(qa junior imax)).variant
 

data/test/lib/cineworld_uk/internal/title_sanitizer_test.rb

@@ -90,6 +90,31 @@ class CineworldUk::Internal::TitleSanitizerTest < Minitest::Test
     assert_sanitized 'Bebefinn Sing-Along Movie', 'Bebefinn Sing-Along Movie'
   end
 
+  def test_removes_format_prefix
+    assert_sanitized 'Wildwood', '(4DX) Wildwood'
+    assert_sanitized 'Wildwood', '(ScreenX) Wildwood'
+  end
+
+  def test_removes_movies_for_juniors_prefix
+    assert_sanitized 'Paw Patrol: The Mighty Movie', 'M4J: Paw Patrol: The Mighty Movie'
+  end
+
+  def test_removes_family_films_prefix
+    assert_sanitized 'Paw Patrol: The Dino Movie', '£2 Family Films : Paw Patrol: The Dino Movie'
+  end
+
+  def test_removes_film_year
+    assert_sanitized 'Street Fighter', 'Street Fighter (2026)'
+  end
+
+  def test_removes_season_prefix_and_year
+    assert_sanitized 'From Dusk Till Dawn', 'Horror Season 2026 From Dusk Till Dawn (1996)'
+  end
+
+  def test_removes_re_release
+    assert_sanitized 'Zindagi Na Milegi Dobara', 'Zindagi Na Milegi Dobara (Re-release) (Hindi)'
+  end
+
   def test_removes_festival_prefix
     assert_sanitized 'Scum Of The Earth', 'Cine-Excess 2026: Scum Of The Earth'
   end

data/test/lib/cineworld_uk/performance_test.rb

@@ -18,13 +18,13 @@ class CineworldUk::PerformanceTest < Minitest::Test
     performances = performances_on_date
 
     assert(performances.all? { |p| p.instance_of?(CineworldUk::Performance) })
-    assert_equal 6, performances.count
+    assert_equal 7, performances.count
   end
 
   def test_at_accepts_string_id
     stub_showtimes(DATE)
 
-    assert_equal 6, CineworldUk::Performance.at('014', from: DATE, to: DATE).count
+    assert_equal 7, CineworldUk::Performance.at('014', from: DATE, to: DATE).count
   end
 
   def test_at_parses_first_performance
@@ -70,6 +70,18 @@ class CineworldUk::PerformanceTest < Minitest::Test
     assert_equal Cinebase::Festival.new(name: 'Cine-Excess', year: 2026), performance.festival
   end
 
+  def test_at_parses_format_and_film_year
+    performance = performances_on_date[5]
+
+    assert_equal 'Wildwood', performance.film_name
+    assert_equal 2026, performance.film_year
+    assert_equal %w(4dx), performance.variant
+  end
+
+  def test_new_sets_film_year
+    assert_equal 1996, CineworldUk::Performance.new(options(film_year: 1996)).film_year
+  end
+
   def test_at_keeps_after_midnight_on_next_utc_day
     assert_equal Time.utc(2026, 10, 24, 23, 15), performances_on_date.last.starting_at
   end
@@ -80,7 +92,7 @@ class CineworldUk::PerformanceTest < Minitest::Test
 
     performances = CineworldUk::Performance.at(14, from: DATE, to: DATE + 1)
 
-    assert_equal 6, performances.count
+    assert_equal 7, performances.count
     assert_not_requested :get, "#{BASE_URL}sites"
   end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cineworld_uk
 version: !ruby/object:Gem::Version
-  version: 4.2.0
+  version: 4.3.0
 platform: ruby
 authors:
 - Andy Croll
@@ -113,14 +113,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.2'
+        version: '5.4'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.2'
+        version: '5.4'
 - !ruby/object:Gem::Dependency
   name: nokogiri
   requirement: !ruby/object:Gem::Requirement