cremefraiche 1.1.8

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 48cc0065d28074c113f879f7dbc47e424b78a52e75f54eeb74f25d287658e8c6
+  data.tar.gz: 16b22c86a2c3843de9a3000c336108196bb2deb480eaff8761f8d22b2cb07075
+SHA512:
+  metadata.gz: 6a668022a9d83c0977c6f53fd0b8ab19cb9ebfb5b74ddc8d3203862ce7daf369a28b7abc55259dcde290f7224cbba4f1edc1ce4a4b6d8ff4680aee646d824830
+  data.tar.gz: ee181963d9fbf566b13a40777c78295d01503d449145746a64a76bdb10d1050e96d2d4e39ba0db8622b4c54a97a1c6b969c03491d005d5829f14b69790406b8a

data/README.md

@@ -0,0 +1,114 @@
+Creme Fraîche
+=======================
+Email to PDF Konverter 
+------------------------------------------
+
+SYNOPSIS
+=======================
+
+**cremefraiche [eml-files] ...**
+
+**cremefraiche < mail**
+
+**cremefraicheGui**
+
+
+
+DESCRIPTION
+=======================
+This program converts email to PDF. The objective is to keep readable
+versions of the messages, HTML versions of the processed mails are simplified,
+colors and images are lost in the process.
+
+The resulting mails will be created either
+
+* in the same directory alongside the original eml files
+
+* when 1 mail is piped-in to cremefraiche, in the *current working directory*.
+  In this case, the new PDF-file will overwrite, if it exists, an existing file
+  *001_mail_message.pdf*
+
+**ATTN!** Not all html flavors will result in usable PDF; reacting to all
+possible variations in the way that Mail is created these days, is an ongoing
+endeavor. If you need authentic output of a HTML mail, **use a different
+software**, a Web Browser or a converter specifically developed for the task.
+
+CONFIGURATION
+===============
+Cremefraiche is highly configurable. 
+
+To create your own version of the configuration file in order to modify
+the behavior of the program, execute cremefraiche once with the only 
+argument “user-conf”:
+ 
+**user@machine:~$ cremefraiche user-conf**
+
+The file will be written in a hidden subdirectory *.cremefraiche* and is 
+named *config*. It is full of explanations and it should be no problem to do the
+necessary adaptations directly in the file.
+
+You can also set and modify values in the GUI, after pushing the button
+that refers to the configuration.
+
+The Graphical User Interface
+============================
+Execute 
+
+**cremefraicheGui**.
+
+The simplistic GUI serves to keep a list of eml files for repeated conversion
+to PDF. You can also exempt files from this list from an immediate conversion
+but keep it for later use. 
+
+In the GUI, you can also decide to interrupt running conversions in a
+way that necessitates a kill-signal in the console version of the program. 
+
+Other Information
+=================
+
+pipe-in a mail from STDIN
+--------------------------
+You can pipe in mails to cremefraiche. This is useful for use in conjunction
+with mail-clients that allow such operation, notably the *Mutt* mail client.
+For Mutt, it is sufficient to define two macros in the file .muttrc :
+
+<code>macro index X "|cremefraiche -\n"          "make PDF"</code>
+
+<code>macro pager X "|cremefraiche -\n"          "make PDF"</code>
+
+This will enable the Shortcut *Shift-x* in the mail index and in the pager.
+
+Source-Code
+-----------
+The gem-file that you get with the gem-utility or from rubygems.org contains  
+all the code of the program and some documentation (this page notably). To read  
+its content, you must
+
+1. untar the gem-file with tar _-xf cremefraiche-1.1.7.gem_
+2. uncompress the data.gz archive: _gunzip data.gz_
+3. untar the resultig data.tar archive: _tar -xf data.tar_
+
+This creates the directories bin, doc and lib.
+
+Why « Crème Fraîche » ?
+-----------------------
+As with *Crème Fraîche* you create splendid meals from otherwise frugal 
+ingredients, I found it a good name for the initial versions of the program.
+
+In the meantime – and under the influence of too much HTML garbage – I wonder
+what you will make of it. Though simplifying the HTML-mail that I receive, in
+an effort to make it readable, is still an objective.
+
+License
+-------
+**Cremefraiche** is distributed under the conditions of the WTFPL-2.0 or later  
+License (see http://www.wtfpl.net/txt/copying/ or license-text in the doc  
+directory of the gem-file).
+
+Author
+-----
+Cremefraiche has been developed by  
+Michael Uplawski <michael.uplawski@uplawski.eu>
+
+Ω
+==

