cmdlet 0.0.7 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 49865609277b82bf27cc7275b38f0830109e2228b8ab3629ca1774d07b85f834
-  data.tar.gz: 7d6c2c92910fc466f8f0d3e04ebb4356dfb070c17e553a3e573c60e946648032
+  metadata.gz: 4aaf22abcff261a22b71b4c4adeaf77dd8d629836936eabb1b20b2d8a61b3a28
+  data.tar.gz: 4d249fee0dd48b4774881e16bcc92b303f788e45b22c54c14a321a70468bcabf
 SHA512:
-  metadata.gz: d7bd4e1e6364146d104a96bd66425df76f3bd164b350f1b3328f046cc8c8e2b6f2d65eec9dacd18c7ce510e064846f10b0ba2a49315089f6ff0235e494b34387
-  data.tar.gz: e0ddc16a51d5c16957ac2241098de2f1a7a0de777f59621d8398da8e61172ae07c9ea796971e48ce024a646eee0c6b29cd1fe93fde4c6840c0d41b497c63da14
+  metadata.gz: ab39c705f59887093ecbf3a8ad2ec66f133bf14048f544b142b3de324fdb25006dfa19bb66efdf5e281d0167bac8b4bd2958769cff3ad8879515f833f24fa5d5
+  data.tar.gz: e78c0098b63350dfcc77bb7c6c50d902b8da963a9fc8531639a5c6835df4fdae3158b8518f2efd2f87a2fda9dfd9fb3a573f774159c04fad451dca50da09ac43

