vtt2ass 0.2.5 → 0.2.11

data/doc/top-level-namespace.html

@@ -86,7 +86,7 @@
     
   
     
-      <strong class="classes">Classes:</strong> <span class='object_link'><a href="ASSFile.html" title="ASSFile (class)">ASSFile</a></span>, <span class='object_link'><a href="ASSStyle.html" title="ASSStyle (class)">ASSStyle</a></span>, <span class='object_link'><a href="ASSSubtitle.html" title="ASSSubtitle (class)">ASSSubtitle</a></span>, <span class='object_link'><a href="Application.html" title="Application (class)">Application</a></span>, <span class='object_link'><a href="VTTSubtitle.html" title="VTTSubtitle (class)">VTTSubtitle</a></span>
+      <strong class="classes">Classes:</strong> <span class='object_link'><a href="ASSFile.html" title="ASSFile (class)">ASSFile</a></span>, <span class='object_link'><a href="ASSLine.html" title="ASSLine (class)">ASSLine</a></span>, <span class='object_link'><a href="ASSStyle.html" title="ASSStyle (class)">ASSStyle</a></span>, <span class='object_link'><a href="ASSStyleParams.html" title="ASSStyleParams (class)">ASSStyleParams</a></span>, <span class='object_link'><a href="Application.html" title="Application (class)">Application</a></span>, <span class='object_link'><a href="VTTFile.html" title="VTTFile (class)">VTTFile</a></span>, <span class='object_link'><a href="VTTLine.html" title="VTTLine (class)">VTTLine</a></span>
     
   
 </p>
@@ -102,9 +102,9 @@
 </div>
 
       <div id="footer">
-  Generated on Thu Jan 14 00:31:16 2021 by
+  Generated on Tue Mar 23 21:07:02 2021 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.26 (ruby-2.7.2).
+  0.9.26 (ruby-3.0.0).
 </div>
 
     </div>

data/lib/vtt2ass.rb

@@ -29,6 +29,9 @@ module Vtt2ass
             opts.on("-s", "--font-size SIZE", Integer, "Specify a font size for the subtitles (default: 52)") do |font_size|
                 options[:font_size] = font_size
             end
+            opts.on("-t", "--title TITLE", String, "Specify a title for you file. If the input is a directory, all files will share the same title.") do |title|
+                options[:title] = title
+            end
             opts.on("-v", "--version", "Show version") do
                 puts Vtt2ass::VERSION
                 exit

data/lib/vtt2ass/ASSFile.rb

@@ -8,6 +8,8 @@ class ASSFile
     attr_reader :title, :width, :height
     attr_accessor :ass_styles, :ass_lines
 
+    ##
+    # Creates a new ASSFile instance and assigns the default values of instance variables.
     def initialize(title, width, height)
         @width = width
         @height = height
@@ -34,6 +36,10 @@ class ASSFile
         @ass_lines = []
     end
 
+    ##
+    # This method receives a VTTFile object and font arguments creates new ASSLine with the params of 
+    # each VTTLine. All those ASSLine are stored in an array. It also creates an array of ASSStyle that
+    # will be used in the ASS style list.
     def convertVTTtoASS(vtt_file, font_family, font_size)
         vtt_file.lines.each do |line|
             @ass_lines.push(ASSLine.new(line.style, line.time_start, line.time_end, line.text))
@@ -50,6 +56,8 @@ class ASSFile
         end
     end
 
+    ##
+    # This method writes the content of the ASSFile object into a file path that is provided.
     def writeToFile(file_path)
         File.open(file_path, 'w') do |line|
             line.print "\ufeff"

data/lib/vtt2ass/ASSLine.rb

@@ -1,3 +1,5 @@
+require 'htmlentities'
+
 ##
 # This class defines an ASS subtile line.
 class ASSLine
@@ -28,6 +30,7 @@ class ASSLine
     #
     # * Requires +text+, a string of VTT formated text as input.  
     def convertToAssText(text)
+        decoder = HTMLEntities.new()
         text = text
             .gsub(/\r/, '')
             .gsub(/\n/, '\\N')
@@ -42,7 +45,7 @@ class ASSLine
             .gsub(/<[^>]>/, '')
             .gsub(/\\N$/, '')
             .gsub(/ +$/, '')