data/bin/cremefraiche

@@ -0,0 +1,117 @@
+#!/usr/bin/env ruby
+#encoding: UTF-8
+=begin
+/***************************************************************************
+ *   ©2011-2023, Michael Uplawski <michael.uplawski@uplawski.eu>           *
+ *                                                                         *
+ *   This program is free software; you can redistribute it and/or modify  *
+ *   it under the terms of the WTFPL 2.0 or later version of the  LICENSE. *
+ *   See https://wtfpl2.com/ for details.                                  * 
+ *                                                                         *
+ *   This program is distributed in the hope that it will be useful,       *
+ *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
+ *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.                  *
+ *                                                                         *
+ ***************************************************************************/
+=end
+
+$WIN = (RUBY_PLATFORM =~ /mswin/)
+
+require_relative '../lib/translating'
+require_relative '../lib/basic_logging'
+require_relative '../lib/cremefraiche'
+require_relative '../lib/confcheck'
+require_relative '../lib/version'
+
+extend(BasicLogging)
+extend(Translating)
+
+# prints the usage message
+def usage
+  if $WIN
+    system 'cls'
+  else
+    system( 'clear')
+  end
+  prog_version = (App_name.dup << ' ' << trl("version %s") %[VERSION])
+  sub_title = trl('EML to PDF converter')
+  width = 32 + [prog_version, sub_title].max {|a, b| a.length <=>b.length}.length
+  hr = '━' * width
+
+  ustr = []
+  ustr << " ┏%s┓" %hr
+  ustr << " ┃%#{width - 16}s                ┃" %prog_version
+  ustr << " ┃%#{width - 16}s                ┃" %sub_title
+  ustr << " ┗%s┛" %hr
+  ustr << ''
+  ustr << " © %s %s %s" %[YEARS, Author, Author_mail] 
+  ustr << ''
+  ustr << " %s" %(trl("Running with Ruby %s on %s") %[RUBY_VERSION, RUBY_PLATFORM])
+  ustr << ''
+  u = trl("Usage")
+  ulen = u.length + 1;
+  ustr << " %s:" %u
+  ustr << ('▔' * ulen )
+  ustr << " \tuser@machine:~$ cremefraiche [%s.eml] <%s.eml ... %s(n).eml>" %[trl('eml_file1'), trl('eml_file2'), trl('eml_file')]
+  ustr << ''
+  ustr << " %s" %trl('This produces 1 PDF-file for each individual email found in the given eml-file(s).')
+  ustr << " %s:" %trl("Please see the file 'config' in the program- or gem-folder for some options")
+  ustr << " \t%s" %[$CONF.config_file]
+  ustr << ''
+  ustr << " %s:" %trl("To create or update a user-version of the configuration-file")
+  ustr << ('▔' * ulen )
+  ustr << " \tuser@machine:~$ ruby cremefraiche user-conf" 
+  ustr << ''
+  ustr << " %s %s" %[trl("Use literally 'user-conf' as argument."), trl("This either creates or overwrites\n a configuration file in a sub-directory '.cremefraiche' of the current user's home-directory")]
+  ustr << "\n"
+  ustr << "This program is free software under the terms of the WTFPL version 2 or later. "
+  ustr << "It is provided as is with no guarantees of any kind."
+  ustr << "\n" * 2
+  ustr.join("\n")
+end
+
+
+
+if(ARGV && ARGV.flatten.empty? )
+  debug('printing usage-message')
+  puts usage()
+elsif ARGV[0] && 'user-conf' == ARGV[0].chomp
+  debug('handling user-configuration')
+  handle_user_conf
+end
+
+
+cf = CremeFraiche.instance()
+cf.process(*ARGV)
+
+# Should a user wish to either update her/his private version of the configuration-file by the current
+# contents of the file originally found in the downloaded program package, this function does the job.
+# It creates a copy of the original file, also, if there is not yet one, in ~/.cremefraiche/config or 
+# whatever the Configuration-singleton returns as file-name for user_configuration.
+def handle_user_conf
+  conf_check = ConfCheck.new()
+  diffs = conf_check.diffs
+  replace = false
+  if( diffs)
+    if(diffs && diffs[:missing].empty? && diffs[:additional].empty?)
+      puts trl("No changes to your user-configuration are necessary.")
+      return false;
+    else
+      m = diffs[:missing]
+      a = diffs[:additional]
+      puts trl("\nThe following changes can be effectuated on your user-configuration")
+      puts "\t+ " << trl("New options") << ":\n\t\t" << m.join('\n\t\t ') if !m.empty?
+      puts "\t- " << trl("Obsolete Options") << ":\n\t\t" << a.join(', ') if !a.empty?
+      puts trl("Do you want to replace your current user-configuration?")
+      puts trl("If you answer 'yes' a back-up copy of your old file will still be available.")
+      puts trl("But your old settings will be replaced by the defaults.")
+      print trl("Your answer (Y/n): ")
+      replace = STDIN.getc.downcase == trl("y") ? true : false
+    end
+    if(! replace)
+      return false;
+    end
+  end
+  conf_check.write_user_conf	
+  return replace;
+end

