active_storage_validations 0.9.7 → 2.0.2

data/config/locales/vi.yml

@@ -1,22 +1,53 @@
 vi:
   errors:
     messages:
-      content_type_invalid: "tệp không hợp lệ"
-      file_size_out_of_range: "kích thước %{file_size} vượt giới hạn"
-      limit_out_of_range: "tổng số tệp vượt giới hạn"
-      image_metadata_missing: "không phải là ảnh"
-      dimension_min_inclusion: "phải lớn hơn hoặc bằng %{width} x %{height} pixel"
-      dimension_max_inclusion: "phải nhỏ hơn hoặc bằng %{width} x %{height} pixel"
-      dimension_width_inclusion: "chiều rộng không nằm trong %{min} và %{max} pixel"
-      dimension_height_inclusion: "chiều cao không nằm trong %{min} và %{max} pixel"
-      dimension_width_greater_than_or_equal_to: "chiều rộng phải lớn hơn hoặc bằng %{length} pixel"
-      dimension_height_greater_than_or_equal_to: "chiều cao phải lớn hơn hoặc bằng %{length} pixel"
-      dimension_width_less_than_or_equal_to: "chiều rộng phải nhỏ hơn hoặc bằng %{length} pixel"
-      dimension_height_less_than_or_equal_to: "chiều cao phải nhỏ hơn hoặc bằng %{length} pixel"
-      dimension_width_equal_to: "chiều rộng phải bằng %{length} pixel"
-      dimension_height_equal_to: "chiều cao phải bằng %{length} pixel"
-      aspect_ratio_not_square: "phải là ảnh hình vuông"
-      aspect_ratio_not_portrait: "phải là ảnh đứng"
-      aspect_ratio_not_landscape: "phải là ảnh ngang"
-      aspect_ratio_is_not: "phải có tỉ lệ ảnh %{aspect_ratio}"
-      aspect_ratio_unknown: "tỉ lệ ảnh không xác định"
+      content_type_invalid:
+        one: "có loại nội dung không hợp lệ (loại nội dung được ủy quyền là %{autorized_human_content_types})"
+        other: "có loại nội dung không hợp lệ (các loại nội dung được ủy quyền là %{autorized_human_content_types})"
+      content_type_spoofed:
+        one: "có một loại nội dung không tương đương với loại được phát hiện thông qua nội dung của nó (loại nội dung được ủy quyền là %{autorized_human_content_types})"
+        other: "có một loại nội dung không tương đương với loại được phát hiện thông qua nội dung của nó (các loại nội dung được ủy quyền là %{autorized_human_content_types})"
+      file_size_not_less_than: "kích thước tệp phải nhỏ hơn %{max} (kích thước hiện tại là %{file_size})"
+      file_size_not_less_than_or_equal_to: "kích thước tệp phải nhỏ hơn hoặc bằng %{max} (kích thước hiện tại là %{file_size})"
+      file_size_not_greater_than: "kích thước tệp phải lớn hơn %{min} (kích thước hiện tại là %{file_size})"
+      file_size_not_greater_than_or_equal_to: "kích thước tệp phải lớn hơn hoặc bằng %{min} (kích thước hiện tại là %{file_size})"
+      file_size_not_between: "kích thước tệp phải nằm trong khoảng từ %{min} đến %{max} (kích thước hiện tại là %{file_size})"
+      total_file_size_not_less_than: "tổng kích thước tệp phải nhỏ hơn %{max} (kích thước hiện tại là %{total_file_size})"
+      total_file_size_not_less_than_or_equal_to: "tổng kích thước tệp phải nhỏ hơn hoặc bằng %{max} (kích thước hiện tại là %{total_file_size})"
+      total_file_size_not_greater_than: "tổng kích thước tệp phải lớn hơn %{min} (kích thước hiện tại là %{total_file_size})"
+      total_file_size_not_greater_than_or_equal_to: "tổng kích thước tệp phải lớn hơn hoặc bằng %{min} (kích thước hiện tại là %{total_file_size})"
+      total_file_size_not_between: "tổng kích thước tệp phải nằm trong khoảng từ %{min} đến %{max} (kích thước hiện tại là %{total_file_size})"
+      duration_not_less_than: "thời lượng phải nhỏ hơn %{max} (thời lượng hiện tại là %{duration})"
+      duration_not_less_than_or_equal_to: "thời lượng phải nhỏ hơn hoặc bằng %{max} (thời lượng hiện tại là %{duration})"
+      duration_not_greater_than: "thời lượng phải lớn hơn %{min} (thời lượng hiện tại là %{duration})"
+      duration_not_greater_than_or_equal_to: "thời lượng phải lớn hơn hoặc bằng %{min} (thời lượng hiện tại là %{duration})"
+      duration_not_between: "thời lượng phải nằm trong khoảng từ %{min} và %{max} (thời lượng hiện tại là %{duration})"
+      limit_out_of_range:
+        zero: "không có tệp nào được đính kèm (phải có giữa các tệp %{min} và %{max})"
+        one: "chỉ có 1 tệp được đính kèm (phải có giữa các tệp %{min} và %{max})"
+        other: "tổng số tệp phải nằm trong khoảng từ %{min} và %{max} tệp (có các tệp %{count} được đính kèm)"
+      limit_min_not_reached:
+        zero: "không có tệp nào được đính kèm (phải có ít nhất %{min} tệp)"
+        one: "chỉ có 1 tệp được đính kèm (phải có ít nhất %{min} tệp)"
+        other: "các tệp %{count} được đính kèm (phải có ít nhất %{min} tệp)"
+      limit_max_exceeded:
+        zero: "không có tệp nào được đính kèm (tối đa là các tệp %{max})"
+        one: "quá nhiều tệp được đính kèm (tối đa là các tệp %{max}, có %{count})"
+        other: "quá nhiều tệp được đính kèm (tối đa là các tệp %{max}, có %{count})"
+      media_metadata_missing: "không phải là ảnh"
+      dimension_min_not_included_in: "phải lớn hơn hoặc bằng %{width} x %{height} pixel"
+      dimension_max_not_included_in: "phải nhỏ hơn hoặc bằng %{width} x %{height} pixel"
+      dimension_width_not_included_in: "chiều rộng không nằm trong %{min} và %{max} pixel"
+      dimension_height_not_included_in: "chiều cao không nằm trong %{min} và %{max} pixel"
+      dimension_width_not_greater_than_or_equal_to: "chiều rộng phải lớn hơn hoặc bằng %{length} pixel"
+      dimension_height_not_greater_than_or_equal_to: "chiều cao phải lớn hơn hoặc bằng %{length} pixel"
+      dimension_width_not_less_than_or_equal_to: "chiều rộng phải nhỏ hơn hoặc bằng %{length} pixel"
+      dimension_height_not_less_than_or_equal_to: "chiều cao phải nhỏ hơn hoặc bằng %{length} pixel"
+      dimension_width_not_equal_to: "chiều rộng phải bằng %{length} pixel"
+      dimension_height_not_equal_to: "chiều cao phải bằng %{length} pixel"
+      aspect_ratio_not_square: "phải là hình vuông (tệp hiện tại là %{width}x%{height}px)"
+      aspect_ratio_not_portrait: "phải là chân dung (tệp hiện tại là %{width}x%{height}px)"
+      aspect_ratio_not_landscape: "phải là ngang (tệp hiện tại là %{width}x%{height}px)"
+      aspect_ratio_not_x_y: "phải là %{authorized_aspect_ratios} (tệp hiện tại là %{width}x%{height}px)"
+      aspect_ratio_invalid: "có tỷ lệ khung hình không hợp lệ (tỷ lệ khung hình hợp lệ là %{authorized_aspect_ratios})"
+      file_not_processable: "không được xác định là tệp phương tiện hợp lệ"

