k_doc 0.0.16 → 0.0.22

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 64615008b76feb26a84e9dd808654495cf3f26bf42f6941b00eaca9013081a76
-  data.tar.gz: e69ccfb764c6dd9df4ee1fe78df56f717726f733184839020d3df968c34fde63
+  metadata.gz: 2dcd9625fafb133dca240894911cad20bf220718f4d12b9d73240d2079f4294f
+  data.tar.gz: 592c2661f4b9a8cd905325b60d6488110029245e89f3dfdd7c1f0eb518205afd
 SHA512:
-  metadata.gz: 94d4cd31dddad2f142fa418c24025c866124722e8f93ee3133d1d7c68893640954c7203e5bd5a502eb75f9650c444d7103945af6fa901ece63450a0537b130d3
-  data.tar.gz: f1a6e045702b3e9c94146ae413f573fc281472eaf5927e9b27a819445cff112b2a688863c7f0bf2d2d4e996e703dd3f4f7721c7766ecd621feb4971b24cfddba
+  metadata.gz: 303a6524573902efd1e7488d080ed1affe6aa23abd4eac80371d7aaceac7289c06fc4ab8dea4b9c817e3a896fce6538ded912684929586487fa043ca9f14cae2
+  data.tar.gz: 996f72379212f095f6786897287282a6add950ca83c5c554da61434556b919b258e1f5777d88116f57bbe756c247c9c09f19ca9b9536edb77c678786a5d16f50

data/.builders/directors/_.rb

@@ -0,0 +1,10 @@
+require_relative './build_actions'
+require_relative './director'
+# require_relative './gem_director'
+require_relative './klue_director'
+require_relative './design_pattern_director'
+
+def klue
+  @klue ||= KlueDirector.new
+end
+

data/.builders/directors/build_actions.rb

@@ -0,0 +1,39 @@
+module BuildActions
+  def cd(folder_key)
+    @builder.cd(folder_key)
+
+    self
+  end
+
+  def add_file(file, **opts)
+    @builder.add_file(file, **opts)
+
+    self
+  end
+
+  def delete_file(file, **opts)
+    @builder.delete_file(file, **opts)
+
+    self
+  end
+
+  def add_clipboard(**opts)
+    @builder.add_clipboard(**opts)
+
+    self
+  end
+
+  def open
+    builder.open
+
+    self
+  end
+  alias o open
+
+  def open_template
+    builder.open_template
+
+    self
+  end
+  alias ot open_template
+end

data/.builders/directors/design_pattern_director.rb

@@ -0,0 +1,39 @@
+class DesignPatternDirector < Director
+  include BuildActions
+
+  def del(file, *_params, **opts)
+    delete_file(file, **opts)
+
+    self
+  end
+  alias dadd del
+
+  def add(output_file, template_file = nil, **opts)
+    template_file = output_file if template_file.nil?
+      
+    opts = {
+      template_file: template_file,
+      on_exist: :write
+    }.merge(opts)
+
+    add_file(output_file, **opts)
+    puts output_file
+
+    self
+  end
+
+  # This pattern would be great as a configurable generic class
+  #
+  # children could be renamed as:
+  # - directors
+  # - components
+  # - elements
+  def composite(name:, relative_path:, **opts)
+    opts = { name: name }.merge(opts)
+    cd(:lib)
+    add(File.join(relative_path, "#{name}.rb"), "composite/composite.rb", **opts)
+    cd(:spec)
+    add(File.join(relative_path, "#{name}_spec.rb"), "composite/composite_spec.rb", **opts)
+    self
+  end
+end

data/.builders/directors/director.rb