data/bin/cremefraicheGui

@@ -0,0 +1,26 @@
+#!/usr/bin/env ruby
+#encoding: UTF-8
+=begin
+/***************************************************************************
+ *   ©2011-2013, Michael Uplawski <michael.uplawski@uplawski.eu>           *
+ *                                                                         *
+ *   This program is free software; you can redistribute it and/or modify  *
+ *   it under the terms of the GNU General Public License as published by  *
+ *   the Free Software Foundation; either version 3 of the License, or     *
+ *   (at your option) any later version.                                   *
+ *                                                                         *
+ *   This program is distributed in the hope that it will be useful,       *
+ *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
+ *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
+ *   GNU General Public License for more details.                          *
+ *                                                                         *
+ *   You should have received a copy of the GNU General Public License     *
+ *   along with this program; if not, write to the                         *
+ *   Free Software Foundation, Inc.,                                       *
+ *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
+ ***************************************************************************/
+
+
+=end
+require_relative '../lib/gui/cremefraicheGui'
+CremeFraicheGui.new(ARGV)

data/cremefraiche.gemspec

@@ -0,0 +1,24 @@
+require_relative "lib/version"
+require 'date'
+
+Gem::Specification.new do |s|
+  s.version     = VERSION
+  s.name        = File.basename(__FILE__, '.gemspec')
+  s.date        = Date.today.strftime('%F')
+  s.summary     = SUMMARY
+  s.description = "transforms EML files to PDF"
+  s.authors     = Author
+  s.email       = Author_mail
+  s.files  	=  Dir.children('doc').collect{|f| 'doc/' << File::path(f)} + Dir.children('bin').collect{|f| 'bin/' << File::path(f)} + Dir.children('lib').collect{|f| 'lib/' << File::path(f) } + Dir.children('lib/gui/').collect{|f| 'lib/gui/' << File::path(f) } + Dir.children('lib/icon').collect{|f| 'lib/icon/' << File::path(f) } + Dir.children('lib/busy_indicator').collect{|f| 'lib/busy_indicator/' << File::path(f) } + %w~cremefraiche.gemspec~.collect{|f|f} << "README.md"
+  s.homepage    = ''
+  s.requirements = 'prawn prawn-table escape nokogiri mail gtk3'
+  s.add_runtime_dependency 'prawn', '~> 2.4', '>= 2.4.0'
+  s.add_runtime_dependency 'prawn-table', '~> 0.2', '>= 0.2.2'
+  s.add_runtime_dependency 'escape', '~> 0.0', '>= 0.0.4'
+  s.add_runtime_dependency 'nokogiri', '~> 1.13', '>= 1.13.10'
+  s.add_runtime_dependency 'mail', '~> 2.8', '>= 2.8.0'
+  s.add_runtime_dependency 'gtk3', '~> 4.0', '>= 4.0.5'
+  s.executables = 'cremefraiche', 'cremefraicheGui'
+  s.license     = 'GPL-3.0'
+  s.required_ruby_version = '>= 2.5'
+end