data/config/locales/zh-CN.yml

@@ -0,0 +1,53 @@
+zh-CN:
+  errors:
+    messages:
+      content_type_invalid:
+        one: "具有无效的内容类型（授权的内容类型为%{authorized_human_content_types})"
+        other: "具有无效的内容类型（授权的内容类型为%{authorized_human_content_types})"
+      content_type_spoofed:
+        one: "其内容类型不等于通过其内容检测到的内容类型（授权内容类型为%{authorized_human_content_types})"
+        other: "其内容类型与通过其内容检测到的内容类型不等效（授权内容类型为%{authorized_human_content_types})"
+      file_size_not_less_than: "文件大小必须小于 %{max}（当前大小为 %{file_size})"
+      file_size_not_less_than_or_equal_to: "文件大小必须小于或等于 %{max}（当前大小为 %{file_size})"
+      file_size_not_greater_than: "文件大小必须大于 %{min}（当前大小为 %{file_size})"
+      file_size_not_greater_than_or_equal_to: "文件大小必须大于或等于 %{min}（当前大小为 %{file_size})"
+      file_size_not_between: "文件大小必须介于 %{min} 和 %{max} 之间（当前大小为 %{file_size})"
+      total_file_size_not_less_than: "总文件大小必须小于 %{max}（当前大小为 %{total_file_size})"
+      total_file_size_not_less_than_or_equal_to: "文件总大小必须小于或等于 %{max}（当前大小为 %{total_file_size})"
+      total_file_size_not_greater_than: "总文件大小必须大于 %{min}（当前大小为 %{total_file_size})"
+      total_file_size_not_greater_than_or_equal_to: "文件总大小必须大于或等于 %{min}（当前大小为 %{total_file_size})"
+      total_file_size_not_between: "总文件大小必须介于 %{min} 和 %{max} 之间（当前大小为 %{total_file_size})"
+      duration_not_less_than: "持续时间必须小于%{max}（当前持续时间为%{duration})"
+      duration_not_less_than_or_equal_to: "持续时间必须小于或等于%{max}（当前持续时间为%{duration})"
+      duration_not_greater_than: "持续时间必须大于%{min}（当前持续时间为%{duration})"
+      duration_not_greater_than_or_equal_to: "持续时间必须大于或等于%{min}（当前持续时间为%{duration})"
+      duration_not_between: "持续时间必须在%{min}和%{max}之间（当前持续时间为%{duration})"
+      limit_out_of_range:
+        zero: "未附加文件（必须具有%{min}和%{max}文件之间)"
+        one: "仅附加1个文件（必须具有%{min}和%{max}文件之间)"
+        other: "文件总数必须在%{min}和%{max}文件之间（已连接%{count}文件)"
+      limit_min_not_reached:
+        zero: "未附加文件（必须至少具有%{min}文件)"
+        one: "仅附加1个文件（必须至少具有%{min}文件)"
+        other: "%{count}文件已连接（必须至少具有%{min}文件)"
+      limit_max_exceeded:
+        zero: "未附加文件（最大为%{max}文件)"
+        one: "附加的文件太多（最大为%{max}文件,得到%{count})"
+        other: "附加的文件太多（最大为%{max}文件,得到%{count})"
+      media_metadata_missing: "不是有效的媒体文件"
+      dimension_min_not_included_in: "必须大于或等于 %{width} x %{height} 像素"
+      dimension_max_not_included_in: "必须小于或等于 %{width} x %{height} 像素"
+      dimension_width_not_included_in: "宽度不在 %{min} 和 %{max} 像素之间"
+      dimension_height_not_included_in: "高度不在 %{min} 和 %{max} 像素之间"
+      dimension_width_not_greater_than_or_equal_to: "宽度必须大于或等于 %{length} 像素"
+      dimension_height_not_greater_than_or_equal_to: "高度必须大于或等于 %{length} 像素"
+      dimension_width_not_less_than_or_equal_to: "宽度必须小于或等于 %{length} 像素"
+      dimension_height_not_less_than_or_equal_to: "高度必须小于或等于 %{length} 像素"
+      dimension_width_not_equal_to: "宽度必须等于 %{length} 像素"
+      dimension_height_not_equal_to: "高度必须等于 %{length} 像素"
+      aspect_ratio_not_square: "必须为正方形（当前文件为 %{width} x%{height} 像素)"
+      aspect_ratio_not_portrait: "必须是纵向的（当前文件为 %{width} x%{height} 像素)"
+      aspect_ratio_not_landscape: "必须是横向（当前文件为 %{width} x%{height} 像素)"
+      expect_ratio_not_x_y: "必须为 %{authorized_aspect_ratios}（当前文件为 %{width} x%{height} 像素)"
+      expect_ratio_not_in_list: "具有无效的长宽比（有效长宽比为 %{authorized_aspect_ratios})"
+      file_not_processable: "未标识为有效的媒体文件"

