multimedia_paradise 1.1.344 → 1.2.2

data/lib/multimedia_paradise/multimedia/base.rb

@@ -39,22 +39,4 @@ class MultimediaBase < ::MultimediaParadise::Base # === MultimediaParadise::Mult
     super()
   end
 
-  # ========================================================================= #
-  # === is_audio_file?
-  # ========================================================================= #
-  def is_audio_file?(i)
-    ::MultimediaParadise.is_audio_file?(i)
-  end; alias is_audio_song?    is_audio_file? # === is_audio_song?
-       alias is_an_audio_file? is_audio_file? # === is_audio_file?
-
-  # ========================================================================= #
-  # === filter_for_audio_files
-  #
-  # We will filter for audio files - so we will keep only files that
-  # are audio files.
-  # ========================================================================= #
-  def filter_for_audio_files(i)
-    i.select {|file| is_audio_file?(file) }
-  end
-
 end; end

data/lib/multimedia_paradise/multimedia/chord.rb

@@ -114,7 +114,7 @@ class Chord # === MultimediaParadise::Chord
         'Not enough notes in chord for a proper inversion.'
     end
     note_array = @notes.to_a.sort
-    notes = (0 .. .amount).map { note_array.shift.adjust_by_semitones(12) }
+    notes = (0 ... amount).map { note_array.shift.adjust_by_semitones(12) }
     Chord.new(notes + note_array)
   end
 

data/lib/multimedia_paradise/multimedia/cut_multimedia/cut_multimedia.rb

@@ -1380,11 +1380,11 @@ class CutMultimedia < ::MultimediaParadise::MultimediaBase # === MultimediaParad
     e rev+'of your file in question. When you are '\
       'done, input '+sfancy('run')
     e rev+'to start the cutting. (Remember: Start positions are '+
-      'like '+sfancy('s1')+', end'
+      'like '+sfancy('s1')+rev+', end'
     e "#{rev}positions are like #{sfancy('e40')}.)#{N}#{N}"
     e rev+'You can also use some extra commands, like "'+
-      simp(:length).to_s+'".'
-    e rev+'Use "help" to display the help menu.'
+      simp(:length).to_s+rev+'".'
+    e "#{rev}Use \"help\" to display the help menu."
     e "#{N}#{simp('Hint:')} #{rev}You can use #{simp('s11')}"\
       "#{rev} and #{simp('e22')} #{rev}to denote a start time"
     e rev+'      at position '+simp('11').to_s+rev+' seconds and an end '+
@@ -1796,7 +1796,8 @@ class CutMultimedia < ::MultimediaParadise::MultimediaBase # === MultimediaParad
       @array_all_start_positions << i.to_f # Store as float.
       if be_verbose
         twentyfour_notation = forestgreen(to_twentyfour_notation(i))
-        e "#{rev}Setting a start point at: #{simp(i)} [#{twentyfour_notation}]"
+        e "#{rev}Setting a start point at: #{simp(i)} "\
+          "#{rev}[#{twentyfour_notation}]"
         feedback_all_start_points
       end
     end
@@ -1877,7 +1878,8 @@ class CutMultimedia < ::MultimediaParadise::MultimediaBase # === MultimediaParad
       end_positions? << i.to_f # Append the end point as a float-value here.
       if be_verbose
         twentyfour_notation = forestgreen(to_twentyfour_notation(i).to_f.to_s)
-        e "#{rev}Setting an end point at: #{simp(i)} #{rev}[#{twentyfour_notation}]"
+        e "#{rev}Setting an end point at: #{simp(i)} "\
+          "#{rev}[#{twentyfour_notation}#{rev}]"
         feedback_all_end_points
       end
     end

data/lib/multimedia_paradise/multimedia/cut_multimedia/evaluate_from_this_file.rb