data/lib/LANG

@@ -0,0 +1 @@
+en

data/lib/basic_logging.rb

@@ -0,0 +1,170 @@
+#!/bin/env ruby
+#encoding: UTF-8
+=begin
+/***************************************************************************
+ *   ©2013-2023, Michael Uplawski <michael.uplawski@uplawski.eu>           *
+ *                                                                         *
+ *   This program is free software; you can redistribute it and/or modify  *
+ *   it under the terms of the WTFPL 2.0 or later, see                     * 
+ *   http://www.wtfpl.net/about/                                           *
+ *                                                                         *
+ *   This program is distributed in the hope that it will be useful,       *
+ *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
+ *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.                  *
+ *                                                                         *
+ ***************************************************************************/
+=end
+
+#
+# Simplified logging. 
+# See example code at the bottom of this file.
+# Execute this file to see the output.
+#
+
+#require 'time'
+
+module BasicLogging
+
+  DEBUG = 0
+  INFO =  1
+  WARN =  2
+  ERROR = 3
+  FATAL = 4
+  UNKNOWN = nil
+  
+  # this is mainly for the translation of method calls into log levels
+  Levels = {:debug => DEBUG, :info => INFO, :warn => WARN, :error => ERROR,
+            :fatal => FATAL, :unknown => UNKNOWN}
+
+  @@log_level = UNKNOWN
+  @@target = STDOUT
+  @@muted = []
+
+  # do not log, if caller is name (class or instance)
+  def self.mute(obj)
+    name = obj.class == Class ? obj.name.dup : obj.class.name
+    @@muted << name
+  end
+
+  def self.is_muted?(obj)
+    name = obj.class == Class ? obj.name.dup : obj.class.name
+    @@muted.include?(name)  
+  end
+
+  # set the log level for the calling class or object
+  def set_level(lv)
+    if lv.respond_to?(:to_str)
+      lv = Levels[lv.to_sym]
+    end
+    if(!lv || (lv.respond_to?(:to_int) && lv >= DEBUG && lv <= FATAL) )
+      @@log_level = lv
+    else
+      STDERR.puts __FILE__.dup << ": ERROR : invalid log level \"" << lv.to_s << "\""
+      STDERR.puts "Keepinng old log level " << Levels.keys.detect {| k| Levels[k] == @@log_level}.to_s
+    end
+  end
+
+  # set the log target for the calling class or object
+  def set_target(tg)
+    if tg.respond_to?(:to_io) 
+      @@target = tg
+    elsif(!File::exist?(tg) || ( File.file?(tg) && File.writable?(tg) ) )
+      @@target = File.open(tg, 'w+')  
+    else
+      STDERR.puts __FILE__.dup << ': ERROR : target ' << tg << ' cannot be set'
+      STDERR.puts "Keeping old target " << @@target.inspect
+      return
+    end
+  end
+
+  # Output of log messages, depending on the log level set for the calling class
+  # and the name of the alias method which is actually called.
+  def log(message)
+    if !BasicLogging.is_muted?(self)
+      # how has this method been called?
+      mlevel = __callee__
+      if Levels.has_key?(mlevel) && Levels[mlevel] <=  FATAL
+        # output only for levels equal or above the value that corresponds to
+        # the calling alias.
+        format_log( message, mlevel) if @@log_level && Levels[mlevel] >= @@log_level 
+      else
+        STDERR.puts __FILE__.dup << ": ERROR : invalid log level \"" << mlevel.to_s << "\""
+      end
+    end
+  end
+
+  alias :debug :log
+  alias :info :log
+  alias :warn :log
+  alias :error :log
+  alias :fatal :log
+
+  attr_reader :target, :log_level
+
+  private 
+
+  # 1 format_log for all loggers.
+  def format_log(message, mlevel)
+    # indicate if a registered class or the registered object of a class is calling.
+    name = self.class == Class ? self.name.dup << ' [class]' : self.class.name
+    @@target.puts '' << name << ' ' << mlevel.to_s << ' ' << Time.now.strftime("%H:%M:%S:%6N")  << ': ' << message
+  end
+end
+#---------test: execute file----------
+if $0 == __FILE__
+  Array.extend(BasicLogging)
+  Array.set_level(BasicLogging::INFO)
+  Array.info('TEST')
+  ar = Array.new
+  ar.extend(BasicLogging)
+  # --- no output : 
+  l = __LINE__
+  ar.debug(l.next.to_s << ': debug-test 0')
+  # output
+  ar.set_level(BasicLogging::DEBUG)
+  l = __LINE__
+  ar.debug(l.next.to_s << ': debug-test 1')
+
+  obj = Object.new
+  obj.extend(BasicLogging)
+  obj.set_level(BasicLogging::DEBUG)
+  puts "--------debug-----------"
+  obj.debug('debug')
+  obj.info('info')
+  obj.warn('warn')
+  obj.error('error')
+  obj.fatal('fatal')
+  puts "--------info-----------"
+  obj.set_level("info")
+  obj.debug('debug')
+  obj.info('info')
+  obj.warn('warn')
+  obj.error('error')
+  obj.fatal('fatal')
+  puts "--------fatal-----------"
+  obj.set_level("fatal")
+  obj.debug('debug')
+  obj.info('info')
+  obj.warn('warn')
+  obj.error('error')
+  obj.fatal('fatal')
+  puts "--------UNKNOWN-----------"
+  obj.set_level(nil)
+  obj.debug('debug')
+  obj.info('info')
+  obj.warn('warn')
+  obj.error('error')
+  obj.fatal('fatal')
+  puts " ------ Output into file ----"
+  obj.set_target "/tmp/test_log.log"
+  puts " ------ INFO -----------"
+  obj.set_level BasicLogging::INFO
+  obj.info('info output')
+
+  obj.info('info output 2') 
+  puts "---------- invalid -------"
+  obj.set_target "/dev/sr0"
+  obj.set_level "power"
+end
+
+# EOF 

