cmdlet 0.0.5 → 0.1.2

data/.builders/generators/01-bootstrap.rb

@@ -1,121 +1,121 @@
+# frozen_string_literal: true
+
 KManager.action :bootstrap do
   action do
     application_name = :cmdlet
 
     # Ruby Gem Bootstrap
     director = KDirector::Dsls::RubyGemDsl
-      .init(k_builder,
-        on_exist:                   :skip,                      # %i[skip write compare]
-        on_action:                  :queue                      # %i[queue execute]
-      )
-      .data(
-        ruby_version:               '2.7',
-        application:                application_name,
-        application_description:    'Cmdlet provides a set of functions (wrapped in the command pattern) that perform simple actions',
-        application_lib_path:       application_name.to_s,
-        application_lib_namespace:  'Cmdlet',
-        namespaces:                 ['Cmdlet'],
-        author:                     'David Cruwys',
-        author_email:               'david@ideasmen.com.au',
-        initial_semver:             '0.0.1',
-        main_story:                 'As a Developer, I want to use simple categorized functions so that I can easily add commonplace functionality to my application',
-        copyright_date:             '2022',
-        website:                    'http://appydave.com/gems/cmdlet'
-      )
-      .github(
-        active: false,
-        repo_name: application_name
-      ) do
-        create_repository
-        # delete_repository
-        # list_repositories
-        open_repository
-        # run_command('git init')
-      end
-      .blueprint(
-        active: false,
-        name: :bin_hook,
-        description: 'initialize repository',
-        on_exist: :write) do
-
-        cd(:app)
-
-        run_template_script('bin/runonce/git-setup.sh', dom: dom)
-
-        add('.githooks/commit-msg').run_command('chmod +x .githooks/commit-msg')
-        add('.githooks/pre-commit').run_command('chmod +x .githooks/pre-commit')
-
-        add('.gitignore')
-
-        run_command('git config core.hooksPath .githooks') # enable sharable githooks (developer needs to turn this on before editing rep)
-
-        run_command("git add .; git commit -m 'chore: #{self.options.description.downcase}'; git push")
-        run_command("gh repo edit -d \"#{dom[:application_description]}\"")
-      end
-      .package_json(
-        active: false,
-        name: :package_json,
-        description: 'Set up the package.json file for semantic versioning'
-      ) do
-        self
-          .add('package.json', dom: dom)
-          .play_actions
-
-        self
-          .add_script('release', 'semantic-release')
-          .sort
-          .development
-          .npm_add_group('semver-ruby')
-
-        run_command("git add .; git commit -m 'chore: #{self.options.description.downcase}'; git push")
-      end
-      .blueprint(
-        active: false,
-        name: :opinionated,
-        description: 'opinionated GEM files',
-        on_exist: :write) do
-
-        cd(:app)
-
-        add('bin/setup')
-        add('bin/console')
-
-        add("lib/#{typed_dom.application}.rb"             , template_file: 'lib/applet_name.rb'         , dom: dom)
-        add("lib/#{typed_dom.application}/version.rb"     , template_file: 'lib/applet_name/version.rb' , dom: dom)
-    
-        add('spec/spec_helper.rb')
-        add("spec/#{typed_dom.application}_spec.rb"       , template_file: 'spec/applet_name_spec.rb', dom: dom)
-
-        add("#{typed_dom.application}.gemspec"            , template_file: 'applet_name.gemspec', dom: dom)
-        add('Gemfile', dom: dom)
-        add('Guardfile', dom: dom)
-        add('Rakefile', dom: dom)
-        add('.rspec', dom: dom)
-        add('.rubocop.yml', dom: dom)
-        add('README.md', dom: dom)
-        add('CODE_OF_CONDUCT.md', dom: dom)
-        add('LICENSE.txt', dom: dom)
-
-        run_command("rubocop -a")
-      
-        run_command("git add .; git commit -m 'chore: #{self.options.description.downcase}'; git push")
-      end
-      .blueprint(
-        active: true,
-        name: :ci_cd,
-        description: 'github actions (CI/CD)',
-        on_exist: :write) do
-
-        cd(:app)
-
-        run_command("gh secret set SLACK_WEBHOOK --body \"$SLACK_REPO_WEBHOOK\"")
-        run_command("gh secret set GEM_HOST_API_KEY --body \"$GEM_HOST_API_KEY\"")
-
-        add('.github/workflows/main.yml')
-        add('.releaserc.json')
-
-        run_command("git add .; git commit -m 'chore: #{self.options.description.downcase}'; git push")
-      end
+               .init(k_builder,
+                     on_exist: :skip, # %i[skip write compare]
+                     on_action: :queue # %i[queue execute]
+                    )
+               .data(
+                 ruby_version: '2.7',
+                 application: application_name,
+                 application_description: 'Cmdlet provides a set of functions (wrapped in the command pattern) that perform simple actions',
+                 application_lib_path: application_name.to_s,
+                 application_lib_namespace: 'Cmdlet',
+                 namespaces: ['Cmdlet'],
+                 author: 'David Cruwys',
+                 author_email: 'david@ideasmen.com.au',
+                 initial_semver: '0.0.1',
+                 main_story: 'As a Developer, I want to use simple categorized functions so that I can easily add commonplace functionality to my application',
+                 copyright_date: '2022',
+                 website: 'http://appydave.com/gems/cmdlet'
+               )
+               .github(
+                 active: false,
+                 repo_name: application_name
+               ) do
+                 create_repository
+                 # delete_repository
+                 # list_repositories
+                 open_repository
+                 # run_command('git init')
+               end
+               .blueprint(
+                 active: false,
+                 name: :bin_hook,
+                 description: 'initialize repository',
+                 on_exist: :write
+               ) do
+                 cd(:app)
+
+                 run_template_script('bin/runonce/git-setup.sh', dom: dom)
+
+                 add('.githooks/commit-msg').run_command('chmod +x .githooks/commit-msg')
+                 add('.githooks/pre-commit').run_command('chmod +x .githooks/pre-commit')
+
+                 add('.gitignore')
+
+                 run_command('git config core.hooksPath .githooks') # enable sharable githooks (developer needs to turn this on before editing rep)
+
+                 run_command("git add .; git commit -m 'chore: #{options.description.downcase}'; git push")
+                 run_command("gh repo edit -d \"#{dom[:application_description]}\"")
+               end
+               .package_json(
+                 active: false,
+                 name: :package_json,
+                 description: 'Set up the package.json file for semantic versioning'
+               ) do
+                 add('package.json', dom: dom)
+                   .play_actions
+
+                 add_script('release', 'semantic-release')
+                   .sort
+                   .development
+                   .npm_add_group('semver-ruby')
+
+                 run_command("git add .; git commit -m 'chore: #{options.description.downcase}'; git push")
+               end
+               .blueprint(
+                 active: false,
+                 name: :opinionated,
+                 description: 'opinionated GEM files',
+                 on_exist: :write
+               ) do
+                 cd(:app)
+
+                 add('bin/setup')
+                 add('bin/console')
+
+                 add("lib/#{typed_dom.application}.rb"             , template_file: 'lib/applet_name.rb'         , dom: dom)
+                 add("lib/#{typed_dom.application}/version.rb"     , template_file: 'lib/applet_name/version.rb' , dom: dom)
+
+                 add('spec/spec_helper.rb')
+                 add("spec/#{typed_dom.application}_spec.rb"       , template_file: 'spec/applet_name_spec.rb', dom: dom)
+
+                 add("#{typed_dom.application}.gemspec"            , template_file: 'applet_name.gemspec', dom: dom)
+                 add('Gemfile', dom: dom)
+                 add('Guardfile', dom: dom)
+                 add('Rakefile', dom: dom)
+                 add('.rspec', dom: dom)
+                 add('.rubocop.yml', dom: dom)
+                 add('README.md', dom: dom)
+                 add('CODE_OF_CONDUCT.md', dom: dom)
+                 add('LICENSE.txt', dom: dom)
+
+                 run_command('rubocop -a')
+
+                 run_command("git add .; git commit -m 'chore: #{options.description.downcase}'; git push")
+               end
+               .blueprint(
+                 active: true,
+                 name: :ci_cd,
+                 description: 'github actions (CI/CD)',
+                 on_exist: :write
+               ) do
+      cd(:app)
+
+      run_command('gh secret set SLACK_WEBHOOK --body "$SLACK_REPO_WEBHOOK"')
+      run_command('gh secret set GEM_HOST_API_KEY --body "$GEM_HOST_API_KEY"')
+
+      add('.github/workflows/main.yml')
+      add('.releaserc.json')
+
+      run_command("git add .; git commit -m 'chore: #{options.description.downcase}'; git push")
+    end
 
     director.play_actions
     # director.builder.logit