@@ -5,15 +5,15 @@
 # require 'multimedia_paradise/multimedia/cut_multimedia/evaluate_from_this_file.rb'
 # =========================================================================== #
 require 'multimedia_paradise/multimedia/base.rb'
-require 'multimedia_paradise/multimedia/cut_multimedia/cut_multimedia.rb'
 
 module MultimediaParadise
 
 class CutMultimedia < ::MultimediaParadise::MultimediaBase # === MultimediaParadise::CutMultimedia
 
+  require 'multimedia_paradise/multimedia/cut_multimedia/cut_multimedia.rb'
   require 'multimedia_paradise/toplevel_methods/e.rb'
   require 'multimedia_paradise/toplevel_methods/esystem.rb'
-  require 'multimedia_paradise/toplevel_methods/merge_multimedia_file.rb'
+  require 'multimedia_paradise/toplevel_methods/merge.rb'
   require 'multimedia_paradise/audio/wav_to_mp3.rb'
 
   # ========================================================================= #

data/lib/multimedia_paradise/multimedia/interactive_shell.rb

@@ -46,9 +46,21 @@ class InteractiveShell < ::MultimediaParadise::Base
   # === menu                                                       (menu tag)
   # ========================================================================= #
   def menu(i)
-    case i
+    case i # case tag
+    # ======================================================================= #
+    # === check-numbers
+    # ======================================================================= #
+    when /Check(-| )?Numbers/i
+      action(:CheckNumbers)
+    # ======================================================================= #
+    # === pwd
+    # ======================================================================= #
     when 'pwd'
-      e Dir.pwd
+      # e sdir(return_pwd)
+      show_prompt
+    # ======================================================================= #
+    # === q
+    # ======================================================================= #
     when 'q','quit','exit'
       :do_exit
     else
@@ -59,7 +71,14 @@ class InteractiveShell < ::MultimediaParadise::Base
   end
 
   # ========================================================================= #
