k_builder 0.0.53 → 0.0.59

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 122c7daee609c40dbd918d5bb98640c3850d3cb0c54eeabee10e4d4082c036f3
-  data.tar.gz: 3c2041cd23f31b624860a141858f0c54ac995cf49b277bd591acb94a37cb1456
+  metadata.gz: cbc297bfc032f0b46f8930052990d5593ec6c490e5616ebb56d340dd0dad7ec6
+  data.tar.gz: f15472d59d723cd64995cc2402a94a3c1e67ffe2bcdd698de0e6c6475c615e47
 SHA512:
-  metadata.gz: ae5aa592ffe9845c5438a80761a2ee8dccf358d4d32cfa6f84926038d64433c9e041911ba464c29811617b871a3c174baadb23d2dadb57bf76bcd9de44487ff9
-  data.tar.gz: c009caabf877b46d424e529bce376477835153338eef1b6bd2fd833fdbfb3b7cca157238823efd86aa44513c0ba5bd7e7fab5571a9799666ba9ab81624e4cb7f
+  metadata.gz: 0f8df1c0e2d708a2f11104b9dc01d1dd71d9fab123c473d610d2fec9f95de27469ff6729545b1b63105c14fe6576600694dbe43fc0783c70e7a44b8f6906f1b0
+  data.tar.gz: 38b884a40257519f61a116d5e063261029220c543628f4122247745cfeb2d8f400a66186cf64de8fa50ee9989cf14f64e49c2162ad08e3ade510ad3a06f1e274

data/k_builder.gemspec

@@ -40,6 +40,7 @@ Gem::Specification.new do |spec|
 
   spec.add_dependency 'handlebars-helpers', '~> 0'
   spec.add_dependency 'k_log', '~> 0'
+  spec.add_dependency 'k_type', '~> 0'
   spec.add_dependency 'k_util', '~> 0'
   # spec.add_dependency "anyway_config"     , ">= 2.0.0"
   # spec.add_dependency "config"     , ">= 3.0.0"

data/lib/k_builder.rb

@@ -1,30 +1,24 @@
 # frozen_string_literal: true
 
+require 'k_log'
+require 'k_util'
+require 'k_type'
 require 'k_builder/version'
 require 'k_builder/base_builder'
 require 'k_builder/base_configuration'
 require 'k_builder/configuration'
 require 'k_builder/file_segments'
-require 'k_builder/named_folders'
-require 'k_builder/layered_folders'
-require 'k_log'
-require 'k_util'
 
 require 'handlebars/helpers/template'
 
 module KBuilder
   # raise KBuilder::Error, 'Sample message'
   class Error < StandardError; end
-
-  # Need to move this into a KLog factory
-  def self.configure_logger
-    logger = Logger.new($stdout)
-    logger.level = Logger::DEBUG
-    logger.formatter = KLog::LogFormatter.new
-    KLog::LogUtil.new(logger)
-  end
 end
 
-L = KBuilder.configure_logger
-
-puts "KBuilder::Version: #{KBuilder::VERSION}" if ENV['KLUE_DEBUG']&.to_s&.downcase == 'true'
+if ENV['KLUE_DEBUG']&.to_s&.downcase == 'true'
+  namespace = 'KBuilder::Version'
+  file_path = $LOADED_FEATURES.find { |f| f.include?('k_builder/version') }
+  version   = KBuilder::VERSION.ljust(9)
+  puts "#{namespace.ljust(35)} : #{version.ljust(9)} : #{file_path}"
+end

data/lib/k_builder/base_builder.rb

@@ -8,6 +8,8 @@ module KBuilder
   #             Setter methods (are NOT fluent) can be created as needed
   #             these methods would not be prefixed with the set_
   class BaseBuilder
+    include KLog::Logging
+
     attr_reader :configuration
 
     attr_accessor :target_folders
@@ -57,6 +59,17 @@ module KBuilder
       }
     end
 
+    def debug
+      log.subheading 'kbuilder'
+
+      target_folders.debug(title: 'target_folders')
+
+      log.info ''
+
+      template_folders.debug(title: 'template folders (search order)')
+      ''
+    end
+
     # ----------------------------------------------------------------------
     # Fluent interface
     # ----------------------------------------------------------------------
@@ -81,6 +94,7 @@ module KBuilder
     # @option opts [String] :to Recipient email
     # @option opts [String] :body The email's body
     def add_file(file, **opts)
+      # move to command
       full_file = opts.key?(:folder_key) ? target_file(file, folder: opts[:folder_key]) : target_file(file)
 
       # Need logging options that can log these internal details
@@ -92,11 +106,22 @@ module KBuilder
 
       # Prettier needs to work with the original file name
       run_prettier file if opts.key?(:pretty)
