universal_pipe_handler 0.0.10

data/doc/todo/todo_for_the_universal_pipe_handler_project.md

@@ -0,0 +1,300 @@
+# =========================================================================== #
+# This file lists which functions should be included or added into
+# the PipeParadise project.
+# =========================================================================== #
+
+(1) add action:
+
+  exchange_character_in_filename (or another name)
+
+assign file THIS_FILE | replace o with a
+
+^^^ will result in faa.txt
+
+---------------------------------------------------------------
+(2) go through and see if we use many of my modern software
+components already; also check if we can reshuffle .csv
+files
+
+shuffle_tab 5 6
+^^^ should exchange these
+---------------------------------------------------------------
+(3) add this:
+
+burn iso *pdf | xmessage done
+
+# the above burns the pdf, and then when done, shows a
+# message to the user.
+---------------------------------------------------------------
+(4) all action-requires should be bundled into a
+single .rb file, so that we can avoid
+requiring it more than once, like
+file_duration
+
+---------------------------------------------------------------
+(5) continually look at
+  https://github.com/cantino/huginn
+and learn from it
+
+---------------------------------------------------------------
+(6) cat $RUBY_TOOLS/return_random_image.rb | nl | colourize | nl
+
+^^^ Irgendwas ist mit colourize falsch. Der output den man
+bekommt, der scheint auf einmal keine Newlines mehr zu haben.
+
+----------------------------------------------------------------------------------------------------
+(7) 
+- assign foo.avi | add_audio blablabla/mp3 # <--- the same as above...
+---------------------------------------------------------------
+(8) 
+- assign foo.avi | convert to animated gif
+
+^^^ should work. also | convert to image
+somehow the ... command sucks.
+
+-----------------------------------------------------------------------------------------------------
+(11) read file bla | create foobar.rtf
+
+^^^ this triggers the binding of ruby rtf stuff.
+
+
+-----------------------------------------------------------------------------------------------------
+(11) any avi | increase audio delay 3ms
+
+assign avi | decrease audio delay 3ms
+
+assign any avi | increase audio delay 3ms
+
+^^^ use any avi, then increase its audio delay by 3 ms.
+
+-----------------------------------------------------------------------------------------------------
+(11) assign bloodsport.avi | duration 155 - 255 | extract_audio_to /tmp/stored_here.mp3
+                            ^^^ This is in seconds
+
+Das hier soll das bloodsport avi assigned, von der sekunden zahl hinspringen und 
+den audio teil rausholen. Synonym sollte auch dies hier gehen:
+
+assign bloodsport.avi | at 00:45:02 | for 20 seconds | extract_audio | save to /tmp/stored_here.mp3
+
+Das macht das selbe. UND danach das ganze natürlich dokumentieren.
+
+
+
+-----------------------------------------------------------------------------------------------------
+
+
+read this_file | starts_with? X
+
+read this_file | starts_with? pqr
+
+  cat LINUX.cgi | egrep '^A' | sort | uniq | wc -l
+  
+  read file foo.txt | starts_with? X | sort | uniq | word_count # print longest line
+
+This counts the number of unique lines in the text file that 
+begin with X. The great thing is that it's quite readable.
+You can read the data left to right.
+
+alias egrep starts_with?
+
+IMPLEMENT:
+  starts_with?
+
+
+-----------------------------------------------------------------------------------------------------
+
+
+match_regex
+
+
+  
+- Video und Audio Processing sollte funktionieren wie mit Avisynth.
+
+open foo.avi | increase audio 2% | duration 5%..50% | crop video 300x150 | filter huffyman | save_to /x.avi | upload_to default
+
+
+
+
+
+find_all "hier kommt die condition..."
+find_all scripts
+
+
+- find_all "hier kommt die condition..." | remove <--- die wird reingepiped.
+   ^^^ das hier wurde schon realisiert      ^^^ das hier verstehe ich nicht ... was will ich da entfernen???
+   und funzt mehr oder weniger.
+
+
+
+- assign audio_song | cut 30% # or cut 0-30, 30% defaults from start to 30% of lenght
+- assign audio_song | cut -30% # reverse. 
+
+
+- we also want to have the ability to use system() for unix things when the command was not registered.
+  but perhaps make this a toggleable setting.
+
+
+
+- automatically create an animated gif somehow... with several images
+
+
+- Eine lose Idee: Wenn eine action nichts gscheites rausgibt ... das dem user sagen
+
+
+
+- grep # to grep for a specific string.
+
+  cat foo | grep blablabla
+   
+    -> alias search_for, searchfor, sfor
+
+
+
+
+- | repackage to squashfs
+      ^^^ this shit did not work!
+
+
+
+- ein allgemeiner fokus is das wir image-dateien manipulieren können, z.bsp
+  
+    rasterize (sollte ein raster machen auf ein image)
+    rasterize: -> image_rasterize
+    
+  Das scheint ziemlich schwer zu sein...
+
+
+
+
+
+>>> [1, 2, 3, 4, 5] | add
+15
+
+>>> [5, 4, 3, 2, 1] | sort
+[1, 2, 3, 4, 5]
+
+[1, 2, 3, 4, 5]
+
+The base class of Pipe is kept simple (7 lines of python) and 
+is usable as a decorator permitting you to create new 
+'pipeable' functions easily. The module provides ~30
+ prepared pipes functions like 'where', 'group_by', 
+ 'sort', 'take_while' 
+  A pipeable 
+ function takes an iterable (tuple, list, generator) 
+ and yields to be itself an iterator, so
+  pipeable function can be piped together.
+
+
+
+- [1, 2, 3, 4, 5] | select even
+- [1, 2, 3, 4, 5] | select odd
+select all even or odd numbers.
+without []
+
+
+[1, 2, 3, 4, 5] | add
+[1, 2, 3, 4, 5] . add
+
+
+
+
+
+
+
+
+
+---------------------------------------------------------------
+
+master_pipe.assign_data = blablabla
+
+We need a way to assign data before the master pipe starts
+its actions. This is the default action! First action always!
+
+assign data |
+
+will always be the first thing that happens!!!
+
+Can be nil.
+
+
+---------------------------------------------------------------
+
+
+flip left right (flip a video left-right)
+
+
+---------------------------------------------------------------
+
+- find . -name '*.rb' | xargs wc -l
+
+ ^^^ das muss auch gehen...
+
+
+
+
+
+---------------------------------------------------------------
+
+- implement: 
+
+   "upload to youtube"
+
+
+
+---------------------------------------------------------------
+
+
+http://www.sean-crist.com/personal/pages/visual_pipes/
+
+  ^^^ ensure that the master pipe can use this too.
+
+
+---------------------------------------------------------------
+Austesten ob "married with bloopers" rausschneiden kann.
+Dazu brauchen wir eine Testdatei, bla.avi.
+
+  assign bla.avi | video_cut 30s | save #APPEND#_modified
+  
+
+  assign bla.avi | video_cut 20-1630s | save #APPEND#_modified
+
+Beides sollte funktionieren.
+
+---------------------------------------------------------------
+
+die conversions aus dem multimedia_project hinzufügen
+
+---------------------------------------------------------------
+
+
+<bradland> shevy: regarding audio, when removing duration,
+ trucate is a good term. when altering amplitude, attenuate/amplify would be the terms used.
+
+<bradland> cool
+<bradland> when designing your API, think of duration as its own entity
+<bradland> most editing is done using markers, referred to as in & out
+<bradland> once markers ar eset, you perform an operation
+<bradland> it's a nice set of abstractions for designing and api
+
+
+- add a way to install stuff
+
+---------------------------------------------------------------
+
+merge video #
+We need a simple way to append new videos to an existing
+video, so that we can chain together different videos,
+automatically, without having to worry about encoding
+and such.
+
+
+---------------------------------------------------------------
+
+- enable or verify that this works:
+
+download https://www.youtube.com/watch?v=UZr75lLiE6k
+we will use youtube-dl for now.
+
+- add rblanks as well to the list of commands that can
+  be done.