data/lib/active_storage_validations/analyzer/audio_analyzer.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+require 'open3'
+require_relative 'shared/asv_ff_probable'
+
+module ActiveStorageValidations
+  # = ActiveStorageValidations Audio \Analyzer
+  #
+  # Extracts the following from an audio attachable:
+  #
+  # * Duration (seconds)
+  # * Bit rate (bits/s)
+  # * Sample rate (hertz)
+  # * Tags (internal metadata)
+  #
+  # Example:
+  #
+  #   ActiveStorageValidations::Analyzer::AudioAnalyzer.new(attachable).metadata
+  #   # => { duration: 5.0, bit_rate: 320340, sample_rate: 44100, tags: { encoder: "Lavc57.64", ... } }
+  #
+  # This analyzer requires the {FFmpeg}[https://www.ffmpeg.org] system library, which is not provided by \Rails.
+  class Analyzer::AudioAnalyzer < Analyzer
+    include ASVFFProbable
+
+    def metadata
+      read_media do |media|
+        {
+          duration: duration,
+          bit_rate: bit_rate,
+          sample_rate: sample_rate,
+          tags: tags
+        }.compact
+      end
+    end
+
+    private
+
+    def duration
+      duration = audio_stream["duration"]
+      Float(duration).round(1) if duration
+    end
+
+    def bit_rate
+      bit_rate = audio_stream["bit_rate"]
+      Integer(bit_rate) if bit_rate
+    end
+
+    def sample_rate
+      sample_rate = audio_stream["sample_rate"]
+      Integer(sample_rate) if sample_rate
+    end
+
+    def tags
+      tags = audio_stream["tags"]
+      Hash(tags) if tags
+    end
+  end
+end

