universal_pipe_handler 0.0.10

data/lib/universal_pipe_handler/cmdlets/count_longest_row.rb

@@ -0,0 +1,21 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'universal_pipe_handler/cmdlets/count_longest_row.rb'
+# =========================================================================== #
+module UniversalPipeHandler
+
+  # ========================================================================= #
+  # === UniversalPipeHandler.cmdlet_count_longest_row
+  # ========================================================================= #
+  def self.cmdlet_count_longest_row
+    n_number = 0
+    result?.each {|_|
+      n_number = _.size unless n_number > _.size
+    }
+    set_result(n_number)
+    return result?
+  end; self.instance_eval { alias count_longest_row cmdlet_count_longest_row } # === UniversalPipeHandler.count_longest_row
+
+end

data/lib/universal_pipe_handler/cmdlets/crop.rb

@@ -0,0 +1,26 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'universal_pipe_handler/cmdlets/crop.rb'
+# =========================================================================== #
+module UniversalPipeHandler
+
+  # ========================================================================= #
+  # === UniversalPipeHandler.cmdlet_crop
+  #
+  # This method can be used to crop an image.
+  # ========================================================================= #
+  def self.cmdlet_crop(
+      crop_command_to_use = result?
+    )
+    filename = result?
+    crop = ImageParadise::Crop.new(
+      filename, crop_command_to_use, :dont_run_yet
+    )
+    crop.run
+    set_result(crop.result?)
+    return result?
+  end; self.instance_eval { alias crop cmdlet_crop } # === UniversalPipeHandler.crop
+
+end

data/lib/universal_pipe_handler/cmdlets/cut.rb

@@ -0,0 +1,101 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'universal_pipe_handler/cmdlets/cut.rb'
+# =========================================================================== #
+module UniversalPipeHandler
+
+  # ========================================================================= #
+  # === UniversalPipeHandler.cmdlet_cut                             (cut tag)
+  #
+  # This action allows you to cut a video or audio file.
+  #
+  # The input can be as complex as "20%-50%".
+  # ========================================================================= #
+  def self.cmdlet_cut(
+      start_position        = result?,
+      duration_in_n_seconds = nil
+    )
+    # To prepare for the duration. bl $RUBY_TIME/start_length_duration.rb
+    start_length_duration = MultimediaParadise::StartLengthDuration.new
+    start_position = start_position.first if start_position.is_a? Array # Trying this since Dec 2014.
+    # original_input = start_position.dup
+    _ = Multimedia::FileDuration.new(result?) # This will contain the filename.
+    # ======================================================================= #
+    # === Handle percent-input next
+    #
+    # This can be either -30 or 30. If we count more than one %, we treat the
+    # whole instruction as a range.
+    # ======================================================================= #
+    if start_position.include?('%')
+      # ===================================================================== #
+      # Enter a %-Range next:
+      # ===================================================================== #
+      if start_position.count('%') > 1 # This here is valid if we have something like "30%-80%"
+        splitted = start_position.split('%')
+        end_pos_in_percent = splitted[-1].to_f.abs
+        duration_in_n_seconds = _.one_percent * end_pos_in_percent
+      else # else we have just one %.
+        start_position = start_position.to_i.abs
+      end
+    end
+    length = _.file_duration # Get the absolute length of the file here.
+    # ========================================================================= #
+    # We set the total length of the file here. This is useful because
+    # we can use this information to calculate extra things.
+    # ========================================================================= #
+    start_length_duration.length = length
+    this_file = result?.first
+    e 'The total length of the file '+sfile(this_file)+' is '+
+      simportant(length.to_s)+' seconds.'
+    _ = 'ffmpeg -y -i '+this_file # Build our sys string here. -y so we overwrite our string.
+    # ========================================================================= #
+    # The variable save_to will keep track of where we will store the newly
+    # generated file (in other words, the output file).
+    # ========================================================================= #
+    save_to = start_dir?+
+              File.basename(this_file.gsub(/\.mp3/,''))+'_ouput'
+    # ========================================================================= #
+    # Hack, hack hackety hack.
+    # ========================================================================= #
+    if File.extname(this_file) == '.mp4'
+      save_to << '.mp4'
+    else
+      save_to << '.mp3'
+    end
+    unless duration_in_n_seconds
+      duration_in_n_seconds = start_position.to_i 
+    end
+    start_position = 0 # Default.
+    # ========================================================================= #
+    # If @position has been set, then we will add the position both to the
+    # start position, and to the end position.
+    # ========================================================================= #
+    if @position
+      start_position = start_position.to_i + @position
+    end
+    # ========================================================================= #
+    # Use StartLengthDuration now to get the required info.
+    # ========================================================================= #
+    start_length_duration.start        = start_position
+    start_length_duration.set_duration = duration_in_n_seconds
+    _ << ' -ss '+start_length_duration.start.to_s
+    _ << ' -t '+(start_length_duration.duration).to_s
+    # ========================================================================= #
+    # The problem with -acodec copy is that an AAC file can not be easily 
+    # copied into a .mp3 file. Hence we must use -acodec libmp3lame
+    # instead here.
+    # ========================================================================= #
+    if save_to.include? 'mp3'
+      _ << ' -acodec libmp3lame '
+    else
+      _ << ' -acodec copy '
+    end
+    _ << save_to
+    esystem "  #{_}"
+    set_result(save_to)
+    result?
+  end; self.instance_eval { alias cut cmdlet_cut } # === UniversalPipeHandler.cut
+
+end