data/.builders/generators/20-categories.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+KManager.action :categories do
+  action do
+    CategoryDirector
+      .init(k_builder)
+      .category(:case       , 'Tokenize and apply case and/or separator')
+      .category(:comparison , 'Comparison helpers, eg. or, and, equal, not equal, less than, greater than etc.')
+      .category(:inflection , 'Inflection handling routines, eg. pluralize, singular, ordinalize')
+      .category(:string     , 'String handling helpers')
+      .category(:array      , 'Array handling routines, eg. join, join_prefix, join_post')
+      .category(:transform  , 'Tokenize and apply case and/or separator')
+      .save_categories
+      .generate
+  end
+end

data/.builders/generators/30-commands-bak.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+KManager.action :commands_bak do
+  action do
+    puts commands.first.function_description
+    # Ruby Gem Bootstrap
+    director = KDirector::Dsls::BasicDsl
+               .init(k_builder,
+                     template_base_folder: '',
+                     on_exist: :skip, # %i[skip write compare]
+                     on_action: :queue # %i[queue execute]
+                    )
+               .blueprint(
+                 active: true,
+                 name: :build_commands,
+                 description: 'Build Commandlets',
+                 on_exist: :write
+               ) do
+      cd(:lib)
+
+      # builder
+      #   .add_file('FUNCTIONS.md',
+      #             template_file: 'FUNCTIONS.md',
+      #             categories: categories.sort_by { |r| r.name },
+      #             functions: functions.sort_by { |r| [r.category, r.name] },
+      #             on_exist: :write)
+
+      add('all_commands.rb',
+          template_file: 'all_commands.rb',
+          commands: commands.sort_by { |r| [r.category, r.name] },
+          on_exist: :write)
+
+      cmdlets.each do |cmdlet|
+        add("#{cmdlet.category}/#{cmdlet.name}.rb",
+            cmdlet: cmdlet,
+            template_file: 'command.rb',
+            on_exist: :write)
+      end
+    end
+
+    director.play_actions
+    # director.builder.logit
+  end
+end
+
+KManager.opts.app_name                    = 'commands'
+KManager.opts.sleep                       = 2
+KManager.opts.reboot_on_kill              = 0
+KManager.opts.reboot_sleep                = 4
+KManager.opts.exception_style             = :short
+KManager.opts.show.time_taken             = true
+KManager.opts.show.finished               = true
+KManager.opts.show.finished_message       = 'FINISHED :)'