data/lib/active_storage_validations/analyzer/content_type_analyzer.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+require 'open3'
+
+module ActiveStorageValidations
+  # = ActiveStorageValidations ContentType \Analyzer
+  #
+  # Extracts the content type from an attachable. This is used to prevent content
+  # type spoofing.
+  #
+  # Example:
+  #
+  #   ActiveStorageValidations::Analyzer::ContentTypeAnalyzer.new(attachable).content_type
+  #   # => { content_type: "image/png" }
+  #
+  # This analyzer requires the {UNIX file}[https://en.wikipedia.org/wiki/File_(command)] command, which is not provided by \Rails. While it is available on most UNIX distributions, it may need to be installed explicitly on minimal or custom setups.
+  class Analyzer::ContentTypeAnalyzer < Analyzer
+    class FileCommandLineToolNotInstalledError < StandardError; end
+
+    def content_type
+      read_media do |media|
+        {
+          content_type: media
+        }
+      end
+    end
+
+    private
+
+    def read_media
+      Tempfile.create(binmode: true) do |tempfile|
+        begin
+          if media(tempfile).present?
+            yield media(tempfile)
+          else
+            logger.info "Skipping file content_type analysis because Linux file command doesn't support the file"
+            nil
+          end
+        ensure
+          tempfile.close
+        end
+      end
+    rescue Errno::ENOENT
+      raise FileCommandLineToolNotInstalledError, 'file command-line tool is not installed'
+    end
+
+    def media_from_path(path)
+      instrument("file") do
+        stdout, status = Open3.capture2(
+          'file',
+          '-b',
+          '--mime-type',
+          path
+        )
+
+        status.success? ? stdout.strip : nil
+      end
+    end
+  end
+end

data/lib/active_storage_validations/analyzer/image_analyzer/image_magick.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module ActiveStorageValidations
+  # This analyzer relies on the third-party {MiniMagick}[https://github.com/minimagick/minimagick] gem.
+  # MiniMagick requires the {ImageMagick}[http://www.imagemagick.org] system library.
+  # This is the default Rails image analyzer.
+  class Analyzer::ImageAnalyzer::ImageMagick < Analyzer::ImageAnalyzer
+
+    private
+
+    def read_media
+      Tempfile.create(binmode: true) do |tempfile|
+        begin
+          if media(tempfile).valid?
+            yield media(tempfile)
+          else
+            logger.info "Skipping image analysis because ImageMagick doesn't support the file"
+            {}
+          end
+        ensure
+          tempfile.close
+        end
+      end
+    rescue MiniMagick::Error => error
+      logger.error "Skipping image analysis due to an ImageMagick error: #{error.message}"
+      {}
+    end
+
+    def media_from_path(path)
+      instrument("mini_magick") do
+        MiniMagick::Image.new(path)
+      end
+    end
+
+    def rotated_image?(image)
+      %w[ RightTop LeftBottom TopRight BottomLeft ].include?(image["%[orientation]"])
+    end
+
+    def supported?
+      require "mini_magick"
+      true
+    rescue LoadError
+      logger.info "Skipping image analysis because the mini_magick gem isn't installed"
+      false
+    end
+  end
+end

