opensecret 0.0.9925 → 0.0.9949

data/lib/keytools/key.pass.rb

@@ -43,14 +43,14 @@ module OpenKey
         assert_min_size MINIMUM_PASSWORD_SIZE
 
         sleep(1)
-        puts "\nEnter a Password  : "
+        puts "Password:"
         first_secret = STDIN.noecho(&:gets).chomp
 
         assert_input_text_size first_secret.length, MINIMUM_PASSWORD_SIZE
         return first_secret unless prompt_twice
 
         sleep(1)
-        puts "\nRe-enter the password : "
+        puts "Re-enter the password:"
         check_secret = STDIN.noecho(&:gets).chomp
 
         assert_same_size_text first_secret, check_secret

data/lib/keytools/key.rb

@@ -316,8 +316,8 @@ module OpenKey
     #
     # This method should only ever be called when this key has been derived
     # from either a (huge) <b>48 byte random source</b> or from a key derivation
-    # function (KDF) such as BCrypt, SCrypt, PBKDF2 or a union from {KdfApi}
-    # which delivers 512 bit (64 byte) key for reduction to 256 bits.
+    # function (KDF) such as BCrypt, SCrypt, PBKDF2 or a union from which the
+    # 512 bit (64 byte) key can be reduced to 256 bits.
     #
     # @return [String]
     #    a binary string of thirty-two (32) eight (8) bit bytes which
@@ -407,24 +407,12 @@ module OpenKey
       calling_lineno = caller_locations(1,1).first.lineno
       caller_details = "#{calling_module} | #{calling_method} | (line #{calling_lineno})"
 
-      log.info(x) { "### #####################################################################" }
-      log.info(x) { "### Caller Details =>> =>> #{caller_details}"                              }
-      log.info(x) { "### #####################################################################" }
-      log.info(x) { "The BitStr Char representation of this key => #{to_s()}" }
-      log.info(x) { "256bit Digest (Urlsafe Base64) of this key => #{Base64.urlsafe_encode64(to_aes_key())}" }
-      log.info(x) { "The IncomingKey Base64 Char representation => #{key_to_encrypt.to_char64()}" }
-      log.info(x) { "Random IV Used for the AESs Key Encryption => #{Base64.urlsafe_encode64(random_iv)}" }
-
       cipher_text = crypt_cipher.update( key_to_encrypt.to_char64 ) + crypt_cipher.final
-      log.info(x) { "Cipher Text Produced after this Encryption => #{Base64.urlsafe_encode64(cipher_text)}" }
 
       binary_text = random_iv + cipher_text
       ones_zeroes = binary_text.unpack("B*")[0]
       ciphertxt64 = Key64.from_bits( ones_zeroes )
 
-      log.info(x) { "Amalgam of Binary Random IV and Ciphertext => #{ciphertxt64}" }
-      log.info(x) { "------------------------------------------------------------------------- >>>>>>" }
-
       size_msg = "Expected bit count is #{EXPECTED_CIPHER_BIT_LENGTH} not #{ones_zeroes.length}."
       raise RuntimeError, size_msg unless ones_zeroes.length == EXPECTED_CIPHER_BIT_LENGTH
 
@@ -468,18 +456,6 @@ module OpenKey
     #    the size of the parameter ciphertext must be 128 base 64 characters.
     def do_decrypt_key ciphertext_to_decrypt
 
-      calling_module = File.basename caller_locations(1,1).first.absolute_path, ".rb"
-      calling_method = caller_locations(1,1).first.base_label
-      calling_lineno = caller_locations(1,1).first.lineno
-      caller_details = "#{calling_module} | #{calling_method} | (line #{calling_lineno})"
-
-      log.info(x) { "### #####################################################################" }
-      log.info(x) { "### Caller Details =>> =>> #{caller_details}"                              }
-      log.info(x) { "### #####################################################################" }
-      log.info(x) { "Amalgam of Binary Random IV and Ciphertext => #{ciphertext_to_decrypt}"    }
-      log.info(x) { "The Base64 Char representation of this key => #{to_s()}"                   }
-      log.info(x) { "256bit Digest (Urlsafe Base64) of this key => #{Base64.urlsafe_encode64(to_aes_key())}" }
-
       bit_text = Key64.to_bits(ciphertext_to_decrypt)
       size_msg = "Expected bit count is #{EXPECTED_CIPHER_BIT_LENGTH} not #{bit_text.length}."
       raise RuntimeError, size_msg unless bit_text.length == EXPECTED_CIPHER_BIT_LENGTH