-  # === run
+  # === show_prompt
+  # ========================================================================= #
+  def show_prompt
+    print steelblue(return_pwd)+royalblue('> ')
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
   # ========================================================================= #
   def run
     loop {

data/lib/multimedia_paradise/multimedia/merge_multimedia.rb

@@ -22,7 +22,7 @@ module MultimediaParadise
 
 class MergeMultimedia < ::MultimediaParadise::Base # === MultimediaParadise::MergeMultimedia
 
-  require 'multimedia_paradise/toplevel_methods/merge_multimedia_file.rb'
+  require 'multimedia_paradise/toplevel_methods/merge.rb'
 
   # ========================================================================= #
   # === initialize
@@ -123,5 +123,6 @@ end; end
 
 if __FILE__ == $PROGRAM_NAME
   MultimediaParadise::MergeMultimedia.new(ARGV)
-end # merge_multimedia
-    # merge_multimedia a.webm b.webm
+end # mergemultimedia
+    # mergemultimedia a.webm b.webm
+    # mergemultimedia one.mp4 two.mp4

data/lib/multimedia_paradise/multimedia/play_from_this_list.rb

@@ -22,11 +22,6 @@ module MultimediaParadise
 
 class PlayFromThisList < ::MultimediaParadise::Base # === MultimediaParadise::PlayFromThisList
 
-  # ========================================================================= #
-  # === NAMESPACE
-  # ========================================================================= #
-  NAMESPACE = inspect
-
   # ========================================================================= #
   # === initialize
   # ========================================================================= #
@@ -46,36 +41,18 @@ class PlayFromThisList < ::MultimediaParadise::Base # === MultimediaParadise::Pl
   # ========================================================================= #
   def reset
     super()
-    # ======================================================================= #
-    # === @namespace
-    # ======================================================================= #
-    @namespace = NAMESPACE
+    infer_the_namespace
     # ======================================================================= #
     # === @dataset
     # ======================================================================= #
     @dataset = nil
   end
 
-  # ========================================================================= #
-  # === set_input
-  # ========================================================================= #
-  def set_commandline_arguments(i = '')
-    i = [i].flatten.compact
-    @commandline_arguments = i
-  end
-
-  # ========================================================================= #
-  # === commandline_arguments?
-  # ========================================================================= #
-  def commandline_arguments?
-    @commandline_arguments
-  end
-
   # ========================================================================= #
   # === determine_from_which_list_to_play
   # ========================================================================= #
   def determine_from_which_list_to_play
-    first = @commandline_arguments.first
+    first = first?
     if first
       if first.is_a? String
         # =================================================================== #
@@ -116,7 +93,7 @@ class PlayFromThisList < ::MultimediaParadise::Base # === MultimediaParadise::Pl
   # ========================================================================= #
   def play_the_files_in_the_dataset
     if @dataset.nil? or @dataset.empty?
-      opnn; e 'No valid input has been given to this class.'
+      opne 'No valid input has been given to this class.'
     else
       @dataset.each {|entry| play_this_file(entry) }
     end
@@ -129,7 +106,7 @@ class PlayFromThisList < ::MultimediaParadise::Base # === MultimediaParadise::Pl
     if i.include? "'"
       i = '"'+i+'"'
     end
-    esystem "#{MultimediaParadise.use_this_player} #{i}"
+    esystem "#{use_which_player?} #{i}"
   end
 
   # ========================================================================= #

data/lib/multimedia_paradise/multimedia/{read_meta_tags.rb → read_meta_tags/read_meta_tags.rb}

@@ -2,14 +2,14 @@
 # Encoding: UTF-8
 # frozen_string_literal: true
 # =========================================================================== #
-# === MultimediaParadise::ReadMetaTags
+# === MultimediaParadise::Multimedia::ReadMetaTags
 #
 # This class can read the meta tags of e. g. .mp3 files and so forth,
 # and display them. It requires TagLib for this to work, presently.
 #
 # Usage example:
 #
-#   MultimediaParadise::ReadMetaTags.new
+#   MultimediaParadise::Multimedia::ReadMetaTags.new
 #
 # =========================================================================== #
 # require 'multimedia_paradise/multimedia/read_meta_tags.rb'
@@ -18,12 +18,9 @@ require 'multimedia_paradise/base/base.rb'
 
 module MultimediaParadise
 
-class ReadMetaTags < ::MultimediaParadise::Base # === MultimediaParadise::ReadMetaTags.new
+module Multimedia
 
-  # ========================================================================= #
-  # === NAMESPACE
-  # ========================================================================= #
-  NAMESPACE = inspect
+class ReadMetaTags < ::MultimediaParadise::Base # === MultimediaParadise::Multimedia::ReadMetaTags
 
   # ========================================================================= #
   # === N_LJUST
@@ -51,10 +48,7 @@ class ReadMetaTags < ::MultimediaParadise::Base # === MultimediaParadise::ReadMe
     # === @title
     # ======================================================================= #
     @title = nil
-    # ======================================================================= #
-    # === @namespace
-    # ======================================================================= #
-    @namespace = NAMESPACE
+    infer_the_namespace
   end
 
   # ========================================================================= #
@@ -132,10 +126,11 @@ class ReadMetaTags < ::MultimediaParadise::Base # === MultimediaParadise::ReadMe
   # ========================================================================= #
   def try_to_load_the_taglib_library
     begin
-      require 'taglib-ruby'
-    rescue LoadError
+      require 'taglib' # require 'taglib-ruby'
+    rescue LoadError => error
       e 'The taglib-ruby gem is not installed. Consider installing '\
         'it ( gem install taglib ).'
+      pp error
       exit
     end
   end
@@ -151,23 +146,23 @@ class ReadMetaTags < ::MultimediaParadise::Base # === MultimediaParadise::ReadMe
   end
 
   # ========================================================================= #
-  # === []
+  # === MultimediaParadise::Multimedia::ReadMetaTags[]
   # ========================================================================= #
-  def self.[](i = '')
+  def self.[](i = ARGV)
     new(i)
   end
 
-end
+end; end
 
 # =========================================================================== #
 # === MultimediaParadise.read_meta_tags_of_this_file
 # =========================================================================== #
 def self.read_meta_tags_of_this_file(i)
-  MultimediaParadise::ReadMetaTags.new(i)
+  MultimediaParadise::Multimedia::ReadMetaTags.new(i)
 end
  
 end
 
 if __FILE__ == $PROGRAM_NAME
-  MultimediaParadise::ReadMetaTags.new(ARGV)
-end # read_meta_tags *mp3
+  MultimediaParadise.read_meta_tags_of_this_file(ARGV)
+end # readmetatags *mp3

data/lib/multimedia_paradise/multimedia/start_length_duration.rb

@@ -17,7 +17,7 @@
 # =========================================================================== #
 module MultimediaParadise
 
-class StartLengthDuration
+class StartLengthDuration # === MultimediaParadise::StartLengthDuration
 
   begin
     require 'colours'
@@ -50,7 +50,7 @@ class StartLengthDuration
   end
 
   # ========================================================================= #
-  # === reset
+  # === reset                                                     (reset tag)
   # ========================================================================= #
   def reset
     @length   = 0
@@ -86,7 +86,7 @@ class StartLengthDuration
   # === calculate_span
   # ========================================================================= #
   def calculate_span # the @span is start to duration. Like: '30-50'
-    @span = @start.to_s+'-'+(@start + @duration).to_s
+    @span = "#{@start}-"+(@start + @duration).to_s
   end
 
   # ========================================================================= #

data/lib/multimedia_paradise/project/project.rb

@@ -29,9 +29,8 @@ module MultimediaParadise
   # This constant points to the main yaml-directory of this project,
   # but it may be better to use the method below this constant.
   # ========================================================================= #
-  PROJECT_YAML_DIRECTORY =
-    "#{MultimediaParadise::PROJECT_BASE_DIRECTORY}yaml/"
-
+  # PROJECT_YAML_DIRECTORY = # Removed as of 03.03.2024.
+    
   # ========================================================================= #
   # === MultimediaParadise.project_yaml_dir?
   #
@@ -41,7 +40,12 @@ module MultimediaParadise
   #
   # ========================================================================= #
   def self.project_yaml_dir?
-    PROJECT_YAML_DIRECTORY
+    "#{MultimediaParadise.project_base_dir?}yaml/"
   end; self.instance_eval { alias project_yaml_directory? project_yaml_dir? } # === MultimediaParadise.project_yaml_directory?
 
+end
+
+if __FILE__ == $PROGRAM_NAME
+  alias e puts
+  e MultimediaParadise.project_yaml_dir?
 end

data/lib/multimedia_paradise/requires/require_the_multimedia_paradise_project.rb

@@ -4,10 +4,10 @@
 # =========================================================================== #
 require 'multimedia_paradise/project/project.rb'
 require 'multimedia_paradise/constants/constants.rb'
-require 'multimedia_paradise/ffmpeg/ffmpeg.rb'
-require 'multimedia_paradise/commandline/menu.rb'
-require 'multimedia_paradise/misc/long_format_to_milliseconds_converter.rb'
-require 'multimedia_paradise/misc/milliseconds_to_long_format_converter.rb'
+require 'multimedia_paradise/toplevel_methods/ffmpeg.rb'
+require 'multimedia_paradise/commandline/commandline.rb'
+require 'multimedia_paradise/time/long_format_to_milliseconds_converter.rb'
+require 'multimedia_paradise/time/milliseconds_to_long_format_converter.rb'
 # =========================================================================== #
 # Add all the toplevel-requires next:
 # =========================================================================== #
@@ -35,4 +35,4 @@ require 'multimedia_paradise/requires/require_the_sinatra_components.rb'
 
 require 'multimedia_paradise/multimedia/video_downloader/video_downloader.rb'
 
-require 'multimedia_paradise/conversions/conversions.rb'
+require 'multimedia_paradise/toplevel_methods/conversions.rb'

data/lib/multimedia_paradise/requires/require_toplevel_methods_files.rb

@@ -14,7 +14,7 @@ module MultimediaParadise
   # === MultimediaParadise.require_toplevel_methods_files
   # ========================================================================= #
   def self.require_toplevel_methods_files
-    target = "#{MultimediaParadise.project_base_dir?}toplevel_methods/*.rb"
+    target = "#{project_base_dir?}toplevel_methods/*.rb"
     these_files = Dir[target] # We will require these files here.
     these_files.each {|file|
       this_file = "multimedia_paradise/toplevel_methods/#{File.basename(file)}"

data/lib/multimedia_paradise/sinatra/app.rb

@@ -16,9 +16,9 @@ require 'sinatra'
 
 class Sinatra < ::Sinatra::Base # === MultimediaParadise::Sinatra
 
-  require 'multimedia_paradise/constants/encodings.rb'
-  require 'multimedia_paradise/toplevel_methods/files_and_directories.rb'
-  require 'multimedia_paradise/toplevel_methods/output_directory.rb'
+  require 'multimedia_paradise/constants/constants.rb'
+  require 'multimedia_paradise/toplevel_methods/files_related_code.rb'
+  require 'multimedia_paradise/toplevel_methods/directory_related_code.rb'
   require 'multimedia_paradise/video/n_videos.rb'
 
   begin

data/lib/multimedia_paradise/statistics/README.md

@@ -1,5 +1,6 @@
-This directory contains code that may be useful if the user
-wishes to obtain statistical information, such as the 
-local video collection or local audio collection. This will
-initially be tailored towards my use cases though - if 
-someone else wants to make use of it, drop me an email.
+This directory contains code that may be useful if the user wishes
+to obtain statistical information, such as the local video collection
+or local audio collection. This will initially be tailored towards
+my use cases though - if someone else wants to make use of it, drop
+me an email. I will write code that can remain flexible, so other
+users can adjust it to their own use cases.

data/lib/multimedia_paradise/statistics/video.rb

@@ -12,7 +12,8 @@
 #   MultimediaParadise::Statistics::Video.new
 #
 # =========================================================================== #
-# require 'multimedia_paradise/video/encode_video'
+# require 'multimedia_paradise/statistics/video.rb'
+# MultimediaParadise.statistics_about_the_local_videos
 # =========================================================================== #
 require 'multimedia_paradise/base/base.rb'
 
@@ -22,17 +23,23 @@ module Statistics
 
 class Video < ::MultimediaParadise::Base # === MultimediaParadise::Statistics::Video
 
-  require 'multimedia_paradise/video/store_available_video_files.rb'
-
   # ========================================================================= #
   # === initialize
   # ========================================================================= #
   def initialize(
       i           = ARGV,
-      run_already = true
+      run_already = true,
+      &block
     )
     reset
     set_commandline_arguments(i)
+    # ======================================================================= #
+    # === Handle blocks given to this method next
+    # ======================================================================= #
+    if block_given?
+      yielded = yield
+      pp yielded
+    end
     run if run_already
   end
 
@@ -48,36 +55,49 @@ class Video < ::MultimediaParadise::Base # === MultimediaParadise::Statistics::V
   # === run                                                         (run tag)
   # ========================================================================= #
   def run
-    opne 'Next showing some information about the local video files:'
+    opnn { :no_trailing }
+    e; e
+    e "#{rev}Next showing some information about the local video files."
+    e
     all_video_files = Dir['/home/x/video/**/**'].select {|entry|
       is_a_video_file?(entry)
     }
     e 'There are a total of '+steelblue(all_video_files.size)+
-      ' video files existing locally.'
+      rev+' video files existing locally.'
     e
-    e '  How many real videos exist? '.ljust(36)+steelblue(
+    e rev+'  How many real videos exist? '.ljust(36)+steelblue(
         all_video_files.select {|inner_entry|
-          inner_entry.include?('/Realvids')
+          inner_entry.include?('/realvids')
         }.size.to_s.rjust(3)
       )
-    e '  How many real life videos exist? '.ljust(36)+steelblue(
+    e rev+'  How many real life videos exist? '.ljust(36)+steelblue(
         all_video_files.select {|inner_entry|
-          inner_entry.include?('/Reallife')
+          inner_entry.include?('/reallife')
         }.size.to_s.rjust(3)
       )
-    e '  How many MMA videos exist? '.ljust(36)+steelblue(
+    e rev+'  How many MMA videos exist? '.ljust(36)+steelblue(
         all_video_files.select {|inner_entry|
-          inner_entry.include?('/MMA')
+          inner_entry.include?('/mixed_martial_arts')
         }.size.to_s.rjust(3)
       )
+    e
     # ======================================================================= #
     # Delegate to class MultimediaParadise::StoreAvailableVideoFiles next.
     # ======================================================================= #
-    MultimediaParadise::StoreAvailableVideoFiles.new
+    action(:StoreAvailableVideoFiles) { :no_opn } # Call the correct action here.
     e
   end
 
-end; end; end
+end; end
+
+# =========================================================================== #
+# === MultimediaParadise.statistics_about_the_local_videos
+# =========================================================================== #
+def self.statistics_about_the_local_videos(&block)
+  MultimediaParadise::Statistics::Video.new(&block)
+end
+
+end
 
 if __FILE__ == $PROGRAM_NAME
   MultimediaParadise::Statistics::Video.new(ARGV)

data/lib/multimedia_paradise/{misc → time}/long_format_to_milliseconds_converter.rb

@@ -4,12 +4,14 @@
 # =========================================================================== #
 # === MultimediaParadise::LongFormatToMillisecondsConverter
 #
+# This is a standalone class.
+#
 # Usage example:
 #
 #   MultimediaParadise::LongFormatToMillisecondsConverter.new
 #
 # =========================================================================== #
-# require 'multimedia_paradise/misc/long_format_to_milliseconds_converter.rb'
+# require 'multimedia_paradise/time/long_format_to_milliseconds_converter.rb'
 # MultimediaParadise.long_format_to_milliseconds(ARGV)
 # =========================================================================== #
 module MultimediaParadise
@@ -157,7 +159,7 @@ class LongFormatToMillisecondsConverter # === MultimediaParadise::LongFormatToMi
   #   MultimediaParadise::LongFormatToMillisecondsConverter['00:33:32.70']
   #
   # ========================================================================= #
-  def self.[](i)
+  def self.[](i = ARGV)
     new(i).result? # This returns the result in milliseconds.
   end
 

data/lib/multimedia_paradise/{misc → time}/milliseconds_to_long_format_converter.rb

@@ -9,7 +9,7 @@
 #   MultimediaParadise::MillisecondsToLongFormatConverter.new(ARGV)
 #
 # =========================================================================== #
-# require 'multimedia_paradise/misc/milliseconds_to_long_format_converter.rb'
+# require 'multimedia_paradise/time/milliseconds_to_long_format_converter.rb'
 # MultimediaParadise.milliseconds_to_long_format
 # =========================================================================== #
 module MultimediaParadise
@@ -124,7 +124,7 @@ class MillisecondsToLongFormatConverter # MillisecondsToLongFormatConverter
   # ========================================================================= #
   def verbose_report
     e @n_milliseconds.to_s+' milliseconds correspond '+
-      'to '+@result.to_s+' in long format.'
+      "to #{@result} in long format."
   end
 
   # ========================================================================= #