data/lib/active_storage_validations/analyzer/image_analyzer/vips.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module ActiveStorageValidations
+  # This analyzer relies on the third-party {ruby-vips}[https://github.com/libvips/ruby-vips] gem.
+  # Ruby-vips requires the {libvips}[https://libvips.github.io/libvips/] system library.
+  class Analyzer::ImageAnalyzer::Vips < Analyzer::ImageAnalyzer
+
+    private
+
+    def read_media
+      Tempfile.create(binmode: true) do |tempfile|
+        begin
+          if media(tempfile)
+            yield media(tempfile)
+          else
+            logger.info "Skipping image analysis because Vips doesn't support the file"
+            {}
+          end
+        ensure
+          tempfile.close
+        end
+      end
+    rescue ::Vips::Error => error
+      logger.error "Skipping image analysis due to a Vips error: #{error.message}"
+      {}
+    end
+
+    def media_from_path(path)
+      instrument("vips") do
+        begin
+          ::Vips::Image.new_from_file(path, access: :sequential)
+        rescue ::Vips::Error
+          # Vips throw errors rather than returning false when reading a not
+          # supported attachable.
+          # We stumbled upon this issue while reading 0 byte size attachable
+          # https://github.com/janko/image_processing/issues/97
+          nil
+        end
+      end
+    end
+
+    ROTATIONS = /Right-top|Left-bottom|Top-right|Bottom-left/
+    def rotated_image?(image)
+      ROTATIONS === image.get("exif-ifd0-Orientation")
+    rescue ::Vips::Error
+      false
+    end
+
+    def supported?
+      require "vips"
+      true
+    rescue LoadError
+      logger.info "Skipping image analysis because the ruby-vips gem isn't installed"
+      false
+    end
+  end
+end

data/lib/active_storage_validations/analyzer/image_analyzer.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module ActiveStorageValidations
+  # = ActiveStorageValidations Image \Analyzer
+  #
+  # This is an abstract base class for image analyzers, which extract width and height from an image attachable.
+  #
+  # If the image contains EXIF data indicating its angle is 90 or 270 degrees, its width and height are swapped for convenience.
+  #
+  # Example:
+  #
+  #   ActiveStorageValidations::Analyzer::ImageAnalyzer::ImageMagick.new(attachable).metadata
+  #   # => { width: 4104, height: 2736 }
+  class Analyzer::ImageAnalyzer < Analyzer
+    @@supported_analyzers = {}
+
+    def metadata
+      return {} unless analyzer_supported?
+
+      read_media do |media|
+        if rotated_image?(media)
+          { width: media.height, height: media.width }
+        else
+          { width: media.width, height: media.height }
+        end
+      end
+    end
+
+    private
+
+    def analyzer_supported?
+      if @@supported_analyzers.key?(self)
+        @@supported_analyzers.fetch(self)
+      else
+        @@supported_analyzers[self] = supported?
+      end
+    end
+
+    # Override this method in a concrete subclass. Have it return true if the image is rotated.
+    def rotated_image?(media)
+      raise NotImplementedError
+    end
+
+    # Override this method in a concrete subclass. Have it return true if the analyzer is supported.
+    def supported?
+      raise NotImplementedError
+    end
+  end
+end

data/lib/active_storage_validations/analyzer/null_analyzer.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module ActiveStorageValidations
+  # = ActiveStorageValidations Null Analyzer
+  #
+  # This is a fallback analyzer when the attachable media type is not supported
+  # by our gem.
+  #
+  # Example:
+  #
+  #   ActiveStorageValidations::Analyzer::NullAnalyzer.new(attachable).metadata
+  #   # => {}
+  class Analyzer::NullAnalyzer < Analyzer
+    def metadata
+      {}
+    end
+  end
+end

