k_director 0.2.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d0c8985292cf5c11bd7bd5e7887be4c29bf72e13095a4c7f1b7195595188a39a
-  data.tar.gz: aa90b26840c62e1c8e60edc0b4aeda07b62a76fa106de2618eb2571a48791680
+  metadata.gz: '0208f9ecd1fa6a0a1a649266a9a6a823e7db688c632e9f79681c9386d6a4a3fb'
+  data.tar.gz: '08140ee775462704f34ade6c236000ed615e877007b9fc1d48dc748de222c72b'
 SHA512:
-  metadata.gz: '0458d1254d8ca4e459d3aa2a6bf23de2b3437d8df7cf0ded66376f6618f5f55f3ae4016506cde7381a81c095140200835950161b47041e6aaa6d086197547aaf'
-  data.tar.gz: 5f8d84e42051822825f82310c3a6ac1afb6fb87beeb10acb68137583b351fa6c92fe7d09356bbc4f03df4c0922cce9a9dd0a5ac4747174ca1f33d4a7c853b9e4
+  metadata.gz: 49321aaf3a58a70ea34e0668cfe89e91ff069bffa2301cd90b51ab64a446b41d69dc2501f2d3cea469d47f8af31f57965840b664f55bad79e14321bbcefd436e
+  data.tar.gz: 04d83e5f3b8d1f8d89ea07eba68b393836a13d8e0876069d38017d1001fe5bd02f1e68803e208f3e020d783eabd5a3280fa673e5784f5ca7f5816f4eb795369e

data/.builders/_.rb

@@ -1,4 +1,3 @@
-require_relative './dsl/builders/dom_builder'
 require_relative './dsl/builders/actions_builder'
 require_relative './dsl/directors/base_director'
 require_relative './dsl/directors/child_director'

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