-        return text
+        return decoder.decode(text)
     end
 
     ##
@@ -80,7 +83,7 @@ class ASSLine
     end
     
     ##
-    # The method pads text so that time numbers are a fixed number of digit.
+    # This method pads text so that time numbers are a fixed number of digit.
     #
     # * Requires +sep+, a string separator.
     # * Requires +input+, an integer.

data/lib/vtt2ass/ASSStyle.rb

@@ -20,6 +20,9 @@ class ASSStyle
         @font_size = font_size
         @style_name = style_name
         @s_params = ASSStyleParams.new(params, width, height)
+        if style_name.eql? 'MainTop'
+            @s_params.vertical_margin = 50
+        end
     end
 
     ##

data/lib/vtt2ass/ASSStyleParams.rb

@@ -1,8 +1,12 @@
 ##
 # This class defines the ASS style parameters from VTT cue settings.
 class ASSStyleParams
-    attr_reader :horizontal_margin, :vertical_margin, :alignment, :align
+    attr_accessor :horizontal_margin, :vertical_margin, :alignment, :align
 
+    ##
+    # Creates an instance of ASSStyleParams
+    # It takes VTT style arguments and assign them to their respectful instance variable.
+    # It calls methods to create ASS values from the VTT cue settings.
     def initialize(params, width, height)
         (params.split(' ').map { |p| p.split(':') }).each do |p|
             case p[0]
@@ -20,6 +24,9 @@ class ASSStyleParams
         createVerticalMargin(height)
     end
 
+    ##
+    # This method decides the alignement value in a 9 position grid based of the
+    # values in cue settings "align" and "line".
     def createAlignment()
         if (defined?(@line) and not defined?(@position)) then
             if (defined?(@align)) then
@@ -50,6 +57,9 @@ class ASSStyleParams
         end
     end
 
+    ##
+    # This method calculates the horizontal margin in px between the alignement position and
+    # and the content displayed by using the "position" cue setting.
     def createHorizontalMargin(width)
         steps = (width / 100).to_i
         if defined?(@position) then
@@ -59,6 +69,9 @@ class ASSStyleParams
         end
     end
 
+    ##
+    # This method calculates the vertical margin in px between the alignement position and
+    # and the content displayed by using the "line" cue setting.
     def createVerticalMargin(height)
         steps = (height / 100).to_i
         if defined?(@line) then

data/lib/vtt2ass/Application.rb

@@ -1,6 +1,3 @@
-# Imports
-require 'os'
-
 # Relative imports
 require_relative 'VTTFile'
 require_relative 'ASSFile'
@@ -13,12 +10,15 @@ class Application
     # Creates a new Application instance.
     # It receives +options+ that can define the input and output directories.
     def initialize(options)
-        @input = options[:input] ? options[:input].gsub('\\', '/') : "./"
-        @output = options[:output] ? options[:output].gsub('\\', '/') : "./"
+        @input = options[:input] ? options[:input].gsub('\\', '/').delete_suffix('/') : "."
+        @output = options[:output] ? options[:output].gsub('\\', '/').delete_suffix('/') : "."
         @width = 1920
         @height = 1080
         @font_family = options[:font_family] ? options[:font_family] : 'Open Sans Semibold'
         @font_size = options[:font_size] ? options[:font_size] : 52
+        if options[:title] then
+            @title = options[:title]
+        end
     end
 
     ##
@@ -28,18 +28,25 @@ class Application
     def start
         if File.directory?(@input) then
             Dir["#{@input}/*.vtt"].each do |file_path|
-                vtt_to_ass(file_path).writeToFile(File.basename(file_path).gsub('.vtt', '.ass'))
+                vtt_to_ass(file_path).writeToFile(@output + '/' + File.basename(file_path).gsub('.vtt', '.ass'))
             end
         elsif File.file?(@input) then
-            vtt_to_ass(@input).writeToFile(File.basename(@input).gsub('.vtt', '.ass'))
+            vtt_to_ass(@input).writeToFile(@output + '/' + File.basename(@input).gsub('.vtt', '.ass'))
         else
             puts 'Error: input file or directory does not exist.'
         end
     end
 