+      # Need support for rubocop -a
 
       self
     end
     alias touch add_file # it is expected that you would not supply any options, just a file name
 
+    def make_folder(folder_key = nil, sub_path: nil)
+      folder_key  = current_folder_key if folder_key.nil?
+      folder      = target_folder(folder_key)
+      folder      = File.join(folder, sub_path) unless sub_path.nil?
+
+      FileUtils.mkdir_p(folder)
+
+      self
+    end
+
     # Add content to the clipboard
     #
     # @option opts [String] :content Supply the content that you want to write to the file
@@ -108,6 +133,7 @@ module KBuilder
     # @option opts [String] :to Recipient email
     # @option opts [String] :body The email's body
     def add_clipboard(**opts)
+      # move to command
       content = process_any_content(**opts)
 
       begin
@@ -125,6 +151,7 @@ module KBuilder
     alias clipboard_copy add_clipboard
 
     def vscode(*file_parts, folder: current_folder_key)
+      # move to command
       file = target_file(*file_parts, folder: folder)
 
       rc "code #{file}"
@@ -234,9 +261,19 @@ module KBuilder
 
       return unless opts[:content_file]
 
-      cf = opts[:content_file]
+      # NOTE: when using content file, you still want to search for it in the template folders, I THINK?
+      cf = find_template_file(opts[:content_file])
+
+      return "content not found: #{opts[:content_file]}" if cf.nil?
+
+      # cf = opts[:content_file]
+
+      # unless File.exist?(cf)
+      #   cf_from_template_folders = find_template_file(cf)
+      #   return "Content not found: #{File.expand_path(cf)}" unless File.exist?(cf_from_template_folders)
 
-      return "Content not found: #{File.expand_path(cf)}" unless File.exist?(cf)
+      #   cf = cf_from_template_folders
+      # end
 
       File.read(cf)
     end
@@ -298,6 +335,8 @@ module KBuilder
 
       puts build_command
 
+      # need to support the fork process options as I was not able to run
+      # k_builder_watch -n because it hid all the following output
       system(build_command)
     end
     alias rc run_command

data/lib/k_builder/base_configuration.rb

@@ -3,17 +3,25 @@
 module KBuilder
   # Base configuration object for all k_builder* GEM
   class BaseConfiguration
-    def self.attach_to(klass_me, klass_target, accessor_name)
-      # Create a memoized getter to an instance of the attaching class (:klass_me)
+    class << self
+      # Attach a child configuration with it's own settings to a parent configuration
       #
-      # def third_party
-      #   @third_party ||= KBuilder::ThirdPartyGem::Configuration.new
-      # end
-      klass_target.send(:define_method, accessor_name) do
-        return instance_variable_get("@#{accessor_name}") if instance_variable_defined?("@#{accessor_name}")
+      # @param [Class] klass_child what class would you like as the child
+      # @param [Class] klass_parent what class would you like to extend with a new child configuration
+      # @param [Symbol] accessor_name what is the name of the accessor that you are adding
+      def attach_config_to_parent(klass_child, klass_parent, accessor_name)
+        # Create a memoized getter to an instance of the attaching class (:klass_child)
+        #
+        # def third_party
+        #   @third_party ||= KBuilder::ThirdPartyGem::Configuration.new
+        # end
+        klass_parent.send(:define_method, accessor_name) do
+          return instance_variable_get("@#{accessor_name}") if instance_variable_defined?("@#{accessor_name}")
 
-        instance_variable_set("@#{accessor_name}", klass_me.new)
+          instance_variable_set("@#{accessor_name}", klass_child.new)
+        end
       end
+      alias attach_to attach_config_to_parent
     end
 
     # move out into module
@@ -29,6 +37,7 @@ module KBuilder
       hash
     end
 
+    # This code is being moved into k_util (data)
     # Any basic (aka primitive) type
     def basic_type?(value)
       value.is_a?(String) ||

data/lib/k_builder/configuration.rb

@@ -19,9 +19,17 @@ module KBuilder
     yield(configuration)
   end
 
+  # Does this class need to move out into k_types?
+  # It is being used with k_manager in a similar fashion
+  #
   # Configuration class
   class Configuration < BaseConfiguration
+    include KLog::Logging
+
+    # Target folders provide a set named folders that can be written to
     attr_accessor :target_folders
+
+    # Template folders provides layered folders that templates can exist within
     attr_accessor :template_folders
 
     def initialize
@@ -29,8 +37,8 @@ module KBuilder
       # @target_folder = Dir.getwd
       # @template_folder = File.join(Dir.getwd, '.templates')
       # @global_template_folder = nil