data/lib/active_storage_validations/analyzer/shared/asv_ff_probable.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module ActiveStorageValidations
+  # ActiveStorageValidations:::ASVFFProbable
+  #
+  # Validator helper methods for analyzers using FFprobe.
+  module ASVFFProbable
+    extend ActiveSupport::Concern
+
+    private
+
+    def read_media
+      Tempfile.create(binmode: true) do |tempfile|
+        begin
+          if media(tempfile).present?
+            yield media(tempfile)
+          else
+            logger.info "Skipping file metadata analysis because ffprobe doesn't support the file"
+            {}
+          end
+        ensure
+          tempfile.close
+        end
+      end
+    rescue Errno::ENOENT
+      logger.info "Skipping file metadata analysis because ffprobe isn't installed"
+      {}
+    end
+
+    def media_from_path(path)
+      instrument(File.basename(ffprobe_path)) do
+        stdout, _stderr, status = Open3.capture3(
+          ffprobe_path,
+          "-print_format", "json",
+          "-show_streams",
+          "-show_format",
+          "-v", "error",
+          path
+        )
+
+        status.success? ? JSON.parse(stdout) : nil
+      end
+    end
+
+    def ffprobe_path
+      ActiveStorage.paths[:ffprobe] || "ffprobe"
+    end
+
+    def video_stream
+      @video_stream ||= streams.detect { |stream| stream["codec_type"] == "video" } || {}
+    end
+
+    def audio_stream
+      @audio_stream ||= streams.detect { |stream| stream["codec_type"] == "audio" } || {}
+    end
+
+    def streams
+      @streams ||= @media["streams"] || []
+    end
+  end
+end

data/lib/active_storage_validations/analyzer/video_analyzer.rb

@@ -0,0 +1,130 @@
+# frozen_string_literal: true
+
+require 'open3'
+require_relative 'shared/asv_ff_probable'
+
+module ActiveStorageValidations
+  # = ActiveStorageValidations Video \Analyzer
+  #
+  # Extracts the following from a video attachable:
+  #
+  # * Width (pixels)
+  # * Height (pixels)
+  # * Duration (seconds)
+  # * Angle (degrees)
+  # * Audio (true if file has an audio channel, false if not)
+  # * Video (true if file has an video channel, false if not)
+  #
+  # Example:
+  #
+  #   ActiveStorageValidations::Analyzer::VideoAnalyzer.new(attachable).metadata
+  #   # => { width: 640, height: 480, duration: 5.0, angle: 0, audio: true, video: true }
+  #
+  # When a video's angle is 90, -90, 270 or -270 degrees, its width and height are automatically swapped for convenience.
+  #
+  # This analyzer requires the {FFmpeg}[https://www.ffmpeg.org] system library, which is not provided by \Rails.
+  class Analyzer::VideoAnalyzer < Analyzer
+    include ASVFFProbable
+
+    def metadata
+      read_media do |media|
+        {
+          width: (Integer(width) if width),
+          height: (Integer(height) if height),
+          duration: duration,
+          angle: angle,
+          audio: audio?,
+          video: video?
+        }.compact
+      end
+    end
+
+    private
+
+    def width
+      if rotated?
+        computed_height || encoded_height
+      else
+        encoded_width
+      end
+    end
+
+    def height
+      if rotated?
+        encoded_width
+      else
+        computed_height || encoded_height
+      end
+    end
+
+    def duration
+      duration = video_stream["duration"] || container["duration"]
+      Float(duration).round(1) if duration
+    end
+
+    def angle
+      if tags["rotate"]
+        Integer(tags["rotate"])
+      elsif display_matrix && display_matrix["rotation"]
+        Integer(display_matrix["rotation"])
+      end
+    end
+
+    def display_matrix
+      side_data.detect { |data| data["side_data_type"] == "Display Matrix" }
+    end
+
+    def display_aspect_ratio
+      if descriptor = video_stream["display_aspect_ratio"]
+        if terms = descriptor.split(":", 2)
+          numerator   = Integer(terms[0])
+          denominator = Integer(terms[1])
+
+          [numerator, denominator] unless numerator == 0
+        end
+      end
+    end
+
+    def rotated?
+      angle == 90 || angle == 270 || angle == -90 || angle == -270
+    end
+
+    def audio?
+      audio_stream.present?
+    end
+
+    def video?
+      video_stream.present?
+    end
+
+    def computed_height
+      if encoded_width && display_height_scale
+        encoded_width * display_height_scale
+      end
+    end
+
+    def encoded_width
+      @encoded_width ||= Float(video_stream["width"]) if video_stream["width"]
+    end
+
+    def encoded_height
+      @encoded_height ||= Float(video_stream["height"]) if video_stream["height"]
+    end
+
+    def display_height_scale
+      @display_height_scale ||= Float(display_aspect_ratio.last) / display_aspect_ratio.first if display_aspect_ratio
+    end
+
+    def tags
+      @tags ||= video_stream["tags"] || {}
+    end
+
+    def side_data
+      @side_data ||= video_stream["side_data_list"] || {}
+    end
+
+    def container
+      @container ||= @media["format"] || {}
+    end
+  end
+end