cmdlet 0.0.7 → 0.1.2

data/lib/cmdlet/array/join_post.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Cmdlet
+  # Array handling routines, eg. join, join_prefix, join_post
+  module Array
+    # JoinPost: join an array of values with separator as a string and using the separator at the end of string
+    class JoinPost < Cmdlet::BaseCmdlet
+      #
+      # @param [String|Int] values - array of values to join
+      # @param [String] separator - separator between values, defaults to comma
+      # @return [String]
+      def call(values, separator = ',')
+        return '' if values.nil? || !values.is_a?(::Array)
+
+        values = values.reject(&:blank?)
+        return '' if values.length.zero?
+
+        "#{values.join(separator)}#{separator}"
+      end
+    end
+  end
+end

data/lib/cmdlet/array/join_pre.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Cmdlet
+  # Array handling routines, eg. join, join_prefix, join_post
+  module Array
+    # JoinPre: join an array of values with separator as a string and using the separator at the beginning of string
+    class JoinPre < Cmdlet::BaseCmdlet
+      #
+      # @param [String|Int] values - array of values to join
+      # @param [String] separator - separator between values, defaults to comma
+      # @return [String]
+      def call(values, separator = ',')
+        return '' if values.nil? || !values.is_a?(::Array)
+
+        values = values.reject(&:blank?)
+        return '' if values.length.zero?
+
+        "#{separator}#{values.join(separator)}"
+      end
+    end
+  end
+end

data/lib/cmdlet/base_cmdlet.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Cmdlet
+  # base cmdlet provides an interface for cmdlets
+  class BaseCmdlet
+    def call(value)
+      value
+    end
+
+    # String tokenizer will clean up a string so that
+    # all sorts of case formatted strings can be
+    # represented in a consistent fashion
+    def tokenizer
+      @_tokenizer ||= Funcky.configuration.tokenizer
+    end
+  end
+end

data/lib/cmdlet/comparison/and.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Cmdlet
+  # Comparison helpers, eg. or, and, equal, not equal, less than, greater than etc.
+  module Comparison
+    # And: Return true if **all of** the given values are truthy.
+    class And < Cmdlet::BaseCmdlet
+      #
+      # @param [Object] values - list of values (via *splat) to be checked via AND condition
+      # @return [String] return true when every value is truthy
+      def call(*values)
+        values.all? { |value| value }
+      end
+    end
+  end
+end

data/lib/cmdlet/comparison/default.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Cmdlet
+  # Comparison helpers, eg. or, and, equal, not equal, less than, greater than etc.
+  module Comparison
+    # Default: Return true if **all of** the given values are truthy.
+    class Default < Cmdlet::BaseCmdlet
+      #
+      # @param [Object] values - one or more paramaters that may or may not contain nil
+      # @return [String] return true when every value is truthy
+      def call(*values)
+        default_value = values[-1]
+
+        find_value = values[0..-2].find { |value| !value.nil? }
+
+        find_value || default_value
+      end
+    end
+  end
+end

data/lib/cmdlet/comparison/eq.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Cmdlet
+  # Comparison helpers, eg. or, and, equal, not equal, less than, greater than etc.
+  module Comparison
+    # Eq: Return true if two values are equal
+    class Eq < Cmdlet::BaseCmdlet
+      #
+      # @param [Object] lhs - lhs - left hand side value
+      # @param [Object] rhs - rhs - right hand side value
+      # @return [String] return truthy value if left hand side equals right hand side
+      def call(lhs, rhs)
+        lhs = lhs.to_s if lhs.is_a?(Symbol)
+        rhs = rhs.to_s if rhs.is_a?(Symbol)
+
+        lhs == rhs
+      end
+    end
+  end
+end