@@ -6,7 +6,9 @@ KManager.action :bootstrap do
       .init(k_builder,
         template_base_folder:       'ruby/gem',
         on_exist:                   :skip,                      # %i[skip write compare]
-        on_action:                  :queue,                     # %i[queue execute]
+        on_action:                  :queue                      # %i[queue execute]
+      )
+      .dom(:settings,
         ruby_version:               '2.7',
         repo_name:                  application_name,
         application:                application_name,
@@ -25,6 +27,9 @@ KManager.action :bootstrap do
       .github do
         parent.options.repo_info = repo_info
 
+        self.repo
+        self.name
+
         # create_repository # (:k_director)
         # delete_repository # (:k_director)
         # list_repositories

data/README.md

@@ -1,3 +1,11 @@
+# Agenda
+
+- GitHub Copilot (Ruby)
+  - Writing specs
+  - DSL
+- SemVer (conventionl commits)
+- GitHub Copilot (GoLang) - Build a Game
+
 # K Director
 
 > KDirector provides domain specific language implementations for code generation

data/docs/CHANGELOG.md

@@ -1,3 +1,36 @@
+## [0.4.1](https://github.com/klueless-io/k_director/compare/v0.4.0...v0.4.1) (2022-01-30)
+
+
+### Bug Fixes
+
+* refactor dom builder with set/add supporting key hierarchies ([8fee48d](https://github.com/klueless-io/k_director/commit/8fee48d12dfb37210ed87d0fb22222bd2db3da28))
+
+# [0.4.0](https://github.com/klueless-io/k_director/compare/v0.3.0...v0.4.0) (2022-01-29)
+
+
+### Bug Fixes
+
+* run rubocop ([e8805aa](https://github.com/klueless-io/k_director/commit/e8805aaddfde04ba1def563d3f7e5e311fa2841a))
+
+
+### Features
+
+* add GitHub DSL ([e8de7d5](https://github.com/klueless-io/k_director/commit/e8de7d599af16be9dced907617d534f029e1e1ad))
+
+# [0.3.0](https://github.com/klueless-io/k_director/compare/v0.2.0...v0.3.0) (2022-01-29)
+
+
+### Features
+
+* add Blueprint DSL ([c27ec12](https://github.com/klueless-io/k_director/commit/c27ec124b8c55b84f2dfd67f37de6ab2c4fb8d22))
+
+# [0.2.0](https://github.com/klueless-io/k_director/compare/v0.1.2...v0.2.0) (2022-01-27)
+
+
+### Features
+
+* add BaseDirector and ChildDirector ([d32265a](https://github.com/klueless-io/k_director/commit/d32265a1e46811bde6bdfbef4b8c9dc8602a8f88))
+
 ## [0.1.2](https://github.com/klueless-io/k_director/compare/v0.1.1...v0.1.2) (2022-01-26)
 
 
@@ -10,4 +43,4 @@
 
 ### Feature
 
-* add dom and action builder ([a61e841](https://github.com/klueless-io/k_director/commit/a61e841a40f544f4751e4aaa012d60a447d2dfab))
+* add dom and action builder ([a61e841](https://github.com/klueless-io/k_director/commit/a61e841a40f544f4751e4aaa012d60a447d2dfab))

data/lib/k_director/builders/actions_builder.rb

@@ -2,26 +2,111 @@
 
 module KDirector
   module Builders
-    # Data builder for KBuilder Actions
-    class ActionsBuilder < KDirector::Builders::DomBuilder
+    # Actions document builder
+    class ActionsBuilder
+      attr_reader :actions
+      attr_reader :dom
+      attr_reader :last_action
+
       def initialize
-        super(schema)
+        reset
+      end
+
+      def reset
+        @actions = []
+        @dom = {}
+        @last_action = {}
       end
 
       def queue_action(action)
-        dom[:actions] << current_node(action)
+        @actions << action
+        @last_action = action
+      end
+
+      # Set many key/value pairs gainst a group
+      #
+      # example:
+      #   set_many(:github, { repo_name: 'repo-name', organization: 'org-name' })
+      def group_set(group, **opts)
+        opts.each do |key, value|
+          set(group, key, value)
+        end
+      end
+
+      # set key_set/value pair, can be used for
+      #
+      # - simple key/value pairs
+      # - initialize key/array pairs
+      #
+      # example:
+      #   set(:a, 1)
+      #   set(:a, [])
+      #   set(:a, [1, 2, 3])
+      #   set(:a, some_value, default_value: 'use if not supplied')
+      #   set(:a, :b, 'nested value')
+      #   set(:a, :b, :c, 'deeply nested value')
+      #   set(:a, :b, :c, :d, :e, :f, 'depth is no barrier')
+      def set(*keyset_value, default_value: nil)
+        size = keyset_value.size
+
+        raise ArgumentError, 'set requires 2 or more arguments' if size < 2
+
+        target = initialize_hierarchy(keyset_value)
+
+        set_kv(target, keyset_value[size - 2], keyset_value[size - 1], default_value: default_value)
+      end
+
+      # add value to array
+      #   set(:a, [])
+      #   add(:a, 1])
+      #   add(:a, 2])
+      #   add(:a, 3])
+      def add(*keyset_value, default_value: nil)
+        size = keyset_value.size
+
+        raise ArgumentError, 'add requires 2 or more arguments' if size < 2
+
+        target = initialize_hierarchy(keyset_value)
+
+        add_kv(target, keyset_value[size - 2], keyset_value[size - 1], default_value: default_value)
+      end
+
+      def debug
+        puts JSON.pretty_generate(actions)
+        # puts JSON.pretty_generate(dom)
+        # log.structure(dom)
+
+        self
       end
 
-      def actions
-        dom[:actions]
+      def build
+        # hook into the set, add and queue_action methods form memoization
+        KUtil.data.to_open_struct(@dom)
       end
 
       private
 
-      def schema
-        {
-          actions: []
-        }
+      def initialize_hierarchy(keys_value)
+        target = @dom
+
+        return target unless keys_value.size > 2
+
+        keys_value.slice(0..-3).each_with_index do |key, _index|
+          target[key] = {} unless target.key?(key)
+          target = target[key]
+        end
+        target
+      end
+
+      def set_kv(target, key, value, default_value: nil)
+        set_value = value.nil? ? default_value : value
+        target[key] = set_value
+      end
+
+      def add_kv(target, key, value, default_value: nil)
+        add_value = value.nil? ? default_value : value
+        target[key] = [] unless target.key?(key)
+        target[key] << add_value
       end
     end
   end

data/lib/k_director/directors/base_director.rb

@@ -22,7 +22,6 @@ module KDirector
       attr_reader :builder
       attr_reader :k_builder
       attr_reader :options
-      attr_accessor :dom
 
       def initialize(k_builder, builder, **opts)
         @k_builder  = k_builder
@@ -35,6 +34,10 @@ module KDirector
         @options.on_action            ||= :queue      # %i[queue execute]
       end
 
+      def dom
+        builder.dom
+      end
+
       # Used by child directors to inherit options from parent
       def inherited_opts(**opts)
         {
@@ -48,6 +51,10 @@ module KDirector
         @options.director_name
       end
 
+      def director_name=(name)
+        @options.director_name = name
+      end
+
       def template_base_folder
         @options.template_base_folder
       end
@@ -66,8 +73,7 @@ module KDirector
           on_exist: on_exist
         }.merge(opts)
 
-        # WHAT IS THIS FOR?
-        opts[:dom] = dom if dom
+        opts[:dom] = dom.except(:actions) if dom
 
         handle_action(k_builder.add_file_action(file, **opts))
 

data/lib/k_director/directors/data.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module KDirector
+  module Dsls
+    module Children
+      # Blueprint DSL is used to add files to the target folder.
+      #
+      # A blueprint is a recipe that you can follow to build out assets on the target application
+      class Blueprint < KDirector::Directors::ChildDirector
+        # Add a single file into the code base
+        #
+        # @param [String] output_filename The output file name, this can be a relative path
+        # @param [Hash] **opts The options
+        # @option opts [String] :template_filename Template filename can be set or it will default to the same value as the output file name
+        # @option opts [String] :template_subfolder Template subfolder
+        def add(output_file, **opts)
+          template_file = opts[:template_file] || output_file
+          template_parts = [template_base_folder, opts[:template_subfolder], template_file].reject(&:blank?)
+          template_path = File.join(*template_parts)
+
+          # maybe template_file should be renamed to template_path in k_builder
+          opts[:template_file] = template_path
+
+          add_file(output_file, **opts)
+        end
+
+        def oadd(name, **opts)
+          add(name, **{ open: true          }.merge(opts))
+        end
+
+        def tadd(name, **opts)
+          add(name, **{ open_template: true }.merge(opts))
+        end
+
+        def fadd(name, **opts)
+          add(name, **{ on_exist: :write    }.merge(opts))
+        end
+
+        # def template_content(template_file, **opts)
+        #   template_parts = [template_base_folder, opts[:template_subfolder], template_file].reject(&:blank?)
+        #   template_file = File.join(*template_parts)
+
+        #   file = k_builder.find_template_file(template_file)
+        #   File.read(file)
+        # end
+
+        def run_template_script(template_file, **opts)
+          template_parts = [template_base_folder, opts[:template_subfolder], template_file].reject(&:blank?)
+          template_path = File.join(*template_parts)
+
+          script = k_builder.process_any_content(template_file: template_path, **opts)
+
+          run_script(script)
+        end
+      end
+    end
+  end
+end

data/lib/k_director/dsls/children/blueprint.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module KDirector
+  module Dsls
+    module Children
+      # Blueprint DSL is used to add files to the target folder.
+      #
+      # A blueprint is a recipe that you can follow to build out assets on the target application
+      class Blueprint < KDirector::Directors::ChildDirector
+        # Add a single file into the code base
+        #
+        # @param [String] output_filename The output file name, this can be a relative path
+        # @param [Hash] **opts The options
+        # @option opts [String] :template_filename Template filename can be set or it will default to the same value as the output file name
+        # @option opts [String] :template_subfolder Template subfolder
+        def add(output_file, **opts)
+          template_file = opts[:template_file] || output_file
+          template_parts = [template_base_folder, opts[:template_subfolder], template_file].reject(&:blank?)
+          template_path = File.join(*template_parts)
+
+          # maybe template_file should be renamed to template_path in k_builder
+          opts[:template_file] = template_path
+
+          add_file(output_file, **opts)
+        end
+
+        def oadd(name, **opts)
+          add(name, **{ open: true          }.merge(opts))
+        end
+
+        def tadd(name, **opts)
+          add(name, **{ open_template: true }.merge(opts))
+        end
+
+        def fadd(name, **opts)
+          add(name, **{ on_exist: :write    }.merge(opts))
+        end
+
+        # def template_content(template_file, **opts)
+        #   template_parts = [template_base_folder, opts[:template_subfolder], template_file].reject(&:blank?)
+        #   template_file = File.join(*template_parts)
+
+        #   file = k_builder.find_template_file(template_file)
+        #   File.read(file)
+        # end
+
+        def run_template_script(template_file, **opts)
+          template_parts = [template_base_folder, opts[:template_subfolder], template_file].reject(&:blank?)
+          template_path = File.join(*template_parts)
+
+          script = k_builder.process_any_content(template_file: template_path, **opts)
+
+          run_script(script)
+        end
+      end
+    end
+  end
+end

data/lib/k_director/dsls/children/github.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+# klueless-io
+# k_director
+# kluless-sites
+
+module KDirector
+  module Dsls
+    module Children
+      # Github DSL provides useful GitHub actions such as (create, delete, list, open repository).
+      class Github < KDirector::Directors::ChildDirector
+        def initialize(parent, **opts)
+          super(parent, **opts)
+
+          @options.repo_name          ||= parent.options.repo_name
+          @options.repo_organization  ||= parent.options.repo_organization
+        end
+
+        def repo
+          return parent.options.repo if defined? parent.options.repo
+
+          parent.options.repo = OpenStruct.new(name: nil, organization: nil)
+        end
+
+        def name
+          repo.repo_name
+        end
+
+        def organization
+          repo.repo_organization
+        end
+      end
+    end
+  end
+end

data/lib/k_director/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module KDirector
-  VERSION = '0.2.0'
+  VERSION = '0.5.0'
 end

data/lib/k_director.rb

@@ -5,10 +5,11 @@ require 'k_util'
 require 'k_builder'
 
 require_relative 'k_director/version'
-require_relative 'k_director/builders/dom_builder'
 require_relative 'k_director/builders/actions_builder'
 require_relative 'k_director/directors/base_director'
 require_relative 'k_director/directors/child_director'
+require_relative 'k_director/dsls/children/blueprint'
+require_relative 'k_director/dsls/children/github'
 
 module KDirector
   # raise KDirector::Error, 'Sample message'

data/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "k_director",
-  "version": "0.2.0",
+  "version": "0.5.0",
   "lockfileVersion": 2,
   "requires": true,
   "packages": {
     "": {
       "name": "k_director",
-      "version": "0.2.0",
+      "version": "0.5.0",
       "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": "k_director",
-  "version": "0.2.0",
+  "version": "0.5.0",
   "description": "Command line and CI/CD tools for k_director",
   "scripts": {
     "release": "semantic-release"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: k_director
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.5.0
 platform: ruby
 authors:
 - David Cruwys
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2022-01-27 00:00:00.000000000 Z
+date: 2022-01-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: k_log
@@ -62,10 +62,6 @@ extra_rdoc_files: []
 files:
 - ".builders/_.rb"
 - ".builders/boot.rb"
-- ".builders/dsl/builders/actions_builder.rb"
-- ".builders/dsl/builders/dom_builder.rb"
-- ".builders/dsl/directors/base_director.rb"
-- ".builders/dsl/directors/child_director.rb"
 - ".builders/dsl/github_dsl.rb"
 - ".builders/dsl/ruby_gem_dsl.rb"
 - ".builders/generators/01-bootstrap.rb"
@@ -90,9 +86,11 @@ files:
 - k_director.gemspec
 - lib/k_director.rb
 - lib/k_director/builders/actions_builder.rb
-- lib/k_director/builders/dom_builder.rb
 - lib/k_director/directors/base_director.rb
 - lib/k_director/directors/child_director.rb
+- lib/k_director/directors/data.rb
+- lib/k_director/dsls/children/blueprint.rb
+- lib/k_director/dsls/children/github.rb
 - lib/k_director/version.rb
 - package-lock.json
 - package.json

data/.builders/dsl/builders/actions_builder.rb

@@ -1,27 +0,0 @@
-# frozen_string_literal: true
-
-module Dsl
-  module Builders
-    class ActionsBuilder < Dsl::Builders::DomBuilder
-      def initialize
-        super(schema)
-      end
-
-      def queue_action(action)
-        dom[:actions] << current_node(action)
-      end
-
-      def actions
-        dom[:actions]
-      end
-
-      private
-
-      def schema
-        { 
-          actions: []
-        }
-      end
-    end
-  end
-end

data/.builders/dsl/builders/dom_builder.rb

@@ -1,40 +0,0 @@
-# frozen_string_literal: true
-
-module Dsl
-  module Builders
-    class DomBuilder
-      attr_reader :dom
-      attr_reader :node
-
-      def initialize(dom = nil)
-        @dom = dom || schema
-      end
-
-      def current_node(node)
-        @node = node
-      end
-
-      alias last_node node
-
-      def reset
-        @dom = schema
-        @last_node = nil
-      end
-
-      def schema
-        {}
-      end
-
-      def logit
-        puts JSON.pretty_generate(dom)
-        # log.structure(dom)
-
-        self
-      end
-
-      def data
-        KUtil.data.to_open_struct(@dom)
-      end
-    end
-  end
-end

data/.builders/dsl/directors/base_director.rb

@@ -1,131 +0,0 @@
-# frozen_string_literal: true
-
-module Dsl
-  module Directors
-    class BaseDirector
-      include KLog::Logging
-
-      class << self
-        def init(k_builder, builder = nil, **opts)
-          if builder.nil?
-            builder = Dsl::Builders::ActionsBuilder.new
-          else
-            builder.reset
-          end
-
-          new(k_builder, builder, **opts)
-        end
-      end
-
-      attr_reader :builder
-      attr_reader :k_builder
-      attr_reader :options
-      attr_accessor :dom
-    
-      def initialize(k_builder, builder, **opts)
-        @k_builder  = k_builder
-        @builder    = builder
-        @options    = OpenStruct.new(**opts)
-
-        @options.director_name        ||= default_director_name
-        @options.template_base_folder ||= default_template_base_folder
-        @options.on_exist             ||= :skip       # %i[skip write compare]
-        @options.on_action            ||= :queue      # %i[queue execute]
-      end
-
-      def director_name
-        @options.director_name
-      end
-
-      def template_base_folder
-        @options.template_base_folder
-      end
-
-      def on_exist
-        @options.on_exist
-      end
-
-      def on_action
-        @options.on_action
-      end
-
-      def add_file(file, **opts)
-        opts = {
-          on_exist: on_exist
-        }.merge(opts)
-
-        opts[:dom] = dom if dom
-
-        handle_action(k_builder.add_file_action(file, **opts))
-
-        self
-      end
-
-      def set_current_folder_action(folder_key)
-        # RUN (not handle)
-        run_action(k_builder.set_current_folder_action(folder_key))
-
-        self
-      end
-      alias cd set_current_folder_action
-
-      def run_command(command)
-        handle_action(k_builder.run_command_action(command))
-
-        self
-      end
-
-      def run_script(script)
-        handle_action(k_builder.run_script_action(script))
-
-        self
-      end
-
-      def play_actions
-        k_builder.play_actions(builder.actions)
-      end
-
-      def debug
-        log.section_heading director_name
-
-        h = options.to_h.sort.to_h
-        h.keys.each do |key|
-          log.kv(titleize.parse(key.to_s), h[key])
-        end
-        nil
-      end
-
-      # def debug_info
-      #   log.kv 'Template Root Folder'   , k_builder.template_folders.folder_paths
-      #   log.kv 'Template Base Folder'   , template_base_folder
-      #   log.kv 'on_exist'               , on_exist
-      #   log.kv 'on_action'              , on_action
-      # end
-
-      private
-
-      def default_template_base_folder
-        ''
-      end
-
-      def default_director_name
-        titleize.parse(self.class.name.split("::").last)
-      end
-
-      def folder_parts(*parts)
-        parts.reject(&:blank?).map(&:to_s)
-      end
-
-      def handle_action(action)
-        builder.queue_action(action)
-        k_builder.play_action(action) if on_action == :execute
-      end
-
-      # run action will queue an action just like handle_action, but it will also run it immediately
-      def run_action(action)
-        builder.queue_action(action)
-        k_builder.run_action(action)
-      end
-    end
-  end
-end

data/.builders/dsl/directors/child_director.rb

@@ -1,27 +0,0 @@
-# frozen_string_literal: true
-
-module Dsl
-  module Directors
-    class ChildDirector < Dsl::Directors::BaseDirector
-      attr_reader :parent
-
-      def initialize(parent, **opts)
-        @parent = parent
-
-        opts = {
-          on_exist: parent.on_exist,
-          on_action: parent.on_action,
-          template_base_folder: parent.template_base_folder
-        }.merge(opts)
-
-        super(parent.k_builder, parent.builder, **opts)
-      end
-
-      def debug
-        parent.debug
-
-        super
-      end
-    end
-  end
-end

data/lib/k_director/builders/dom_builder.rb

@@ -1,41 +0,0 @@
-# frozen_string_literal: true
-
-module KDirector
-  module Builders
-    # Base document builder
-    class DomBuilder
-      attr_reader :dom
-      attr_reader :node
-
-      def initialize(dom = nil)
-        @dom = dom || schema
-      end
-
-      def current_node(node)
-        @node = node
-      end
-
-      alias last_node node
-
-      def reset
-        @dom = schema
-        @last_node = nil
-      end
-
-      def schema
-        {}
-      end
-
-      def logit
-        puts JSON.pretty_generate(dom)
-        # log.structure(dom)
-
-        self
-      end
-
-      def data
-        KUtil.data.to_open_struct(@dom)
-      end
-    end
-  end
-end