justprep 1.2.3 → 1.2.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c5215db017617c8b34a0e8db31b2d2f0e2db2d59c0600671347fdad324ebad83
-  data.tar.gz: b8d16fec5e8898ed0c8154cc1856c83f2b8419d93c1f56e758f95291bff48fde
+  metadata.gz: fa284b4a811b6a6482c55b8fbb60e13e20833583d92d7b5d43672bf0dd9178a1
+  data.tar.gz: 592f588b3f165fa25e4fb0309f6763ceb625d8859cb6e1d80709a98bb3bd0eb8
 SHA512:
-  metadata.gz: bae352f6da8c9b2b1f3a174f64f695485373225db830be20694688e02cc7368aab9e5548862c5e2e24d8ee985eef7f09b20bf674cee6ac85217418958af541e1
-  data.tar.gz: 50d4c6fd1f70c4e042e07d948fb0561e43e0788f73d277d54476e2cbbe9c4587fe4686b69262b7a7eb3d53494146f1a1516f0b3d9925651887d67415e568e73a
+  metadata.gz: a5d250ba9b75361d51c0c756772a846199f8486b4ce2772b0c2d60e76550e9f3bde3b59ac2b3d77d249594bb30246a89de64d97e26e4089ba3dd711bacf2535d
+  data.tar.gz: 6dc5e9a051e6326a95decf12dae092fe9ca59d97f25344009818f784fdf47f12960ccbe007a921d46b12ff4264b6536b0a5257e5e92f7bda4dd708aafd9e27c7

data/README.md

@@ -1,19 +1,28 @@
-# Justprep
+# `justprep`
 
-A pre-processor to the "just" command-line utility packaged as a Ruby Gem.
+Just a CLI pre-processor tool for task runners like "just" my current favorite.
 
-## Installation
+This directory is the codebase for the Ruby gem implementation.  It also contains the common directory where \*.crb files are kept.  These are the files that are shared between this Ruby gem implementation and the Crystal implementation.
 
-    $ gem install justprep
+### Installation for the Ruby version
 
-## Usage
+    gem install justprep
 
-See the top-level README.md file.
+### Installation for the Crystal version
 