data/lib/universal_pipe_handler/base/base.rb

@@ -0,0 +1,147 @@
+#!/usr/bin/ruby -w
+# Encoding: UTF-8
+# frozen_string_literal: true
+# =========================================================================== #
+# === UniversalPipeHandler::Base
+#
+# Usage example:
+#
+#   UniversalPipeHandler::Base.new(ARGV)
+#
+# =========================================================================== #
+# require 'universal_pipe_handler/base/base.rb'
+# < Base
+# =========================================================================== #
+module UniversalPipeHandler
+
+class Base # === UniversalPipeHandler::Base
+
+  require 'universal_pipe_handler/colours/colours.rb' # Mandatory.
+  include Colours
+
+  require 'fileutils'
+
+  require 'universal_pipe_handler/toplevel_methods/all_actions.rb'
+
+  # ========================================================================= #
+  # === NAMESPACE
+  # ========================================================================= #
+  NAMESPACE = inspect
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      commandline_arguments = nil,
+      run_already           = true
+    )
+    reset
+    set_commandline_arguments(
+      commandline_arguments
+    )
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    # ======================================================================= #
+    # === @namespace
+    # ======================================================================= #
+    @namespace = NAMESPACE
+  end
+
+  # ========================================================================= #
+  # === set_commandline_arguments
+  # ========================================================================= #
+  def set_commandline_arguments(i = '')
+    i = [i].flatten.compact
+    @commandline_arguments = i
+  end
+
+  # ========================================================================= #
+  # === commandline_arguments?
+  # ========================================================================= #
+  def commandline_arguments?
+    @commandline_arguments
+  end
+
+  # ========================================================================= #
+  # === first_argument?
+  # ========================================================================= #
+  def first_argument?
+    @commandline_arguments.first
+  end; alias first? first_argument? # === first?
+
+  # ========================================================================= #
+  # === allowed_actions?
+  #
+  # Return every allowed action. This will not be needed by every
+  # subclass, so perhaps this may have to be changed at one point
+  # in time.
+  # ========================================================================= #
+  def allowed_actions?
+    ::UniversalPipeHandler.all_actions?
+  end; alias registered_actions? allowed_actions? # === registered_actions?
+
+  # ========================================================================= #
+  # === copy
+  # ========================================================================= #
+  def copy(from, to)
+    FileUtils.copy(from, to)
+  end
+
+  # ========================================================================== #
+  # === remove_quotes
+  # ========================================================================== #
+  def remove_quotes(i)
+    i.delete('"')
+  end
+
+  # ========================================================================= #
+  # === mkdir
+  # ========================================================================= #
+  def mkdir(i)
+    FileUtils.mkdir_p(i)
+  end
+
+  # ========================================================================= #
+  # === chdir
+  # ========================================================================= #
+  def chdir(i)
+    FileUtils.chdir(i)
+  end; alias cd chdir # === cd
+
+  # ========================================================================= #
+  # === register_sigint
+  # ========================================================================= #
+  def register_sigint
+    Signal.trap('SIGINT') { exit }
+  end
+
+  # ========================================================================= #
+  # === run                                                         (run tag)
+  # ========================================================================= #
+  def run
+  end
+
+  # ========================================================================= #
+  # === return_pwd
+  # ========================================================================= #
+  def return_pwd
+    "#{Dir.pwd}/".squeeze('')
+  end
+
+  # ========================================================================= #
+  # === UniversalPipeHandler::Base[]
+  # ========================================================================= #
+  def self.[](i = '')
+    new(i)
+  end
+
+end; end
+
+if __FILE__ == $PROGRAM_NAME
+  UniversalPipeHandler::Base.new(ARGV)
+end # base.rb