@@ -493,8 +469,6 @@ module OpenKey
       cipher_x.iv  = rawbytes[ 0 .. ( RANDOM_IV_BYTE_COUNT - 1 ) ]
       key_chars_64 = cipher_x.update( rawbytes[ RANDOM_IV_BYTE_COUNT .. -1 ] ) + cipher_x.final
 
-      log.info(x) { "The OutgoingKey Base64 Char representation => #{key_chars_64}" }
-
       return Key.from_char64( key_chars_64 )
 
     end

data/lib/session/fact.finder.rb

@@ -1,21 +1,6 @@
 #!/usr/bin/ruby
 
-# opensession contains basic behaviour for managing a client only
-# (serverless) session. Configuration directives are read and written
-# from an INI off the home directory that is created when the session
-# is first initiated.
-#
-# The session is expected to be formally closed down and that is
-# reflected by explicitly deleting the configuration file. If this
-# "session over" command is not issued a reasonable time limit is
-# then invoked when the next session command is issued.
-#
-# This "session awakening" wipes the slate clean and starts afresh
-# with regard to the two dimensional array of configuration directive
-# pointers.
-module OpenSession
-
-  require "pp"
+module OpenSecret
 
   # --
   # -- -----------------
@@ -64,85 +49,23 @@ module OpenSession
   # --
   # --
   class FactFind
-    include Singleton
 
     @@eval_prefix = "rb>>"
-    attr_reader :i, :f
-
-    # --
-    # -- Initialize the internal fact database
-    # -- which is exposed for fact consumption
-    # -- via
-    # --
-    # --  @i => [identity] facts (1D)
-    # --  @n => (reserved perhaps 4 nested facts)
-    # --  @f => [file facts] database (2D)
-    # --  @a => (reserved)
-    # --  @c => coded consumtion (in software)
-    # --  @t => template placeholders (2D)
-    # --  @s => sibling (same category) facts (1D)
-    # --
-    def instantiate plugin_id
-
-      @i = { :plugin  => plugin_id,
-             :time    => Stamp.yyjjj_hhmm_sst,
-             :user    => Home.usr,
-             :station => nil
-           }
 
-      @f = {}
-
-      @s = {}
-
-      @f.store symbol(plugin_id), {}
-      @p = @f[symbol(plugin_id)]
-
-
-    end
-
-
-
-    #--
-    #-- Set the main directory path.
-    #-- This method adds the parameter path to
-    #-- the identity map. After this method
-    #-- executes you will be able to access the
-    #-- directory with @i[:dir]
-    #--
-    def add_dir_to_identity key_directory
-      @i[:dir] = key_directory
-    end
-
-
-
-    # --
-    # --
-    # --
-    def assimilate_plugin_facts
-
-      plugin_fact_filepath = File.join @i[:src_dir], "#{@i[:plugin]}.ini"
-      log.info(x) { "Plugin Factfile => #{plugin_fact_filepath}" }
-      assimilate_ini_file plugin_fact_filepath
+    # The fact tree values can be referenced using the @f
+    # specifier with a 2 dimensional key.
+    attr_reader :f
 
-    end
-
-
-    # --
-    # --
-    # --
-    def assimilate_general_facts
 
-      facts_folder = fact_path("published.facts")
+    # This method constructs the FactFind object and tree database
+    # and initializers the root fact container structures.
+    def initialize
 
-      factfiles_map = Files.in_folders( Array.new.push(facts_folder) )
-      factfiles_map.each do |file_name, folder_name|
-
-        log.info(x) {"Assimilating facts from => [#{file_name}]"}
-        factfile_path = File.join factfiles_map[file_name], file_name
-        log.info(x) {"Factfile location => [#{nickname factfile_path}]"}
-        assimilate_ini_file factfile_path
+      @f = {}
+      @s = {}
 
-      end
+# --->      @f.store symbol(plugin_id), {}
+# --->      @p = @f[symbol(plugin_id)]
 
     end
 
@@ -171,162 +94,6 @@ module OpenSession
     end
 
 
