m3u8 0.8.2 → 1.8.1

data/spec/lib/m3u8/media_item_spec.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+
 require 'spec_helper'
 
 describe M3u8::MediaItem do
@@ -24,6 +25,16 @@ describe M3u8::MediaItem do
       expect(item.characteristics).to eq('public.html')
       expect(item.channels).to eq('6')
     end
+
+    it 'assigns v13 attributes from options' do
+      options = { type: 'AUDIO', group_id: 'aac', name: 'English',
+                  stable_rendition_id: 'audio-en', bit_depth: 16,
+                  sample_rate: 44_100 }
+      item = described_class.new(options)
+      expect(item.stable_rendition_id).to eq('audio-en')
+      expect(item.bit_depth).to eq(16)
+      expect(item.sample_rate).to eq(44_100)
+    end
   end
 
   describe '.parse' do
@@ -48,6 +59,16 @@ describe M3u8::MediaItem do
       expect(item.characteristics).to eq('public.html')
       expect(item.channels).to eq('6')
     end
+
+    it 'parses v13 attributes' do
+      tag = '#EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="aac",' \
+            'NAME="English",STABLE-RENDITION-ID="audio-en",' \
+            'BIT-DEPTH=16,SAMPLE-RATE=44100'
+      item = described_class.parse(tag)
+      expect(item.stable_rendition_id).to eq('audio-en')
+      expect(item.bit_depth).to eq(16)
+      expect(item.sample_rate).to eq(44_100)
+    end
   end
 
   describe '#to_s' do
@@ -86,5 +107,18 @@ describe M3u8::MediaItem do
         expect(output).to eq(expected)
       end
     end
+
+    context 'when v13 attributes are assigned' do
+      it 'returns tag text with new attributes' do
+        options = { type: 'AUDIO', group_id: 'aac', name: 'English',
+                    channels: '2', stable_rendition_id: 'audio-en',
+                    bit_depth: 16, sample_rate: 44_100 }
+        item = M3u8::MediaItem.new(options)
+        output = item.to_s
+        expect(output).to include('STABLE-RENDITION-ID="audio-en"')
+        expect(output).to include('BIT-DEPTH=16')
+        expect(output).to include('SAMPLE-RATE=44100')
+      end
+    end
   end
 end

data/spec/lib/m3u8/part_inf_item_spec.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe M3u8::PartInfItem do
+  describe '.new' do
+    it 'assigns attributes from options' do
+      item = described_class.new(part_target: 0.5)
+      expect(item.part_target).to eq(0.5)
+    end
+  end
+
+  describe '.parse' do
+    it 'parses tag' do
+      tag = '#EXT-X-PART-INF:PART-TARGET=0.5'
+      item = described_class.parse(tag)
+      expect(item.part_target).to eq(0.5)
+    end
+  end
+
+  describe '#to_s' do
+    it 'returns m3u8 format representation' do
+      item = described_class.new(part_target: 0.5)
+      expect(item.to_s).to eq('#EXT-X-PART-INF:PART-TARGET=0.5')
+    end
+  end
+end