data/.builders/generators/cmdlets/array.rb

@@ -0,0 +1,109 @@
+# frozen_string_literal: true
+
+KManager.action :array_commands do
+  action do
+    CmdletDirector
+      .init(k_builder, category: :array)
+      .cmdlet do
+        name :join
+        description           'join an array of values with separator as a string'
+        result                'new String formed by joining the array elements with seperator'
+
+        parameter             :values, 'array of values to join', param_type: 'String|Int'
+        parameter             :separator, 'separator between values, defaults to comma', default: "','"
+
+        ruby <<-RUBY
+          return false if values.nil? || values.length == 0
+          values = values.reject(&:blank?)
+          return '' if values.length.zero?
+
+          values.join(separator)
+        RUBY
+      end
+      .cmdlet do
+        name :join_pre
+        description           'join an array of values with separator as a string and using the separator at the beginning of string'
+
+        parameter             :values, 'array of values to join', param_type: 'String|Int'
+        parameter             :separator, 'separator between values, defaults to comma', default: "','"
+
+        ruby <<-'RUBY'
+          return '' if values.nil? || !values.is_a?(::Array)
+          values = values.reject(&:blank?)
+          return '' if values.length.zero?
+
+          "#{separator}#{values.join(separator)}"
+        RUBY
+      end
+      .cmdlet do
+        name :join_pre
+        description           'join an array of values with separator as a string and using the separator at the beginning of string'
+
+        parameter             :values, 'array of values to join', param_type: 'String|Int'
+        parameter             :separator, 'separator between values, defaults to comma', default: "','"
+
+        ruby <<-'RUBY'
+          return '' if values.nil? || !values.is_a?(::Array)
+          values = values.reject(&:blank?)
+          return '' if values.length.zero?
+
+          "#{separator}#{values.join(separator)}"
+        RUBY
+      end
+      .cmdlet do
+        name :join_post
+        description           'join an array of values with separator as a string and using the separator at the end of string'
+
+        parameter             :values, 'array of values to join', param_type: 'String|Int'
+        parameter             :separator, 'separator between values, defaults to comma', default: "','"
+
+        ruby <<-'RUBY'
+            return '' if values.nil? || !values.is_a?(::Array)
+            values = values.reject(&:blank?)
+            return '' if values.length.zero?
+
+            "#{values.join(separator)}#{separator}"
+        RUBY
+      end
+      .generate
+      .debug
+  end
+end
+
+# result                "return block when every value is truthy"
+
+# parameter('values', 'list of values (via *splat) to be checked via AND condition', splat: true)
+
+# example <<-TEXT
+#   {{#if (and p1 p2 p3 p4 p5)}}
+#     found
+#   {{/if}}
+# TEXT
+
+# example <<-TEXT
+#   {{#if (and name age)}}
+#     {{name}}-{{age}}
+#   {{else}}
+#     no name or age
+#   {{/if}}
+# TEXT
+
+# builder
+#   .add_file('FUNCTIONS.md',
+#             template_file: 'FUNCTIONS.md',
+#             categories: categories.sort_by { |r| r.name },
+#             functions: functions.sort_by { |r| [r.category, r.name] },
+#             on_exist: :write)
+
+# add('all_commands.rb',
+#     template_file: 'all_commands.rb',
+#     commands: commands.sort_by { |r| [r.category, r.name] },
+#     on_exist: :write)
+
+# cmdlets.each do |cmdlet|
+
+#   add("#{cmdlet.category}/#{cmdlet.name}.rb",
+#                     cmdlet: cmdlet,
+#                     template_file: 'command.rb',
+#                     on_exist: :write)
+# end