-    # --
-    # -- Assimilate [[ hub-runtime.ini ]]
-    # -- This factfile builds upon the (fundamental) handful of
-    # -- identity facts. It derives the facts for
-    # --
-    # --   - the plugin instance folder
-    # --   - the instance stamp id keys
-    # --
-    # -- The instance fact file is not allowed to harbour any
-    # -- external dependencies.
-    # --
-    def assimilate_instance_facts
-
-      instance_facts_file = fact_path("hub-runtime.ini")
-      log.info(x) { "Path to instance facts file => #{instance_facts_file}" }
-      assimilate_ini_file instance_facts_file
-
-    end
-
-
-    # --
-    # -- -----------------------------------
-    # -- Finding the Workstation (Category)
-    # -- -----------------------------------
-    # --
-    # -- The known hosts facts file is parsed with each
-    # -- section [examined] by asking two (2) questions.
-    # --
-    # --   [1] - is [username] this workstation's username?
-    # --   [2] - does [hostnames] include this hostname?
-    # --
-    # -- The 1st section to answer [YES] to both questions
-    # -- is deemed as our workstation. Its symbol header is
-    # -- then used for assimilation - how?
-    # --
-    # -- ----------------------------------------
-    # -- Assimilating Workstation Specific Facts
-    # -- ----------------------------------------
-    # --
-    # -- We do NOT assimilate the whole file.
-    # -- We simply assimilate the [SECTION] of the file
-    # -- that is deemed to be OUR (this) workstation.
-    # --
-    # -- -------------------------------------------
-    # -- Dependency Constraints | Workstation Facts
-    # -- -------------------------------------------
-    # --
-    # -- (work)station facts can [only] depend on facts that
-    # -- have been declared in [[ hub-runtime.ini ]]. No
-    # -- other external fact dependencies are permitted.
-    # --
-    def identify_my_workstation
-
-      workstation_factfile_name = "known-hosts.ini"
-      log_begin_workstation_identification workstation_factfile_name
-      stations_factfile = fact_path workstation_factfile_name
-      log.info(x) { "Workstations Facts File (Path) => #{nickname stations_factfile}" }
-
-      our_user = Home.usr
-      our_host = NetDns.instance.host_name
-      log.info(x){ "Station Search For => #{our_user}@#{our_host}" }
-
-      workstations = IniFile.load stations_factfile
-      workstations.each_section do |station|
-
-        no_user = "Workstation [#{station}] has no [username] fact."
-        raise RuntimeError.new no_user unless workstations[station].has_key? "username"
-
-        has_hostnames = workstations[station].has_key? "hostnames"
-        no_hostnames = "[#{station}] not a workstation as no [hostnames] fact - Skip!"
-        log.warn(x) { no_hostnames } unless has_hostnames
-        next unless has_hostnames
-
-        this_user = evaluate(workstations[station]["username"])
-        these_hosts = evaluate(workstations[station]["hostnames"])
-        match = this_user.eql?(our_user) && these_hosts.include?(our_host)
-
-        log.info(x){ "[#{station}] with #{this_user}@#{these_hosts} - No!" } unless match
-        next unless match
-
-        log.info(x){ "[#{station}] with #{this_user}@#{these_hosts} - Matched!" }
-        dup_msg = "Duplicate or repeat match disallowed! #{@i[:station]} and #{station}"
-        raise RuntimeError.new dup_msg unless @i[:station].nil?
-
-        @i[:station] = station
-        @i[:workstation] = station.gsub(".", "_").to_sym
-
-      end
-
-      no_match_msg = "No workstation match made for [#{our_user}@#{our_host}]."
-      raise RuntimeError.new no_match_msg if @i[:station].nil?
-      log_end_workstation_identification workstation_factfile_name
-      LogObject.map @i
-
-    end
-
-
-    #--
-    #-- Knowing and setting @i[:workstation] to our workstation is key.
-    #-- This means that the other workstations can reference files in
-    #-- each others drives without knowing which workstation is being
-    #-- used (see ssh.keyfile for a ghost reference example).
-    #--
-    #-- Now we can proceed to assimilate the entire station facts file.
-    #--
-    def assimilate_station_facts
-
-      stations_factfile = fact_path "known-hosts.ini"
-      assimilate_ini_file stations_factfile
-
-    end
-
-
-    # --
-    # -- Get the path to a fact file or folder within the
-    # -- reusable facts source tree.
-    # --
-    # -- The base directory is acquired by dropping down
-    # -- three (3) directory levels from where this module
-    # -- is and then going into reusable.facts and finally
-    # -- appending the parameter path (file or folder).
-    # --
-    def fact_path fact_filename
-      fact_basedir = File.dirname( File.dirname( File.dirname( __FILE__ ) ) )
-      return File.join( File.join(fact_basedir,"reusable.facts"), fact_filename )
-    end
-
-
-    # --
-    # -- Call instantiate() before calling populate().
-    # --
-    # -- This method assimilates any and all fact files
-    # -- (recursively) found in two subdirectories
-    # --
-    # --   [1] - "reusable facts" and
-    # --   [2] - the [plugin] folder
-    # --
-    def self.populate
-
-    end
-
-
-    # -- -------------------------------------------------------------- -- #
-    # -- Eval and return result of parameter string if it is ruby code. -- #
-    # -- -------------------------------------------------------------- -- #
-    def evaluate string
-
-      # -----> @todo raise a FactError here
-
-      raise RuntimeError.new "Fact to Evaluate is Nil." if string.nil?
-      return string unless string.start_with? @@eval_prefix
-      return eval( string.gsub @@eval_prefix, "" )
-
-    end
-
-
     # ----> -------------------------------------------------->
     # ----> How to Write a Custom Error
     # ----> -------------------------------------------------->
