m3u8 1.8.0 → 1.9.0

data/spec/lib/m3u8/variable_resolver_spec.rb

@@ -0,0 +1,104 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe M3u8::VariableResolver do
+  def resolve(content, **opts)
+    M3u8::Playlist.read(content).resolve_variables(**opts)
+  end
+
+  it 'substitutes NAME/VALUE references in URIs and quoted attributes' do
+    content = <<~M3U8
+      #EXTM3U
+      #EXT-X-DEFINE:NAME="host",VALUE="https://cdn.example.com"
+      #EXT-X-DEFINE:NAME="grp",VALUE="audio-aac"
+      #EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="{$grp}",NAME="EN",URI="{$host}/a.m3u8"
+      #EXT-X-STREAM-INF:BANDWIDTH=1000,AUDIO="{$grp}"
+      {$host}/video.m3u8
+    M3U8
+    resolved = resolve(content)
+    expect(resolved.playlists.first.uri)
+      .to eq('https://cdn.example.com/video.m3u8')
+    expect(resolved.playlists.first.audio).to eq('audio-aac')
+    media = resolved.media_items.first
+    expect(media.group_id).to eq('audio-aac')
+    expect(media.uri).to eq('https://cdn.example.com/a.m3u8')
+  end
+
+  it 'leaves references untouched when not resolved' do
+    content = <<~M3U8
+      #EXTM3U
+      #EXT-X-DEFINE:NAME="host",VALUE="https://cdn.example.com"
+      #EXT-X-TARGETDURATION:10
+      #EXTINF:5.0,
+      {$host}/seg.ts
+      #EXT-X-ENDLIST
+    M3U8
+    playlist = M3u8::Playlist.read(content)
+    expect(playlist.segments.first.segment).to eq('{$host}/seg.ts')
+  end
+
+  it 'resolves IMPORT values from the imported hash' do
+    content = <<~M3U8
+      #EXTM3U
+      #EXT-X-DEFINE:IMPORT="host"
+      #EXT-X-TARGETDURATION:10
+      #EXTINF:5.0,
+      {$host}/seg.ts
+      #EXT-X-ENDLIST
+    M3U8
+    resolved = resolve(content, imported: { 'host' => 'https://x' })
+    expect(resolved.segments.first.segment).to eq('https://x/seg.ts')
+  end
+
+  it 'raises when an IMPORT value is missing' do
+    content = <<~M3U8
+      #EXTM3U
+      #EXT-X-DEFINE:IMPORT="host"
+      #EXT-X-TARGETDURATION:10
+      #EXTINF:5.0,
+      {$host}/seg.ts
+      #EXT-X-ENDLIST
+    M3U8
+    expect { resolve(content) }
+      .to raise_error(M3u8::InvalidPlaylistError, /IMPORT variable not found/)
+  end
+
+  it 'resolves QUERYPARAM values from the query hash' do
+    content = <<~M3U8
+      #EXTM3U
+      #EXT-X-DEFINE:QUERYPARAM="tok"
+      #EXT-X-TARGETDURATION:10
+      #EXTINF:5.0,
+      seg.ts?t={$tok}
+      #EXT-X-ENDLIST
+    M3U8
+    resolved = resolve(content, query: { 'tok' => 'abc' })
+    expect(resolved.segments.first.segment).to eq('seg.ts?t=abc')
+  end
+
+  it 'raises on an undefined variable reference' do
+    content = <<~M3U8
+      #EXTM3U
+      #EXT-X-TARGETDURATION:10
+      #EXTINF:5.0,
+      {$nope}/seg.ts
+      #EXT-X-ENDLIST
+    M3U8
+    expect { resolve(content) }
+      .to raise_error(M3u8::InvalidPlaylistError, /Undefined variable: nope/)
+  end
+
+  it 'raises when a reference precedes its definition' do
+    content = <<~M3U8
+      #EXTM3U
+      #EXT-X-TARGETDURATION:10
+      #EXTINF:5.0,
+      {$host}/seg.ts
+      #EXT-X-DEFINE:NAME="host",VALUE="https://x"
+      #EXT-X-ENDLIST
+    M3U8
+    expect { resolve(content) }
+      .to raise_error(M3u8::InvalidPlaylistError, /Undefined variable: host/)
+  end
+end

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: m3u8
 version: !ruby/object:Gem::Version
-  version: 1.8.0
+  version: 1.9.0
 platform: ruby
 authors:
 - Seth Deckard
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-07 00:00:00.000000000 Z
-dependencies: []
+date: 2026-05-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bigdecimal
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Generate and parse m3u8 playlists for HTTP Live Streaming (HLS).
 email:
 - seth@deckard.me
@@ -34,6 +48,7 @@ files:
 - lib/m3u8/builder.rb
 - lib/m3u8/byte_range.rb
 - lib/m3u8/cli.rb
+- lib/m3u8/cli/diff_command.rb
 - lib/m3u8/cli/inspect_command.rb
 - lib/m3u8/cli/validate_command.rb
 - lib/m3u8/codecs.rb
@@ -62,11 +77,13 @@ files:
 - lib/m3u8/scte35_splice_null.rb
 - lib/m3u8/scte35_time_signal.rb
 - lib/m3u8/segment_item.rb
+- lib/m3u8/serializable.rb
 - lib/m3u8/server_control_item.rb
 - lib/m3u8/session_data_item.rb
 - lib/m3u8/session_key_item.rb
 - lib/m3u8/skip_item.rb
 - lib/m3u8/time_item.rb
+- lib/m3u8/variable_resolver.rb
 - lib/m3u8/version.rb
 - lib/m3u8/writer.rb
 - m3u8.gemspec
@@ -94,9 +111,11 @@ files:
 - spec/lib/m3u8/bitrate_item_spec.rb
 - spec/lib/m3u8/builder_spec.rb
 - spec/lib/m3u8/byte_range_spec.rb
+- spec/lib/m3u8/cli/diff_command_spec.rb
 - spec/lib/m3u8/cli/inspect_command_spec.rb
 - spec/lib/m3u8/cli/validate_command_spec.rb
 - spec/lib/m3u8/cli_spec.rb
+- spec/lib/m3u8/conformance_spec.rb
 - spec/lib/m3u8/content_steering_item_spec.rb
 - spec/lib/m3u8/date_range_item_spec.rb
 - spec/lib/m3u8/define_item_spec.rb
@@ -121,11 +140,13 @@ files:
 - spec/lib/m3u8/scte35_splice_null_spec.rb
 - spec/lib/m3u8/scte35_time_signal_spec.rb
 - spec/lib/m3u8/segment_item_spec.rb
+- spec/lib/m3u8/serializable_spec.rb
 - spec/lib/m3u8/server_control_item_spec.rb
 - spec/lib/m3u8/session_data_item_spec.rb
 - spec/lib/m3u8/session_key_item_spec.rb
 - spec/lib/m3u8/skip_item_spec.rb
 - spec/lib/m3u8/time_item_spec.rb
+- spec/lib/m3u8/variable_resolver_spec.rb
 - spec/lib/m3u8/writer_spec.rb
 - spec/lib/m3u8_spec.rb
 - spec/spec_helper.rb