data/.builders/generators/cmdlets/comparison.rb

@@ -0,0 +1,164 @@
+# frozen_string_literal: true
+
+KManager.action :comparison_commands do
+  action do
+    CmdletDirector
+      .init(k_builder, category: :comparison)
+      .cmdlet do
+        name :and
+        description           'Return true if **all of** the given values are truthy.'
+        result                'return true when every value is truthy'
+
+        parameter             :values, 'list of values (via *splat) to be checked via AND condition', splat: '*', param_type: 'Object'
+
+        ruby <<-RUBY
+          values.all? { |value| value }
+        RUBY
+      end
+      .cmdlet do
+        name :default
+        description           'Return true if **all of** the given values are truthy.'
+        result                'return true when every value is truthy'
+
+        parameter             :values, 'one or more paramaters that may or may not contain nil', splat: '*', param_type: 'Object'
+
+        ruby <<-RUBY
+          default_value = values[-1]
+
+          find_value = values[0..-2].find { |value| !value.nil? }
+
+          find_value || default_value
+        RUBY
+
+      end
+      .cmdlet do
+        name :eq
+        description           'Return true if two values are equal'
+        result                'return truthy value if left hand side equals right hand side'
+
+        parameter             :lhs, 'lhs - left hand side value', param_type: 'Object'
+        parameter             :rhs, 'rhs - right hand side value', param_type: 'Object'
+
+        ruby <<-RUBY
+          lhs = lhs.to_s if lhs.is_a?(Symbol)
+          rhs = rhs.to_s if rhs.is_a?(Symbol)
+
+          lhs == rhs
+        RUBY
+      end
+      .cmdlet do
+        name :gt
+        description           'Return true if left hand side GREATER THAN right hand side'
+        result                'truthy value if left hand side GREATER THAN right hand side'
+
+        parameter             :lhs, 'lhs - left hand side value', param_type: 'Object'
+        parameter             :rhs, 'rhs - right hand side value', param_type: 'Object'
+
+        ruby <<-RUBY
+          lhs > rhs
+        RUBY
+      end
+      .cmdlet do
+        name :gte
+        description           'Return true if left hand side GREATER THAN or EQUAL TO right hand side'
+        result                'truthy value if left hand side GREATER THAN or EQUAL TO  right hand side'
+
+        parameter             :lhs, 'lhs - left hand side value', param_type: 'Object'
+        parameter             :rhs, 'rhs - right hand side value', param_type: 'Object'
+
+        ruby <<-RUBY
+          lhs >= rhs
+        RUBY
+      end
+      .cmdlet do
+        name :lt
+        description           'Return true if left hand side LESS THAN right hand side'
+        result                'truthy value if left hand side LESS THAN right hand side'
+
+        parameter             :lhs, 'lhs - left hand side value', param_type: 'Object'
+        parameter             :rhs, 'rhs - right hand side value', param_type: 'Object'
+
+        ruby <<-RUBY
+          lhs < rhs
+        RUBY
+      end
+      .cmdlet do
+        name :lte
+        description           'Return true if left hand side LESS THAN or EQUAL TO right hand side'
+        result                'truthy value if left hand side LESS THAN or EQUAL TO  right hand side'
+
+        parameter             :lhs, 'lhs - left hand side value', param_type: 'Object'
+        parameter             :rhs, 'rhs - right hand side value', param_type: 'Object'
+
+        ruby <<-RUBY
+          lhs <= rhs
+        RUBY
+      end
+      .cmdlet do
+        name :ne
+        description           'Return true if left hand side is NOT equal to right hand side'
+        result                'truthy value if left hand side is NOT equal to right hand side'
+
+        parameter             :lhs, 'lhs - left hand side value', param_type: 'Object'
+        parameter             :rhs, 'rhs - right hand side value', param_type: 'Object'
+
+        ruby <<-RUBY
+          lhs = lhs.to_s if lhs.is_a?(Symbol)
+          rhs = rhs.to_s if rhs.is_a?(Symbol)
+
+          lhs != rhs
+        RUBY
+      end
+      .cmdlet do
+        name :or
+        description           'Return true if any value is truthy.'
+        result                'return true when first value is truthy'
+
+        parameter             :values, 'list of values (via *splat) to be checked via AND condition', splat: '*', param_type: 'Object'
+
+        ruby <<-RUBY
+          values.any? { |value| value }
+        RUBY
+      end
+    .generate
+    .debug
+  end
+end
+
+# result                "return block when every value is truthy"
+
+# parameter('values', 'list of values (via *splat) to be checked via AND condition', splat: true)
+
+# example <<-TEXT
+#   {{#if (and p1 p2 p3 p4 p5)}}
+#     found
+#   {{/if}}
+# TEXT
+
+# example <<-TEXT
+#   {{#if (and name age)}}
+#     {{name}}-{{age}}
+#   {{else}}
+#     no name or age
+#   {{/if}}
+# TEXT
+
+# builder
+#   .add_file('FUNCTIONS.md',
+#             template_file: 'FUNCTIONS.md',
+#             categories: categories.sort_by { |r| r.name },
+#             functions: functions.sort_by { |r| [r.category, r.name] },
+#             on_exist: :write)
+
+# add('all_commands.rb',
+#     template_file: 'all_commands.rb',
+#     commands: commands.sort_by { |r| [r.category, r.name] },
+#     on_exist: :write)
+
+# cmdlets.each do |cmdlet|
+
+#   add("#{cmdlet.category}/#{cmdlet.name}.rb",
+#                     cmdlet: cmdlet,
+#                     template_file: 'command.rb',
+#                     on_exist: :write)
+# end

