feat: add methods to detect default streams and attachment pictures

6.1.0

CHANGELOG

@@ -1,3 +1,7 @@
+== 6.1.0 2024-10-24
+* Added new `default?` and `attached_pic?` helper methods to FFMPEG::Stream objects
+* Added new `audio_with_attached_pic?` helper method to FFMPEG::Media objects
+
 == 6.0.2 2024-06-19
 
 Fixes:

lib/ffmpeg/media.rb

@@ -195,6 +195,10 @@ def audio_only?
       audio? && !video?
     end
 
+    def audio_with_attached_pic?
+      audio? && streams.any?(&:attached_pic?)
+    end
+
     def silent?
       !audio?
     end

lib/ffmpeg/stream.rb

@@ -101,6 +101,14 @@ def audio?
       codec_type == CodecType::AUDIO
     end
 
+    def default?
+      metadata.dig(:disposition, :default) == 1
+    end
+
+    def attached_pic?
+      metadata.dig(:disposition, :attached_pic) == 1
+    end
+
     def width
       @rotation.nil? || @rotation == 180 ? @width : @height
     end

lib/ffmpeg/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module FFMPEG
-  VERSION = '6.0.3'
+  VERSION = '6.1.0'
 end

spec/ffmpeg/media_spec.rb

@@ -247,6 +247,7 @@ module FFMPEG
       end
 
       it 'should return false if the media has video streams' do
+        subject = described_class.new("#{fixture_path}/sounds/napoleon.mp3")
         expect(subject.audio_only?).to be(false)
       end
 
@@ -256,6 +257,22 @@ module FFMPEG
       end
     end
 
+    describe '#audio_with_attached_pic?' do
+      it 'should return true if the media has audio streams with attached pictures' do
+        subject = described_class.new("#{fixture_path}/sounds/napoleon.mp3")
+        expect(subject.audio_with_attached_pic?).to be(true)
+      end
+
+      it 'should return false if the media does not have audio streams with attached pictures' do
+        expect(subject.audio_with_attached_pic?).to be(false)
+      end
+
+      it 'should return false if the media does not have attached pictures' do
+        subject = described_class.new("#{fixture_path}/sounds/hello.wav")
+        expect(subject.audio_with_attached_pic?).to be(false)
+      end
+    end
+
     %i[
       index
       profile

spec/ffmpeg/stream_spec.rb

@@ -62,6 +62,42 @@ module FFMPEG
       end
     end
 
+    describe '#default?' do
+      context 'when marked as default' do
+        let(:metadata) { { disposition: { default: 1 } } }
+
+        it 'should return true' do
+          expect(subject.default?).to be(true)
+        end
+      end
+
+      context 'when not marked as default' do
+        let(:metadata) { { disposition: { default: 0 } } }
+
+        it 'should return false' do
+          expect(subject.default?).to be(false)
+        end
+      end
+    end
+
+    describe '#attached_pic?' do
+      context 'when marked as an attached picture' do
+        let(:metadata) { { disposition: { attached_pic: 1 } } }
+
+        it 'should return true' do
+          expect(subject.attached_pic?).to be(true)
+        end
+      end
+
+      context 'when not marked as an attached picture' do
+        let(:metadata) { { disposition: { attached_pic: 0 } } }
+
+        it 'should return false' do
+          expect(subject.attached_pic?).to be(false)
+        end
+      end
+    end
+
     describe '#width' do
       context 'when the rotation is nil' do
         let(:metadata) { { width: 100, height: 200 } }