data/lib/cmdlet/comparison/gt.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Cmdlet
+  # Comparison helpers, eg. or, and, equal, not equal, less than, greater than etc.
+  module Comparison
+    # Gt: Return true if left hand side GREATER THAN right hand side
+    class Gt < Cmdlet::BaseCmdlet
+      #
+      # @param [Object] lhs - lhs - left hand side value
+      # @param [Object] rhs - rhs - right hand side value
+      # @return [String] truthy value if left hand side GREATER THAN right hand side
+      def call(lhs, rhs)
+        lhs > rhs
+      end
+    end
+  end
+end

data/lib/cmdlet/comparison/gte.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Cmdlet
+  # Comparison helpers, eg. or, and, equal, not equal, less than, greater than etc.
+  module Comparison
+    # Gte: Return true if left hand side GREATER THAN or EQUAL TO right hand side
+    class Gte < Cmdlet::BaseCmdlet
+      #
+      # @param [Object] lhs - lhs - left hand side value
+      # @param [Object] rhs - rhs - right hand side value
+      # @return [String] truthy value if left hand side GREATER THAN or EQUAL TO  right hand side
+      def call(lhs, rhs)
+        lhs >= rhs
+      end
+    end
+  end
+end

data/lib/cmdlet/comparison/lt.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Cmdlet
+  # Comparison helpers, eg. or, and, equal, not equal, less than, greater than etc.
+  module Comparison
+    # Lt: Return true if left hand side LESS THAN right hand side
+    class Lt < Cmdlet::BaseCmdlet
+      #
+      # @param [Object] lhs - lhs - left hand side value
+      # @param [Object] rhs - rhs - right hand side value
+      # @return [String] truthy value if left hand side LESS THAN right hand side
+      def call(lhs, rhs)
+        lhs < rhs
+      end
+    end
+  end
+end

data/lib/cmdlet/comparison/lte.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Cmdlet
+  # Comparison helpers, eg. or, and, equal, not equal, less than, greater than etc.
+  module Comparison
+    # Lte: Return true if left hand side LESS THAN or EQUAL TO right hand side
+    class Lte < Cmdlet::BaseCmdlet
+      #
+      # @param [Object] lhs - lhs - left hand side value
+      # @param [Object] rhs - rhs - right hand side value
+      # @return [String] truthy value if left hand side LESS THAN or EQUAL TO  right hand side
+      def call(lhs, rhs)
+        lhs <= rhs
+      end
+    end
+  end
+end

data/lib/cmdlet/comparison/ne.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Cmdlet
+  # Comparison helpers, eg. or, and, equal, not equal, less than, greater than etc.
+  module Comparison
+    # Ne: Return true if left hand side is NOT equal to right hand side
+    class Ne < Cmdlet::BaseCmdlet
+      #
+      # @param [Object] lhs - lhs - left hand side value
+      # @param [Object] rhs - rhs - right hand side value
+      # @return [String] truthy value if left hand side is NOT equal to right hand side
+      def call(lhs, rhs)
+        lhs = lhs.to_s if lhs.is_a?(Symbol)
+        rhs = rhs.to_s if rhs.is_a?(Symbol)
+
+        lhs != rhs
+      end
+    end
+  end
+end

data/lib/cmdlet/comparison/or.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Cmdlet
+  # Comparison helpers, eg. or, and, equal, not equal, less than, greater than etc.
+  module Comparison
+    # Or: Return true if any value is truthy.
+    class Or < Cmdlet::BaseCmdlet
+      #
+      # @param [Object] values - list of values (via *splat) to be checked via AND condition
+      # @return [String] return true when first value is truthy
+      def call(*values)
+        values.any? { |value| value }
+      end
+    end
+  end
+end

data/lib/cmdlet/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Cmdlet
-  VERSION = '0.0.7'
+  VERSION = '0.1.2'
 end

data/lib/cmdlet.rb

@@ -4,8 +4,11 @@
 require 'k_config'
 require_relative 'cmdlet/version'
 require_relative 'cmdlet/configuration'
+require_relative 'cmdlet/base_cmdlet'
 require_relative 'cmdlet/string_tokenizer'
 