data/lib/universal_pipe_handler/cmdlets/days.rb

@@ -0,0 +1,41 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'universal_pipe_handler/cmdlets/days.rb'
+# =========================================================================== #
+module UniversalPipeHandler
+
+  # ========================================================================= #
+  # === UniversalPipeHandler.cmdlet_days?
+  #
+  # The input should be amount of seconds.
+  #
+  # However had, this is context-dependent and thus a bit difficult to
+  # handle correctly.
+  #
+  # For instance, take these two different inputs:
+  #
+  #     '5 years | days?'
+  #     '45 days | n_seconds?'
+  #
+  # The first variant obviously gives us n seconds to days?, and then
+  # days? can output the amount of days.
+  #
+  # The second variant should however had simply give us the amount of
+  # seconds that 45 days have.
+  #
+  # The convention thus will be that we will always convert into seconds,
+  # and when it is fed into n_seconds? then we will not do any further
+  # modification.
+  # ========================================================================= #
+  def self.cmdlet_days?(i = result?)
+    i = i.join.strip if i.is_a? Array
+    # result = i.to_f / ONE_DAY_HAS_N_SECONDS.to_f
+    # i = result.floor
+    set_result(i)
+    return result?
+  end; self.instance_eval { alias action_days?   cmdlet_days? } # === UniversalPipeHandler.action_days?
+       self.instance_eval { alias action_n_days? cmdlet_days? } # === UniversalPipeHandler.action_days?
+
+end

data/lib/universal_pipe_handler/cmdlets/decolourize.rb

@@ -0,0 +1,25 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'universal_pipe_handler/cmdlets/decolourize.rb'
+# =========================================================================== #
+module UniversalPipeHandler
+
+  # ========================================================================= #
+  # === UniversalPipeHandler.cmdlet_decolourize
+  #
+  # This method will get rid of the colours from a video file.
+  # ========================================================================= #
+  def self.cmdlet_decolourize(
+      this_file = result?
+    )
+    this_file = this_file.first if this_file.is_a? Array
+    output_file = 'decolourized_file_'+File.basename(this_file)
+    _ = 'ffmpeg -i '+this_file+' -vf format=gray '+output_file
+    esystem _
+    set_result(output_file)
+    return result? 
+  end; self.instance_eval { alias decolourize cmdlet_decolourize } # === UniversalPipeHandler.decolourize
+
+end

data/lib/universal_pipe_handler/cmdlets/download.rb

@@ -0,0 +1,30 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'universal_pipe_handler/cmdlets/download.rb'
+# =========================================================================== #
+module UniversalPipeHandler
+
+  begin
+    require 'wget'
+  rescue LoadError; end
+
+  # ========================================================================= #
+  # === UniversalPipeHandler.cmdlet_download
+  #
+  # Download a file via this cmdlet.
+  # ========================================================================= #
+  def self.cmdlet_download(i)
+    if Object.const_defined? :Wget # Then use WgetWrapper if it is available.
+      Wget.new(i)
+    else
+      cmd = 'wget '+i
+      run_sys_cmd(cmd)
+    end
+    @file = File.basename(i)
+    set_result @file
+    result?
+  end; self.instance_eval { alias download cmdlet_download } # === UniversalPipeHandler.download
+
+end

data/lib/universal_pipe_handler/cmdlets/download_torrent.rb

@@ -0,0 +1,17 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'universal_pipe_handler/cmdlets/torrent.rb'
+# =========================================================================== #
+module UniversalPipeHandler
+
+  # ========================================================================= #
+  # === UniversalPipeHandler.cmdlet_torrent
+  # ========================================================================= #
+  def self.cmdlet_torrent
+    cmdlet_search_torrent
+    cmdlet_download(result?)
+  end; self.instance_eval { alias torrent cmdlet_torrent } # === UniversalPipeHandler.torrent
+
+end