@@ -350,44 +117,6 @@ module OpenSession
     # ----> -------------------------------------------------->
 
 
-    # -- ---------------------------------------- -- #
-    # -- Add a fact to the main 2D fact database. -- #
-    # -- ---------------------------------------- -- #
-    def add_fact group_symbol, key_symbol, key_value
-
-      nil_error_text = "Neither fact coordinates nor value can be nil. [group]=> #{group_symbol} [key]=> #{key_symbol} [value]=> #{key_value}"
-      raise ArgumentError.new nil_error_text if group_symbol.nil? || key_symbol.nil? || key_value.nil?
-
-      if @f.has_key? group_symbol then
-
-        # --
-        # -- This isn't the first fact within this group
-        # -- so store the new fact key/value pair within
-        # -- the group's namespace.
-        # --
-        @f[group_symbol][key_symbol] = key_value
-
-      else
-
-        # --
-        # -- Create a new umbrella grouping against which
-        # -- the new key-value pairing will be inserted.
-        # --
-        @f.store group_symbol, { key_symbol => key_value }
-
-      end
-
-      # --
-      # -- The @s sibling hash is updated to reflect the
-      # -- key-value pairs within the current group. This
-      # -- allows @s to be used as shorthand within INI
-      # -- file fact definition statements.
-      # --
-      @s = @f[group_symbol]
-
-    end
-
-
     # -- ------------------------------------------- -- #
     # --                                             -- #
     # --  Template                                   -- #
@@ -458,30 +187,39 @@ module OpenSession
 
 
 
-    def assimilate_fact group_str, key_str, input_value
-
-      grp_symbol = group_str.gsub(".", "_").to_sym
-      key_symbol = key_str.gsub(".", "_").to_sym
+    # This method assimilates a two-dimensional fact bringing it into the
+    # fact tree fold.
+    #
+    # Once assimilated, this fact with a 2D index can be reused
+    # - for future fact resolution
+    # - by classes with access to the fact tree
+    # - for dynamic template resolution
+    #
+    # @param fact_group_str the first dimensional fact key
+    # @param fact_key_str the second dimensional fact key
+    # @param fact_value_str value of the fact to assimilate
+    def assimilate_fact fact_group_str, fact_key_str, fact_value_str
 
-      raise ArgumentError, "Assimilating Fact [ #{group_str} ][ #{key_str} ] => Value is NIL" if input_value.nil?
+      grp_symbol = fact_group_str.gsub(".", "_").to_sym
+      key_symbol = fact_key_str.gsub(".", "_").to_sym
 
-      fact_val = input_value.strip
+      raise ArgumentError, "Assimilating Fact [ #{fact_group_str} ][ #{fact_key_str} ] => Value is NIL" if fact_value_str.nil?
+      fact_string = fact_value_str.strip
 
       begin
 