-## Contributing
+    brew install --build-from-source MadBomber/tap/justprep
+
+### Documentation
+
+Since this capability is implemented in both Ruby and Crystal there is only one set of documentation.  Both implementations act the same way.  See the [repository's Wiki](https://github.com/MadBomber/justprep/wiki) for details.
+
+
+### Contributing
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/justprep.
 
+If you have a different CLI task runner than what justprep currently supports, let me know so we can add it to the support list.
+
 ## License
 
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+justprep is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/justprep.gemspec

@@ -8,18 +8,16 @@ Gem::Specification.new do |spec|
   spec.authors       = ["Dewayne VanHoozer"]
   spec.email         = ["dvanhoozer@gmail.com"]
 
-  spec.summary       = "A pre-processor for the 'just' command line utility"
+  spec.summary       = "Just a pre-processor for CLI task runners like 'just'"
   spec.description   = <<~EOS
-    allows a "justfile" to be auto-generated from a seperate source file
-    that contains inclusionary keywords such as include, import, require
-    and with.  These keywords are followed by a path to a file.  If the
-    file exists, the contents of the file are inserted into the file
-    at the position of the keyword command.  After all keywords have
-    been process a new "justfile" is created which can then be used by
-    the 'just' tool.
+    justprep is a CLI tool implemented as a Ruby gem AND a 
+    compiled Crystal binary.  It allows a task file to be 
+    auto-generated from seperate source files that contain 
+    inclusionary keywords such as include, import, require 
+    and with.
   EOS
 
-  spec.homepage      = "http://github.com/MadBomber/justprep/tree/main/ruby"
+  spec.homepage      = "http://github.com/MadBomber/justprep"
   spec.license       = "MIT"
   spec.required_ruby_version = ">= 2.4.0"
 

data/lib/justprep/common/constants.crb

@@ -1,7 +1,53 @@
-VERSION = "1.2.3"
+VERSION = "1.2.4"
 
-JUSTPREP_FILENAME_IN  = ENV.fetch("JUSTPREP_FILENAME_IN", "main.just")
-JUSTPREP_FILENAME_OUT = ENV.fetch("JUSTPREP_FILENAME_OUT", "justfile")
-JUSTPREP_KEYWORDS     = ENV.fetch("JUSTPREP_KEYWORDS", "import include require with").split
+class Justprep
 
-JUSTPREP_MODULE_KEYWORD = ENV.fetch("JUSTPREP_MODULE_KEYWORD", "module")
+# define class variables used for configuration
+# This helps Crystal know what the type of the varibles are.
+
+@@justprep_for            = "String"
+@@justprep_module_keyword = "String"
+@@justprep_keywords       = ["String", "String"]
+@@justprep_filename_in    = "String"
+@@justprep_filename_out   = "String"
+@@filename_option         = "String"
+
+
+# defining all these instance methods for Ruby's unit tests
+
+def justprep_for           ; @@justprep_for end
+def justprep_module_keyword; @@justprep_module_keyword end
+def justprep_keywords      ; @@justprep_keywords end
+def justprep_filename_in   ; @@justprep_filename_in end
+def justprep_filename_out  ; @@justprep_filename_out end
+def filename_option        ; @@filename_option end
+
+
+def using_just?
+  "just" == @@justprep_for
+end
+
+
+# Sets the configuration class variables from their cooresponding
+# system environment variables.  Any configuration coming from the
+# command-line parameters are set in the handle_command_line_parameters()
+# method.
+#
+def set_configuration
+  @@justprep_for            = ENV.fetch("JUSTPREP_FOR",           "just")
+  @@justprep_module_keyword = ENV.fetch("JUSTPREP_MODULE_KEYWORD", "module")
+  @@justprep_keywords       = ENV.fetch("justprep_keywords", "import include require with").split
+
+  if using_just?
+    @@justprep_filename_in  = ENV.fetch("JUSTPREP_FILENAME_IN",   "main.just")
+    @@justprep_filename_out = ENV.fetch("JUSTPREP_FILENAME_OUT",  "justfile")
+    @@filename_option       = "-f"
+
+  else
+    @@justprep_filename_in  = ENV.fetch("JUSTPREP_FILENAME_IN")
+    @@justprep_filename_out = ENV.fetch("JUSTPREP_FILENAME_OUT")
+    @@filename_option       = ""
+  end
+end
+
+end # class Justprep

data/lib/justprep/common/error_messages.crb

@@ -1,5 +1,7 @@
 # common/error_messages.crb
 
+class Justprep
+
 # Parameters:
 #   line_number .. Integer (zero-based index)
 #   a_line ....... String
@@ -19,7 +21,7 @@ def error_file_does_not_exist(line_number, a_line)
 
   x              = a_line.index(" ")
 
-  if a_line.starts_with?(JUSTPREP_MODULE_KEYWORD)
+  if a_line.starts_with?(@@justprep_module_keyword.to_s)
     x              = a_line.index(" ", x.nil? ? 0 : x + 1) # because Crystal thinks x could be nil
   end
 
@@ -51,3 +53,19 @@ def error_syntax(line_number, a_line)
   return nil
 end
 
+
+def error_keyword_conflict
+  comma_space = ", "
+  STDERR.puts "
+
+ERROR:  There is a conflict between the environment variables
+        $JUSTPREP_MODULE_KEYWORD _cannot_ be in $JUSTPREP_KEYWORDS
+
+        $JUSTPREP_KEYWORDS => #{@@justprep_keywords.join(comma_space)}
+        $JUSTPREP_MODULE_KEYWORD => #{@@justprep_module_keyword}
+
+"
+  return nil
+end
+
+end # class Justprep

data/lib/justprep/common/expand_file_path.crb

@@ -1,5 +1,7 @@
 # common/expand_file_path.crb
 
+class Justprep
+
 # use an external shell to expand system environment variables
 def expand_file_path(a_path_string)
   a_path_string = a_path_string.strip
@@ -13,3 +15,4 @@ def expand_file_path(a_path_string)
   return a_path_string
 end
 
+end # class Justprep

data/lib/justprep/common/generate_module_tasks.crb

@@ -0,0 +1,61 @@
+# .../ruby/lib/justprep/common/generate_module_tasks.crb
+
+class Justprep
+
+# Given an Array of Strings representing the fake
+# module names it returns a String to be appended
+# to the generated justfile.
+#
+# Input:
+#   module_names .... Array(String) fake module names
+#
+# Output:
+#   tasks ... String
+#
+def generate_module_tasks(module_names)
+  if self.using_just?
+    tasks = create_just_tasks(module_names)
+  else
+    tasks = "# Do not know how to make modules for #{@@justprep_for}"
+  end
+
+  return tasks
+end
+
+
+def create_just_tasks(module_names)
+  tasks = ""
+
+  module_names.each do |mod_name|
+    tasks += "
+
+# Module #{mod_name}
+@#{mod_name} what='' args='':
+  #{@@justprep_for} #{@@filename_option} {{module_#{mod_name}}} {{what}} {{args}}
+
+"
+  end
+
+  return tasks
+end
+
+
+def create_run_tasks(module_names)
+  tasks = ""
+
+  module_names.each do |mod_name|
+    tasks += "
+
+##
+# Module #{mod_name}
+# Encapsulates additional tasks
+#{mod_name}:
+  #{JUSTPREP_FOR} #{FILENAME_OPTION} ${module_#{mod_name}} ${@}
+
+"
+  end
+
+  return tasks
+end
+
+end # class Justprep

data/lib/justprep/common/handle_command_line_parameters.crb

@@ -1,5 +1,6 @@
 # common/handle_command_line_parameters.crb
 
+class Justprep
 
 # take care of ARGV
 #
@@ -8,17 +9,30 @@
 #   otherwise it terminates the process
 #
 def handle_command_line_parameters
+  # When true, header/footer wrappers around include content are excluded
+  @@no_brag = false
+
   if ARGV.size > 0
     ARGV.each do |param|
       if "--version" == param
         puts "jusrprep v#{VERSION} (#{IMPLEMENTATION})"
+        exit(1)
       elsif ["-h", "--help"].includes?(param)
         usage
+        exit(1)
+      elsif "--no-brag" == param
+        @@no_brag = true
       else
         STDERR.puts "justprep does not support: #{param}"
+        exit(1)
       end
     end
-
-    exit(1)
   end
 end
+
+
+def no_brag?
+  @@no_brag
+end
+
+end # class Justprep

data/lib/justprep/common/include_content_from.crb

@@ -1,5 +1,6 @@
 # .../ruby/lib/justprep/common/def include_content_from.crb
 
+class Justprep
 
 # single-level inclusion
 #
@@ -11,14 +12,15 @@
 #   nil .... This is a function without specific return value
 #
 def include_content_from(out_file, module_filename)
-  out_file.puts "\n# >>> #{module_filename}"
+  out_file.puts "\n# >>> #{module_filename}" unless no_brag?
 
   File.read_lines(module_filename).each do |m_line|
     out_file.puts m_line
   end
 
-  out_file.puts "# <<< #{module_filename}\n"
+  out_file.puts "# <<< #{module_filename}\n" unless no_brag?
 
   return nil
 end
 
+end # class Justprep

data/lib/justprep/common/just_find_it.crb

@@ -1,9 +1,11 @@
 # common/just_find_it.crb
 
+class Justprep
+
 # look for first occurace of mainfile
 # returns nil when none are found.
 def just_find_it(here = FileUtils.pwd)
-  mainfile_path = here + "/" + JUSTPREP_FILENAME_IN
+  mainfile_path = here + "/" + @@justprep_filename_in.to_s
   return mainfile_path if File.exists?(mainfile_path)
 
   parts = here.to_s.split("/")
@@ -12,3 +14,5 @@ def just_find_it(here = FileUtils.pwd)
   return nil if parts.empty?
   return just_find_it(parts.join('/'))
 end
+
+end # class Justprep

data/lib/justprep/common/replacement_for_module_line.crb

@@ -1,5 +1,7 @@
 # .../ruby/lig/justprep/common/replacement_for_module_line.crb
 
+class Justprep
+
 # Inserts the module_name into the Array of module_names
 # Returns a string that defines the variable for the path to the module
 #
@@ -48,3 +50,5 @@ def replacement_for_module_line(line_number, a_string)
 
   return [module_name, "module_#{module_name} := \"#{path_to_module}\""]
 end
+
+end # class Justprep

data/lib/justprep/common/usage.crb

@@ -1,30 +1,53 @@
 # common/usage.crb
 
+class Justprep
+
 def usage
   usage_text = "
 justprep v#{VERSION} (#{IMPLEMENTATION})
 
-A pre-processor to the just command line utility
+Just a pre-processor to CLI task runners such as 'just'
 By Dewayne VanHoozer <dvanhoozer@gmail.com>
 
 USAGE:
-  justprep [flags] && just
+  justprep [flags]
+  justprep && #{@@justprep_for}
 
 FLAGS:
       --version   Shows the current version
   -h, --help      Displays this usage message
+      --no-brag   Do not add header/footer around included content
 
 DESCRIPTION:
-  Looks for a file named #{JUSTPREP_FILENAME_IN} in the current
+  Looks for a file named #{@@justprep_filename_in} in the current
   directory hierarchy.  If found it replaces all lines that
-  have the keywords (#{JUSTPREP_KEYWORDS.join(", ")}) followed
-  by file path with the contents of the specified file.
+  have the keywords (#{@@justprep_keywords.join(", ")}) followed
+  by a file path with the contents of the specified file.
+
+  if it finds a line that begins with the module keyword
+  (#{@@justprep_module_keyword}) in sets up a fake module
+  system consistent with the target CLI task runner #{@@justprep_for}.
 
 SYSTEM ENVIRONMENT VARIABLES:
-                            Default Value
-  JUSTPREP_FILENAME_IN .... main.just
-  JUSTPREP_FILENAME_OUT ... justfile
+                            Default / Current Value
+  JUSTPREP_FOR ............ 'just'
+                            '#{@@justprep_for}'
+
+  JUSTPREP_FILENAME_IN .... 'main.just'
+                            '#{@@justprep_filename_in}'
+
+  JUSTPREP_FILENAME_OUT ... 'justfile'
+                            '#{@@justprep_filename_out}'
+
   JUSTPREP_KEYWORDS ....... 'import include require with'
+                            '#{@@justprep_keywords.join(' ')}'
+
+  JUSTPREP_MODULE_KEYWORD . 'module'
+                            '#{@@justprep_module_keyword}'
+
+DOCUMENTATION:
+  A full set of documentation can be found in the project's
+  wiki:  https://github.com/MadBomber/justprep/wiki
 
 SUGGESTION:
   Create an alias for your command shell. For example
@@ -44,3 +67,5 @@ THANKS TO:
 
   return usage_text
 end
+
+end # class Justprep

data/lib/justprep/crystal_methods.rb

@@ -5,7 +5,7 @@
 
 # TODO: find other classes in which Ruby/Crystal differ
 
-class Array
+module Enumerable
   alias_method :includes?, :include?
 end
 

data/lib/justprep.rb

@@ -10,8 +10,9 @@
 #
 # variable name             default value
 # ---------------------     -------------
-# JUSTPREP_FILENAME_IN  ... main.just
-# JUSTPREP_FILENAME_OUT ... justfile
+# JUSTPREP_FOR ............ 'just'
+# JUSTPREP_FILENAME_IN  ... 'main.just'
+# JUSTPREP_FILENAME_OUT ... 'justfile'
 # JUSTPREP_KEYWORDS     ... 'import include require with'
 # JUSTPREP_MODULE_KEYWORD . 'module'
 #
@@ -39,7 +40,7 @@ load COMMON_DIR + "expand_file_path.crb"
 load COMMON_DIR + "handle_command_line_parameters.crb"
 load COMMON_DIR + "just_find_it.crb"
 load COMMON_DIR + "usage.crb"
-load COMMON_DIR + "generate_module_recipes.crb"
+load COMMON_DIR + "generate_module_tasks.crb"
 load COMMON_DIR + "replacement_for_module_line.crb"
 load COMMON_DIR + "include_content_from.crb"
 
@@ -47,6 +48,7 @@ class Justprep
   attr_accessor :module_names
 
   def initialize
+    set_configuration               # sets class vars from envars
     handle_command_line_parameters  # may terminate the process
     @module_names = []
   end
@@ -54,23 +56,22 @@ class Justprep
 
   # Main function called from executable
   def execute
-    if JUSTPREP_KEYWORDS.includes?(JUSTPREP_MODULE_KEYWORD)
-      STDERR.puts
-      STDERR.puts "ERROR: Environment Variable Configuration Problem"
-      STDERR.puts "       JUSTPREP_KEYWORDS cannot include the same value"
-      STDERR.puts "       as the JUSTPREP_MODULE_KEYWORD"
-      STDERR.puts
+    # SMELL:  for some reason the crystal_methods alias_method of
+    #         includes? for include? is not working.
+
+    if @@justprep_keywords.include?(@@justprep_module_keyword)
+      error_keyword_conflict
       exit(1)
     end
 
     in_filename  = just_find_it
 
     if in_filename.nil?
-      STDERR.puts "WARNING: JUSTPREP_FILENAME_IN Not Found: #{JUSTPREP_FILENAME_IN}"
+      STDERR.puts "WARNING: $JUSTPREP_FILENAME_IN Not Found: #{@@justprep_filename_in}"
       exit(0)
     end
 
-    out_filename  = File.dirname(in_filename) + "/" + JUSTPREP_FILENAME_OUT
+    out_filename  = File.dirname(in_filename) + "/" + @@justprep_filename_out
 
     in_file   = File.open(in_filename,  "r")
     out_file  = File.open(out_filename, "w")
@@ -90,8 +91,8 @@ class Justprep
       # NOTE: Leading spaces are not allowed.  The keywords
       #       MUST be complete left-justified.
       #
-      if JUSTPREP_KEYWORDS.include?(parts.first.downcase)
-        out_file.puts "# #{a_line}"
+      if @@justprep_keywords.include?(parts.first.downcase)
+        out_file.puts "# #{a_line}" unless no_brag?
 
         glob_filename = expand_file_path(parts[1..parts.size].join(" "))
 
@@ -110,7 +111,7 @@ class Justprep
             exit(1)
           end
         end
-      elsif JUSTPREP_MODULE_KEYWORD == parts.first.downcase
+      elsif @@justprep_module_keyword == parts.first.downcase
         result_array  = replacement_for_module_line(line_number, a_line)
         @module_names << result_array.first
         out_file.puts result_array.last
@@ -119,7 +120,7 @@ class Justprep
       end
     end # in_file.readlines ...
 
-    out_file.puts generate_module_recipes(@module_names)
+    out_file.puts generate_module_tasks(@module_names)
 
     out_file.close
   end # def

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: justprep
 version: !ruby/object:Gem::Version
-  version: 1.2.3
+  version: 1.2.4
 platform: ruby
 authors:
 - Dewayne VanHoozer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-06-19 00:00:00.000000000 Z
+date: 2022-07-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bump
@@ -24,14 +24,9 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: |
-  allows a "justfile" to be auto-generated from a seperate source file
-  that contains inclusionary keywords such as include, import, require
-  and with.  These keywords are followed by a path to a file.  If the
-  file exists, the contents of the file are inserted into the file
-  at the position of the keyword command.  After all keywords have
-  been process a new "justfile" is created which can then be used by
-  the 'just' tool.
+description: "justprep is a CLI tool implemented as a Ruby gem AND a \ncompiled Crystal
+  binary.  It allows a task file to be \nauto-generated from seperate source files
+  that contain \ninclusionary keywords such as include, import, require \nand with.\n"
 email:
 - dvanhoozer@gmail.com
 executables:
@@ -53,7 +48,7 @@ files:
 - lib/justprep/common/constants.crb
 - lib/justprep/common/error_messages.crb
 - lib/justprep/common/expand_file_path.crb
-- lib/justprep/common/generate_module_recipes.crb
+- lib/justprep/common/generate_module_tasks.crb
 - lib/justprep/common/handle_command_line_parameters.crb
 - lib/justprep/common/include_content_from.crb
 - lib/justprep/common/just_find_it.crb
@@ -61,8 +56,7 @@ files:
 - lib/justprep/common/usage.crb
 - lib/justprep/crystal_methods.rb
 - lib/justprep/version.rb
-- prototype.rb
-homepage: http://github.com/MadBomber/justprep/tree/main/ruby
+homepage: http://github.com/MadBomber/justprep
 licenses:
 - MIT
 metadata:
@@ -82,8 +76,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.16
+rubygems_version: 3.3.18
 signing_key:
 specification_version: 4
-summary: A pre-processor for the 'just' command line utility
+summary: Just a pre-processor for CLI task runners like 'just'
 test_files: []

data/lib/justprep/common/generate_module_recipes.crb

@@ -1,27 +0,0 @@
-# .../ruby/lib/justprep/common/generate_module_recipes.crb
-
-# Given an Array of Strings representing the fake
-# module names it returns a String to be appended
-# to the generated justfile.
-#
-# Input:
-#   module_names .... Array(String) fake module names
-#
-# Output:
-#   recipes ... String
-#
-def generate_module_recipes(module_names)
-  recipes = ""
-
-  module_names.each do |mod_name|
-    recipes += "
-
-# Module #{mod_name}
-@#{mod_name} what='' args='':
-  just -f {{module_#{mod_name}}} {{what}} {{args}}
-
-"
-  end
-
-  return recipes
-end

data/prototype.rb

@@ -1,125 +0,0 @@
-#!/usr/bin/env ruby
-# encoding: utf-8
-# frozen_string_literal: true
-# warn_indent: true
-##########################################################
-###
-##  File: justprep.rb
-##  Desc: A preprocessor for justfiles using "main.just"
-##        Looks for keywords: import include require with
-##        followed by a file name or path.
-##
-##        It looks for a file "main.just" in the current directory.
-##        If it does not exist, does nothing.  Otherwise it reviews
-##        the file for the KEYWORDS.  When found it inserts the
-##        content of the specified file into that position.  The
-##        final text is written out to the "justfile" for processing
-##        with the "just" tool.
-##
-##        There is NO ERROR checking.  including file names/paths
-##        are assume to have to space characters.
-##
-##  By:   Dewayne VanHoozer (dvanhoozer@gmail.com)
-#
-
-KEYWORDS  = %w[ import include require with ]
-BASEFILE  = 'justfile'
-MAINFILE  = 'main.just'
-
-require 'pathname'
-
-######################################################
-# Local methods
-
-# review the text looking for module references
-def find_modules(text)
-  modules = []
-
-  KEYWORDS.each do |keyword|
-    modules << text.select{|x| x.start_with? "#{keyword} "}
-  end
-
-  return modules.flatten!
-end
-
-
-# somg;e-level inclusion
-def include_content_from(file_path)
-  content   = []
-  content  << "\n# >>> #{file_path}"
-  content  << file_path.readlines.map{|x| x.chomp} # TODO: support recursion??
-  content  << "# <<< #{file_path}\n"
-
-  return content.flatten
-end
-
-
-# look for first occurace of mainfile
-def just_find_it(here=Pathname.pwd)
-  mainfile = here + MAINFILE
-  return mainfile if mainfile.exist?
-  return nil if here == here.parent
-  return just_find_it(here.parent)
-end
-
-
-# use an external shell to expand system environment variables
-def expand_file_path(a_path_string)
-  if a_path_string.start_with? '~'
-    a_path_string = "${HOME}" + a_path_string[1, a_path_string.size-1]
-  end
-
-  a_path_string = `echo "#{a_path_string}"`.chomp
-
-  return a_path_string
-end
-
-
-######################################################
-# Main
-
-mainfile  = just_find_it
-
-exit(0) if mainfile.nil?
-
-basefile  = mainfile.parent + BASEFILE
-
-text = mainfile.readlines.map{|x| x.chomp} # drop the line ending from each line
-
-modules = find_modules text
-
-if modules.empty?
-  basefile.write text
-  exit(0)
-end
-
-modules.each do |a_line|
-  an_index        = text.index a_line
-  begin_filename  = a_line.index(' ')
-  module_filename = a_line[begin_filename, a_line.size - begin_filename].strip
-
-  if module_filename.empty?
-    STDERR.puts "#{an_index}: #{a_line}"
-    STDERR.puts "ERROR: No path/to/file was provided"
-    next
-  end
-
-  if module_filename.include?('~')  || module_filename.include?('$')
-    module_filename = expand_file_path(module_filename)
-  end
-
-  module_path     = Pathname.new(module_filename)
-
-  if module_path.relative?
-    module_path = mainfile.parent + module_path
-  end
-
-  if module_path.exist?
-    text[an_index]  = include_content_from(module_path)
-  else
-    STDERR.puts "#{an_index}: #{a_line}"
-    STDERR.puts "| ERROR: File Does Not Exist - #{module_path}"
-  end
-end
-
-basefile.write text.flatten!.join "\n"