justprep 1.0.1 → 1.2.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d4729fa9db5b45ee64efff9c7f0aaddbeddf6d654cfe031d1a7039a13c8deca0
-  data.tar.gz: a2806b5e251bf062763aec4b5c1806919051a3251e42d7c03f61a557f53b9465
+  metadata.gz: fa284b4a811b6a6482c55b8fbb60e13e20833583d92d7b5d43672bf0dd9178a1
+  data.tar.gz: 592f588b3f165fa25e4fb0309f6763ceb625d8859cb6e1d80709a98bb3bd0eb8
 SHA512:
-  metadata.gz: b27ccd199ac3f53759e0c07e039c3d5d3d4212166c5f4d6cec0fde22fb4f0281746ca7a61b690cb882280e4bdb0e45f7aee446a3696aadc40db20b9617a1117a
-  data.tar.gz: 436b0657a5d2a66d1db74cdfb953f7a83f2b69889653bb0ad0204365a79117f8adcf086aabc7f256123adefcac8861db339362de7d46c4d4e271974e507a799f
+  metadata.gz: a5d250ba9b75361d51c0c756772a846199f8486b4ce2772b0c2d60e76550e9f3bde3b59ac2b3d77d249594bb30246a89de64d97e26e4089ba3dd711bacf2535d
+  data.tar.gz: 6dc5e9a051e6326a95decf12dae092fe9ca59d97f25344009818f784fdf47f12960ccbe007a921d46b12ff4264b6536b0a5257e5e92f7bda4dd708aafd9e27c7

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    justprep (1.0.1)
+    justprep (1.0.2)
 
 GEM
   remote: https://rubygems.org/

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/bin/justprep

@@ -1,5 +1,5 @@
 #!/usr/bin/env ruby
 
-require 'justprep'
+require_relative '../lib/justprep.rb'
 
-Justprep.execute
+Justprep.new.execute

data/justfile

@@ -1,6 +1,5 @@
 # github.com/MadBomber/justprep/**/ruby/justfile
 #
-# gem install bump
 
 set positional-arguments := true
 
@@ -14,6 +13,10 @@ set positional-arguments := true
   just -l --list-prefix 'just ' --list-heading ''
   echo
 
+# Run the minitest examples on the Ruby code
+test: build
+  rake test
+
 
 # Build the current gem
 @build:
@@ -24,26 +27,3 @@ set positional-arguments := true
 @install:
   rake install:local
 
-
-#################################################
-## Recipes that deal with the source code version
-## Version manager is handled by the "bump" gem
-
-# Set the version: major . minor . patch
-@set version:
-  bump set {{version}} --no-commit --replace-in ../crystal/version.cr
-
-
-# Show current version
-@show:
-  bump current
-
-
-# Bump the level:  major . minor . patch
-bump level='patch':
-  #!/bin/bash
-  if [[ "{{level}}" =~ ^(major|minor|patch)$ ]]; then
-    bump {{level}} --no-commit --replace-in ../crystal/version.cr
-  else
-    echo "ERROR: level must be one of: major, minor, patch"
-  fi

data/justprep.gemspec

@@ -1,25 +1,23 @@
 # frozen_string_literal: true
 
-require_relative "lib/justprep/version"
+load "lib/justprep/common/constants.crb"
 
 Gem::Specification.new do |spec|
   spec.name          = "justprep"
-  spec.version       = Justprep::VERSION
+  spec.version       = VERSION
   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

@@ -0,0 +1,53 @@
+VERSION = "1.2.4"
+
+class Justprep
+
+# 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