-        unless discard_fact?( group_str, key_str, fact_val )
-          eval_value = evaluate(get_fact_value(fact_val))
-          add_fact grp_symbol, get_key_symbol(key_str), eval_value
-        end
+        raise ArgumentError, "Fact object in section #{fact_group_str} with key #{fact_key_str} is nil." if fact_string.nil?
+        eval_value = evaluate( fact_string )
+        add_fact grp_symbol, to_symbol(fact_key_str), eval_value
 
       rescue Exception => e
 
         log.fatal(x) { "## ##################### #################################" }
         log.fatal(x) { "## Fact Evaluation Error ---------------------------------" }
         log.fatal(x) { "## ##################### #################################" }
-        log.fatal(x) { "## Fact Family => #{group_str}"                             }
-        log.fatal(x) { "## Fact Key    => #{key_str}"                               }
-        log.fatal(x) { "## Fact Stmt   => #{fact_val}"                              }
+        log.fatal(x) { "## Fact Family => #{fact_group_str}"                        }
+        log.fatal(x) { "## Fact Key    => #{fact_key_str}"                          }
+        log.fatal(x) { "## Fact Stmt   => #{fact_string}"                           }
         log.fatal(x) { "## Fact Error  => #{e.message}"                             }
         log.fatal(x) { "## ##################### #################################" }
         e.backtrace.log_lines
@@ -492,9 +230,9 @@ module OpenSession
 
       unless @f.has_key? grp_symbol then
 
-        log.debug(x){ "# -- ---------------------------------------------------------- #" }
-        log.debug(x){ "# -- the [#{group_str}] silo facts." }
-        log.debug(x){ "# -- ---------------------------------------------------------- #" }
+        log.debug(x){ "# @@ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ #" }
+        log.debug(x){ "# @@ the [#{fact_group_str}] silo facts."                          }
+        log.debug(x){ "# @@ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ #" }
 
       end
 
@@ -503,164 +241,63 @@ module OpenSession
       print_value = "****************"
       print_value = eval_value unless sensitive
 
-      # -- -------------------------------------------------------- -- #
-      # -- Log the human readable (fixed-width) key and value pair. -- #
-      # -- -------------------------------------------------------- -- #
       fw_key = sprintf '%-33s', "@f[:#{grp_symbol}][:#{key_symbol}]"
       log.debug(x){ "#{fw_key} => #{print_value}" }
 
     end
 
 
-    def discard_fact? group_str, key_str, input_value
-
-      is_if = key_str.strip.end_with? "(if)"
-      is_unless = key_str.strip.end_with?("(un)") || key_str.strip.end_with?("(unless)")
-      return false unless is_if || is_unless
-
-      two_parts = input_value.split( @@eval_prefix )
-      no_prefix = "Conditional must be followed by eval prefix => #{two_parts}"
-      raise RuntimeError.new no_pefix unless two_parts.length == 2
-
-      conditional_part = two_parts.first.strip
-      no_curlies_msg = "Wrap conditional in curly braces => #{conditional_part}"
-      is_wrapped = conditional_part.start_with?("{") && conditional_part.end_with?("}")
-      raise RuntimeError.new no_curlies_msg unless is_wrapped
-
-      conditional_stmt = conditional_part[1..-2].strip
-      log.info(x){ "Conditional Stmt => #{conditional_stmt}" }
-      conditional_val = evaluate( @@eval_prefix + conditional_stmt )
-      is_boolean = [true, false].include? conditional_val
-
-      boolean_msg = "=> #{conditional_stmt} <= evaluated to [#{conditional_val}] not boolean."
-      raise RuntimeError.new boolean_msg unless is_boolean
-
-      return false if is_if && conditional_val
-      return true if is_if && !conditional_val
-
-      return true if is_unless && conditional_val
-      return false if is_unless && !conditional_val
-
-      raise RuntimeError.new "Unreachable if[#{is_if}] unless[#{is_unless}] => #{conditional_val}"
-
-    end
-
-
-    #--
-    #-- Return the symbolic representation of the
-    #-- parameter key. Periods are replaced with
-    #-- underscores (as per the fact convention)
-    #-- before conversion to a symbol.
-    #--
-    #-- Nil is not handled.
-    #-- String is stripped beforehand just in case.
-    #--
-    def symbol from_string
 
+    # This static method converts from string to symbol.
+    # @param from_string the neither nil nor empty string to convert to a symbol
+    # @return a symbol representation of the input string
+    def to_symbol from_string
       return from_string.strip.gsub(".", "_").to_sym