data/lib/universal_pipe_handler/cmdlets/duration.rb

@@ -0,0 +1,34 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'universal_pipe_handler/cmdlets/duration.rb'
+# =========================================================================== #
+module UniversalPipeHandler
+
+  begin
+    require 'multimedia_paradise/audio/file_duration/file_duration.rb'
+  rescue LoadError; end
+
+  # ========================================================================= #
+  # === UniversalPipeHandler.cmdlet_duration
+  # ========================================================================= #
+  def self.cmdlet_duration(
+      i = result?
+    )
+    n_seconds = 0
+    if i.is_a? Array
+      i.each {|entry|
+        _ = Multimedia::FileDuration.new(entry)
+        n_seconds += _.duration?
+      }
+    else
+      _ = Multimedia::FileDuration.new(i)
+      n_seconds += _.duration?
+    end
+    result = 'Duration of `'+sfile(i)+'`: '+sfancy(n_seconds.to_s)+' seconds.'
+    set_result(result)
+    return result?
+  end; self.instance_eval { alias duration cmdlet_duration } # === UniversalPipeHandler.duration
+
+end

data/lib/universal_pipe_handler/cmdlets/extract.rb

@@ -0,0 +1,27 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'universal_pipe_handler/cmdlets/extract.rb'
+# =========================================================================== #
+module UniversalPipeHandler
+
+  # ========================================================================= #
+  # === UniversalPipeHandler.cmdlet_extract
+  #
+  # Here we will extract the audio and the video.
+  # ========================================================================= #
+  def self.cmdlet_extract(i = nil)
+    _ = result?
+    if i.is_a? Array
+      case i.first
+      when 'audio'
+        action_extract_audio _, Dir.pwd
+      end
+    else # Delegate towards the two other methods here.
+      action_extract_audio _, Dir.pwd
+      action_extract _
+    end
+  end; self.instance_eval { alias extract cmdlet_extract } # === UniversalPipeHandler.extract
+
+end

data/lib/universal_pipe_handler/cmdlets/extract_all.rb

@@ -0,0 +1,23 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'universal_pipe_handler/cmdlets/extract_all.rb'
+# =========================================================================== #
+module UniversalPipeHandler
+
+  # ========================================================================= #
+  # === UniversalPipeHandler.cmdlet_extract_all
+  # ========================================================================= #
+  def self.cmdlet_extract_all(dir = result?)
+    dir = dir.first if dir.is_a? Array
+    all_files = get_all_files_from(dir)
+    all_files.each { |file|
+      _ = extract_aller.new(file, :dont_run_yet) # If it is an archive, extract_all it.
+      _.set_extract_all_to_this_location(dir) # We will extract_all into the same directory.
+      _.run
+    }
+    set_result(all_files)
+  end; self.instance_eval { alias extract_all cmdlet_extract_all } # === UniversalPipeHandler.extract_all
+
+end

data/lib/universal_pipe_handler/cmdlets/extract_audio.rb

@@ -0,0 +1,30 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'universal_pipe_handler/cmdlets/extract_audio.rb'
+# =========================================================================== #
+module UniversalPipeHandler
+
+  # ========================================================================= #
+  # === UniversalPipeHandler.cmdlet_extract_audio
+  #
+  # This method will extract audio from a video container.
+  #
+  # We will make use of the project ExtractAudio for this, so we
+  # absolutely depend on that project.
+  #
+  # The functionality is implemented as part of the multimedia_paradise
+  # gem.
+  # ========================================================================= #
+  def self.cmdlet_extract_audio(
+      i                    = result?,
+      optional_store_where = nil
+    )
+    e "Extracting audio from #{sfancy(i)} next." if be_verbose?
+    _ = MultimediaParadise.extract_audio(i, optional_store_where)
+    set_result(_)
+    return result?
+  end; self.instance_eval { alias extract_audio cmdlet_extract_audio } # === UniversalPipeHandler.extract_audio
+
+end

data/lib/universal_pipe_handler/cmdlets/extract_video.rb

@@ -0,0 +1,18 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'universal_pipe_handler/cmdlets/extract_video.rb'
+# =========================================================================== #
+module UniversalPipeHandler
+
+  # ========================================================================= #
+  # === UniversalPipeHandler.cmdlet_extract_video
+  #
+  # Simply delegate towards MultimediaParadise.
+  # ========================================================================= #
+  def self.cmdlet_extract_video(i = result?)
+    MultimediaConversions.extract_video(i)
+  end; self.instance_eval { alias extract_video cmdlet_extract_video } # === UniversalPipeHandler.extract_video
+
+end

