k_builder 0.0.1 → 0.0.23

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d63754fbda587b7ea17d7ae17d4fb33029fac853280ce5125bfb1d7924c4ddfc
-  data.tar.gz: 62d174cd9cf2b5ad60a43319875efffc6845a409ea1067b4cb01d916f69456cf
+  metadata.gz: 1e1de8ff91bc3e273459d6970c8c1c136184e9c0990b0645fa426888317640eb
+  data.tar.gz: b6a5856f4bbb628422968a80a212fc6fbb1515b19c2cc29160d9cf984faa2b40
 SHA512:
-  metadata.gz: 53b98c935cb446629725ccb9a4bd4fa6babe87e985e7886ab2308592cb5413604063cb54eee5f439dfe79263b3d73d03c32c94cbe9ccb89eaf0599b1c655e9ea
-  data.tar.gz: 985ad06c8e9a92f5e79eab2167b35cebee0940ae87bd9044e3de466c09786364444cbffafe7441bef59f8d031186106ffc317d9ddc91dc6c9288066db670f548
+  metadata.gz: 62e85ea3f17a20cbc3bd180b74a057caab722d37de1bdb008353839f5f0159f564b69a4bcee9124857c7d24fe5b7b46afe967b86e52aaac7009960a663294886
+  data.tar.gz: 51a3c0374b57f0cfebc099df6d86c7657b50815185ea60f71e37cc9f27c5edf4afbb1933e727c1e68b81b179b079f7666c89a9273e971d7aa72fdb74e0411942

data/.rubocop.yml

@@ -60,6 +60,9 @@ Naming/MemoizedInstanceVariableName:
 Naming/VariableNumber:
   Exclude:
     - "**/spec/**/*"
+Naming/AccessorMethodName:
+  Exclude:
+    - "**/*builder*.rb"
 Style/EmptyMethod:    
   Exclude:
     - "**/spec/**/*"