@@ -0,0 +1,71 @@
+# common/error_messages.crb
+
+class Justprep
+
+# Parameters:
+#   line_number .. Integer (zero-based index)
+#   a_line ....... String
+#
+# Returns:
+#   nil
+#
+def error_file_does_not_exist(line_number, a_line)
+  STDERR.puts
+  STDERR.puts "ERROR: File Does Not Exist"
+
+  # Crystal types thinks line_number can be nil or Int32
+  line_out = sprintf("% d ", line_number.nil? ? 0 : line_number)
+  STDERR.puts (" "*line_out.size)+"|"
+  STDERR.puts "#{line_out}| #{a_line}"
+  STDERR.print (" "*line_out.size)+"|"
+
+  x              = a_line.index(" ")
+
+  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
+
+  begin_filename = x.nil? ? a_line.size + 2 : x + 2
+  end_filename   = a_line.size
+  len_filename   = end_filename - begin_filename + 1
+
+  len_filename = 13 if len_filename < 0
+
+  STDERR.puts (" "*begin_filename) + ("^"*len_filename)
+  STDERR.puts
+
+  return nil
+end
+
+
+def error_syntax(line_number, a_line)
+  STDERR.puts
+  STDERR.puts "ERROR: Syntax Problem"
+
+  # Crystal types thinks line_number can be nil or Int32
+  line_out = sprintf("% d ", line_number.nil? ? 0 : line_number)
+  STDERR.puts (" "*line_out.size)+"|"
+  STDERR.puts "#{line_out}| #{a_line}"
+  STDERR.print (" "*line_out.size)+"| "
+  STDERR.puts "^"*(a_line.size)
+  STDERR.puts
+
+  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

@@ -0,0 +1,18 @@
+# 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
+
+  if a_path_string.to_s.starts_with? "~"
+    a_path_string = "${HOME}" + a_path_string.to_s[1, a_path_string.to_s.size-1]
+  end
+
+  a_path_string = `echo "#{a_path_string}"`.chomp
+
+  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

@@ -0,0 +1,38 @@
+# common/handle_command_line_parameters.crb
+
+class Justprep
+
+# take care of ARGV
+#
+# Returns
+#   nil when there are no command line parameters
+#   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
+  end
+end
+
+
+def no_brag?
+  @@no_brag
+end
+
+end # class Justprep

data/lib/justprep/common/include_content_from.crb

@@ -0,0 +1,26 @@
+# .../ruby/lib/justprep/common/def include_content_from.crb
+
+class Justprep
+
+# single-level inclusion
+#
+# Input:
+#   out_file .......... A File pointer for String output
+#   module_filename ... String The name of the file to be included
+#
+# Output:
+#   nil .... This is a function without specific return value
+#
+def include_content_from(out_file, 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" unless no_brag?
+
+  return nil
+end
+
+end # class Justprep

data/lib/justprep/common/just_find_it.crb

@@ -0,0 +1,18 @@
+# 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.to_s
+  return mainfile_path if File.exists?(mainfile_path)
+
+  parts = here.to_s.split("/")
+  parts.pop
+
+  return nil if parts.empty?
+  return just_find_it(parts.join('/'))
+end
+
+end # class Justprep

data/lib/justprep/common/replacement_for_module_line.crb

@@ -0,0 +1,54 @@
+# .../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
+#
+# This method replaces a source line that looks like this:
+#
+#   module aaa path/to/modules/justfile
+#
+# with a line that looks like this:
+#
+#   module_aaa := "path/to/modules/justfile"
+#
+# where "aaa" is the module name.
+#
+# Limitations:
+#
+#   module_name can not have a space.  Only :alphanumberic: characters
+#   and the underscore character are valid.
+#
+#   The "path/to/modules/justfile" must exist.  Otherwise an error
+#   message is generated.
+#
+# Input:
+#   line_numer .... Integer the line number in the source file
+#   a_string ...... String the line from the source file
+#
+# Output:
+#   an Array(String) of size 2 where
+#   .first is the fake module_name
+#   .last is the replacement string that defines the module variable
+#
+def replacement_for_module_line(line_number, a_string)
+  parts = a_string.split(" ")
+
+  if parts.size < 3
+    error_syntax(line_number, a_string)
+    exit(1)
+  end
+
+  module_name     = parts[1]
+  path_to_module  = parts[2..].join(" ")
+
+  unless File.exists?(path_to_module)
+    error_file_does_not_exist(line_number, a_string)
+    exit(1)
+  end
+
+  return [module_name, "module_#{module_name} := \"#{path_to_module}\""]
+end
+
+end # class Justprep

data/lib/justprep/common/usage.crb

@@ -0,0 +1,71 @@
+# common/usage.crb
+
+class Justprep
+
+def usage
+  usage_text = "
+justprep v#{VERSION} (#{IMPLEMENTATION})
+
+Just a pre-processor to CLI task runners such as 'just'
+By Dewayne VanHoozer <dvanhoozer@gmail.com>
+
+USAGE:
+  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
+  directory hierarchy.  If found it replaces all lines that
+  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 / 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
+    alias jj='justprep && just'
+
+THANKS TO:
+  Casey Rodarmor <casey@rodarmor.com>
+    for Just because just is just a handy utility with just an
+    odd name but an extreamly useful product. :)
+
+  Greg Lutostanski <greg.luto@gmail.com>
+    for the homebrew formula and the github actions to compile
+    a new Crystal release.
+
+"
+  puts usage_text
+
+  return usage_text
+end
+
+end # class Justprep