data/.builders/.templates/cmdlet.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Cmdlet
+  # {{cmdlet.category_description}}
+  module {{camel cmdlet.category}}
+    # {{camel cmdlet.name}}: {{cmdlet.description}}
+    class {{camel cmdlet.name}} < Cmdlet::BaseCmdlet
+      {{#each cmdlet.usecases}}
+      # @example
+      #
+      #   puts {{camel ./function}}.new.call({{{nice_inputs}}})
+      #
+      #   {{expected_output}}
+      #
+      {{/each}}
+      #
+      {{#each cmdlet.parameters}}
+      # @param [{{./param_type}}] {{./name}} - {{./description}}
+      {{/each}}
+      # @return [String] {{cmdlet.result}}
+      def call({{#each cmdlet.parameters}}{{#if ./splat}}{{./splat}}{{/if}}{{./name}}{{#if ./default}} = {{{./default}}}{{/if}}{{#if @last}}{{^}}, {{/if}}{{/each}})
+{{{cmdlet.ruby}}}
+      end
+    end
+  end
+end

data/.builders/.templates/{command_spec.rb → cmdlet_spec.rb}

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
-# {{camel command.name}}: {{command.function_description}}
-RSpec.describe Funcky::{{camel command.category}}::{{camel command.name}} do
+# {{camel cmdlet.name}}: {{cmdlet.description}}
+RSpec.describe Cmdlet::{{camel cmdlet.category}}::{{camel cmdlet.name}} do
   let(:instance) { described_class.new }
   
   describe 'initialize' do
@@ -10,8 +10,8 @@ RSpec.describe Funcky::{{camel command.category}}::{{camel command.name}} do
     it { is_expected.not_to be_nil }
   end
 
-  describe '#parse' do
-    subject { instance.parse(value) }
+  describe '#call' do
+    subject { instance.call(value) }
 
     let(:value) { nil }
 

data/.builders/.templates/require_all_cmdlets.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+{{#each cmdlets}}
+require_relative '{{category}}/{{name}}'
+{{/each}}

data/.builders/_.rb

@@ -1,4 +1,10 @@
-# require_relative './documents/_'
+# frozen_string_literal: true
+
+require_relative './director/category_dao'
+require_relative './director/cmdlet_dao'
+require_relative './director/dao'
+
+require_relative './director/category_builder'
 require_relative './director/category_director'
 require_relative './director/cmdlet_builder'
 require_relative './director/cmdlet_director'

data/.builders/boot.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Boot Sequence
 
 include KLog::Logging

data/.builders/data/categories.json

@@ -17,20 +17,12 @@
       "description": "String handling helpers"
     },
     {
-      "name": "a_array",
+      "name": "array",
       "description": "Array handling routines, eg. join, join_prefix, join_post"
     },
     {
-      "name": "a_transform",
+      "name": "transform",
       "description": "Tokenize and apply case and/or separator"
-    },
-    {
-      "name": "a_comparison",
-      "description": "Comparison helpers, eg. or, and, equal, not equal, less than, greater than etc."
-    },
-    {
-      "name": "a_inflection",
-      "description": "Inflection handling routines, eg. pluralize, singular, ordinalize"
     }
   ]
 }

data/.builders/data/cmdlets/array.json

@@ -0,0 +1,121 @@
+{
+  "category_key": "array",
+  "cmdlets": [
+    {
+      "name": "join",
+      "description": "join an array of values with separator as a string",
+      "result": "new String formed by joining the array elements with seperator",
+      "category": "array",
+      "category_description": "Array handling routines, eg. join, join_prefix, join_post",
+      "base_class_require": null,
+      "base_class": null,
+      "parameters": [
+        {
+          "name": "values",
+          "description": "array of values to join",
+          "splat": null,
+          "default": null,
+          "param_type": "String|Int"
+        },
+        {
+          "name": "separator",
+          "description": "separator between values, defaults to comma",
+          "splat": null,
+          "default": "','",
+          "param_type": "String"
+        }
+      ],
+      "examples": [
+
+      ],
+      "ruby": "          return false if values.nil? || values.length == 0\n          values = values.reject(&:blank?)\n          return '' if values.length.zero?\n\n          values.join(separator)\n"
+    },
+    {
+      "name": "join_pre",
+      "description": "join an array of values with separator as a string and using the separator at the beginning of string",
+      "result": null,
+      "category": "array",
+      "category_description": "Array handling routines, eg. join, join_prefix, join_post",
+      "base_class_require": null,
+      "base_class": null,
+      "parameters": [
+        {
+          "name": "values",
+          "description": "array of values to join",
+          "splat": null,
+          "default": null,
+          "param_type": "String|Int"
+        },
+        {
+          "name": "separator",
+          "description": "separator between values, defaults to comma",
+          "splat": null,
+          "default": "','",
+          "param_type": "String"
+        }
+      ],
+      "examples": [
+
+      ],
+      "ruby": "          return '' if values.nil? || !values.is_a?(::Array)\n          values = values.reject(&:blank?)\n          return '' if values.length.zero?\n\n          \"#{separator}#{values.join(separator)}\"\n"
+    },
+    {
+      "name": "join_pre",
+      "description": "join an array of values with separator as a string and using the separator at the beginning of string",
+      "result": null,
+      "category": "array",
+      "category_description": "Array handling routines, eg. join, join_prefix, join_post",
+      "base_class_require": null,
+      "base_class": null,
+      "parameters": [
+        {
+          "name": "values",
+          "description": "array of values to join",
+          "splat": null,
+          "default": null,
+          "param_type": "String|Int"
+        },
+        {
+          "name": "separator",
+          "description": "separator between values, defaults to comma",
+          "splat": null,
+          "default": "','",
+          "param_type": "String"
+        }
+      ],
+      "examples": [
+
+      ],
+      "ruby": "          return '' if values.nil? || !values.is_a?(::Array)\n          values = values.reject(&:blank?)\n          return '' if values.length.zero?\n\n          \"#{separator}#{values.join(separator)}\"\n"
+    },
+    {
+      "name": "join_post",
+      "description": "join an array of values with separator as a string and using the separator at the end of string",
+      "result": null,
+      "category": "array",
+      "category_description": "Array handling routines, eg. join, join_prefix, join_post",
+      "base_class_require": null,
+      "base_class": null,
+      "parameters": [
+        {
+          "name": "values",
+          "description": "array of values to join",
+          "splat": null,
+          "default": null,
+          "param_type": "String|Int"
+        },
+        {
+          "name": "separator",
+          "description": "separator between values, defaults to comma",
+          "splat": null,
+          "default": "','",
+          "param_type": "String"
+        }
+      ],
+      "examples": [
+
+      ],
+      "ruby": "            return '' if values.nil? || !values.is_a?(::Array)\n            values = values.reject(&:blank?)\n            return '' if values.length.zero?\n\n            \"#{values.join(separator)}#{separator}\"\n"
+    }
+  ]
+}

data/.builders/data/cmdlets/comparison.json

@@ -0,0 +1,245 @@
+{
+  "category_key": "comparison",
+  "cmdlets": [
+    {
+      "name": "and",
+      "description": "Return true if **all of** the given values are truthy.",
+      "result": "return true when every value is truthy",
+      "category": "comparison",
+      "category_description": "Comparison helpers, eg. or, and, equal, not equal, less than, greater than etc.",
+      "base_class_require": null,
+      "base_class": null,
+      "parameters": [
+        {
+          "name": "values",
+          "description": "list of values (via *splat) to be checked via AND condition",
+          "splat": "*",
+          "default": null,
+          "param_type": "Object"
+        }
+      ],
+      "examples": [
+
+      ],
+      "ruby": "          values.all? { |value| value }\n"
+    },
+    {
+      "name": "default",
+      "description": "Return true if **all of** the given values are truthy.",
+      "result": "return true when every value is truthy",
+      "category": "comparison",
+      "category_description": "Comparison helpers, eg. or, and, equal, not equal, less than, greater than etc.",
+      "base_class_require": null,
+      "base_class": null,
+      "parameters": [
+        {
+          "name": "values",
+          "description": "one or more paramaters that may or may not contain nil",
+          "splat": "*",
+          "default": null,
+          "param_type": "Object"
+        }
+      ],
+      "examples": [
+
+      ],
+      "ruby": "          default_value = values[-1]\n\n          find_value = values[0..-2].find { |value| !value.nil? }\n\n          find_value || default_value\n"
+    },
+    {
+      "name": "eq",
+      "description": "Return true if two values are equal",
+      "result": "return truthy value if left hand side equals right hand side",
+      "category": "comparison",
+      "category_description": "Comparison helpers, eg. or, and, equal, not equal, less than, greater than etc.",
+      "base_class_require": null,
+      "base_class": null,
+      "parameters": [
+        {
+          "name": "lhs",
+          "description": "lhs - left hand side value",
+          "splat": null,
+          "default": null,
+          "param_type": "Object"
+        },
+        {
+          "name": "rhs",
+          "description": "rhs - right hand side value",
+          "splat": null,
+          "default": null,
+          "param_type": "Object"
+        }
+      ],
+      "examples": [
+
+      ],
+      "ruby": "          lhs = lhs.to_s if lhs.is_a?(Symbol)\n          rhs = rhs.to_s if rhs.is_a?(Symbol)\n\n          lhs == rhs\n"
+    },
+    {
+      "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",
+      "category": "comparison",
+      "category_description": "Comparison helpers, eg. or, and, equal, not equal, less than, greater than etc.",
+      "base_class_require": null,
+      "base_class": null,
+      "parameters": [
+        {
+          "name": "lhs",
+          "description": "lhs - left hand side value",
+          "splat": null,
+          "default": null,
+          "param_type": "Object"
+        },
+        {
+          "name": "rhs",
+          "description": "rhs - right hand side value",
+          "splat": null,
+          "default": null,
+          "param_type": "Object"
+        }
+      ],
+      "examples": [
+
+      ],
+      "ruby": "          lhs > rhs\n"
+    },
+    {
+      "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",
+      "category": "comparison",
+      "category_description": "Comparison helpers, eg. or, and, equal, not equal, less than, greater than etc.",
+      "base_class_require": null,
+      "base_class": null,
+      "parameters": [
+        {
+          "name": "lhs",
+          "description": "lhs - left hand side value",
+          "splat": null,
+          "default": null,
+          "param_type": "Object"
+        },
+        {
+          "name": "rhs",
+          "description": "rhs - right hand side value",
+          "splat": null,
+          "default": null,
+          "param_type": "Object"
+        }
+      ],
+      "examples": [
+
+      ],
+      "ruby": "          lhs >= rhs\n"
+    },
+    {
+      "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",
+      "category": "comparison",
+      "category_description": "Comparison helpers, eg. or, and, equal, not equal, less than, greater than etc.",
+      "base_class_require": null,
+      "base_class": null,
+      "parameters": [
+        {
+          "name": "lhs",
+          "description": "lhs - left hand side value",
+          "splat": null,
+          "default": null,
+          "param_type": "Object"
+        },
+        {
+          "name": "rhs",
+          "description": "rhs - right hand side value",
+          "splat": null,
+          "default": null,
+          "param_type": "Object"
+        }
+      ],
+      "examples": [
+
+      ],
+      "ruby": "          lhs < rhs\n"
+    },
+    {
+      "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",
+      "category": "comparison",
+      "category_description": "Comparison helpers, eg. or, and, equal, not equal, less than, greater than etc.",
+      "base_class_require": null,
+      "base_class": null,
+      "parameters": [
+        {
+          "name": "lhs",
+          "description": "lhs - left hand side value",
+          "splat": null,
+          "default": null,
+          "param_type": "Object"
+        },
+        {
+          "name": "rhs",
+          "description": "rhs - right hand side value",
+          "splat": null,
+          "default": null,
+          "param_type": "Object"
+        }
+      ],
+      "examples": [
+
+      ],
+      "ruby": "          lhs <= rhs\n"
+    },
+    {
+      "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",
+      "category": "comparison",
+      "category_description": "Comparison helpers, eg. or, and, equal, not equal, less than, greater than etc.",
+      "base_class_require": null,
+      "base_class": null,
+      "parameters": [
+        {
+          "name": "lhs",
+          "description": "lhs - left hand side value",
+          "splat": null,
+          "default": null,
+          "param_type": "Object"
+        },
+        {
+          "name": "rhs",
+          "description": "rhs - right hand side value",
+          "splat": null,
+          "default": null,
+          "param_type": "Object"
+        }
+      ],
+      "examples": [
+
+      ],
+      "ruby": "          lhs = lhs.to_s if lhs.is_a?(Symbol)\n          rhs = rhs.to_s if rhs.is_a?(Symbol)\n\n          lhs != rhs\n"
+    },
+    {
+      "name": "or",
+      "description": "Return true if any value is truthy.",
+      "result": "return true when first value is truthy",
+      "category": "comparison",
+      "category_description": "Comparison helpers, eg. or, and, equal, not equal, less than, greater than etc.",
+      "base_class_require": null,
+      "base_class": null,
+      "parameters": [
+        {
+          "name": "values",
+          "description": "list of values (via *splat) to be checked via AND condition",
+          "splat": "*",
+          "default": null,
+          "param_type": "Object"
+        }
+      ],
+      "examples": [
+
+      ],
+      "ruby": "          values.any? { |value| value }\n"
+    }
+  ]
+}

data/.builders/director/category_builder.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+class CategoryBuilder < KDirector::Builders::ActionsBuilder
+  def category(name, description)
+    value = {
+      name: name,
+      description: description
+    }
+
+    add(:categories, value: value)
+
+    self
+  end
+
+  def save_categories(**opts)
+    k_builder
+      .cd(:builder_data)
+      .add('categories.json', content: to_json, **opts)
+
+    self
+  end
+
+  def osave_categories(**opts)
+    save_categories(**{ open: true }.merge(opts))
+  end
+end

data/.builders/director/category_dao.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+class CategoryDao
+  attr_reader :k_builder
+  attr_reader :load_time
+  attr_reader :data
+
+  def initialize(k_builder)
+    @k_builder = k_builder
+    @load_time = nil
+    @data = nil
+  end
+
+  def file_name
+    k_builder.target_folders.join(:builder_data, 'categories.json')
+  end
+
+  def reload?
+    @load_time.nil? || @load_time < File.mtime(file_name)
+  end
+
+  def find_category(name)
+    result = categories.find { |category| category[:name] == name.to_s }
+
+    raise "Category #{name} not found" if result.nil?
+
+    result
+  end
+
+  def categories
+    if reload?
+      @data = JSON.parse(File.read(file_name), symbolize_names: true)
+      @categories = data[:categories]
+      @load_time = File.mtime(file_name)
+    end
+    @categories
+  end
+end

data/.builders/director/category_director.rb

@@ -1,25 +1,39 @@
 # frozen_string_literal: true
 
 class CategoryDirector < KDirector::Directors::BaseDirector
-  def category(name, description)
-    value = {
-      name: name,
-      description: description
-    }
+  defaults(builder_type: CategoryBuilder, on_exist: :write, on_action: :execute)
 
-    builder.add(:categories, value: value)
+  def category(name, description)
+    builder.category(name, description)
 
     self
   end
 
-  def category_file
-    k_builder.target_folders.join(:builder_data, 'categories.json')
+  def generate
+    generate_require_all_cmdlets
+
+    self
   end
 
-  def save_categories
+  def save_categories(**opts)
     cd(:builder_data)
-    add('categories.json', content: builder.to_json)
+    add('categories.json', content: builder.to_json, **opts)
 
     self
   end
+
+  def osave_categories(**opts)
+    save_categories(**{ open: true }.merge(opts))
+  end
+
+  private
+
+  def generate_require_all_cmdlets
+    cd(:lib)
+    add('_.rb',
+      template_file: 'require_all_cmdlets.rb',
+      cmdlets: data_access.cmdlet.all_cmdlets)
+
+  end
+  
 end