+require_relative 'cmdlet/_'
+
 module Cmdlet
   # raise Cmdlet::Error, 'Sample message'
   Error = Class.new(StandardError)

data/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "cmdlet",
-  "version": "0.0.7",
+  "version": "0.1.2",
   "lockfileVersion": 2,
   "requires": true,
   "packages": {
     "": {
       "name": "cmdlet",
-      "version": "0.0.7",
+      "version": "0.1.2",
       "devDependencies": {
         "@klueless-js/semantic-release-rubygem": "github:klueless-js/semantic-release-rubygem",
         "@semantic-release/changelog": "^6.0.1",

data/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cmdlet",
-  "version": "0.0.7",
+  "version": "0.1.2",
   "description": "Cmdlet provides a set of functions (wrapped in the command pattern) that perform simple actions",
   "scripts": {
     "release": "semantic-release"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cmdlet
 version: !ruby/object:Gem::Version
-  version: 0.0.7
+  version: 0.1.2
 platform: ruby
 authors:
 - David Cruwys
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2022-07-09 00:00:00.000000000 Z
+date: 2022-07-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -47,24 +47,30 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".builders/.templates/FUNCTIONS.MD"
-- ".builders/.templates/all_commands.rb"
-- ".builders/.templates/command.rb"
-- ".builders/.templates/command_spec.rb"
+- ".builders/.templates/cmdlet.rb"
+- ".builders/.templates/cmdlet_spec.rb"
+- ".builders/.templates/require_all_cmdlets.rb"
 - ".builders/_.rb"
 - ".builders/boot.rb"
 - ".builders/data/categories.json"
+- ".builders/data/cmdlets/array.json"
+- ".builders/data/cmdlets/comparison.json"
+- ".builders/director/category_builder.rb"
+- ".builders/director/category_dao.rb"
 - ".builders/director/category_director.rb"
 - ".builders/director/cmdlet_builder.rb"
 - ".builders/director/cmdlet_child.rb"
+- ".builders/director/cmdlet_dao.rb"
 - ".builders/director/cmdlet_director.rb"
-- ".builders/documents/categories.rb"
-- ".builders/documents/cmdlets.rb"
+- ".builders/director/dao.rb"
 - ".builders/documents/commands.rb"
 - ".builders/documents/use_cases.rb"
 - ".builders/documents/x_functions.rb"
 - ".builders/generators/01-bootstrap.rb"
-- ".builders/generators/20-commands.rb"
-- ".builders/generators/25-categories.rb"
+- ".builders/generators/20-categories.rb"
+- ".builders/generators/30-commands-bak.rb"
+- ".builders/generators/cmdlets/array.rb"
+- ".builders/generators/cmdlets/comparison.rb"
 - ".releaserc.json"
 - ".rspec"
 - ".rubocop.yml"
@@ -78,8 +84,21 @@ files:
 - bin/console
 - bin/setup
 - lib/cmdlet.rb
+- lib/cmdlet/_.rb
 - lib/cmdlet/all_commands.rb
 - lib/cmdlet/array/join.rb
+- lib/cmdlet/array/join_post.rb
+- lib/cmdlet/array/join_pre.rb
+- lib/cmdlet/base_cmdlet.rb
+- lib/cmdlet/comparison/and.rb
+- lib/cmdlet/comparison/default.rb
+- lib/cmdlet/comparison/eq.rb
+- lib/cmdlet/comparison/gt.rb
+- lib/cmdlet/comparison/gte.rb
+- lib/cmdlet/comparison/lt.rb
+- lib/cmdlet/comparison/lte.rb
+- lib/cmdlet/comparison/ne.rb
+- lib/cmdlet/comparison/or.rb
 - lib/cmdlet/configuration.rb
 - lib/cmdlet/string_tokenizer.rb
 - lib/cmdlet/version.rb

data/.builders/.templates/all_commands.rb

@@ -1,5 +0,0 @@
-# frozen_string_literal: true
-
-{{#each commands}}
-require 'cmdlet/{{category}}/{{name}}'
-{{/each}}

data/.builders/.templates/command.rb

@@ -1,26 +0,0 @@
-# frozen_string_literal: true
-
-# reference: https://github.com/rails/rails/blob/master/activesupport/lib/active_support/inflector/methods.rb
-
-module Cmdlet
-  # {{cmdlet.category_description}}
-  module {{camel cmdlet.category}}
-    # {{camel cmdlet.name}}: {{cmdlet.command_description}}
-    class {{camel cmdlet.name}} < Funcky::BaseFunction
-      {{#each cmdlet.usecases}}
-      # @example
-      #
-      #   puts {{camel ./function}}.new.parse({{{nice_inputs}}})
-      #
-      #   {{expected_output}}
-      #
-      {{/each}}
-      #
-      # @param [String|Int] value - numeric value
-      # @return [String] ordinal suffix that would be required for a number
-      def parse(value)
-{{{cmdlet.ruby}}}
-      end
-    end
-  end
-end

data/.builders/documents/categories.rb

@@ -1,24 +0,0 @@
-def categories
-  return @categories unless @categories.nil?
-
-  
-  result = KDoc.model :document do
-    table :rows do
-      fields :name, :description
-
-      row :case               , "Tokenize and apply case and/or separator"
-      row :comparison         , "Comparison helpers, eg. or, and, equal, not equal, less than, greater than etc."
-      row :inflection         , "Inflection handling routines, eg. pluralize, singular, ordinalize"
-      row :string             , "String handling helpers"
-
-      row :array            , "Array handling routines, eg. join, join_prefix, join_post"
-      row :a_transform        , "Tokenize and apply case and/or separator"
-      row :a_comparison       , "Comparison helpers, eg. or, and, equal, not equal, less than, greater than etc."
-      row :a_inflection       , "Inflection handling routines, eg. pluralize, singular, ordinalize"
-    end
-  end
-  
-  @categories = result.raw_data_struct.rows
-end
-@categories = nil
-

data/.builders/documents/cmdlets.rb

@@ -1,30 +0,0 @@
-def cmdlets
-  commands.map do |command|
-    category = categories.find { |c| c.name == command.category }
-    
-    log.error("Category '#{command.category}' not found") unless category
-  
-    OpenStruct.new(
-      category: command.category,
-      name: command.name,
-      category_description: category.description,
-      command_description: command.description,
-      ruby: command.ruby,
-      usecases: use_cases
-        .select { |uc| uc.category == command.category && uc.command == command.name }
-        .map { |uc| 
-          OpenStruct.new({
-            category:         uc.category,
-            command:         uc.command,
-            inputs:           uc.inputs,
-            nice_inputs:      nice_inputs(uc.inputs),
-            expected_output:  uc.expected_output 
-          })
-        }
-    )
-  end
-end
-
-def nice_inputs(values)
-  values.map { |value| value.is_a?(String) ? "'#{value}'" : value }.join(', ')
-end

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

@@ -1,54 +0,0 @@
-KManager.action :commands 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/25-categories.rb

@@ -1,20 +0,0 @@
-KManager.action :categories do
-  action do
-
-    CategoryDirector
-      .init(k_builder,
-        on_exist:                   :write,                      # %i[skip write compare]
-        on_action:                  :execute                     # %i[queue execute]
-      )
-      .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(:a_array            , "Array handling routines, eg. join, join_prefix, join_post")
-      .category(:a_transform        , "Tokenize and apply case and/or separator")
-      .category(:a_comparison       , "Comparison helpers, eg. or, and, equal, not equal, less than, greater than etc.")
-      .category(:a_inflection       , "Inflection handling routines, eg. pluralize, singular, ordinalize")
-      .save_categories
-      .category_file
-  end
-end