data/lib/justprep/crystal_methods.rb

@@ -0,0 +1,26 @@
+# common/crystal_methods.rb
+
+# Monkey oatch Ruby classes to match method names
+# used by Crystal
+
+# TODO: find other classes in which Ruby/Crystal differ
+
+module Enumerable
+  alias_method :includes?, :include?
+end
+
+class Pathname
+  alias_method :exists?, :exist?
+end
+
+class String
+  alias_method :starts_with?, :start_with?
+  alias_method :ends_with?,   :end_with?
+  alias_method :includes?,    :include?
+end
+
+class File
+  class << self
+    alias_method :read_lines, :readlines
+  end
+end

data/lib/justprep/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Justprep
-  VERSION = "1.0.1"
+  VERSION = "1.0.2"
 end

data/lib/justprep.rb

@@ -10,185 +10,118 @@
 #
 # 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'
+#
+# NOTE:
+#   JUSTPREP_KEYWORDS  ** CANNOT ** include the value for
+#   JUSTPREP_MODULE_KEYWORD
 #
 
-require           "pathname"
-require_relative  "justprep/version"
-
-module Justprep
-  class << self
-    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
+IMPLEMENTATION  = "Ruby"
 
+require           "fileutils"
+require           "pathname"
+require_relative  "justprep/crystal_methods"
 
-    # review the text looking for module references
-    def find_modules(text)
-      modules = []
+# The common directory contains files which are usable in
+# both the Ruby gem and compiled Crystal implementations
+# The files have the extension ".crb"
+#
+COMMON_DIR = Pathname.new(__FILE__) + '../justprep/common'
+
+# Loading these common methods as global kernel-level
+load COMMON_DIR + "constants.crb"
+load COMMON_DIR + "error_messages.crb"
+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_tasks.crb"
+load COMMON_DIR + "replacement_for_module_line.crb"
+load COMMON_DIR + "include_content_from.crb"
+
+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
+
+
+  # Main function called from executable
+  def execute
+    # 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
 
-      JUSTPREP_KEYWORDS.each do |keyword|
-        modules << text.select{|x| x.start_with?("#{keyword} ") || x.strip == keyword}
-      end
+    in_filename  = just_find_it
 
-      return modules.flatten!
+    if in_filename.nil?
+      STDERR.puts "WARNING: $JUSTPREP_FILENAME_IN Not Found: #{@@justprep_filename_in}"
+      exit(0)
     end
 
+    out_filename  = File.dirname(in_filename) + "/" + @@justprep_filename_out
 
-    # 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"
+    in_file   = File.open(in_filename,  "r")
+    out_file  = File.open(out_filename, "w")
 
-      return content.flatten
-    end
+    line_number = 0
 
+    in_file.readlines.map{|x| x.chomp}.each do |a_line|
+      line_number += 1
 
-    # look for first occurace of mainfile
-    def just_find_it(here=Pathname.pwd)
-      mainfile = here + JUSTPREP_FILENAME_IN
-      return mainfile if mainfile.exist?
-      return nil if here == here.parent
-      return just_find_it(here.parent)
-    end
-
+      parts = a_line.to_s.split(" ")
 
-    # 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]
+      if 0 == parts.size
+        out_file.puts
+        next
       end
 
-      a_path_string = `echo "#{a_path_string}"`.chomp
+      # 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}" unless no_brag?
 
-      return a_path_string
-    end
+        glob_filename = expand_file_path(parts[1..parts.size].join(" "))
 