data/lib/busy_indicator/busy_function_test.rb

@@ -0,0 +1,50 @@
+#encoding: UTF-8
+=begin
+/***************************************************************************
+ *   ©2011-2023, Michael Uplawski <michael.uplawski@uplawski.eu>           *
+ *                                                                         *
+ *   This program is free software; you can redistribute it and/or modify  *
+ *   it under the terms of the WTFPL 2.0 or later version of the  LICENSE. *
+ *   See https://wtfpl2.com/ for details.                                  * 
+ *                                                                         *
+ *   This program is distributed in the hope that it will be useful,       *
+ *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
+ *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.                  *
+ *                                                                         *
+ ***************************************************************************/
+
+ A test and demo for the BusyIndicator.
+ This does not use the final BusyIndicator but directly creates
+ a Thread.
+=end
+require './color_output'
+
+def clean_busy_indicator(thr, width, comment)
+  thr.terminate
+  thr.join
+  print ("\b" * width)
+  print ("%+#{width}s\n" %comment)
+end
+
+def busy_indicator(width)
+  tobj = Thread.new() do
+    loop do 
+      %w"OOO ooo ___ ooo".each do |s|
+        print "%+#{width}s" %s
+        sleep 0.1
+        print ("\b" * width)
+      end
+    end
+  end
+end
+# =======================
+if($0 == __FILE__)
+  width = 20
+  2.times do
+    puts "I am busy, pse wait..."
+    thr = busy_indicator(width)
+    sleep 3
+    clean_busy_indicator(thr, width, "Okay")
+  end
+end
+

data/lib/busy_indicator/busy_indicator.rb