@@ -0,0 +1,185 @@
+class Director
+  include KType::Composite
+  # Should this be on the base class, or setup as needed on child directors?
+
+  attr_reader :builder
+
+  # Maybe Deprecate
+  attr_reader :director_types
+
+  def initialize(parent = nil, **opts)
+    attach_parent(parent)
+
+    reset_settings
+    process_options(opts)
+  end
+
+  def init(opts)
+    reset_settings
+    process_options(opts)
+    
+    self
+  rescue => ex
+    log.exception(ex)
+  end
+
+  def reset
+    reset_settings
+
+    self
+  rescue => ex
+    log.exception(ex)
+  end
+
+  def register(name, klass)
+    register_director(name, klass)
+
+    self
+  rescue => ex
+    log.exception(ex)
+  end
+
+  def back
+    navigate_parent
+  end
+
+  def with(director, &block)
+    change_director = director(director)
+    change_director.instance_eval(&block)
+    navigate_parent
+  end
+
+  def help(*topics) #**opts)
+    if topics.blank?
+      help_actions
+      return
+    end
+
+    help_actions          if topics.include?(:all)
+    help_channels         if topics.include?(:channels)
+  rescue => ex
+    log.exception(ex)
+  end
+
+  def director(name)
+    @director ||= Hash.new do |add_to_hash, key|
+      raise "Director not registered: #{key}" unless has_child?(key)
+      director = get_child(key)
+      add_to_hash[key] = director.klass.new(self).init(builder_config_name: key)
+    end
+    @director[name]
+  rescue => ex
+    log.exception(ex)
+  end
+
+  def guard(message)
+    log.error(message)
+
+    self
+  end
+  
+
+  # def director(type, name)
+  #   Setup.config(type).debug
+  # end
+
+  def debug
+    # puts 'debug'
+    # puts children
+    # puts director_types
+    if builder
+      builder.debug
+    else
+      log.error "No builder"
+    end
+
+    director_types.keys.each do |key|
+      log.section_heading(key)
+      log.structure director_types[key]
+    end
+    
+    self
+  end
+
+  private
+
+  # Composite Pattern Custom Implementation - BEGIN
+
+  def has_child?(key)
+    @children.key?(key)
+  end
+
+  def get_child(key)
+    @children[key]
+  end
+
+  def add_child(key, child)
+    @children[key] = child
+  end
+
+  def reset_children
+    @children = {}
+  end
+
+  # Composite Pattern Custom Implementation - END
+
+  def register_director(name, klass)
+    if has_child?(name)
+      log.error "Director has already been registered: #{name}"
+      return
+    end
+
+    add_director(name, klass)
+  rescue => ex
+    log.exception(ex)
+  end
+
+  def add_director(name, klass)
+    director = OpenStruct.new(name: name, klass: klass)
+
+    # Adding a director should create a new method for accessing that director
+    add_child(name, director)
+  rescue => ex
+    log.exception(ex)
+  end
+
+  # HELP
+
+  def help_actions
+    log.warn 'Help about actions available from this class'
+  end
+
+  def help_channels
+    log.warn 'Help about channels'
+    debug
+  end
+
+  def reset_settings
+    @builder = nil
+    reset_children
+    @director_types = {}
+  end
+
+  def process_options(opts)
+    attach_builder(opts)
+  rescue => ex
+    log.exception(ex)
+  end
+
+  # If builder is provided then use it
+  # If builder configuration is provided
+  # If builder config_name is provided
+
+  def attach_builder(opts)
+    return if @builder
+
+    log.warning("options :builder and :builder_config_name are mutually exclusive, will use opts[:builder]") if opts[:builder] && opts[:builder_config_name]
+
+    # Use the provided builder
+    @builder = opts[:builder] if opts[:builder]
+
+    return if @builder
+
+    @builder = KBuilder::BaseBuilder.init(KBuilder.configuration(opts[:builder_config_name]))
+  end
+end

data/.builders/directors/klue_director.rb

@@ -0,0 +1,5 @@
+class KlueDirector < Director
+  def design_patterns
+    director(:design_patterns)
+  end
+end

data/.builders/initializers/_.rb