-    # Print usage text
-    def usage
-      puts <<~EOS
-        justprep v#{VERSION} (ruby)
-        A pre-processor to the just command line utility
-        By Dewayne VanHoozer <dvanhoozer@gmail.com>
-
-        USAGE:
-          justprep [flags] && just
-
-        FLAGS:
-              --version   Shows the current version
-          -h, --help      Displays this usage message
-
-        DESCRIPTION:
-          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.
-
-        SYSTEM ENVIRONMENT VARIABLES:
-                                    Default Value
-          JUSTPREP_FILENAME_IN .... main.just
-          JUSTPREP_FILENAME_OUT ... justfile
-          JUSTPREP_KEYWORDS ....... 'import include require with'
-
-        SUGGESTION:
-          Create an alias for your command shell. For example
-            alias jj='justprop && just'
-
-        THANKS TO:
-          Casey Rodarmor <casey@rodarmor.com>
-          Just because just is just a handy utility with just an odd name. :)
-
-      EOS
-    end
+        module_filenames = Dir.glob(glob_filename)
 
+        if 0 == module_filenames.size
+          error_file_does_not_exist(line_number, a_line)
+          exit(1)
+        end
 
-    # take care of ARGV processing
-    def handle_command_line_parameters
-      if ARGV.size > 0
-        ARGV.each do |param|
-          if "--version" == param
-            puts "jusrprep v#{VERSION} (ruby)"
-          elsif ["-h", "--help"].include?(param)
-            usage
+        module_filenames.each do |module_filename|
+          if File.exist?(module_filename)
+            include_content_from(out_file, module_filename)
           else
-            STDERR.puts "justprep does not support: #{param}"
+            error_file_does_not_exist(line_number, a_line)
             exit(1)
           end
         end
+      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
+      else
+        out_file.puts a_line
       end
-    end
-
-
-    # Main function called from executable
-    def execute
-      handle_command_line_parameters
-
-      mainfile  = just_find_it
-
-      if mainfile.nil?
-        STDERR.puts "WARNING: JUSTPREP_FILENAME_IN Not Found: #{JUSTPREP_FILENAME_IN}"
-        exit(0)
-      end
-
-      basefile  = mainfile.parent + JUSTPREP_FILENAME_OUT
-
-      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(' ')
+    end # in_file.readlines ...
 
-        if begin_filename.nil?
-          module_filename = ""
-        else
-          module_filename = a_line[begin_filename, a_line.size - begin_filename].chomp.strip
-        end
-
-        if module_filename.empty?
-          STDERR.puts "ERROR: No path/to/file was provided"
-          line_out = sprintf('% d ', an_index+1)
-          STDERR.puts (" "*line_out.size)+"|"
-          STDERR.puts "#{line_out}| #{a_line}"
-          STDERR.print (" "*line_out.size)+"|"
-          STDERR.puts (" "*(a_line.size+2)) + "^"
-          exit(1)
-        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 "ERROR: File Does Not Exist - #{module_path}"
-          line_out = sprintf('% d ', an_index+1)
-          STDERR.puts (" "*line_out.size)+"|"
-          STDERR.puts "#{line_out}| #{a_line}"
-          STDERR.print (" "*line_out.size)+"|"
-          STDERR.puts (" "*(a_line.index(module_filename)+1)) + "^"
-          exit(1)
-        end
-      end # modules.each do |a_line|
+    out_file.puts generate_module_tasks(@module_names)
 
-      basefile.write text.flatten!.join "\n"
-    end # def execute
-  end # class << self
-end # module Justprep
+    out_file.close
+  end # def
+end # class Justprep

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: justprep
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.2.4
 platform: ruby
 authors:
 - Dewayne VanHoozer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-07-18 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:
@@ -50,9 +45,18 @@ files:
 - justfile
 - justprep.gemspec
 - lib/justprep.rb
+- lib/justprep/common/constants.crb
+- lib/justprep/common/error_messages.crb
+- lib/justprep/common/expand_file_path.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
+- lib/justprep/common/replacement_for_module_line.crb
+- 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:
@@ -72,8 +76,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.24
+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/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"