nocode 0.0.1 → 0.0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e3f1a62969f19767ac717993632a0d51785969482b172c6e33cbfc94cfd13ce3
-  data.tar.gz: 76e62efa73b9d7489cea1bb7825df6ed490439de097f3b3abb404a8f74f98d63
+  metadata.gz: 8726547b06744c6a7870a8634901b344e41a65bb1ede23c7e68e99d2218d482f
+  data.tar.gz: 3462f703d7639662c0da4f96ec9913749698c7f7a08a58387671db909a88785f
 SHA512:
-  metadata.gz: f64bfa9cc952d58d9a5d37c5ac1045fae4e5b63d1f9bac5f5ac2522420790dc0003b878e52c009bc275960acf39732ccfd65a9d3c68d223954bd4ff56ba30eb7
-  data.tar.gz: 317d4ef406a064b2160247475a30911eaed26ac8d009a435c3ec9abe95ee91d64a88729a7146d3e19f7ab719e405b69b42dcaddf2fa928e0ef9d9fa014574b47
+  metadata.gz: f7bcfd37d152798a753801944a6a4787e3ad83a08fcfca0b40d9a0957cd7c5142a298adbb64215ed2e161c9e7f842b89ab460f6374fb8ec552a3482aa0b712eb
+  data.tar.gz: 6e024f679e2973888d5bb67c20988c8e93b296a6b6c4dbc66f7cb1f55d8638db48842834fd00c2a6d24050d9aa61950666107ff285a469e3f63835f74e7a5e7d

data/.github/workflows/rubygem.yml

@@ -25,3 +25,5 @@ jobs:
         bundler-cache: true # runs 'bundle install' and caches installed gems automatically
     - name: Run tests
       run: bundle exec rake
+    - name: Security audit dependencies
+      run: bundle exec bundler-audit check --update

data/.rubocop.yml

@@ -14,8 +14,5 @@ Metrics/BlockLength:
 Metrics/MethodLength:
   Max: 20
 
-Style/Documentation:
-  Enabled: false
-
 RSpec/ExampleLength:
   Max: 10

data/CHANGELOG.md

@@ -1,3 +1,16 @@
-#### February 9th, 2022
+#### 0.0.5 - February 13th, 2022
+
+* Added initial Dataset steps.
+
+#### 0.0.4 - February 13th, 2022
+
+* Increase class documentation
+* Add YAML serialization/deserialization
+
+#### 0.0.3 - February 12th, 2022
+
+* Add initial implementation.
+
+#### 0.0.0 - February 9th, 2022
 
 * Establish initial repository and gem infrastructure.

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,73 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, gender identity and expression, level of experience,
+nationality, personal appearance, race, religion, or sexual identity and
+orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported. All complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

data/README.md

@@ -2,8 +2,126 @@
 
 #### Execute Ruby code through YAML
 