@@ -0,0 +1,7 @@
+require 'k_log'
+require 'k_util'
+
+include KLog::Logging
+
+require_relative './configure_builder'
+require_relative './handlebars_helpers'

data/.builders/initializers/configure_builder.rb

@@ -0,0 +1,38 @@
+KBuilder.reset(:gem)
+KBuilder.configure(:gem) do |config|
+  # config.template_folders.add(:global     , '~/dev/kgems/k_templates/definitions/genesis')
+  config.target_folders.add(:root         , File.expand_path('..', Dir.getwd))
+  config.target_folders.add(:lib          , :root, 'lib', 'k_doc')
+  config.target_folders.add(:spec         , :root, 'spec', 'k_doc')
+end
+
+KBuilder.reset(:design_patterns)
+KBuilder.configure(:design_patterns) do |config|
+  config.template_folders.add(:global     , '~/dev/kgems/k_templates/templates/ruby_design_patterns')
+  config.target_folders.add(:root         , File.expand_path('..', Dir.getwd))
+  config.target_folders.add(:lib          , :root, 'lib', 'k_doc')
+  config.target_folders.add(:spec         , :root, 'spec', 'k_doc')
+end
+
+# KBuilder.configuration(:gem).debug
+
+# def builder
+#   @builder ||= KBuilder::BaseBuilder.init
+# end
+
+puts ':)'
+
+# Setup.configure(:microapp) do |config|
+#   config.template_folders.add(:microapp   , '~/dev/kgems/k_templates/definitions/microapp')
+#   config.target_folders.add(:root         , Dir.getwd)
+# end
+
+# Setup.configure(:data) do |config|
+#   # config.template_folders.add(:microapp   , '~/dev/kgems/k_templates/definitions/microapp')
+#   config.target_folders.add(:root         , File.expand_path('..', Dir.getwd), '.data')
+# end
+
+# Setup.configure(:actual_app) do |config|
+#   # config.template_folders.add(:microapp   , '~/dev/kgems/k_templates/definitions/microapp')
+#   config.target_folders.add(:root         , File.expand_path('..', Dir.getwd))
+# end

data/.builders/initializers/handlebars_helpers.rb

@@ -0,0 +1,27 @@
+Handlebars::Helpers.configure do |config|
+  config_file = File.join(Gem.loaded_specs['handlebars-helpers'].full_gem_path, '.handlebars_helpers.json')
+  config.helper_config_file = config_file
+
+  string_config_file = File.join(Gem.loaded_specs['handlebars-helpers'].full_gem_path, '.handlebars_string_formatters.json')
+  config.string_formatter_config_file = string_config_file
+end
+
+def camel
+  require 'handlebars/helpers/string_formatting/camel'
+  Handlebars::Helpers::StringFormatting::Camel.new
+end
+
+def titleize
+  require 'handlebars/helpers/string_formatting/titleize'
+  Handlebars::Helpers::StringFormatting::Titleize.new
+end
+
+def pluralize
+  require 'handlebars/helpers/inflection/pluralize'
+  Handlebars::Helpers::Inflection::Pluralize.new
+end
+
+def singularize
+  require 'handlebars/helpers/inflection/singularize'
+  Handlebars::Helpers::Inflection::Singularize.new
+end

data/.builders/setup.rb

@@ -0,0 +1,18 @@
+require 'initializers/_'
+require 'directors/_'
+
+klue
+  .reset
+  .register(:design_patterns           , DesignPatternDirector)
+
+klue
+  .with(:design_patterns) do
+    composite(
+      relative_path: 'mixins',
+      name: :composite_spec,
+      namespace: 'KDoc',
+      children_name: :child,
+      children_name_plural: :children)
+  end
+
+puts '...'

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/k_doc/(.+)\.rb$}) { |m| "spec/unit/#{m[1]}_spec.rb" }
+    watch(%r{^lib/k_doc/**/(.+)\.rb$}) { |m| "spec/unit/#{m[1]}_spec.rb" }
     watch(%r{^lib/k_doc/commands/(.+)\.rb$}) { |m| "spec/unit/commands/#{m[1]}_spec.rb" }
   end
 