-
     end
 
 
-    #--
-    #-- Return the (key access) symbol that represents the
-    #-- plugin id plus a string given in the parameter.
-    #--
-    #-- ---------
-    #-- Example
-    #-- ---------
-    #--
-    #--  Plugin Id  => ide.hub
-    #--  Append Str => host
-    #--
-    #--  equals
-    #--
-    #--  Key String => ide.hub.host
-    #--  Key Symbol => ide_hub_host
-    #--
-    #--
-    #-- So the symbol :ide_hub_host is returned.
-    #--
-    def plugin_symbol append_string
-
-      key_string = @i[:plugin] + "." + append_string.strip
-      return key_string.gsub(".", "_").to_sym
-
-    end
-
 
-    def get_key_symbol dirty_key_string
+    private
 
-      key_string = dirty_key_string.strip
-      split_string = "(unless)"
-      split_string = "(if)" if key_string.end_with? "(if)"
-      split_string = "(un)" if key_string.end_with? "(un)"
 
-      return key_string.split(split_string).first.gsub(".", "_").to_sym
 
-    end
-
-
-    def get_fact_value fact_value_string
-
-      is_conditional = fact_value_string.start_with?("{") && fact_value_string.include?( @@eval_prefix )
-      return fact_value_string unless is_conditional
-
-      return fact_value_string.rpartition( @@eval_prefix )[1..-1].join
-
-    end
+    def add_fact group_symbol, key_symbol, key_value
 
+      fact_component = "[group]=> #{group_symbol} [key]=> #{key_symbol} [value]=> #{key_value}"
+      nil_error_text = "Neither fact coordinates nor values can be nil. #{fact_component}"
+      raise ArgumentError.new nil_error_text if group_symbol.nil? || key_symbol.nil? || key_value.nil?
 
-    def exists? fact_reference
+      if @f.has_key? group_symbol then
 
-      log.info(x) { "Does Fact Exist? => #{fact_reference}" }
-      return false if fact_reference.nil?
-      return false if fact_reference.strip.length == 0
-      return true if fact_reference.strip.length > 0
+        # -- This isn't the first fact within this group
+        # -- so store the new fact key/value pair within
+        # -- the group's namespace.
+        @f[group_symbol][key_symbol] = key_value
 
-    end
+      else
 
+        # -- Create a new umbrella grouping against which
+        # -- the new key-value pairing will be inserted.
+        @f.store group_symbol, { key_symbol => key_value }
 
-    # --
-    # -- dot => period (full stop)
-    # -- Deliver a "." period character
-    # --
-    def dot
-      return "."
-    end
+      end
 
+      # -- The @s sibling hash is updated to reflect the
+      # -- key-value pairs within the current group. This
+      # -- allows @s to be used as shorthand within INI
+      # -- file fact definition statements.
+      @s = @f[group_symbol]
 
-    # --
-    # -- colon => full colon character
-    # -- Delivers a ":" colon character
-    # --
-    def colon
-      return ":"
     end
 
 
-    def log_begin_workstation_identification the_filename
-
-      log.info(x) { "-                                                         -" }
-      log.info(x) { "# @@ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@ #" }
-      log.info(x) { "# -- ------------------------------------------------- -- #" }
-      log.info(x) { "# -- [= BEGIN WORKSTATION IDENTIFICATION =] #{the_filename}" }
-      log.info(x) { "# -- ------------------------------------------------- -- #" }
-      log.info(x) { "# @@ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@ #" }
-
-    end
-
+    def evaluate string
 
-    def log_end_workstation_identification the_filename
+      # -----> @todo raise a FactError here
 
-      log.info(x) { "# @@ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@ #" }
-      log.info(x) { "# -- ------------------------------------------------- -- #" }
-      log.info(x) { "# -- [= END WORKSTATION IDENTIFICATION =] #{the_filename}"   }
-      log.info(x) { "# -- ------------------------------------------------- -- #" }
-      log.info(x) { "# @@ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @@ #" }
-      log.info(x) { "-                                                         -" }
-      log.info(x) { "-                                                         -" }
-      log.info(x) { "-                                                         -" }
+      raise RuntimeError.new "Fact to Evaluate is Nil." if string.nil?
+      return string unless string.start_with? @@eval_prefix
+      return eval( string.gsub @@eval_prefix, "" )
 
     end