data/lib/universal_pipe_handler/cmdlets/find_all.rb

@@ -0,0 +1,40 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'universal_pipe_handler/cmdlets/find_all.rb'
+# =========================================================================== #
+module UniversalPipeHandler
+
+  # ========================================================================= #
+  # === UniversalPipeHandler.cmdlet_find_all                       (find tag)
+  #
+  # This cmdlet can be used in similar ways as "grep".
+  # ========================================================================= #
+  def self.cmdlet_find_all(
+      search_term = commandline_arguments?
+    )
+    keyphrase_to_search_for = search_term
+    if keyphrase_to_search_for.is_a? Array
+      keyphrase_to_search_for = keyphrase_to_search_for.first
+    end
+    e 'Now searching for the term `'+
+      sfancy(keyphrase_to_search_for)+'`:'+N+N
+    dataset = result?
+    dataset = dataset.reject {|line|
+      line !~ /#{keyphrase_to_search_for}/ # Here we apply the "grep" action.
+    }
+    colourize = true
+    # ======================================================================= #
+    # If we enable colourizing the result, then we will add swarn(search_term)
+    # ======================================================================= #
+    if colourize
+      dataset.map! {|entry|
+        entry.gsub!(/(#{keyphrase_to_search_for})/, swarn("\\1"))
+      }
+    end
+    set_result(dataset)
+    return result?
+  end; self.instance_eval { alias find_all cmdlet_find_all } # === UniversalPipeHandler.find_all
+
+end

data/lib/universal_pipe_handler/cmdlets/generate_random_video.rb

@@ -0,0 +1,29 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'universal_pipe_handler/cmdlets/generate_random_video.rb'
+# =========================================================================== #
+module UniversalPipeHandler
+
+  # ========================================================================= #
+  # === UniversalPipeHandler.cmdlet_generate_random_video
+  #
+  # We generate a random video here.
+  #
+  # The second argument is a hash that can keep extra options.
+  # ========================================================================= #
+  def self.cmdlet_generate_random_video(i = result?, hash_with_options = {})
+    output_file = 'output.mpg'
+    if hash_with_options.has_key? :duration
+      duration = 'duration='+hash_with_options.delete(:duration)
+    else
+      duration = 'duration=15' # The default.
+    end
+    _ = 'ffmpeg -f lavfi -i testsrc='+duration+':size=1280x720:rate=30 '+output_file
+    esystem _
+    set_result(output_file)
+    return result?
+  end; self.instance_eval { alias generate_random_video cmdlet_generate_random_video } # === UniversalPipeHandler.generate_random_video
+
+end

data/lib/universal_pipe_handler/cmdlets/generate_string.rb

@@ -0,0 +1,27 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'universal_pipe_handler/cmdlets/generate_string.rb'
+# =========================================================================== #
+module UniversalPipeHandler
+
+  # ========================================================================= #
+  # === UniversalPipeHandler.cmdlet_generate_string
+  #
+  # This method will simply generate a random string.
+  #
+  # action_generate_string 25, false
+  #
+  # ========================================================================= #
+  def self.cmdlet_generate_string(
+      max = 50,
+      assign_to_result = true
+    )
+    alphabet = ('a'..'z').to_a << ' '
+    _ = (0...max).map { alphabet.sample }.join
+    set_result(_) if assign_to_result
+    return result?
+  end; self.instance_eval { alias generate_string cmdlet_generate_string } # === UniversalPipeHandler.generate_string
+
+end

data/lib/universal_pipe_handler/cmdlets/get_all_audio_files.rb

@@ -0,0 +1,33 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'universal_pipe_handler/cmdlets/get_all_audio_files.rb'
+# =========================================================================== #
+module UniversalPipeHandler
+
+  # ========================================================================= #
+  # === UniversalPipeHandler.cmdlet_get_all_audio_files
+  #
+  # We depend on the action "get all files" for this method here.
+  #
+  # We will obtain all audio files from the current working directory,
+  # by first obtaining all files, and then applying a filter.
+  # ========================================================================= #
+  def self.cmdlet_get_all_audio_files(
+      from = Dir.pwd
+    )
+    from = '/Depot/Audio' if from.nil?
+    _ = action_get_all_audio_files(from)
+    # ======================================================================= #
+    # Next, we apply a filter to get only the audio files:
+    # ======================================================================= #
+    _.reject! {|entry|
+      entry = File.extname(entry).delete('.')
+      ! ARRAY_AUDIO_FILES.include?(entry)
+    }
+    set_result(_) # We use this result.
+    return _      
+  end; self.instance_eval { alias get_all_audio_files cmdlet_get_all_audio_files } # === UniversalPipeHandler.get_all_audio_files
+
+end

data/lib/universal_pipe_handler/cmdlets/get_all_files.rb

@@ -0,0 +1,61 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'universal_pipe_handler/cmdlets/get_all_files.rb'
+# =========================================================================== #
+module UniversalPipeHandler
+
+  require 'universal_pipe_handler/toplevel_methods/misc.rb'
+
+  # ========================================================================= #
+  # === UniversalPipeHandler.cmdlet_get_all_files                 (files tag)
+  #
+  # Invoked via list_content(). We use expand_path here to get the
+  # real absolute path. It will return all files that matched a
+  # certain criteria.
+  #
+  # The first argument is the target directory. This MUST include a
+  # trailing '/' - the method here will NOT append a trailing '/'.
+  #
+  # The second argument, called `include_the_subdirectories`, instructs this method
+  # to traverse into subdirectories.
+  # ========================================================================= #
+  def self.cmdlet_get_all_files(
+      from_this_directory = :try_to_use_the_working_directory_variable,
+      include_the_subdirectories     = false
+    )
+    if from_this_directory.is_a? Array
+      from_this_directory = from_this_directory.first
+    end
+    case from_this_directory
+    # ======================================================================= #
+    # === :default
+    # ======================================================================= #
+    when :default, :def, nil
+      from_this_directory = return_pwd
+    # ======================================================================= #
+    # === :try_to_use_the_working_directory_variable
+    # ======================================================================= #
+    when :try_to_use_the_working_directory_variable
+      from_this_directory = UniversalPipeHandler.working_directory?
+      if from_this_directory.nil?
+        from_this_directory = return_pwd
+      end
+    end
+
+    @target_directory = from_this_directory # this may have to be changed eventually.
+    if @target_directory.start_with? ':' # assume it is a special keyword.
+      @target_directory = sanitize_url(@target_directory)
+    end
+    target = @target_directory+'**'
+    target = @target_directory+'**/**' if include_the_subdirectories
+    _ = Dir[target].map {|entry| File.expand_path(entry) }
+    set_result(_)
+    return result? # We will return all found files.      
+  end; self.instance_eval { alias get_all_files      cmdlet_get_all_files } # === UniversalPipeHandler.get_all_files
+       self.instance_eval { alias get_all_files_from cmdlet_get_all_files } # === UniversalPipeHandler.get_all_files_from
+       self.instance_eval { alias list_content       cmdlet_get_all_files } # === UniversalPipeHandler.list_content
+       self.instance_eval { alias cmdlet_ls          cmdlet_get_all_files } # === UniversalPipeHandler.cmdlet_ls
+
+end

data/lib/universal_pipe_handler/cmdlets/get_all_images.rb

@@ -0,0 +1,47 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'universal_pipe_handler/cmdlets/get_all_images.rb'
+# =========================================================================== #
+module UniversalPipeHandler
+
+  # ========================================================================= #
+  # === UniversalPipeHandler.cmdlet_get_all_images
+  #
+  # The first argument specifies from where we get the image files.
+  #
+  # In order for this to work, we will tap into the method called
+  # action_get_all_files().
+  # ========================================================================= #
+  def self.cmdlet_get_all_images(
+      dir             = start_directory?,
+      include_subdirs = false
+    )
+    if dir.is_a? Hash
+      if dir.has_key? :from
+        dir = dir.delete :from
+      end
+    end
+    if dir == :include_subdirs
+      dir = start_directory?
+      include_subdirs = true
+    end
+    dir = dir.first if dir.is_a? Array
+    dir << '/' unless dir.end_with? '/'
+    dir = sanitize_url(dir)
+    dir = dir.first if dir.is_a? Array # We must check again here due to sanitize_url().
+    case dir.delete('/')
+    when 'njoy_dir','njoy'
+      dir = '/home/x/data/images/NJOY/'
+    end
+    @target_directory = dir # this may have to be changed eventually.
+    _ = action_get_all_files(target_directory?, include_subdirs)
+    _.select! {|file|
+      ARRAY_IMAGE_FILE_TYPES.include?(File.extname(file).delete('.'))
+    }
+    set_result(_)
+    return result?
+  end; self.instance_eval { alias get_all_images cmdlet_get_all_images } # === UniversalPipeHandler.get_all_images
+
+end