data/k_doc.gemspec

@@ -44,4 +44,7 @@ Gem::Specification.new do |spec|
   spec.add_dependency 'k_type'                , '~> 0.0.0'
   spec.add_dependency 'k_util'                , '~> 0.0.0'
   # spec.add_dependency 'tty-box',         '~> 0.5.0'
+  spec.metadata = {
+    'rubygems_mfa_required' => 'true'
+  }
 end

data/lib/k_doc/container.rb

@@ -1,63 +1,49 @@
 # frozen_string_literal: true
 
 module KDoc
-  # A data acts a base data object for any data requires tagging such as
-  # unique key, type and namespace.
+  # A container acts a base data object for any data that requires tagging
+  # such as unique key, type and namespace.
   class Container
-    # include KLog::Logging
-
-    # Seems like there is way too much data here
-    # Firstly it should probably be in an interface
-    # Secondly some of this (namespace, project_key, error) belongs in k_manager
-    # So container would be better off just being key, type, data
-    attr_reader :key
-
-    # NOTE: This should not be using an opinion in this project
-    attr_reader :type
-
-    # Move this up to k_manager
-    # attr_reader :namespace
-    # attr_reader :project_key
-    attr_reader :error
-
-    # Create container for storing data/documents.
-    #
-    # Any container can be uniquely identified via it's
-    # key, type, namespace and project_key attributes
-    #
-    # @param [Hash] **opts The options
-    # @option opts [String|Symbol] name Name of the container
-    # @option opts [String|Symbol] type Type of the container, defaults to KDoc:: FakeOpinion.new.default_model_type if not set
-    # @option opts [String|Symbol] namespace Namespace that the container belongs to
-    # @option opts [String|Symbol] project_key Project that the container belongs to
-    def initialize(**opts)
-      @key = opts[:key] || SecureRandom.alphanumeric(4)
-      @type = opts[:type] || '' # KDoc.opinion.default_model_type
-      # @namespace = opts[:namespace] || ''
-      # @project_key = opts[:project_key] || ''
-
-      # Old name is default_data, wonder if I still need that idea?
-      # Most documents live within a hash, some tabular documents such as CSV will use an []
-      # @data       = slice_option(:default_data) || {}
-      @data = opts[:data] || {}
+    include KLog::Logging
+    include KDoc::Guarded
+    include KDoc::Taggable
+    include KDoc::Datum
+    include KDoc::BlockProcessor
+
+    attr_reader :opts
+
+    # TODO: Owner/Owned need to be in a module and tested
+    attr_accessor :owner
+
+    def owned?
+      @owner != nil
     end
 
-    # def unique_key
-    #   @unique_key ||= KDoc.util.build_unique_key(key, type, namespace, project_key)
-    # end
+    def initialize(**opts, &block)
+      @opts = opts
+
+      initialize_tag(opts)
+      initialize_data(opts)
+      initialize_block(opts, &block)
+    end
+
+    def default_container_type
+      :container
+    end
+
+    def default_data_type
+      Hash
+    end
 
-    def debug_header
-      log.kv 'key', key
-      log.kv 'type', type
-      # log.kv 'namespace', namespace
-      # log.kv 'project_key', namespace
-      # log.kv 'error', error
+    def debug
+      debug_container
+      debug_errors
     end
 
-    attr_writer :data
+    private
 
-    def data
-      @data.clone
+    def debug_errors
+      log.block(errors, title: 'errors') unless valid?
     end
   end
 end

data/lib/k_doc/csv_doc.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+require 'csv'
+
+module KDoc
+  # CsvDoc is a DSL for modeling CSV data objects
+  class CsvDoc < KDoc::Container
+    attr_reader :file
+
+    # Create CSV document
+    #
+    # @param [String|Symbol] name Name of the document
+    # @param args[0] Type of the document, defaults to KDoc:: FakeOpinion.new.default_csv_type if not set
+    # @param default: Default value (using named params), as above
+    def initialize(key = nil, **opts, &block)
+      super(**{ key: key }.merge(opts))
+
+      initialize_file
+
+      @block = block if block_given?
+    end
+
+    # Load data from file
+    #
+    # @param [Symbol] load_action The load_action to take if data has already been loaded
+    # @param [:once] load_action :once will load the data from content source on first try only
+    # @param [:reload] load_action :reload will reload from content source each time
+    # @param [Symbol] data_action The data_action to take when setting data, defaults to :replace
+    # @param [:replace] data_action :replace will replace the existing data instance with the incoming data value
+    # @param [:append] data_action :append will keep existing data and then new value data over the top
+    def load(load_action: :once, data_action: :replace)
+      return if load_action == :once && loaded?
+
+      rows = []
+
+      CSV.foreach(file, headers: true, header_converters: :symbol) do |row|
+        rows << row.to_h
+      end
+
+      set_data(rows, data_action: data_action)
+
+      @loaded = true
+    end
+
+    def loaded?
+      @loaded
+    end
+
+    private
+
+    def initialize_file
+      @file ||= opts.delete(:file) || ''
+      @loaded = false
+    end
+
+    def default_data_type
+      Array
+    end
+
+    def default_container_type
+      :csv
+    end
+  end
+end

data/lib/k_doc/fake_opinion.rb

@@ -5,8 +5,12 @@ require 'json'
 module KDoc
   # This is called fake opinion because I have not figured out
   # how I want to implement this
+  # Need to look at the configuration patterns, this is really a configuration
   class FakeOpinion
     attr_accessor :default_model_type
+    attr_accessor :default_csv_type
+    attr_accessor :default_json_type
+    attr_accessor :default_yaml_type
     attr_accessor :default_settings_key
     attr_accessor :default_table_key
 
@@ -16,6 +20,9 @@ module KDoc
 
     def initialize
       @default_model_type = :entity
+      @default_csv_type = :csv
+      @default_json_type = :json
+      @default_yaml_type = :yaml
       @default_settings_key = :settings
       @default_table_key = :table
 

data/lib/k_doc/json_doc.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module KDoc
+  # JsonDoc is a DSL for modeling JSON data objects
+  class JsonDoc < KDoc::Container
+    attr_reader :file
+
+    # Create JSON document
+    #
+    # @param [String|Symbol] name Name of the document
+    # @param args[0] Type of the document, defaults to KDoc:: FakeOpinion.new.default_csv_type if not set
+    # @param default: Default value (using named params), as above
+    # @param [Proc] block The block is stored and accessed different types in the document loading workflow.
+    def initialize(key = nil, **opts, &_block)
+      super(**{ key: key }.merge(opts))
+
+      initialize_file
+    end
+
+    # Load data from file
+    #
+    # @param [Symbol] load_action The load_action to take if data has already been loaded
+    # @param [:once] load_action :once will load the data from content source on first try only
+    # @param [:reload] load_action :reload will reload from content source each time
+    # @param [Symbol] data_action The data_action to take when setting data, defaults to :replace
+    # @param [:replace] data_action :replace will replace the existing data instance with the incoming data value
+    # @param [:append] data_action :append will keep existing data and then new value data over the top
+    def load(load_action: :once, data_action: :replace)
+      return if load_action == :once && loaded?
+
+      content = File.read(file)
+      hash = JSON.parse(content)
+
+      set_data(hash, data_action: data_action)
+
+      @loaded = true
+    end
+
+    def loaded?
+      @loaded
+    end
+
+    private
+
+    def initialize_file
+      @file ||= opts.delete(:file) || ''
+      @loaded = false
+    end
+
+    def default_data_type
+      Hash
+    end
+
+    def default_container_type
+      :json
+    end
+  end
+end