data/CHANGELOG.md

@@ -1,3 +1,39 @@
+## [0.1.1](https://github.com/klueless-io/cmdlet/compare/v0.1.0...v0.1.1) (2022-07-10)
+
+
+### Bug Fixes
+
+* add specs ([80f384f](https://github.com/klueless-io/cmdlet/commit/80f384f9f7cd1c1ea67396bb12d3119c433ea139))
+
+# [0.1.0](https://github.com/klueless-io/cmdlet/compare/v0.0.7...v0.1.0) (2022-07-09)
+
+
+### Features
+
+* generate commandlets ([a61948e](https://github.com/klueless-io/cmdlet/commit/a61948e285d488d3aab68a9ef3bd0c136b87170f))
+
+## [0.0.7](https://github.com/klueless-io/cmdlet/compare/v0.0.6...v0.0.7) (2022-07-09)
+
+
+### Bug Fixes
+
+* add category director ([3b72b72](https://github.com/klueless-io/cmdlet/commit/3b72b72d9f739c9a3711f14a640bb6d527e17140))
+* add category director ([cea0f1a](https://github.com/klueless-io/cmdlet/commit/cea0f1ae37bfbb67d634f18cf1d315a80c1f6082))
+
+## [0.0.6](https://github.com/klueless-io/cmdlet/compare/v0.0.5...v0.0.6) (2022-07-08)
+
+
+### Bug Fixes
+
+* add tests for configuration ([59a764f](https://github.com/klueless-io/cmdlet/commit/59a764f99f84dbe1c5b1022e8fdc2386fcced92a))
+
+## [0.0.5](https://github.com/klueless-io/cmdlet/compare/v0.0.4...v0.0.5) (2022-07-08)
+
+
+### Bug Fixes
+
+* add string tokenizer ([9d996ff](https://github.com/klueless-io/cmdlet/commit/9d996ff97545617b894d2f29c4500dc44df492b7))
+
 ## [0.0.4](https://github.com/klueless-io/cmdlet/compare/v0.0.3...v0.0.4) (2022-07-08)
 
 

data/Guardfile

@@ -19,7 +19,7 @@ group :green_pass_then_cop, halt_on_fail: true do
     # Ruby files
     ruby = dsl.ruby
     dsl.watch_spec_files_for(ruby.lib_files)
-    watch(%r{^lib//(.+)\.rb$}) { |m| "spec/unit/#{m[1]}_spec.rb" }
+    watch(%r{^lib//(.+)\.rb$}) { |m| "spec/**/#{m[1]}_spec.rb" }
     watch(%r{^lib//commands/(.+)\.rb$}) { |m| "spec/unit/commands/#{m[1]}_spec.rb" }
   end
 

data/lib/cmdlet/_.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require_relative 'array/join'
+require_relative 'array/join_post'
+require_relative 'array/join_pre'
+require_relative 'comparison/and'
+require_relative 'comparison/default'
+require_relative 'comparison/eq'
+require_relative 'comparison/gt'
+require_relative 'comparison/gte'
+require_relative 'comparison/lt'
+require_relative 'comparison/lte'
+require_relative 'comparison/ne'
+require_relative 'comparison/or'

data/lib/cmdlet/all_commands.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require 'cmdlet/array/join'