-[![Ruby Gem CI](https://github.com/mattruggio/nocode/actions/workflows/rubygem.yml/badge.svg)](https://github.com/mattruggio/nocode/actions/workflows/rubygem.yml)
-
-**Warning**: This library is currently experimental.
+[![Gem Version](https://badge.fury.io/rb/nocode.svg)](https://badge.fury.io/rb/nocode) [![Ruby Gem CI](https://github.com/mattruggio/nocode/actions/workflows/rubygem.yml/badge.svg)](https://github.com/mattruggio/nocode/actions/workflows/rubygem.yml) [![Maintainability](https://api.codeclimate.com/v1/badges/66479dae44129c87dc88/maintainability)](https://codeclimate.com/github/mattruggio/nocode/maintainability) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 This is a proof of concept showing how a YAML interface could be draped over arbitrary Ruby code.  The YAML contains a series of steps with each step mapping to a specific Ruby class.  The Ruby classes just have one responsibility: to implement #perform.
+
+## Installation
+
+To install through Rubygems:
+
+````
+gem install nocode
+````
+
+You can also add this to your Gemfile using:
+
+````
+bundle add nocode
+````
+
+## Examples
+
+Create a file called `nocode-csv-to-json.yaml`:
+
+### CSV-to-JSON File Converter
+
+````yaml
+parameters:
+  input_filename: input.csv
+  output_filename: output.json
+
+steps:
+  - type: io/read
+    name: READ FILE
+    options:
+      path:
+        - files
+        - << parameters.input_filename >>
+  - type: deserialize/csv
+  - type: serialize/json
+  - type: io/write
+    options:
+      path:
+        - files
+        - << parameters.output_filename >>
+````
+
+Create csv file at: `files/input.csv`
+
+Execute in Ruby:
+
+````ruby
+path = Pathname.new('nocode-csv-to-json.yaml')
+
+Nocode.execute(path)
+````
+
+Or use bundler:
+
+````zsh
+bundle exec nocode `nocode-csv-to-json.yaml
+````
+
+A file should have been created at: `files/output.json`.
+
+Notes:
+
+* Path can be an array or a string.  If its an array then the environment's path separator will be used.
+* The `name` job key is optional.  If present then it will print out on the log.
+* Parameter values can be interpolated with keys and values using `<< parameters.key >>` syntax
+
+
+
+## Contributing
+
+### Development Environment Configuration
+
+Basic steps to take to get this repository compiling:
+
+1. Install [Ruby](https://www.ruby-lang.org/en/documentation/installation/) (check nocode.gemspec for versions supported)
+2. Install bundler (gem install bundler)
+3. Clone the repository (git clone git@github.com:mattruggio/nocode.git)
+4. Navigate to the root folder (cd nocode)
+5. Install dependencies (bundle)
+
+### Running Tests
+
+To execute the test suite run:
+
+````bash
+bundle exec rspec spec --format documentation
+````
+
+Alternatively, you can have Guard watch for changes:
+
+````bash
+bundle exec guard
+````
+
+Also, do not forget to run Rubocop:
+
+````bash
+bundle exec rubocop
+````
+
+### Publishing
+
+Note: ensure you have proper authorization before trying to publish new versions.
+
+After code changes have successfully gone through the Pull Request review process then the following steps should be followed for publishing new versions:
+
+1. Merge Pull Request into main
+2. Update `version.rb` using [semantic versioning](https://semver.org/)
+3. Install dependencies: `bundle`
+4. Update `CHANGELOG.md` with release notes
+5. Commit & push main to remote and ensure CI builds main successfully
+6. Run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Code of Conduct
+
+Everyone interacting in this codebase, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/mattruggio/nocode/blob/main/CODE_OF_CONDUCT.md).
+
+## License
+
+This project is MIT Licensed.

data/lib/nocode/context.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
 module Nocode
+  # Describes the environment for each running step.  An instance is initialized when a job
+  # kicks off and then is passed from step to step.
   class Context
     attr_reader :io, :parameters, :registers
 
@@ -17,7 +19,7 @@ module Nocode
     end
 
     def parameter(key)
-      parameters(key)
+      parameters[key]
     end
 
     def to_h

data/lib/nocode/executor.rb

@@ -1,11 +1,17 @@
 # frozen_string_literal: true
 
 require_relative 'context'
-require_relative 'options_template'
 require_relative 'step_registry'
 
 module Nocode
+  # Manages the lifecycle and executes a job.
   class Executor
+    NAME_KEY       = 'name'
+    OPTIONS_KEY    = 'options'
+    PARAMETERS_KEY = 'parameters'
+    STEPS_KEY      = 'steps'
+    TYPE_KEY       = 'type'
+
     attr_reader :yaml, :io
 
     def initialize(yaml, io: $stdout)
@@ -17,8 +23,8 @@ module Nocode
     end
 
     def execute
-      steps      = yaml['steps'] || []
-      parameters = yaml['parameters'] || {}
+      steps      = yaml[STEPS_KEY] || []
+      parameters = yaml[PARAMETERS_KEY] || {}
       context    = Context.new(io: io, parameters: parameters)
 
       log_title
@@ -38,14 +44,14 @@ module Nocode
     private
 
     def make_step(step, context)
-      type             = step['type'].to_s
-      name             = step['name'].to_s
-      options          = step['options'] || {}
-      compiled_options = OptionsTemplate.new(options).evaluate(context.to_h)
-      step_class       = StepRegistry.constant!(type)
+      step       = Util::ObjectTemplate.new(step).evaluate(context.to_h)
+      type       = step[TYPE_KEY].to_s
+      name       = step[NAME_KEY].to_s
+      options    = step[OPTIONS_KEY] || {}
+      step_class = StepRegistry.constant!(type)
 
       step_class.new(
-        options: Util::Dictionary.new(compiled_options),
+        options: Util::Dictionary.new(options),
         context: context,
         name: name,
         type: type

data/lib/nocode/step.rb

@@ -1,14 +1,22 @@
 # frozen_string_literal: true
 
 module Nocode
+  # Defines a running step.  Steps should be sub-classes of this class as well as to implement
+  # #perform.
   class Step
     extend Forwardable
     include Util::Arrayable
     include Util::Optionable
 
-    attr_reader :name, :context, :options, :type
+    attr_reader :context,
+                :name,
+                :options,
+                :type
 
-    def_delegators :context, :parameters, :registers, :io
+    def_delegators :context,
+                   :io,
+                   :parameters,
+                   :registers
 
     def initialize(
       context: Context.new,

data/lib/nocode/step_registry.rb

@@ -2,7 +2,11 @@
 
 require_relative 'step'
 
+# This will execute the StepRegisty's load! method upon script evaluation.
 module Nocode
+  # Provides a global place to register all valid steps by their types.  By default the
+  # steps directory will be autoloaded and their paths will be used as their types.  For example:
+  # for the class: steps/io/write, it would register as "io/write" type.
   class StepRegistry < Util::ClassRegistry
     include Singleton
 
@@ -22,9 +26,11 @@ module Nocode
     def load!
       files_loaded = Util::ClassLoader.new(DIR).load!
 
+      # Class the parent to load up the registry with the files we found.
       load(files_loaded, PREFIX)
     end
   end
 
+  # Call upon class evaluation to autoload all classes.
   StepRegistry.load!
 end

data/lib/nocode/steps/copy.rb

@@ -2,11 +2,12 @@
 
 module Nocode
   module Steps
+    # Shallow-copy one register to another.
     class Copy < Step
       option :from_register, :to_register
 
       def perform
-        registers[to_register_option] = registers[from_register_option]
+        registers[to_register_option] = registers[from_register_option].dup
       end
     end
   end

data/lib/nocode/steps/dataset/append.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Nocode
+  module Steps
+    module Dataset
+      # Add entries specified in the options to the end of the specified register's
+      # existing entries.
+      class Append < Step
+        option :entries, :register
+
+        def perform
+          registers[register_option] = array(registers[register_option])
+
+          array(entries_option).each do |entry|
+            registers[register_option].append(entry)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/nocode/steps/dataset/coalesce.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Nocode
+  module Steps
+    module Dataset
+      # Combine all specified from_registers into one dataset and place in the specified
+      # to_register.  If anything currently exists in the to_register then it will be coerced
+      # to an array and prepended to the beginning.
+      class Coalesce < Step
+        option :from_registers, :to_register
+
+        def perform
+          registers[to_register_option] = array(registers[to_register_option])
+
+          array(from_registers_option).each do |from_register|
+            registers[to_register_option] += array(registers[from_register])
+          end
+        end
+      end
+    end
+  end
+end

data/lib/nocode/steps/dataset/insert.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Nocode
+  module Steps
+    module Dataset
+      # Insert the entries to the at_index of the specified register.
+      # If at_index is nil then they will appended to the end.
+      class Insert < Step
+        option :at_index, :entries, :register
+
+        def perform
+          registers[register_option] = array(registers[register_option])
+
+          registers[register_option].insert(at_index, *entries)
+        end
+
+        private
+
+        def entries
+          array(entries_option)
+        end
+
+        def at_index
+          at_index_option.nil? ? -1 : at_index_option.to_i
+        end
+      end
+    end
+  end
+end

data/lib/nocode/steps/dataset/prepend.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Nocode
+  module Steps
+    module Dataset
+      # Add entries specified in the options to the beginning of the specified register's
+      # existing entries.
+      class Prepend < Step
+        option :entries, :register
+
+        def perform
+          registers[register_option] = array(registers[register_option])
+
+          array(entries_option).reverse_each do |entry|
+            registers[register_option].prepend(entry)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/nocode/steps/dataset/range.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Nocode
+  module Steps
+    module Dataset
+      # Slice a dataset and keep on the entries between start_index and end_index, inclusively.
+      # If start_index is not provided then it defaults to 0.
+      # If end_index is not provided then it defaults to the end of the dataset.
+      class Range < Step
+        option :end_index,
+               :register,
+               :start_index
+
+        def perform
+          registers[register_option] = array(registers[register_option])
+
+          registers[register_option] = registers[register_option][start_index..end_index]
+        end
+
+        private
+
+        def start_index
+          start_index_option.nil? ? 0 : start_index_option.to_i
+        end
+
+        def end_index
+          end_index_option.nil? ? -1 : end_index_option.to_i
+        end
+      end
+    end
+  end
+end

data/lib/nocode/steps/delete.rb

@@ -2,6 +2,7 @@
 
 module Nocode
   module Steps
+    # Remove a register completely.
     class Delete < Step
       option :register
 

data/lib/nocode/steps/deserialize/csv.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Nocode
+  module Steps
+    module Deserialize
+      # take a specified register and parse it as a CSV to produce an array of hashes.
+      class Csv < Step
+        option :register
+
+        def perform
+          input = registers[register_option].to_s
+
+          registers[register_option] = CSV.new(input, headers: true).map(&:to_h)
+        end
+      end
+    end
+  end
+end

data/lib/nocode/steps/deserialize/json.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Nocode
+  module Steps
+    module Deserialize
+      # take a specified register and parse it as JSON to produce Ruby object(s).
+      class Json < Step
+        option :register
+
+        def perform
+          input = registers[register_option]
+
+          registers[register_option] = JSON.parse(input)
+        end
+      end
+    end
+  end
+end

data/lib/nocode/steps/deserialize/yaml.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Nocode
+  module Steps
+    module Deserialize
+      # Take a specified register and parse it as YAML to produce Ruby object(s).
+      #
+      # NOTE: This will throw an error if unsafe YAML types are used.  The only allowed types are
+      # array, hash, strings, numbers, booleans, nil.  See:
+      # https://ruby-doc.org/stdlib-2.6.1/libdoc/psych/rdoc/Psych.html#method-c-safe_load
+      class Yaml < Step
+        option :register
+
+        def perform
+          input = registers[register_option]
+
+          registers[register_option] = YAML.safe_load(input)
+        end
+      end
+    end
+  end
+end

data/lib/nocode/steps/io/read.rb

@@ -3,6 +3,7 @@
 module Nocode
   module Steps
     module Io
+      # Read a file from disk and place its contents in a register.
       class Read < Step
         option :path,
                :register

data/lib/nocode/steps/io/write.rb

@@ -3,6 +3,7 @@
 module Nocode
   module Steps
     module Io
+      # Write the contents of a register to disk.
       class Write < Step
         option :path,
                :register

data/lib/nocode/steps/log.rb

@@ -2,6 +2,7 @@
 
 module Nocode
   module Steps
+    # Simply output the passed in message into the outputted log.
     class Log < Step
       option :message
 

data/lib/nocode/steps/serialize/csv.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Nocode
+  module Steps
+    module Serialize
+      # Take the contents of a register and create a CSV out of its contents.  The CSV contents
+      # will override the register specified.
+      class Csv < Step
+        option :register
+
+        def perform
+          input = registers[register_option]
+
+          registers[register_option] = CSV.generate do |csv|
+            array(input).each_with_index do |object, index|
+              csv << object.keys if index.zero? && object.respond_to?(:keys)
+
+              add_object(object, csv)
+            end
+          end
+        end
+
+        private
+
+        def add_object(object, csv)
+          object ||= {}
+
+          if object.is_a?(Array)
+            csv << object
+          elsif object.respond_to?(:values)
+            csv << object.values
+          end
+        end
+      end
+    end
+  end
+end

data/lib/nocode/steps/serialize/json.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Nocode
+  module Steps
+    module Serialize
+      # Take the contents of a register and serialize it as JSON.  The serialized JSON
+      # will override the register specified.
+      class Json < Step
+        option :register
+
+        def perform
+          input = registers[register_option]
+
+          registers[register_option] = input.to_json
+        end
+      end
+    end
+  end
+end

data/lib/nocode/steps/serialize/yaml.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Nocode
+  module Steps
+    module Serialize
+      # Take the contents of a register and serialize it as YAML.  The serialized YAML
+      # will override the register specified.
+      class Yaml < Step
+        option :register
+
+        def perform
+          input = registers[register_option]
+
+          registers[register_option] = input.to_yaml
+        end
+      end
+    end
+  end
+end

data/lib/nocode/steps/set.rb

@@ -2,6 +2,7 @@
 
 module Nocode
   module Steps
+    # Set a register's value to the value option specified.
     class Set < Step
       option :register, :value
 

data/lib/nocode/steps/sleep.rb

@@ -2,6 +2,9 @@
 
 module Nocode
   module Steps
+    # Sleep for an arbitrary number of seconds.
+    #
+    # Mechanic: https://apidock.com/ruby/Kernel/sleep
     class Sleep < Step
       option :seconds
 

data/lib/nocode/util/arrayable.rb

@@ -2,6 +2,7 @@
 
 module Nocode
   module Util
+    # Hand
     module Arrayable
       def array(value)
         if value.is_a?(Hash)

data/lib/nocode/util/class_loader.rb

@@ -2,6 +2,7 @@
 
 module Nocode
   module Util
+    # Loads a directory full of Ruby classes and returns their relative paths.
     class ClassLoader
       EXTENSION = '.rb'
 

data/lib/nocode/util/class_registry.rb

@@ -2,6 +2,9 @@
 
 module Nocode
   module Util
+    # Create a type -> class constant interface.  Classes can be registered as types.  Types
+    # are snake-cased while class names are stored as pascal-cased.  Then constant! can be called
+    # to retrieve the class constant by type.
     class ClassRegistry
       extend Forwardable
 

data/lib/nocode/util/dictionary.rb

@@ -2,6 +2,7 @@
 
 module Nocode
   module Util
+    # A hash-like object which ensures all keys are strings.
     class Dictionary
       extend Forwardable
 

data/lib/nocode/util/object_template.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+require_relative 'string_template'
+
+module Nocode
+  module Util
+    # Built on top of StringTemplate but instead of only working for a string, this will
+    # recursively evaluate all strings within an object.  Heuristics:
+    #    - Strings evaluate using StringTemplate
+    #    - Hashes will have their keys and values traversed
+    #    - Arrays will have their entries traversed
+    #    - All other types will simply return themselves
+    class ObjectTemplate
+      attr_reader :object
+
+      def initialize(object)
+        @object = object
+
+        freeze
+      end
+
+      def evaluate(values = {})
+        recursive_evaluate(object, values)
+      end
+
+      private
+
+      def recursive_evaluate(expression, values)
+        case expression
+        when Array
+          expression.map { |o| recursive_evaluate(o, values) }
+        when Hash
+          expression.to_h do |k, v|
+            [recursive_evaluate(k, values), recursive_evaluate(v, values)]
+          end
+        when String
+          Util::StringTemplate.new(expression).evaluate(values)
+        else
+          expression
+        end
+      end
+    end
+  end
+end

data/lib/nocode/util/optionable.rb

@@ -2,6 +2,20 @@
 
 module Nocode
   module Util
+    # Add on a DSL for classes.  The DSL allows for a new class-level keyword called 'option'
+    # which can be used to describe what metadata values are important.  Then instances
+    # can reference those option's values using magic _option methods.  For example:
+    #
+    # class Animal
+    #   include Optionable
+    #   option :type
+    #   attr_writer :options
+    # end
+    #
+    # animal = Animal.new
+    # animal.options = { 'type' => 'dog' }
+    #
+    # animal.type_option # -> should return 'dog'
     module Optionable
       def self.included(klass)
         klass.extend(ClassMethods)

data/lib/nocode/util/string_template.rb

@@ -2,6 +2,11 @@
 
 module Nocode
   module Util
+    # Takes in an expression and interpolates in any parameters using << >> notation.
+    # For example:
+    #   input = { 'person' => 'hops' }
+    #   Nocode::Util::StringTemplate.new("Hello, << person.name >>!").evaluate(input)
+    # Should produce: "Hello, hops!"
     class StringTemplate
       LEFT_TOKEN  = '<<'
       RIGHT_TOKEN = '>>'
@@ -11,7 +16,7 @@ module Nocode
       attr_reader :expression
 
       def initialize(expression)
-        @expression = expression
+        @expression = expression.to_s
 
         freeze
       end

data/lib/nocode/util.rb

@@ -4,5 +4,5 @@ require_relative 'util/arrayable'
 require_relative 'util/class_loader'
 require_relative 'util/class_registry'
 require_relative 'util/dictionary'
+require_relative 'util/object_template'
 require_relative 'util/optionable'
-require_relative 'util/string_template'

data/lib/nocode/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Nocode
-  VERSION = '0.0.1'
+  VERSION = '0.0.5'
 end

data/lib/nocode.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
 require 'benchmark'
+require 'csv'
 require 'fileutils'
+require 'json'
 require 'singleton'
 require 'time'
 require 'yaml'
@@ -12,7 +14,9 @@ require 'nocode/util'
 # Core
 require 'nocode/executor'
 
+# Establish main top-level namespace
 module Nocode
+  # Default consumer entrypoint into the library.
   class << self
     def execute(yaml, io: $stdout)
       Executor.new(yaml, io: io).execute

data/nocode.gemspec

@@ -29,6 +29,7 @@ Gem::Specification.new do |s|
 
   s.required_ruby_version = '>= 2.6'
 
+  s.add_development_dependency('bundler-audit')
   s.add_development_dependency('guard-rspec')
   s.add_development_dependency('pry')
   s.add_development_dependency('rake')

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: nocode
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.5
 platform: ruby
 authors:
 - Matthew Ruggio
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-02-13 00:00:00.000000000 Z
+date: 2022-02-14 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler-audit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: guard-rspec
   requirement: !ruby/object:Gem::Requirement
@@ -151,6 +165,7 @@ files:
 - ".rubocop.yml"
 - ".tool-versions"
 - CHANGELOG.md
+- CODE_OF_CONDUCT.md
 - Gemfile
 - Guardfile
 - LICENSE
@@ -161,14 +176,24 @@ files:
 - lib/nocode.rb
 - lib/nocode/context.rb
 - lib/nocode/executor.rb
-- lib/nocode/options_template.rb
 - lib/nocode/step.rb
 - lib/nocode/step_registry.rb
 - lib/nocode/steps/copy.rb
+- lib/nocode/steps/dataset/append.rb
+- lib/nocode/steps/dataset/coalesce.rb
+- lib/nocode/steps/dataset/insert.rb
+- lib/nocode/steps/dataset/prepend.rb
+- lib/nocode/steps/dataset/range.rb
 - lib/nocode/steps/delete.rb
+- lib/nocode/steps/deserialize/csv.rb
+- lib/nocode/steps/deserialize/json.rb
+- lib/nocode/steps/deserialize/yaml.rb
 - lib/nocode/steps/io/read.rb
 - lib/nocode/steps/io/write.rb
 - lib/nocode/steps/log.rb
+- lib/nocode/steps/serialize/csv.rb
+- lib/nocode/steps/serialize/json.rb
+- lib/nocode/steps/serialize/yaml.rb
 - lib/nocode/steps/set.rb
 - lib/nocode/steps/sleep.rb
 - lib/nocode/util.rb
@@ -176,6 +201,7 @@ files:
 - lib/nocode/util/class_loader.rb
 - lib/nocode/util/class_registry.rb
 - lib/nocode/util/dictionary.rb
+- lib/nocode/util/object_template.rb
 - lib/nocode/util/optionable.rb
 - lib/nocode/util/string_template.rb
 - lib/nocode/version.rb

data/lib/nocode/options_template.rb

@@ -1,34 +0,0 @@
-# frozen_string_literal: true
-
-module Nocode
-  class OptionsTemplate
-    attr_reader :object
-
-    def initialize(object)
-      @object = object
-
-      freeze
-    end
-
-    def evaluate(values = {})
-      recursive_evaluate(object, values)
-    end
-
-    private
-
-    def recursive_evaluate(expression, values)
-      case expression
-      when Array
-        expression.map { |o| recursive_evaluate(o, values) }
-      when Hash
-        expression.to_h do |k, v|
-          [recursive_evaluate(k, values), recursive_evaluate(v, values)]
-        end
-      when String
-        Util::StringTemplate.new(expression).evaluate(values)
-      else
-        expression
-      end
-    end
-  end
-end