-      @target_folders = NamedFolders.new
-      @template_folders = LayeredFolders.new
+      @target_folders = KType::NamedFolders.new
+      @template_folders = KType::LayeredFolders.new
     end
 
     def initialize_copy(orig)
@@ -40,25 +48,15 @@ module KBuilder
       @template_folders = orig.template_folders.clone
     end
 
-    # rubocop:disable Metrics/AbcSize
     def debug
-      L.subheading 'kbuilder base configuration'
+      log.subheading 'kbuilder base configuration'
 
-      L.section_heading 'target_folders'
-      target_folders.folders.each_key do |key|
-        folder = target_folders.folders[key]
-        L.kv key.to_s, folder
-      end
-      L.info ''
+      target_folders.debug(title: 'target_folders')
 
-      L.section_heading 'template folders (search order)'
+      log.info ''
 
-      template_folders.ordered_keys.each do |key|
-        folder = template_folders.folders[key]
-        L.kv key.to_s, folder
-      end
+      template_folders.debug(title: 'template folders (search order)')
       ''
     end
-    # rubocop:enable Metrics/AbcSize
   end
 end

data/lib/k_builder/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module KBuilder
-  VERSION = '0.0.53'
+  VERSION = '0.0.59'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: k_builder
 version: !ruby/object:Gem::Version
-  version: 0.0.53
+  version: 0.0.59
 platform: ruby
 authors:
 - David Cruwys
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-04-01 00:00:00.000000000 Z
+date: 2021-06-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: handlebars-helpers
@@ -38,6 +38,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: k_type
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: k_util
   requirement: !ruby/object:Gem::Requirement
@@ -85,8 +99,6 @@ files:
 - lib/k_builder/base_configuration.rb
 - lib/k_builder/configuration.rb
 - lib/k_builder/file_segments.rb
-- lib/k_builder/layered_folders.rb
-- lib/k_builder/named_folders.rb
 - lib/k_builder/version.rb
 - usage/_out1.png
 - usage/_out2.png

data/lib/k_builder/layered_folders.rb

@@ -1,104 +0,0 @@
-# frozen_string_literal: true
-
-module KBuilder
-  #
-  # Named folders makes sense for generated/output folders because you may want
-  # more than one type of location to generate output.
-  #
-  # Don't confuse multiple named output folders with sub-paths, when you want to
-  # build up a file name in a child folder, you can do that as part of building
-  # the filename.
-  #
-  # The idea behind named folders is for when you have two or more totally different
-  # outputs that (may live in the a similar location) or live in different locations.
-
-  # Layered folders allow files to be found in any of the searchable folders
-  #
-  # They derive from and thus work just like named folders in that they allow folders
-  # to be stored with easy to remember names/alias's.
-  #
-  # Where they differ is that they are retrieved in preferential search order that is
-  # by default (First In, Last Out) priority aka a Stack (Last In, First Out) or
-  # optionally over ridden via the search_order method
-  #
-  # Layered folders makes sense for use with template files and source data/model
-  # where you can have specific usage files available and if they are not found then
-  # you can use fall-back files in other folders.
-  #
-  # example:
-  #   folders = LayeredFolders.new
-  #   folders.add(:global       , '~/global_templates')
-  #   folders.add(:domain       , '/my-project/domain_templates')
-  #   folders.add(:app          , '/my-project/my-app/.templates')
-  #
-  #   # Find a file and folder will in folders in this order
-  #   # app_templates, then domain_templates and then finally global templates
-  #   # ['/my-project/my-app/.templates', '/my-project/domain_templates', '~/global_templates']
-  #   #
-  #   # Find a file called template1.txt and return its fully-qualified path
-  #   folders.find_file('template1.txt')
-  #
-  #   # As above, but returns the folder only, file name and sub-paths are ignored
-  #   folders.find_file_folder('template1.txt')
-  #   folders.find_file_folder('abc/xyz/deep-template.txt')
-  #
-  #   # If an additional folder is added, say in child configuration that is designed
-  #   # to override some of the global templates, then you can run a search_order
-  #   # method to re-order the templates
-  #
-  #   folders.add(:global_shim  , '~/global_templates_shim')
-  #   folders.search_order(:app, :domain, :global_shim, :global)
-  #
-  # class Builder < KBuilder::BaseBuilder
-  class LayeredFolders < KBuilder::NamedFolders
-    attr_reader :ordered_keys
-    attr_reader :ordered_folders
-
-    def initialize
-      super()
-
-      @ordered_keys = []
-      @ordered_folders = []
-    end
-
-    def initialize_copy(orig)
-      super(orig)
-
-      @ordered_keys = orig.ordered_keys.clone
-      @ordered_folders = orig.ordered_folders.clone
-    end
-
-    def add(folder_key, *folder_parts)
-      folder = super(folder_key, *folder_parts)
-
-      ordered_keys.prepend(folder_key)
-      ordered_folders.prepend(folder)
-
-      folder
-    end
-
-    # File name or array of sub-paths plus file
-    #
-    # Return the folder that a file is found in
-    def find_file(file_parts)
-      folder = find_file_folder(file_parts)
-      folder.nil? ? nil : File.join(folder, file_parts)
-    end
-
-    # File name or array of sub-paths plus file
-    #
-    # Return the folder that a file is found in
-    def find_file_folder(file_parts)
-      ordered_folders.find { |folder| File.exist?(File.join(folder, file_parts)) }
-    end
-
-    def to_h
-      {
-        ordered: {
-          keys: ordered_keys,
-          folders: ordered_folders
-        }
-      }.merge(@folders)
-    end
-  end
-end