+    ##
+    # This method creates a new VTTFile object from the file path provided and convert its content
+    # inside a new ASSFile object.
     def vtt_to_ass(file_path)
         vtt_file = VTTFile.new(file_path)
-        ass_file = ASSFile.new(File.basename(file_path).gsub('.vtt', ''), @width, @height)
+        ass_file = ASSFile.new(
+            (defined?(@title) ? @title : File.basename(file_path).gsub('.vtt', '')),
+            @width,
+            @height
+        )
         ass_file.convertVTTtoASS(vtt_file, @font_family, @font_size)
         return ass_file
     end

data/lib/vtt2ass/VTTFile.rb

@@ -1,6 +1,3 @@
-# Imports
-require 'os'
-
 # Relative imports
 require_relative 'VTTLine'
 
@@ -9,19 +6,32 @@ require_relative 'VTTLine'
 class VTTFile
     attr_accessor :lines
 
+    ##
+    # Creates a new VTTFile instance and assigns the default values of instance variables.
     def initialize(file_path)
         @title = File.basename(file_path).gsub('.vtt', '')
         @lines = []
-        separator = OS.posix? ? "\r\n\r\n": "\n\n"
+        separator = determine_line_ending(file_path) ? "\n\n" : "\r\n\r\n"
+        count = 0
         File.foreach(file_path, separator) do |paragraph|
-            paragraph = paragraph.rstrip.gsub(/\r\n/, "\n")
+            paragraph = paragraph.rstrip.gsub(/[\r\n]/, "\n")
             if not paragraph.eql? "" then
-                @lines.push(VTTLine.new(paragraph))
+                vtt_line = VTTLine.new(paragraph)
+                @lines.push(vtt_line)
+                count += 1
             end
         end
         @lines.shift
     end
 
+    def determine_line_ending(file_path)
+        File.open(file_path, 'r') do |file|
+            return file.readline[/\r?\n$/] == "\n"
+        end
+    end
+
+    ##
+    # This method writes the content of the VTTFile object into a file path that is provided.
     def writeToFile(file_path)
         File.open(file_path, 'w') do |line|
             line.print "\ufeff"
@@ -29,6 +39,8 @@ class VTTFile
         end
     end
 
+    ##
+    # This method concatenates the object data in the right order for a string output.
     def to_s
         return "WEBVTT\n\n\n" + @lines 
     end

data/lib/vtt2ass/VTTLine.rb

@@ -22,7 +22,7 @@ class VTTLine
                 @time_start = m[1]
                 @time_end = m[2]
                 @params = m[3]
-                if @params.include? "align:middle line:7%" then
+                if @params.include? "align:middle line:7%" or @params.include? "align:middle line:10%" then
                     @style = "MainTop"
                 end
             else

data/lib/vtt2ass/version.rb

@@ -1,3 +1,8 @@
+##
+# Vtt2ass module to provide the version number
 module Vtt2ass
-  VERSION = "0.2.5"
+  ##
+  # This is the version of the application.
+  # This needs to be changed for each gem release.
+  VERSION = "0.2.11"
 end

data/vtt2ass.gemspec

@@ -24,4 +24,10 @@ Gem::Specification.new do |spec|
   spec.bindir        = "exe"
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
+
+  spec.add_dependency 'htmlentities'
+
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'minitest'
+  spec.add_development_dependency 'yard'
 end

metadata

@@ -1,15 +1,71 @@
 --- !ruby/object:Gem::Specification
 name: vtt2ass
 version: !ruby/object:Gem::Version
-  version: 0.2.5
+  version: 0.2.11
 platform: ruby
 authors:
 - Louis-Philippe Fortin
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2021-03-13 00:00:00.000000000 Z
-dependencies: []
+date: 2021-04-17 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: htmlentities
+  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'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: 
 email:
 - timemaster.lpf@gmail.com
@@ -27,9 +83,13 @@ files:
 - bin/run
 - bin/setup
 - doc/ASSFile.html
+- doc/ASSLine.html
 - doc/ASSStyle.html
+- doc/ASSStyleParams.html
 - doc/ASSSubtitle.html
 - doc/Application.html
+- doc/VTTFile.html
+- doc/VTTLine.html
 - doc/VTTSubtitle.html
 - doc/Vtt2ass.html
 - doc/Vtt2ass/Error.html