data/spec/lib/m3u8/part_item_spec.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe M3u8::PartItem do
+  describe '.new' do
+    it 'assigns attributes from options' do
+      options = { uri: 'part1.ts', duration: 1.5, independent: true,
+                  gap: false }
+      item = described_class.new(options)
+      expect(item.uri).to eq('part1.ts')
+      expect(item.duration).to eq(1.5)
+      expect(item.independent).to be true
+      expect(item.gap).to be false
+    end
+  end
+
+  describe '.parse' do
+    it 'parses tag with all attributes' do
+      tag = '#EXT-X-PART:DURATION=1.5,URI="part1.ts",' \
+            'INDEPENDENT=YES,BYTERANGE="500@0",GAP=YES'
+      item = described_class.parse(tag)
+      expect(item.duration).to eq(1.5)
+      expect(item.uri).to eq('part1.ts')
+      expect(item.independent).to be true
+      expect(item.byterange.length).to eq(500)
+      expect(item.byterange.start).to eq(0)
+      expect(item.gap).to be true
+    end
+
+    it 'parses tag without optional attributes' do
+      tag = '#EXT-X-PART:DURATION=1.5,URI="part1.ts"'
+      item = described_class.parse(tag)
+      expect(item.duration).to eq(1.5)
+      expect(item.uri).to eq('part1.ts')
+      expect(item.independent).to be false
+      expect(item.byterange).to be_nil
+      expect(item.gap).to be false
+    end
+  end
+
+  describe '#to_s' do
+    it 'returns tag with all attributes' do
+      options = { duration: 1.5, uri: 'part1.ts', independent: true,
+                  byterange: M3u8::ByteRange.new(length: 500, start: 0),
+                  gap: true }
+      item = described_class.new(options)
+      expected = '#EXT-X-PART:DURATION=1.5,URI="part1.ts",' \
+                 'INDEPENDENT=YES,BYTERANGE="500@0",GAP=YES'
+      expect(item.to_s).to eq(expected)
+    end
+
+    it 'returns tag with only required attributes' do
+      options = { duration: 1.5, uri: 'part1.ts' }
+      item = described_class.new(options)
+      expected = '#EXT-X-PART:DURATION=1.5,URI="part1.ts"'
+      expect(item.to_s).to eq(expected)
+    end
+
+    it 'should render small float values as floating-point number instead of scientific notation' do
+      options = { duration: 0.00001, uri: 'part1.ts' }
+      item = described_class.new(options)
+      expected = '#EXT-X-PART:DURATION=0.00001,URI="part1.ts"'
+      expect(item.to_s).to eq(expected)
+    end
+  end
+end

data/spec/lib/m3u8/playback_start_spec.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+
 require 'spec_helper'
 
 describe M3u8::PlaybackStart do
@@ -10,20 +11,18 @@ describe M3u8::PlaybackStart do
     end
   end
 
-  describe '#parse' do
+  describe '.parse' do
     it 'parses tag with all attributes' do
-      start = described_class.new
       tag = '#EXT-X-START:TIME-OFFSET=20.0,PRECISE=YES'
-      start.parse(tag)
+      start = described_class.parse(tag)
 
       expect(start.time_offset).to eq(20.0)
       expect(start.precise).to be true
     end
 
     it 'parses tag without optional attributes' do
-      start = described_class.new
       tag = '#EXT-X-START:TIME-OFFSET=-12.9'
-      start.parse(tag)
+      start = described_class.parse(tag)
 
       expect(start.time_offset).to eq(-12.9)
       expect(start.precise).to be_nil

data/spec/lib/m3u8/playlist_item_spec.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+
 require 'spec_helper'
 
 describe M3u8::PlaylistItem do
@@ -32,28 +33,29 @@ describe M3u8::PlaylistItem do
       expect(item.name).to eq('test_name')
       expect(item.hdcp_level).to eq('TYPE-0')
     end
-  end
 