data/lib/k_builder/named_folders.rb

@@ -1,116 +0,0 @@
-# frozen_string_literal: true
-
-module KBuilder
-  # Named folders allow folders to be stored with easy to remember names/alias's
-  # Secondarily, you can also build up file names based on these named folders.
-  #
-  # Named folders makes sense for generated/output folders because you may want
-  # more than one type of location to generate output.
-  #
-  # Don't confuse multiple named output folders with sub-paths, when you want to
-  # build up a file name in a child folder, you can do that as part of building
-  # the filename.
-  #
-  # The idea behind named folders is for when you have two or more totally different
-  # outputs that (may live in the a similar location) or live in different locations.
-  # Samples:
-  #   name: :code       - generating source code into a project
-  #   name: :slide      - generating slide deck into a documentation folder
-  #   name: :webpack    - folder where you might generate webpack files, e.g. webpack.config.*.json
-  #
-  # example:
-  #   folders = NamedFolders.new
-  #   folders.add(:csharp       , '~/dev/csharp/cool-project')
-  #   folders.add(:package_json , :csharp)
-  #   folders.add(:webpack      , folders.join(:csharp, 'config'))
-  #   folders.add(:builder      , folders.join(:csharp, 'builder'))
-  #   folders.add(:slides       , '~/doc/csharp/cool-project')
-  #
-  #   puts folders.get(:builder)
-  #
-  #   puts folders.get_filename(:csharp, 'Program.cs')
-  #   puts folders.get_filename(:csharp, 'Models/Order.cs')
-  #   puts folders.get_filename(:csharp, 'Models', 'Order.cs')
-  #
-  # Do I need to support :default?
-  class NamedFolders
-    attr_reader :folders
-
-    attr_reader :current
-
-    def initialize
-      @folders = {}
-      @current = nil
-    end
-
-    def initialize_copy(orig)
-      super(orig)
-
-      @folders = orig.folders.clone
-    end
-
-    def current=(folder_key)
-      guard_folder_key(folder_key)
-      @current = folder_key
-    end
-
-    # Add support for file_parts
-    def add(folder_key, *folder_parts)
-      # get a predefined folder by symbol
-      folder = join_folder_parts(folder_parts)
-      if folder.is_a?(Symbol)
-        folder = get(folder)
-      elsif folder.start_with?('~')
-        folder = File.expand_path(folder)
-      end
-
-      @current = folder_key if @current.nil?
-      folders[folder_key] = folder
-    end
-
-    # Get a folder
-    def get(folder_key)
-      guard_folder_key(folder_key)
-      folders[folder_key]
-    end
-
-    # Join the lookup folder key with the subpath folder parts (optionally + filename) and return the folder or filename
-    #
-    # Return fully qualified filename
-    def join(folder_key, *file_folder_parts)
-      folder = get(folder_key)
-
-      File.join(folder, file_folder_parts)
-    end
-    # Get a file name using the lookup folder key and the file name or array of sub-paths plus filename
-    alias get_filename join
-
-    def folder_keys
-      @folders.keys
-    end
-
-    def to_h
-      @folders
-    end
-
-    private
-
-    def join_folder_parts(folder_parts)
-      raise KBuilder::Error, 'No folder part provided' if folder_parts.nil? || folder_parts.length.zero?
-
-      # If only one part, and that can be a folder or :folder_key, then just return it
-      return folder_parts.first if folder_parts.length == 1
-
-      folder_parts = folder_parts.map.with_index do |folder_part, index|
-        folder_part = get(folder_part) if index.zero? && folder_part.is_a?(Symbol)
-        folder_part
-      end
-
-      File.join(folder_parts)
-    end
-
-    def guard_folder_key(folder_key)
-      raise KBuilder::Error, "Folder not found, this folder key not found: #{folder_key}" unless folders.key?(folder_key)
-    end
-  end
-end