@@ -0,0 +1,89 @@
+#encoding: UTF-8
+=begin
+/***************************************************************************
+ *   ©2011-2023, Michael Uplawski <michael.uplawski@uplawski.eu>           *
+ *                                                                         *
+ *   This program is free software; you can redistribute it and/or modify  *
+ *   it under the terms of the WTFPL 2.0 or later version of the  LICENSE. *
+ *   See https://wtfpl2.com/ for details.                                  * 
+ *                                                                         *
+ *   This program is distributed in the hope that it will be useful,       *
+ *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
+ *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.                  *
+ *                                                                         *
+ ***************************************************************************/
+=end
+
+require_relative 'color_output'
+
+#The BusyIndicator will show an "Animation" for the time of its execution.
+#The main program will continue to run in its own thread and should stop
+#the BusyIndicator, once that a process of longer duration has terminated. 
+class BusyIndicator
+	attr_writer :width
+	# Defines a busy_indicator of a width of 'width' characters.
+	# If 'start' is true, the text-animation is run immediately.
+	def initialize(start = true, width = nil)
+		@width = width && width >= 3 ? width : 3
+		@thr = busy_indicator(@width) if start
+	end
+	
+	# Starts the text-animation, returns the thread.
+	def run() 
+		@thr = busy_indicator(@width)
+	end
+
+	# Stops the text-animation, terminates the thread.
+	# If comment is not null, it will be displayed in the end.
+	def stop(comment)
+		@thr.terminate
+		@thr.join
+		print ("\b" * @width)
+		print ("%+#{@width}s\n" %comment)
+	end
+	private
+	def busy_indicator(width)
+		tobj = Thread.new() do
+			print "working ... "
+			loop do 
+				# %w"OOO ooo ___ ooo".each do |s|
+				%w"000 OOO UUU VVV YYY TTT 777 >>> === --- ooo".each do |s|
+				# %w"0OU OUV UVY VYT YT7 T7> 7>= >=- =-o -o0 o0O".each do |s|
+					print "%+#{width}s" %s
+					sleep 0.1
+					print ("\b" * width)
+				end
+			end
+		end
+	end
+end
+# =======================
+# Example
+# You can run this file directly from a command-line, 
+# like this
+# user@mchine$: ruby busy_indicator.rb
+#
+# The program below will then start four (4) 
+# BusyIndicators and stop them again, one by one.  
+# The width of the "animation" is variated.
+# In the loop, the BusyIndicator is started upon
+# its creation, the other two instances are first
+# created then 'run'.
+if($0 == __FILE__)
+	width = 20
+	2.times do
+		puts "I am busy, pse wait..."
+		thr = BusyIndicator.new(true, width)
+		sleep 3
+		thr.stop("Okay")
+	end
+        bi = BusyIndicator.new(false)
+	bi.run
+	sleep 3
+	bi.stop("Stopped")
+	bi.width = 8
+	bi.run
+	sleep 3
+	bi.stop("stopped again")
+end
+

data/lib/busy_indicator/color_output.rb

@@ -0,0 +1,45 @@
+#encoding: UTF-8
+=begin
+/***************************************************************************
+ *   ©2011-2023, Michael Uplawski <michael.uplawski@uplawski.eu>           *
+ *                                                                         *
+ *   This program is free software; you can redistribute it and/or modify  *
+ *   it under the terms of the WTFPL 2.0 or later version of the  LICENSE. *
+ *   See https://wtfpl2.com/ for details.                                  * 
+ *                                                                         *
+ *   This program is distributed in the hope that it will be useful,       *
+ *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
+ *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.                  *
+ *                                                                         *
+ ***************************************************************************/
+=end
+
+#  Helper functions for color-output to an Ansi-terminal.
+#  ... I have never seen an Ansi-terminal, but learned that about each Linux
+#  terminal-emulator can behave like one.
+#  And anyway. This works.
+
+COLORS = {:default => 9, :black => 0, :red => 1, :green => 2, :yellow => 3, :blue => 4, :purple => 5, :cyan => 6, :white => 7 }
+
+BG = 4
+FG = 3
+REGULAR = 0
+BOLD = 1
+UNDERLINE = 4
+BLINK = 5
+SWAP = 7
+NEUTRAL = 0
+
+STYLES = {:regular => REGULAR, :bold => BOLD, :underline => UNDERLINE, :blink => BLINK, :swap => SWAP, :neutral => NEUTRAL}
+
+def colored_text(text, color_code)
+    "#{color_code}#{text}e[0m"
+end
+
+def colored_output(output_text, fg_color = :default, bg_color = :default, style = :regular , mode = :neutral )
+  "\033[%i;%i;%i%i;%i%im%s\033[0m" %[STYLES[mode.to_sym], STYLES[style.to_sym], FG, COLORS[fg_color.to_sym], BG, COLORS[bg_color.to_sym], output_text]
+end
+
+def red(text); colorize(text, "\033[31m"); end
+def green(text); colorize(text, "\033[32m"); end
+