-  describe '.parse' do
-    it 'returns new instance from parsed tag' do
-      tag = %(#EXT-X-STREAM-INF:CODECS="avc",BANDWIDTH=540,) +
-            %(PROGRAM-ID=1,RESOLUTION=1920x1080,FRAME-RATE=23.976,) +
-            %(AVERAGE-BANDWIDTH=550,AUDIO="test",VIDEO="test2",) +
-            %(SUBTITLES="subs",CLOSED-CAPTIONS="caps",URI="test.url",) +
-            %(NAME="1080p",HDCP-LEVEL=TYPE-0)
-      expect_any_instance_of(described_class).to receive(:parse).with(tag)
-      item = described_class.parse(tag)
-      expect(item).to be_a(described_class)
+    it 'assigns new v13 attributes from options' do
+      options = { bandwidth: 540, uri: 'test.url',
+                  stable_variant_id: 'hd-1080', video_range: 'SDR',
+                  allowed_cpc: 'com.example.drm:SMART-TV/PC',
+                  pathway_id: 'CDN-A',
+                  req_video_layout: 'CH-MONO',
+                  supplemental_codecs: 'dvh1.05.06/db4g',
+                  score: 12.5 }
+      item = described_class.new(options)
+      expect(item.stable_variant_id).to eq('hd-1080')
+      expect(item.video_range).to eq('SDR')
+      expect(item.allowed_cpc).to eq('com.example.drm:SMART-TV/PC')
+      expect(item.pathway_id).to eq('CDN-A')
+      expect(item.req_video_layout).to eq('CH-MONO')
+      expect(item.supplemental_codecs).to eq('dvh1.05.06/db4g')
+      expect(item.score).to eq(12.5)
     end
   end
 
-  describe '#parse' do
+  describe '.parse' do
     it 'assigns values from parsed tag' do
-      input = %(#EXT-X-STREAM-INF:CODECS="avc",BANDWIDTH=540,) +
-              %(PROGRAM-ID=1,RESOLUTION=1920x1080,FRAME-RATE=23.976,) +
-              %(AVERAGE-BANDWIDTH=550,AUDIO="test",VIDEO="test2",) +
-              %(SUBTITLES="subs",CLOSED-CAPTIONS="caps",URI="test.url",) +
-              %(NAME="1080p",HDCP-LEVEL=TYPE-0)
+      input = '#EXT-X-STREAM-INF:CODECS="avc",BANDWIDTH=540,PROGRAM-ID=1,RESOLUTION=1920x1080,FRAME-RATE=23.976,AVERAGE-BANDWIDTH=550,AUDIO="test",VIDEO="test2",SUBTITLES="subs",CLOSED-CAPTIONS="caps",URI="test.url",NAME="1080p",HDCP-LEVEL=TYPE-0'
       item = M3u8::PlaylistItem.parse(input)
       expect(item.program_id).to eq '1'
       expect(item.codecs).to eq 'avc'
@@ -71,6 +73,24 @@ describe M3u8::PlaylistItem do
       expect(item.iframe).to be false
       expect(item.hdcp_level).to eq('TYPE-0')
     end
+
+    it 'parses v13 attributes' do
+      input = '#EXT-X-STREAM-INF:BANDWIDTH=5000000,CODECS="avc1.640028,mp4a.40.2",RESOLUTION=1920x1080,STABLE-VARIANT-ID="hd-1080",VIDEO-RANGE=SDR,ALLOWED-CPC="com.example.drm:SMART-TV/PC",PATHWAY-ID="CDN-A",SCORE=12.5,SUPPLEMENTAL-CODECS="dvh1.05.06/db4g",REQ-VIDEO-LAYOUT="CH-MONO"'
+      item = M3u8::PlaylistItem.parse(input)
+      expect(item.stable_variant_id).to eq('hd-1080')
+      expect(item.video_range).to eq('SDR')
+      expect(item.allowed_cpc).to eq('com.example.drm:SMART-TV/PC')
+      expect(item.pathway_id).to eq('CDN-A')
+      expect(item.score).to eq(12.5)
+      expect(item.supplemental_codecs).to eq('dvh1.05.06/db4g')
+      expect(item.req_video_layout).to eq('CH-MONO')
+    end
+
+    it 'keeps bandwidth nil when BANDWIDTH is missing' do
+      input = '#EXT-X-STREAM-INF:CODECS="avc",URI="test.url"'
+      item = M3u8::PlaylistItem.parse(input)
+      expect(item.bandwidth).to be_nil
+    end
   end
 
   describe '#to_s' do
@@ -193,6 +213,27 @@ describe M3u8::PlaylistItem do
       end
     end
 
+    context 'when v13 attributes are present' do
+      it 'returns tag with new attributes' do
+        options = { codecs: 'avc1.640028', bandwidth: 5_000_000,
+                    uri: '1080p.m3u8', stable_variant_id: 'hd-1080',
+                    video_range: 'SDR', pathway_id: 'CDN-A',
+                    score: 12.5,
+                    supplemental_codecs: 'dvh1.05.06/db4g',
+                    allowed_cpc: 'com.example.drm:SMART-TV/PC',
+                    req_video_layout: 'CH-MONO' }
+        item = described_class.new(options)
+        output = item.to_s
+        expect(output).to include('STABLE-VARIANT-ID="hd-1080"')
+        expect(output).to include('VIDEO-RANGE=SDR')
+        expect(output).to include('PATHWAY-ID="CDN-A"')
+        expect(output).to include('SCORE=12.5')
+        expect(output).to include('SUPPLEMENTAL-CODECS="dvh1.05.06/db4g"')
+        expect(output).to include('ALLOWED-CPC="com.example.drm:SMART-TV/PC"')
+        expect(output).to include('REQ-VIDEO-LAYOUT="CH-MONO"')
+      end
+    end
+
     context 'when iframe is enabled' do
       it 'returns EXT-X-I-FRAME-STREAM-INF tag' do
         options = { codecs: 'avc', bandwidth: 540, uri: 'test.url',
@@ -289,4 +330,76 @@ describe M3u8::PlaylistItem do
     item = M3u8::PlaylistItem.new options
     expect(item.codecs).to eq 'avc1.640033'
   end
+
+  it 'generates HEVC codec strings' do
+    options = { profile: 'hevc-main', level: 3.1 }
+    item = M3u8::PlaylistItem.new options
+    expect(item.codecs).to eq 'hvc1.1.6.L93.B0'
+
+    options = { profile: 'hevc-main', level: 4.0 }
+    item = M3u8::PlaylistItem.new options
+    expect(item.codecs).to eq 'hvc1.1.6.L120.B0'
+
+    options = { profile: 'hevc-main', level: 5.0 }
+    item = M3u8::PlaylistItem.new options
+    expect(item.codecs).to eq 'hvc1.1.6.L150.B0'
+
+    options = { profile: 'hevc-main', level: 5.1 }
+    item = M3u8::PlaylistItem.new options
+    expect(item.codecs).to eq 'hvc1.1.6.L153.B0'
+
+    options = { profile: 'hevc-main-10', level: 4.0 }
+    item = M3u8::PlaylistItem.new options
+    expect(item.codecs).to eq 'hvc1.2.4.L120.B0'
+
+    options = { profile: 'hevc-main-10', level: 5.1 }
+    item = M3u8::PlaylistItem.new options
+    expect(item.codecs).to eq 'hvc1.2.4.L153.B0'
+  end
+
+  it 'generates AV1 codec strings' do
+    options = { profile: 'av1-main', level: 4.0 }
+    item = M3u8::PlaylistItem.new options
+    expect(item.codecs).to eq 'av01.0.08M.08'
+
+    options = { profile: 'av1-main', level: 5.1 }
+    item = M3u8::PlaylistItem.new options
+    expect(item.codecs).to eq 'av01.0.13M.08'
+
+    options = { profile: 'av1-high', level: 4.0 }
+    item = M3u8::PlaylistItem.new options
+    expect(item.codecs).to eq 'av01.1.08H.10'
+
+    options = { profile: 'av1-high', level: 5.1 }
+    item = M3u8::PlaylistItem.new options
+    expect(item.codecs).to eq 'av01.1.13H.10'
+  end
+
+  it 'generates modern audio codec strings' do
+    item = M3u8::PlaylistItem.new audio_codec: 'ac-3'
+    expect(item.codecs).to eq 'ac-3'
+
+    item = M3u8::PlaylistItem.new audio_codec: 'ec-3'
+    expect(item.codecs).to eq 'ec-3'
+
+    item = M3u8::PlaylistItem.new audio_codec: 'e-ac-3'
+    expect(item.codecs).to eq 'ec-3'
+
+    item = M3u8::PlaylistItem.new audio_codec: 'flac'
+    expect(item.codecs).to eq 'fLaC'
+
+    item = M3u8::PlaylistItem.new audio_codec: 'opus'
+    expect(item.codecs).to eq 'Opus'
+  end
+
+  it 'accepts integer levels for codec lookup' do
+    item = M3u8::PlaylistItem.new(profile: 'main', level: 4)
+    expect(item.codecs).to eq 'avc1.4d0028'
+
+    item = M3u8::PlaylistItem.new(profile: 'baseline', level: 3)
+    expect(item.codecs).to eq 'avc1.66.30'
+
+    item = M3u8::PlaylistItem.new(profile: 'high', level: 4)
+    expect(item.codecs).to eq 'avc1.640028'
+  end
 end