data/Guardfile

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+guard :bundler, cmd: 'bundle install' do
+  watch('Gemfile')
+  watch('k_builder.gemspec')
+end
+
+group :green_pass_then_cop, halt_on_fail: true do
+  guard :rspec, cmd: 'bundle exec rspec -f doc' do
+    require 'guard/rspec/dsl'
+    dsl = Guard::RSpec::Dsl.new(self)
+
+    # RSpec files
+    rspec = dsl.rspec
+    watch(rspec.spec_helper) { rspec.spec_dir }
+    watch(rspec.spec_support) { rspec.spec_dir }
+    watch(rspec.spec_files)
+
+    # Ruby files
+    ruby = dsl.ruby
+    dsl.watch_spec_files_for(ruby.lib_files)
+    watch(%r{^lib/k_builder/(.+)\.rb$}) { |m| "spec/unit/#{m[1]}_spec.rb" }
+    watch(%r{^lib/k_builder/commands/(.+)\.rb$}) { |m| "spec/unit/commands/#{m[1]}_spec.rb" }
+  end
+
+  guard :rubocop, all_on_start: false, cli: ['--format', 'clang'] do
+    watch(/{.+\.rb$/)
+    watch(%r{(?:.+/)?\.rubocop(?:_todo)?\.yml$}) { |m| File.dirname(m[0]) }
+  end
+end

data/README.md

@@ -1,6 +1,6 @@
 # K Builder
 
-> K Builder provides various fluent builders for initializing applications with different language requirements
+> KBuilder provides various fluent builders and code generators for initializing applications with different language requirements
 
 ## Installation
 
@@ -26,16 +26,52 @@ gem install k_builder
 
 ### Main Story
 
-
+As a Polyglot Developer, I want to be up and running in any development language with consistency, so I am productive and using best practices
 
 See all [stories](./STORIES.md)
 
-
 ## Usage
 
 See all [usage examples](./USAGE.md)
 
+### Basic Example
+
+#### Configure and Run
+
+Setup configuration for KBuilder
+
+Generate two files:
 
+1. main.rb is based on class.rb from app_template
+2. configuration.log.txt is based on an inline template
+
+Check out usage.md for more details
+
+```ruby
+usecases_folder = File.join(Dir.getwd, 'spec', 'usecases')
+
+KBuilder.configure do |config|
+  config.template_folder = File.join(usecases_folder, '.app_template')
+  config.global_template_folder = File.join(usecases_folder, '.global_template')
+  config.target_folder = File.join(usecases_folder, '.output')
+end
+
+template = <<~TEXT
+  Configured Template Folder        : {{a}}
+  Configured Global Template Folder : {{b}}
+  Configured Output Folder          : {{c}}
+TEXT
+
+builder = KBuilder::Builder.init
+
+builder.add_file('main.rb', template_file: 'class.rb', name: 'main').add_file(
+  'configuration.log.txt',
+  template: template,
+  a: builder.template_folder,
+  b: builder.global_template_folder,
+  c: builder.target_folder
+)
+```
 
 ## Development
 
@@ -45,7 +81,7 @@ Checkout the repo
 git clone klueless-io/k_builder
 ```
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. 
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests.
 
 You can also run `bin/console` for an interactive prompt that will allow you to experiment.
 

data/STORIES.md

@@ -1,6 +1,6 @@
 # K Builder
 
-> K Builder provides various fluent builders for initializing applications with different language requirements
+> KBuilder provides various fluent builders and code generators for initializing applications with different language requirements
 
 As a Polyglot Developer, I want to be up and running in any development language with consistency, so I am productive and using best practices
 
@@ -8,26 +8,21 @@ As a Polyglot Developer, I want to be up and running in any development language
 
 ### Stories next on list
 
-As a Developer, I can DO_SOMETHING, so that I QUALITY_OF_LIFE
-
-- Subtask
+As a Polyglot Developer, I want to be up and running in any development language with consistency, so I am productive and using best practices [EPIC]
 
 ### Tasks next on list
 
-Setup RubyGems and RubyDoc
-
-- Build and deploy gem to [rubygems.org](https://rubygems.org/gems/k_builder)
-- Attach documentation to [rubydoc.info](https://rubydoc.info/github/to-do-/k_builder/master)
-
-Setup GitHub Action (test and lint)
-
-- Setup Rspec action
-- Setup RuboCop action
+BaseBuilder
 
 ## Stories and tasks
 
 ### Tasks - completed
 
+Setup RubyGems and RubyDoc
+
+- Build and deploy gem to [rubygems.org](https://rubygems.org/gems/k_builder)
+- Attach documentation to [rubydoc.info](https://rubydoc.info/github/to-do-/k_builder/master)
+
 Setup project management, requirement and SCRUM documents
 
 - Setup readme file
@@ -35,6 +30,11 @@ Setup project management, requirement and SCRUM documents
 - Setup a project backlog
 - Setup an examples/usage document
 
+Setup GitHub Action (test and lint)
+
+- Setup Rspec action
+- Setup RuboCop action
+
 Setup new Ruby GEM
 
 - Build out a standard GEM structure

data/USAGE.md

@@ -1,19 +1,104 @@
 # K Builder
 
-> K Builder provides various fluent builders for initializing applications with different language requirements
+> KBuilder provides various fluent builders and code generators for initializing applications with different language requirements
 
 As a Polyglot Developer, I want to be up and running in any development language with consistency, so I am productive and using best practices
 
 ## Usage
 
-### Sample Classes
+### Configure And Build
 
-#### Simple example
-
-Description for a simple example that shows up in the USAGE.MD
+Print the configuration
 
 ```ruby
-class SomeRuby
-  def initialize; end
+usecases_folder = File.join(Dir.getwd, 'spec', 'usecases')
+
+KBuilder.configure do |config|
+  config.template_folder = File.join(usecases_folder, '.app_template')
+  config.global_template_folder = File.join(usecases_folder, '.global_template')
+  config.target_folder = File.join(usecases_folder, '.output')
 end
+
+puts JSON.pretty_generate(KBuilder.configuration.to_hash)
+```
+
+```javascript
+{
+  "target_folder": "/Users/name/dev/kgems/k_builder/spec/usecases/.output",
+  "template_folder": "/Users/name/dev/kgems/k_builder/spec/usecases/.app_template",
+  "global_template_folder": "/Users/name/dev/kgems/k_builder/spec/usecases/.global_template"
+}
 ```
+
+#### Folder Structure (starting)
+
+Example folder structure for this usecase before running the builder
+
+> Note: app-templates will take preference over global templates
+
+![](_usage_folder_before.png)
+
+#### Run builder
+
+This example builder will add 4 files into the output folder.
+
+1. `main.rb` is based on `class.rb` from `app_template`
+2. `person.rb` & `address.rb` are based on `model.rb` from `global_template`
+3. `configuration.log.txt` is based on an inline template
+
+```ruby
+template = <<~TEXT
+  Configured Template Folder        : {{a}}
+  Configured Global Template Folder : {{b}}
+  Configured Output Folder          : {{c}}
+TEXT
+
+builder = KBuilder::Builder.init
+
+builder
+  .add_file('main.rb', template_file: 'class.rb', name: 'main')
+  .add_file('person.rb',
+            template_file: 'model.rb',
+            name: 'person',
+            fields: %i[first_name last_name])
+  .add_file('address.rb',
+            template_file: 'model.rb',
+            name: 'address',
+            fields: %i[street1 street2 post_code state])
+  .add_file('configuration.log.txt',
+            template: template,
+            a: builder.template_folder,
+            b: builder.global_template_folder,
+            c: builder.target_folder)
+  .add_file('css/index.css',
+            template: '{{#each colors}} .{{.}} { color: {{.}} }  {{/each}}',
+            colors: ['red', 'blue', 'green'],
+            pretty: true)
+
+```
+
+#### Folder Structure (after)
+
+Folder structure after running the builder
+
+![](_usage_folder_after.png)
+
+#### main.rb
+
+![main.rb](_out1.png)
+
+#### person.rb
+
+![](_out2.png)
+
+#### address.rb
+
+![person.rb](_out3.png)
+
+#### configuration.log.txt
+
+![configuration.log.txt](_out4.png)
+
+#### css/index.css
+
+![css/index.css](_out5.png)

data/k_builder.gemspec

@@ -13,7 +13,7 @@ Gem::Specification.new do |spec|
   spec.description            = <<-TEXT
     K Builder provides various fluent builders for initializing applications with different language requirements
   TEXT
-  spec.homepage               = 'http://appydave.com/gems/k-builder'
+  spec.homepage               = 'http://appydave.com' # /gems/k-builder'
   spec.license                = 'MIT'
 
   # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
@@ -38,5 +38,7 @@ Gem::Specification.new do |spec|
   spec.require_paths = ['lib']
   # spec.extensions    = ['ext/k_builder/extconf.rb']
 
-  # spec.add_dependency 'tty-box',         '~> 0.5.0'
+  spec.add_dependency 'handlebars-helpers', '~> 0'
+  # spec.add_dependency "anyway_config"     , ">= 2.0.0"
+  # spec.add_dependency "config"     , ">= 3.0.0"
 end

data/lib/k_builder.rb

@@ -1,6 +1,12 @@
 # frozen_string_literal: true
 
 require 'k_builder/version'
+require 'k_builder/base_configuration'
+require 'k_builder/configuration'
+require 'k_builder/base_builder'
+require 'k_builder/builder'
+
+require 'handlebars/helpers/template'
 
 module KBuilder
   # raise KBuilder::Error, 'Sample message'

data/lib/k_builder/base_builder.rb

@@ -0,0 +1,131 @@
+# frozen_string_literal: true
+
+module KBuilder
+  # Base builder defines builder methods, build method and configuration
+  #
+  # Convention: Setter methods (are Fluent) and use the prefix set_
+  #             Getter methods (are NOT fluent) and return the stored value
+  #             Setter methods (are NOT fluent) can be created as needed
+  #             these methods would not be prefixed with the set_
+  class BaseBuilder
+    attr_reader :hash
+
+    # Factory method that provides a builder for a specified structure
+    # runs through a configuration block and then builds the final structure
+    #
+    # @return [type=Object] data structure
+    def self.build
+      init.build
+    end
+
+    # Create and initialize the builder.
+    #
+    # Initialization can be done via any of these three sequential steps.
+    #   - Configuration hash
+    #   - After new event
+    #   - Configuration block (lambda)
+    #
+    # @return [Builder] Returns the builder via fluent interface
+    def self.init(configuration = nil)
+      builder = new(configuration)
+
+      builder.after_new
+
+      yield(builder) if block_given?
+
+      builder
+    end
+
+    # Use after_new to massage hash values that come in via
+    # configuration into more complex values
+    #
+    # Abstract method
+    def after_new; end
+
+    # assigns a builder hash and defines builder methods
+    def initialize(configuration = nil)
+      @hash = {}
+
+      unless configuration.nil?
+        raise KBuilder::StandardError, 'Unknown configuration object' unless configuration.is_a?(Hash)
+
+        hash.merge!(configuration)
+      end
+
+      define_builder_setter_methods
+    end
+
+    # Return an array of symbols to represent the fluent
+    # setter methods that you want on your builder.
+    #
+    # Abstract method
+    def builder_setter_methods
+      raise NotImplementedError
+    end
+
+    # @return [Hash/StrongType] Returns data object, can be a hash
+    #                           or strong typed object that you
+    #                           have wrapped around the hash
+    def build
+      hash
+    end
+
+    # TODO
+    # Support Nesting
+    # Support Generation fo the following
+    #   - fluent set_
+    #   - Support setter (non-fluent)
+    #   - Support getter (non-fluent)
+
+    # # builds a nested structure by either builder block or hash
+    # # @param data_structure [type=DataStructure]
+    # # @param builder [type=Builder]
+    # # @param attributes [type=Hash|DataStructure instance]
+    # # @param &block
+    # #
+    # # @return [type=Hash]
+    # def build_nested(data_structure, builder, attributes = {}, &block)
+    #   if block_given?
+    #     builder.build(&block).to_h
+    #   else
+    #     build_hash(data_structure, attributes)
+    #   end
+    # end
+
+    private
+
+    # #
+    # # @param data_structure [type=DataStructure]
+    # # @param attributes [type=Hash, DataStructure]
+    # #
+    # # @return [type=Hash]
+    # def build_hash(data_structure, attributes)
+    #   if attributes.is_a?(data_structure)
+    #     attributes.to_h
+    #   else
+    #     data_structure.new(attributes).to_h
+    #   end
+    # end
+
+    # Defines all of the necessary builder setter methods
+    #
+    # @return [Builder] Returns the builder via fluent interface
+    def define_builder_setter_methods
+      builder_setter_methods.each { |method| define_builder_method(method) }
+      self
+    end
+
+    # Defines a method using the convention set_[method_name]
+    #
+    # Convention: Setter methods (are Fluent) and use the prefix set_
+    #             Getter methods (are NOT fluent) and return the stored value
+    #
+    # @return [Builder] Returns the builder via fluent interface
+    def define_builder_method(method_name)
+      self.class.send(:define_method, "set_#{method_name}") do |value|
+        @hash[method_name.to_s] = value
+        self
+      end
+    end
+  end
+end

data/lib/k_builder/base_configuration.rb

@@ -0,0 +1,106 @@
+# frozen_string_literal: true
+
+module KBuilder
+  # Base configuration object for all k_builder* GEM
+  class BaseConfiguration
+    def to_hash
+      hash = {}
+      instance_variables.each { |var| hash[var.to_s.delete('@')] = instance_variable_get(var) }
+      hash
+    end
+
+    def kv(name, value)
+      puts "#{name.rjust(30)} : #{value}"
+    end
+
+    # All of this code should be extracted into a module
+    #
+    # The module should then be extracted out into a GEM so that
+    # I can include it as needed. The GEM might be called
+    # (dynamic attributes) and would allow a regular class to act like an OpenStruct
+    # K-DSL uses data hash, while base configuration uses instance variables
+
+    def respond_to_missing?(name, *_args, &_block)
+      # puts 'respond_to_missing?'
+      # puts "respond_to_missing: #{name}"
+      n = name.to_s
+      n = n[0..-2] if n.end_with?('=')
+
+      if n.end_with?('?')
+        super
+      else
+        # This has not been fully tested
+        instance_variable_defined?("@#{n}") || super
+      end
+    end
+
+    def method_missing(name, *args, &_block)
+      # puts "method_missing: #{name}"
+      # puts "args.length   : #{args.length}"
+
+      add_getter_or_param_method(name)
+      add_setter_method(name)
+
+      send(name, args[0]) if args.length == 1 # name.end_with?('=')
+
+      super unless self.class.method_defined?(name)
+    end
+
+    # Handles Getter method and method with single parameter
+    # object.my_name
+    # object.my_name('david')
+    def add_getter_or_param_method(name)
+      # L.progress(1, 'add_getter_or_param_method')
+      self.class.class_eval do
+        # L.progress(2, 'add_getter_or_param_method')
+        name = name.to_s.gsub(/=$/, '')
+        # L.progress(3, 'add_getter_or_param_method')
+        # L.kv 'name', name
+        define_method(name) do |*args|
+          # L.progress(4, 'add_getter_or_param_method')
+          # L.kv 'add_getter_or_param_method', name
+          raise KBuilder::Error, 'Multiple setting values is not supported' if args.length > 1
+
+          if args.length.zero?
+            get_value(name)
+          else
+            send("#{name}=", args[0])
+          end
+        end
+      end
+    end
+
+    # Handles Setter method
+    # object.my_name = 'david'
+    def add_setter_method(name)
+      # L.progress(1, 'add_setter_method')
+      self.class.class_eval do
+        # L.progress(2, 'add_setter_method')
+        name = name.to_s.gsub(/=$/, '')
+        # L.progress(3, 'add_setter_method')
+        # L.kv 'add_setter_method', name
+        define_method("#{name}=") do |value|
+          # L.progress(4, 'add_setter_method')
+          # L.kv 'name', name
+          # L.kv 'value', value
+          instance_variable_set("@#{name}", value)
+          # my_data[name.to_s] = value
+        end
+      end
+    end
+
+    def get_value(name)
+      instance_variable_get("@#{name}")
+    end
+  end
+
+  # class L
+  #   def self.progress(index, label)
+  #     puts "#{index} - #{label}"
+  #   end
+
+  #   def self.kv(name, value)
+  #     puts "#{name.rjust(30)} : #{value}"
+  #   end
+  # end
+end

data/lib/k_builder/builder.rb

@@ -0,0 +1,258 @@
+# frozen_string_literal: true
+
+module KBuilder
+  # Base builder defines builder methods, build method and configuration
+  class Builder < KBuilder::BaseBuilder
+    # builder_setter_methods = %w[].freeze
+    # target_folder
+    # template_folder
+    # global_template_folder
+
+    def initialize(configuration = nil)
+      configuration = KBuilder.configuration.to_hash if configuration.nil?
+
+      super(configuration)
+    end
+
+    # rubocop:disable Metrics/AbcSize
+    def after_new
+      # ensure that any configured folders are expanded
+      self.target_folder = hash['target_folder'] unless hash['target_folder'].nil?
+      self.template_folder = hash['template_folder'] unless hash['template_folder'].nil?
+      self.global_template_folder = hash['global_template_folder'] unless hash['global_template_folder'].nil?
+    end
+    # rubocop:enable Metrics/AbcSize
+
+    # Return an array of symbols to represent the fluent setter methods in this builder.
+    def builder_setter_methods
+      # Currently I have manually created my settings because I needed custom
+      # logic in the settings to handle path expansion
+      []
+    end
+
+    # def build
+    #   # SomeDryStruct.new(hash)
+    # end
+
+    # ----------------------------------------------------------------------
+    # Fluent interface
+    # ----------------------------------------------------------------------
+
+    # Add a file to the target location
+    #
+    # @param [String] file The file name with or without relative path, eg. my_file.json or src/my_file.json
+    # @option opts [String] :content Supply the content that you want to write to the file
+    # @option opts [String] :template Supply the template that you want to write to the file, template will be processed  ('nobody') From address
+    # @option opts [String] :content_file File with content, file location is based on where the program is running
+    # @option opts [String] :template_file File with handlebars templated content that will be transformed, file location is based on the configured template_path
+    #
+    # Extra options will be used as data for templates, e.g
+    # @option opts [String] :to Recipient email
+    # @option opts [String] :body The email's body
+    def add_file(file, **opts)
+      full_file = target_file(file)
+
+      FileUtils.mkdir_p(File.dirname(full_file))
+
+      content = process_any_content(**opts)
+
+      File.write(full_file, content)
+
+      # Prettier needs to work with the original file name
+      run_prettier file if opts.key?(:pretty)
+
+      self
+    end
+
+    # ----------------------------------------------------------------------
+    # Attributes: Think getter/setter
+    #
+    # The following getter/setters can be referenced both inside and outside
+    # of the fluent builder fluent API. They do not implement the fluent
+    # interface unless prefixed by set_.
+    #
+    # set_: Only setters with the prefix _set are considered fluent.
+    # ----------------------------------------------------------------------
+
+    # Target folder
+    # ----------------------------------------------------------------------
+
+    # Fluent setter for target folder
+    def set_target_folder(value)
+      self.target_folder = value
+
+      self
+    end
+
+    # Setter for target folder
+    def target_folder=(value)
+      hash['target_folder'] = File.expand_path(value)
+    end
+
+    # Getter for target folder
+    def target_folder
+      hash['target_folder']
+    end
+
+    # Template folder
+    # ----------------------------------------------------------------------
+
+    # Fluent setter for template folder
+    def set_template_folder(value)
+      self.template_folder = value
+
+      self
+    end
+
+    # Setter for template folder
+    # Refactor: Make Private
+    def template_folder=(value)
+      hash['template_folder'] = File.expand_path(value)
+    end
+
+    # Getter for template folder
+    # Refactor: generate
+    def template_folder
+      hash['template_folder']
+    end
+
+    # Global Target folder
+    # ----------------------------------------------------------------------
+
+    # Fluent setter for global template folder
+    def set_global_template_folder(value)
+      self.global_template_folder = value
+
+      self
+    end
+
+    # Setter for global template folder
+    # Refactor: Make Private
+    def global_template_folder=(value)
+      hash['global_template_folder'] = File.expand_path(value)
+    end
+
+    # Setter for global template folder
+    # Refactor: generate
+    def global_template_folder
+      hash['global_template_folder']
+    end
+
+    # Internal Actions are considered helpers for the builder, they do
+    # something useful, but they do not tend to implement fluent interfaces.
+    #
+    # They some times do actions, they sometimes return information.
+    #
+    # NOTE: [SRP] - These methods should probably be converted into objects
+    # ----------------------------------------------------------------------
+
+    # Gets a target_file relative to target folder
+    def target_file(file)
+      File.join(target_folder, file)
+    end
+
+    # Gets a template_file relative to the template folder
+    def template_file(file)
+      File.join(template_folder, file)
+    end
+
+    # Gets a global_template_file relative to the global template folder
+    def global_template_file(file)
+      File.join(global_template_folder, file)
+    end
+
+    # Gets a template_file relative to the template folder, looks first in
+    # local template folder and if not found, looks in global template folder
+    def find_template_file(file)
+      full_file = template_file(file)
+      return full_file if File.exist?(full_file)
+
+      full_file = global_template_file(file)
+      return full_file if File.exist?(full_file)
+
+      # File not found
+      nil
+    end
+
+    # Use content from a a selection of content sources
+    #
+    # @option opts [String] :content Just pass through the :content as is.
+    # @option opts [String] :content_file Read content from the :content_file
+    #
+    # Future options
+    # @option opts [String] :content_loren [TODO]Create Loren Ipsum text as a :content_loren count of words
+    # @option opts [String] :content_url Read content from the :content_url
+    #
+    # @return Returns some content
+    def use_content(**opts)
+      return opts[:content] unless opts[:content].nil?
+
+      return unless opts[:content_file]
+
+      cf = opts[:content_file]
+
+      return "Content not found: #{File.expand_path(cf)}" unless File.exist?(cf)
+
+      File.read(cf)
+    end
+
+    # Use template from a a selection of template sources
+    #
+    # @option opts [String] :template Just pass through the :template as is.
+    # @option opts [String] :template_file Read template from the :template_file
+    #
+    # @return Returns some template
+    def use_template(**opts)
+      return opts[:template] unless opts[:template].nil?
+
+      return unless opts[:template_file]
+
+      tf = find_template_file(opts[:template_file])
+
+      return "template not found: #{opts[:template_file]}" if tf.nil?
+
+      File.read(tf)
+    end
+
+    # Process content will take any one of the following
+    #  - Raw content
+    #  - File based content
+    #  - Raw template (translated via handlebars)
+    #  - File base template (translated via handlebars)
+    #
+    # Process any of the above inputs to create final content output
+    #
+    # @option opts [String] :content Supply the content that you want to write to the file
+    # @option opts [String] :template Supply the template that you want to write to the file, template will be transformed using handlebars
+    # @option opts [String] :content_file File with content, file location is based on where the program is running
+    # @option opts [String] :template_file File with handlebars templated content that will be transformed, file location is based on the configured template_path
+    def process_any_content(**opts)
+      raw_content = use_content(**opts)
+
+      return raw_content if raw_content
+
+      template_content = use_template(**opts)
+
+      Handlebars::Helpers::Template.render(template_content, opts) unless template_content.nil?
+    end
+
+    def run_prettier(file, log_level: :log)
+      # command = "prettier --check #{file} --write #{file}"
+      command = "npx prettier --loglevel #{log_level} --write #{file}"
+
+      run_command command
+    end
+
+    def run_command(command)
+      # Deep path create if needed
+      FileUtils.mkdir_p(target_folder)
+
+      build_command = "cd #{target_folder} && #{command}"
+
+      puts build_command
+
+      system(build_command)
+    end
+    alias rc run_command
+  end
+end

data/lib/k_builder/configuration.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+# Attach configuration to the KBuilder module
+module KBuilder
+  # Configuration for webpack5/builder
+  class << self
+    attr_writer :configuration
+  end
+
+  def self.configuration
+    @configuration ||= Configuration.new
+  end
+
+  def self.reset
+    @configuration = Configuration.new
+  end
+
+  def self.configure
+    yield(configuration)
+  end
+
+  # Configuration class
+  class Configuration < BaseConfiguration
+    attr_accessor :target_folder
+    attr_accessor :template_folder
+    attr_accessor :global_template_folder
+
+    def initialize
+      super
+      @target_folder = Dir.getwd
+      @template_folder = File.join(Dir.getwd, '.templates')
+      @global_template_folder = nil
+    end
+
+    def debug
+      puts '-' * 120
+      puts 'kbuilder base configuration'
+      kv 'target_folder'         , target_folder
+      kv 'template_folder'       , template_folder
+      kv 'global_template_folder', global_template_folder
+    end
+  end
+end

data/lib/k_builder/version.rb

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

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: k_builder
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.23
 platform: ruby
 authors:
 - David Cruwys
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-03-10 00:00:00.000000000 Z
-dependencies: []
+date: 2021-03-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: handlebars-helpers
+  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'
 description: "    K Builder provides various fluent builders for initializing applications
   with different language requirements\n"
 email:
@@ -24,11 +38,19 @@ files:
 - ".rubocop.yml"
 - CODE_OF_CONDUCT.md
 - Gemfile
+- Guardfile
 - LICENSE.txt
 - README.md
 - Rakefile
 - STORIES.md
 - USAGE.md
+- _out1.png
+- _out2.png
+- _out3.png
+- _out4.png
+- _out5.png
+- _usage_folder_after.png
+- _usage_folder_before.png
 - bin/console
 - bin/k
 - bin/kgitsync
@@ -38,12 +60,16 @@ files:
 - hooks/update-version
 - k_builder.gemspec
 - lib/k_builder.rb
+- lib/k_builder/base_builder.rb
+- lib/k_builder/base_configuration.rb
+- lib/k_builder/builder.rb
+- lib/k_builder/configuration.rb
 - lib/k_builder/version.rb
-homepage: http://appydave.com/gems/k-builder
+homepage: http://appydave.com
 licenses:
 - MIT
 metadata:
-  homepage_uri: http://appydave.com/gems/k-builder
+  homepage_uri: http://appydave.com
   source_code_uri: https://github.com/klueless-io/k_builder
   changelog_uri: https://github.com/klueless-io/k_builder/commits/master
 post_install_message: