k_doc 0.0.22 → 0.0.26

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2dcd9625fafb133dca240894911cad20bf220718f4d12b9d73240d2079f4294f
-  data.tar.gz: 592c2661f4b9a8cd905325b60d6488110029245e89f3dfdd7c1f0eb518205afd
+  metadata.gz: e43e7408a95cf8bf701922e28ef33115d12dd66dd77af00ca1f8b0e492c0952d
+  data.tar.gz: 74506c87934ece30b1e5e37b111fc6ff347ae277b8085aff50a0dce698946b7c
 SHA512:
-  metadata.gz: 303a6524573902efd1e7488d080ed1affe6aa23abd4eac80371d7aaceac7289c06fc4ab8dea4b9c817e3a896fce6538ded912684929586487fa043ca9f14cae2
-  data.tar.gz: 996f72379212f095f6786897287282a6add950ca83c5c554da61434556b919b258e1f5777d88116f57bbe756c247c9c09f19ca9b9536edb77c678786a5d16f50
+  metadata.gz: 92427570dd666fa9d679472fe48dd79771a877209ddd80df4143db1b03cf75ed587af99b1bca3f39e4f039e6ffa4e074c2173f19f8047811a17ca6c7d25cf248
+  data.tar.gz: 553d2c7d0bbf1304b7814e3196b3bf4d90a413c920c2209865918dd3351edabcd6fdad345cb4deb53fb5cb2678b637992caf00a7349218030a37518605071206

data/.builders/directors/director.rb

@@ -180,6 +180,6 @@ class Director
 
     return if @builder
 
-    @builder = KBuilder::BaseBuilder.init(KBuilder.configuration(opts[:builder_config_name]))
+    @builder = KBuilder::BaseBuilder.init(KConfig.configuration(opts[:builder_config_name]))
   end
 end

data/.builders/initializers/configure_builder.rb

@@ -1,5 +1,5 @@
 KBuilder.reset(:gem)
-KBuilder.configure(:gem) do |config|
+KConfig.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')
@@ -7,14 +7,14 @@ KBuilder.configure(:gem) do |config|
 end
 
 KBuilder.reset(:design_patterns)
-KBuilder.configure(:design_patterns) do |config|
+KConfig.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
+# KConfig.configuration(:gem).debug
 
 # def builder
 #   @builder ||= KBuilder::BaseBuilder.init

data/.rubocop.yml

@@ -44,15 +44,20 @@ Layout/LineLength:
 Lint/UnusedMethodArgument:
   AllowUnusedKeywordArguments: true
 
-Style/Documentation:
+Style/AccessorGrouping:
   Enabled: false
-
 Style/BlockComments:
   Enabled: false
   Include:
     - "**/spec/*"
-
-# My Preferences - Start
+Style/Documentation:
+  Enabled: false
+Style/EmptyMethod:    
+  Exclude:
+    - "**/spec/**/*"
+Style/OpenStructUse:
+  Exclude:
+    - "**/spec/**/*"
 Metrics/ClassLength:
   Enabled: false
 Metrics/ModuleLength:
@@ -63,23 +68,14 @@ Naming/MemoizedInstanceVariableName:
 Naming/VariableNumber:
   Exclude:
     - "**/spec/**/*"
-Style/EmptyMethod:    
-  Exclude:
-    - "**/spec/**/*"
 Metrics/ParameterLists:
   Exclude:
     - "**/spec/**/*"
 Layout/EmptyLineBetweenDefs:
   Exclude:
     - "**/spec/**/*"
-
 Lint/AmbiguousBlockAssociation:
   Exclude:
     - "**/spec/**/*"
-
-Style/AccessorGrouping:
-  Enabled: false
-
 Layout/SpaceBeforeComma:
   Enabled: false
-# My Preferences - End

data/README.md

@@ -52,17 +52,6 @@ Checkout the repo
 git clone klueless-io/k_doc
 ```
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests.
-
-You can also run `bin/console` for an interactive prompt that will allow you to experiment.
-
-```bash
-bin/console
-
-Aaa::Bbb::Program.execute()
-# => ""
-```
-
 `k_doc` is setup with Guard, run `guard`, this will watch development file changes and run tests automatically, if successful, it will then run rubocop for style quality.
 
 To release a new version, update the version number in `version.rb`, build the gem and push the `.gem` file to [rubygems.org](https://rubygems.org).

data/lib/k_doc/action.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module KDoc
+  # Action is a DSL for modeling JSON data objects
+  class Action < KDoc::Container
+    attr_reader :file
+
+    # Simple Ruby Action
+    #
+    # @param [String|Symbol] name Name of the document
+    # @param args[0] Type of the document, defaults to KDoc:: FakeOpinion.new.default_action_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))
+    end
+
+    private
+
+    def default_data_type
+      String
+    end
+
+    def default_container_type
+      :action
+    end
+  end
+end

data/lib/k_doc/container.rb

@@ -9,6 +9,7 @@ module KDoc
     include KDoc::Taggable
     include KDoc::Datum
     include KDoc::BlockProcessor
+    include KDoc::Importable
 
     attr_reader :opts
 
@@ -24,6 +25,7 @@ module KDoc
 
       initialize_tag(opts)
       initialize_data(opts)
+      initialize_import(opts) if respond_to?(:initialize_import)
       initialize_block(opts, &block)
     end
 
@@ -32,11 +34,12 @@ module KDoc
     end
 
     def default_data_type
-      Hash
+      @default_data_type ||= Hash
     end
 
     def debug
-      debug_container
+      debug_taggable
+      debug_block_processor
       debug_errors
     end
 

data/lib/k_doc/fake_opinion.rb

@@ -7,6 +7,7 @@ module KDoc
   # how I want to implement this
   # Need to look at the configuration patterns, this is really a configuration
   class FakeOpinion
+    attr_accessor :default_action_type
     attr_accessor :default_model_type
     attr_accessor :default_csv_type
     attr_accessor :default_json_type
@@ -19,7 +20,9 @@ module KDoc
     attr_accessor :table_class
 
     def initialize
-      @default_model_type = :entity
+      # @default_model_type = :entity
+      @default_action_type = :action
+      @default_model_type = :kdoc
       @default_csv_type = :csv
       @default_json_type = :json
       @default_yaml_type = :yaml

data/lib/k_doc/mixins/block_processor.rb

@@ -6,9 +6,19 @@ module KDoc
   # Rename: BlockProcessor
   module BlockProcessor
     attr_accessor :block
+    attr_accessor :block_state
 
     def initialize_block(_opts, &block)
       @block = block if block_given?
+      @block_state = :initial
+    end
+
+    def evaluated?
+      @block_state == :evaluated || @block_state == :actioned
+    end
+
+    def actioned?
+      @block_state == :actioned
     end
 
     def execute_block(run_actions: nil)
@@ -20,6 +30,7 @@ module KDoc
       return if @block.nil?
 
       instance_eval(&@block)
+      @block_state = :evaluated
     rescue StandardError => e
       log.error('Standard error in document')
       # puts "key #{unique_key}"
@@ -32,7 +43,10 @@ module KDoc
     def run_on_action
       return if @block.nil?
 
-      on_action if respond_to?(:on_action)
+      if respond_to?(:on_action)
+        on_action
+        @block_state = :actioned
+      end
     rescue StandardError => e
       log.error('Standard error while running actions')
       # puts "key #{unique_key}"
@@ -41,5 +55,11 @@ module KDoc
       @error = e
       raise
     end
+
+    def debug_block_processor
+      log.kv 'block_state', block_state       , debug_pad_size if respond_to?(:block_state)
+      log.kv 'evaluated'  , evaluated?        , debug_pad_size if respond_to?(:evaluated?)
+      log.kv 'actioned'   , actioned?         , debug_pad_size if respond_to?(:actioned?)
+    end
   end
 end

data/lib/k_doc/mixins/guarded.rb

@@ -7,7 +7,7 @@ module KDoc
   module Guarded
     Guard = Struct.new(:type, :message)
 
-    def guard(message)
+    def guard(message, log: false)
       errors << Guard.new(:guard, message)
     end
 
@@ -24,6 +24,14 @@ module KDoc
       errors.map(&:message)
     end
 
+    def error_hash
+      errors.map(&:to_h)
+    end
+
+    # TODO: Add these predicates
+    # def errors?
+    # def warnings?
+
     def valid?
       errors.length.zero?
     end
@@ -34,5 +42,9 @@ module KDoc
         log.error error.message if error.type == :guard
       end
     end
+
+    def clear_errors
+      errors.clear
+    end
   end
 end

data/lib/k_doc/mixins/importable.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module KDoc
+  # Alow documents to import data from other sources (usually other documents)
+
+  module Importable
+    include KLog::Logging
+
+    attr_reader :importer
+    attr_reader :imports
+
+    # Imports are provided via an options hash, these imports are remove from the hash as they are read
+    #
+    # Any container can import data from an existing container via the import options
+    # rubocop:disable Style/OpenStructUse
+    def initialize_import(opts)
+      # log.error 'initialize_import'
+      @importer = opts.delete(:importer)
+      @imports = OpenStruct.new
+    end
+    # rubocop:enable Style/OpenStructUse
+
+    def call_importer
+      return unless importer
+
+      importer.call(self)
+    end
+
+    # def import(tag)
+    #   KManager.find_document(tag)
+    # end
+
+    # def import_data(tag, as: :document)
+    #   doc = KManager.find_document(tag)
+
+    #   return nil unless doc&.data
+
+    #   # log.error 'about to import'
+    #   doc.debug(include_header: true)
+
+    #   return KUtil.data.to_open_struct(doc.data) if %i[open_struct ostruct].include?(as)
+
+    #   doc.data
+    # end
+
+    protected
+
+    def debug_importable
+      # log.kv 'class type' , self.class.name   , debug_pad_size
+    end
+  end
+end

data/lib/k_doc/mixins/taggable.rb

@@ -44,6 +44,7 @@ module KDoc
       @type ||= @tag_options.delete(:type) || default_container_type
     end
 
+    # TODO: rename to area (or area root namespace)
     # Project name
     #
     # Examples
@@ -66,39 +67,22 @@ module KDoc
       @namespace = ns.is_a?(Array) ? ns : [ns]
     end
 
-    # # Internal data object
-    # def data
-    #   @data ||= @tag_options.delete(:data) || @tag_options.delete(:default_data) || default_data_value
-    #   # Settings and Table on Model needed access to @data for modification, I don't think this should be a clone
-    #   # never return the original data object, but at the same time
-    #   # do not re-clone it every time this accessor is called.
-    #   # @clone_data ||= @data.clone
-    # end
-
-    # Implement in container
-    # def default_container_type
-    # :container
-    # end
-
-    # def default_data_value
-    #   {}
-    # end
-
     protected
 
     # rubocop:disable Metrics/AbcSize
-    def debug_container
-      log.kv 'tag' , tag , debug_pad_size
-      log.kv 'project'  , project   , debug_pad_size unless project.nil? || project.empty?
-      log.kv 'namespace', namespace , debug_pad_size unless namespace.nil? || namespace.empty?
-      log.kv 'key'      , key       , debug_pad_size
-      log.kv 'type'     , type      , debug_pad_size
+    def debug_taggable
+      log.kv 'tag'        , tag               , debug_pad_size
+      log.kv 'project'    , project           , debug_pad_size unless project.nil? || project.empty?
+      log.kv 'namespace'  , namespace         , debug_pad_size unless namespace.nil? || namespace.empty?
+      log.kv 'key'        , key               , debug_pad_size
+      log.kv 'type'       , type              , debug_pad_size
+      log.kv 'class type' , self.class.name   , debug_pad_size
       # log.kv 'error'    , error     , debug_kv_pad_size
     end
     # rubocop:enable Metrics/AbcSize
 
     def debug_pad_size
-      @debug_pad_size ||= @tag_options.delete(:debug_pad_size) || 15
+      @debug_pad_size ||= @tag_options.delete(:debug_pad_size) || 20
     end
 
     private
@@ -107,8 +91,8 @@ module KDoc
       values = []
       values << project if project
       values += namespace
-      values << type if type
       values << key
+      values << type if type
       values -= [nil, '']
       @tag = values.join('_').to_sym
     end

data/lib/k_doc/model.rb

@@ -115,7 +115,8 @@ module KDoc
 
     def debug_header
       log.heading self.class.name
-      debug_container
+      debug_taggable
+      debug_block_processor
       debug_header_keys
 
       log.line

data/lib/k_doc/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module KDoc
-  VERSION = '0.0.22'
+  VERSION = '0.0.26'
 end

data/lib/k_doc.rb

@@ -15,8 +15,10 @@ require 'k_doc/mixins/taggable'
 require 'k_doc/mixins/datum'
 require 'k_doc/mixins/block_processor'
 require 'k_doc/mixins/composable_components'
+require 'k_doc/mixins/importable'
 require 'k_doc/container'
 # require 'k_doc/data'
+require 'k_doc/action'
 require 'k_doc/csv_doc'
 require 'k_doc/json_doc'
 require 'k_doc/yaml_doc'
@@ -52,6 +54,12 @@ module KDoc
       model(key, **{ type: :app_settings }.merge(**options), &block)
     end
 
+    def action(key = nil, **options, &block)
+      doc = KDoc::Action.new(key, **options, &block)
+      doc.execute_block
+      doc
+    end
+
     def csv(key = nil, **options, &block)
       doc = KDoc::CsvDoc.new(key, **options, &block)
       doc.execute_block

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: k_doc
 version: !ruby/object:Gem::Version
-  version: 0.0.22
+  version: 0.0.26
 platform: ruby
 authors:
 - David Cruwys
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-11-28 00:00:00.000000000 Z
+date: 2022-02-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -119,6 +119,7 @@ files:
 - hooks/update-version
 - k_doc.gemspec
 - lib/k_doc.rb
+- lib/k_doc/action.rb
 - lib/k_doc/container.rb
 - lib/k_doc/csv_doc.rb
 - lib/k_doc/decorators/settings_decorator.rb
@@ -129,6 +130,7 @@ files:
 - lib/k_doc/mixins/composable_components.rb
 - lib/k_doc/mixins/datum.rb
 - lib/k_doc/mixins/guarded.rb
+- lib/k_doc/mixins/importable.rb
 - lib/k_doc/mixins/taggable.rb
 - lib/k_doc/model.rb
 - lib/k_doc/model_backup.rb
@@ -156,7 +158,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.7
+rubygems_version: 3.2.33
 signing_key:
 specification_version: 4
 summary: KDoc provides a document in the form a DSL that contains flexible key/value