markdown_exec 1.3.1 → 1.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e0c996cc59c02f9cfff6948467f4714bfb7e010ec61f886b9508b4af1a80dbc6
-  data.tar.gz: 9cd5bbe3d4b59c5d272ae42bd58ef228132a4af6471ee7d31867a69742c8b9ea
+  metadata.gz: 4350ee3346d6295cea603ec3602ce13c3cff3ebe83ff766c873141bebd28dca6
+  data.tar.gz: 57f150a38020be6404bdf140755c7328f70417f1fd98286c2974492d085707c0
 SHA512:
-  metadata.gz: d2a005d3d3d4550644d470ea734902fb3ba796de73d115a041dccbcdee85a675956427ee20e8a6fb68df91c8a5b96cc820458f61120e71ab64f568563145689a
-  data.tar.gz: 3eadd9f350b5138f808b7ce986f2b6a5b8f747c650788c36b7d46b1ed17eccde6b018862c1334e1277fe29a27f617fe08d44b45e2bed6f182888713df813c04f
+  metadata.gz: 4a412d4bf068a09371989336b50e82822e142fa27ee45c2d578a0d40834e74a618fbe968a26e10640a127c0c1078ecb1a65798bb19c7b171cfc07f11b08e03f3
+  data.tar.gz: e6df4504a02de72dcf40b07acc39cb24752916511217354d485502183469ac061ab841d7fdfbe30e63ffa93cd87c403ec619678998b17adce7e7b68bef87eb2d

data/.rubocop.yml

@@ -9,6 +9,9 @@ AllCops:
 Layout/LeadingCommentSpace:
   Enabled: false
 
+Layout/LineContinuationLeadingSpace:
+  Enabled: false
+
 Lint/SafeNavigationChain:
   Enabled: false
 
@@ -38,7 +41,16 @@ Metrics/PerceivedComplexity:
 
 Minitest/MultipleAssertions:
   Enabled: false
- 
+
+# RSpec/AnyInstance:
+#   Enabled: false
+
+# RSpec/MultipleExpectations:
+#   Enabled: true
+
+# RSpec/StubbedMock:
+#   Enabled: false
+
 Security/YAMLLoad:
   Enabled: false
 
@@ -57,6 +69,9 @@ Style/MixinUsage:
 Style/MultilineBlockChain:
   Enabled: false
 
+Style/SlicingWithRange:
+  Enabled: false
+
 Style/StringLiterals:
   Enabled: true
   EnforcedStyle: single_quotes

data/CHANGELOG.md

@@ -78,6 +78,13 @@
 - [ ] command to export each command to file, menu for list
 - [ ] list of fenced code blocks to ignore, eg ```expect or ```mermaid
 
+## [1.3.2] - 2022-11-12
+
+### Added
+
+- Add EnvOpts class
+- RSpec for internal classes
+
 ## [1.3.1] - 2022-10-29
 
 ### Added

data/Gemfile

@@ -11,11 +11,11 @@ gem 'erb'
 gem 'minitest', '~> 5.0'
 gem 'rake', '~> 13.0'
 gem 'reek'
-# gem 'rspec'
+gem 'rspec'
 gem 'rubocop', '~> 1.21'
 gem 'rubocop-minitest', require: false
 gem 'rubocop-rake', require: false
-# gem 'rubocop-rspec', require: false
+gem 'rubocop-rspec', require: false
 gem 'shellwords'
 gem 'uri'
 gem 'yaml'

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    markdown_exec (1.3.1)
+    markdown_exec (1.3.2)
       clipboard (~> 1.3.6)
       open3 (~> 0.1.1)
       optparse (~> 0.1.1)
@@ -14,6 +14,7 @@ GEM
     ast (2.4.2)
     cgi (0.3.3)
     clipboard (1.3.6)
+    diff-lcs (1.5.0)
     erb (2.2.3)
       cgi
     json (2.6.2)
@@ -34,6 +35,19 @@ GEM
       rainbow (>= 2.0, < 4.0)
     regexp_parser (2.6.0)
     rexml (3.2.5)
+    rspec (3.12.0)
+      rspec-core (~> 3.12.0)
+      rspec-expectations (~> 3.12.0)
+      rspec-mocks (~> 3.12.0)
+    rspec-core (3.12.0)
+      rspec-support (~> 3.12.0)
+    rspec-expectations (3.12.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.12.0)
+    rspec-mocks (3.12.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.12.0)
+    rspec-support (3.12.0)
     rubocop (1.37.1)
       json (~> 2.3)
       parallel (~> 1.10)
@@ -50,6 +64,8 @@ GEM
       rubocop (>= 0.90, < 2.0)
     rubocop-rake (0.6.0)
       rubocop (~> 1.0)
+    rubocop-rspec (2.14.2)
+      rubocop (~> 1.33)
     ruby-progressbar (1.11.0)
     shellwords (0.1.0)
     tty-color (0.6.0)
@@ -77,9 +93,11 @@ DEPENDENCIES
   minitest (~> 5.0)
   rake (~> 13.0)
   reek
+  rspec
   rubocop (~> 1.21)
   rubocop-minitest
   rubocop-rake
+  rubocop-rspec
   shellwords
   uri
   yaml

data/README.md

@@ -265,6 +265,10 @@ bundle exec rake uninstall
 bundle exec rake install
 ```
 
+- add git version tag
+
+- push to remote origin
+
 ```
 bundle exec rake publish
 ```

data/Rakefile

@@ -34,6 +34,7 @@ tap_config envvar: MarkdownExec::TAP_DEBUG
 
 RuboCop::RakeTask.new do |task|
   task.requires << 'rubocop-minitest'
+  task.requires << 'rubocop-rspec'
 end
 
 desc 'named task because minitest not included in rubocop tests'
@@ -41,8 +42,14 @@ task :rubocopminitest do
   `rubocop --require rubocop-minitest`
 end
 
+# desc 'rspec'
+# task :rspec do
+#     puts "in rspec"
+#   `pwd && rspec`
+# end
+
 task default: %i[test reek rubocop rubocopminitest]
-# task default: %i[spec test reek rubocop rubocopminitest]
+# task default: %i[rspec test reek rubocop rubocopminitest]
 
 # task :default => :build
 
@@ -630,7 +637,7 @@ def update_tab_completion(target)
 
   svhs = YAML.load File.open(MENU_YML)
   svhs.each do |svh|
-    svh[:compreply] = CLI::value_for_cli(svh[:default]) if svh[:compreply].nil?
+    svh[:compreply] = CLI.value_for_cli(svh[:default]) if svh[:compreply].nil?
   end.tap_inspect name: :svhs, type: :yaml
 
   File.write target, ERB.new(File.read(filespec = File.join(BF, 'tab_completion.sh.erb'))).result(binding)

data/bin/tab_completion.sh

@@ -13,7 +13,7 @@ __filedirs_all()
 }
 
 _mde_echo_version() {
-  echo "1.3.1"
+  echo "1.3.2"
 }
 
 _mde() {
@@ -138,4 +138,4 @@ _mde() {
 
 complete -o filenames -o nospace -F _mde mde
 # _mde_echo_version
-# echo "Updated: 2022-10-29 23:24:15 UTC"
+# echo "Updated: 2022-11-13 18:09:17 UTC"

data/lib/env.rb

@@ -10,17 +10,21 @@ module Env
   # :reek:NilCheck
   # :reek:UtilityFunction
   def env_bool(name, default: false)
-    return default if name.nil? || (val = ENV[name]).nil?
+    return default if name.nil? || (val = ENV.fetch(name, nil)).nil?
     return false if val.empty? || val == '0'
 
     true
   end
 
+  def env_bool_false(name)
+    !(val = (name && ENV.fetch(name, nil))).nil? && !(val.empty? || val == '0')
+  end
+
   # skip :reek:DataClump
   # skip :reek:NilCheck
   # skip :reek:UtilityFunction
   def env_int(name, default: 0)
-    return default if name.nil? || (val = ENV[name]).nil?
+    return default if name.nil? || (val = ENV.fetch(name, nil)).nil?
     return default if val.empty?
 
     val.to_i
@@ -30,7 +34,7 @@ module Env
   # skip :reek:NilCheck
   # skip :reek:UtilityFunction
   def env_str(name, default: '')
-    return default if name.nil? || (val = ENV[name]).nil?
+    return default if name.nil? || (val = ENV.fetch(name, nil)).nil?
 
     val || default
   end

data/lib/env_opts.rb

@@ -0,0 +1,244 @@
+# frozen_string_literal: true
+
+# encoding=utf-8
+
+require_relative 'tap'
+
+include Tap #; tap_config
+
+# define options with initial values
+# option to read value from environmnt variables
+# option to cast input values
+# value priority: default < environment < argument
+#
+class EnvOpts
+  attr_reader :opts, :values
+
+  def initialize(opts_raw = {}, argv = ARGV)
+    @opts = {}
+    @values = {}
+    add_options(opts_raw)
+    # parse(argv, &block) if block_given?
+    block_given? ? parse(argv, &block) : parse(argv)
+
+    self # rubocop:disable Lint/Void
+  end
+
+  # add options to menu
+  # calculate help text
+  #
+  def add_options(opts_raw)
+    return self if opts_raw.nil?
+
+    rows = opts_raw.map do |key, opt_raw|
+      key2 = key_name_to_option_name(key)
+
+      # set_per_options(key2, opt_raw)
+      @opts[key2] = (opt_raw ||= {})
+      set_key_value_as_cast key2, EnvOpts.optdefault(opt_raw)
+
+      set_key_value_per_environment_as_cast(key2, opt_raw)
+
+      [
+        [20, '-', "--#{key}"],
+        [16, '-', @opts[key2][:env].present? ? option_name_to_environment_name(key2, @opts[key2]) : ''],
+        # [24, '-', get_environment_value_from_option(key2, @opts[key2])],
+        [24, '-', @opts[key2][:default]],
+        [6, '-', if (fixed = opt_raw.fetch(:fixed, nil)).nil?
+                   ":#{option_cast(@opts[key2])}"
+                 else
+                   fixed.to_s
+                 end]
+      ]
+    end.tap_yaml 'rows'
+
+    max_widths = rows.reduce([0, 0, 0, 0]) do |memo, (c0, c1, c2, c3)|
+      [
+        [memo[0], c0[2].to_s.length].max,
+        [memo[1], c1[2].to_s.length].max,
+        [memo[2], c2[2].to_s.length].max,
+        [memo[3], c3[2].to_s.length].max
+      ]
+    end.tap_inspect 'max_widths'
+
+    @values['help'] = rows.map do |(c0, c1, c2, c3)|
+      [format("%#{c0[1]}#{max_widths[0]}s", c0[2]),
+       format("%#{c1[1]}#{max_widths[1]}s", c1[2]),
+       format("%#{c2[1]}#{max_widths[2]}s", c2[2]),
+       format("%#{c3[1]}#{max_widths[3]}s", c3[2])]
+    end.map do |row|
+      row.join('  ')
+    end.join("\n")
+    @opts.tap_inspect '@opts'
+    @values.tap_inspect '@values'
+
+    self
+  end
+
+  # accept :d or :default option
+  #
+  def self.optdefault(opt_raw)
+    return opt_raw[:d] unless opt_raw[:d].nil?
+
+    opt_raw[:default]
+  end
+
+  def output_help
+    puts @values['help']
+  end
+
+  # process arguments as mostly pairs of option name and value
+  #
+  def parse(argv = ARGV)
+    return self if argv.nil? || !(argv&.count || 0).positive?
+
+    args_ind = 0
+    while args_ind < argv.count
+      args_consumed = 0
+      arg = argv.fetch(args_ind, '') #.tap_inspect 'argument', source: 'EnvOpts'
+      if arg.start_with? '--'
+        opt_name = arg[2..-1] #.tap_inspect 'opt_name', source: 'EnvOpts'
+        args_consumed = consume_arguments(opt_name, argv.fetch(args_ind + 1, nil))
+      end
+
+      if args_consumed.zero?
+        if arg == '--help'
+          output_help
+          exit
+        elsif block_given?
+          yield 'NAO', [arg]
+          args_consumed = 1
+        else
+          warn "Invalid argument: #{arg.inspect} in #{argv.inspect}"
+          exit 1
+        end
+      end
+
+      args_ind += args_consumed
+    end
+    @opts.tap_inspect '@opts'
+    @values.tap_inspect '@values'
+
+    self
+  end
+
+  # set option current values per environment values
+  #
+  def set_keys_value_per_environment_as_cast(opts_raw)
+    return self if opts_raw.nil?
+
+    opts_raw.each do |key, opt_raw|
+      set_key_value_per_environment_as_cast(key_name_to_option_name(key), opt_raw)
+    end
+    @opts.tap_inspect '@opts'
+
+    self
+  end
+
+  private
+
+  # convert key name or symbol to an option name
+  #
+  def key_name_to_option_name(key)
+    (key.is_a?(Symbol) ? symbol_name_to_option_name(key) : key) #.tap_inspect
+  end
+
+  # get cast of environment variable
+  #
+  def option_cast(opt_raw)
+    (opt_raw[:cast].present? ? opt_raw[:cast].to_s : 'to_s').tap_inspect
+  end
+
+  # update value for named option
+  # return number of arguments used
+  #
+  def consume_arguments(opt_name, value)
+    return 0 if (opt_raw = @opts.fetch(opt_name, nil)).nil?
+
+    return 0 unless opt_raw.fetch(:option, true)
+
+    if !(fixed = opt_raw.fetch(:fixed, nil)).nil?
+      set_key_value_as_cast(opt_name, fixed)
+      1
+    elsif value.nil?
+      0
+    else
+      set_key_value_as_cast(opt_name, value)
+      2
+    end
+  end
+
+  # option names use hyphens
+  #
+  def method_name_to_option_name(name)
+    name.to_s.gsub('_', '-') #.tap_inspect
+  end
+
+  # read and write options using the option name as a method
+  #
+  def method_missing(method_name, *args)
+    method_name.tap_inspect 'method_name'
+    if method_name.to_s.end_with?('=')
+      value = args.first
+      name = method_name_to_option_name(method_name.to_s[0..-2])
+      set_key_value_as_cast(name, value)
+    else
+      @values[method_name_to_option_name(method_name)]
+    end.tap_inspect "ref #{method_name}", source: 'EnvOpts'
+  end
+
+  # option name to environment name
+  # if true or empty, compute from option name
+  #
+  def option_name_to_environment_name(opt_name, opt_raw)
+    case env_name = opt_raw.fetch(:env, '')
+    when true, ''
+      "#{@values['env-prefix']}#{opt_name.upcase.gsub('-', '_')}"
+    else
+      env_name
+    end.tap_inspect
+  end
+
+  # get environment value from option
+  #
+  def get_environment_value_from_option(opt_name, opt_raw)
+    ENV.fetch(option_name_to_environment_name(opt_name, opt_raw), nil).tap_inspect
+  end
+
+  # option names are available as methods
+  #
+  def respond_to_missing?(method_name, include_private = false)
+    (@opts.keys.include?(method_name_to_option_name(method_name)) || super)
+  end
+
+  def set_key_value_as_cast(key, value)
+    [key, value].tap_inspect 'key, value'
+    opt = @opts[key]
+    set_key_value_raw(key, (opt[:cast] ? value.send(opt[:cast]) : value))
+  end
+
+  # set key value_per environment as cast
+  #
+  def set_key_value_per_environment_as_cast(key, opt_raw)
+    key.tap_inspect 'key'
+    opt_raw.tap_inspect 'opt_raw'
+    return if opt_raw[:env].nil?
+
+    value = get_environment_value_from_option(key, opt_raw).tap_inspect 'value'
+    set_key_value_as_cast(key, opt_raw[:cast] ? value.send(opt_raw[:cast]) : value) unless value.nil?
+  end
+
+  # set key value (raw)
+  #
+  def set_key_value_raw(key, value)
+    [key, value].tap_inspect 'key, value'
+    @values[key] = value
+  end
+
+  # symbol name to option name
+  # option names use hyphens
+  #
+  def symbol_name_to_option_name(name)
+    name.to_s.gsub('_', '-') #.tap_inspect
+  end
+end

data/lib/environment_opt_parse.rb

@@ -7,6 +7,8 @@ require 'yaml'
 
 require_relative 'object_present'
 
+# add Hash.sym_keys
+#
 class Hash
   unless defined?(sym_keys)
     def sym_keys
@@ -18,6 +20,8 @@ class Hash
   end
 end
 
+# parse application configuration from command-line options and environment variables
+#
 class EnvironmentOptParse
   attr_reader :options, :remainder
 

data/lib/markdown_exec/version.rb

@@ -7,5 +7,5 @@ module MarkdownExec
   BIN_NAME = 'mde'
   GEM_NAME = 'markdown_exec'
   TAP_DEBUG = 'MDE_DEBUG'
-  VERSION = '1.3.1'
+  VERSION = '1.3.2'
 end

data/lib/markdown_exec.rb

@@ -6,7 +6,7 @@
 require 'English'
 require 'clipboard'
 require 'open3'
-# require 'optparse'
+require 'optparse'
 require 'shellwords'
 require 'tty-prompt'
 require 'yaml'
@@ -14,7 +14,7 @@ require 'yaml'
 require_relative 'cli'
 require_relative 'colorize'
 require_relative 'env'
-require_relative 'environment_opt_parse'
+# require_relative 'environment_opt_parse'
 require_relative 'object_present'
 require_relative 'shared'
 require_relative 'tap'
@@ -478,7 +478,7 @@ module MarkdownExec
             yield line, nil, nil, exec_thr if block_given?
           end
           #d 'exec_thr now dead'
-        rescue
+        rescue StandardError
           #d 'stdin error, thread killed, do nothing'
         end
 
@@ -788,11 +788,9 @@ module MarkdownExec
       blocks_in_file = list_blocks_in_file(opts.merge(struct: true))
       mdoc = MDoc.new(blocks_in_file)
 
-      list_blocks_in_file(opts).map do |block|
-        next if mdoc.hide_menu_block_per_options(opts, block)
-
-        block
-      end.compact.tap_inspect
+      list_blocks_in_file(opts).reject do |block|
+        mdoc.hide_menu_block_per_options(opts, block)
+      end.tap_inspect
     end
 
     def list_recent_output(saved_stdout_folder, saved_stdout_glob, list_count)
@@ -1002,21 +1000,6 @@ module MarkdownExec
 
     # :reek:NestedIterators
     def run
-      # eop = EnvironmentOptParse.new(
-      #   menu: File.join(File.expand_path(__dir__), 'menu.yml'),
-      #   options: {
-      #     menu_exit_at_top: true,
-      #     menu_with_exit: true
-      #   }
-      # ).tap_yaml '** eop'
-      # # eop = EnvironmentOptParse.new(menu: 'lib/menu.yml', options: ".#{MarkdownExec::APP_NAME.downcase}.yml", version: MarkdownExec::VERSION).tap_yaml '** eop'
-      # eop.options.tap_inspect 'eop.options'
-      # eop.remainder.tap_inspect 'eop.remainder'
-
-      # exec_block eop.options, eop.options[:block_name]
-
-      # return
-
       ## default configuration
       #
       @options = base_options
@@ -1081,7 +1064,7 @@ module MarkdownExec
       @options[:logged_stdout_filespec] = File.join @options[:saved_stdout_folder], @options[:logged_stdout_filename]
       @logged_stdout_filespec = @options[:logged_stdout_filespec]
       (dirname = File.dirname(@options[:logged_stdout_filespec])).tap_inspect name: :dirname
-      Dir.mkdir dirname unless File.exist?(dirname)
+      Dir.mkdir_p dirname
 
       ol = ["-STDOUT-\n"]
       ol += @execute_files&.fetch(EF_STDOUT, [])
@@ -1218,7 +1201,7 @@ module MarkdownExec
           File.join opts[:saved_script_folder], opts[:saved_script_filename]
 
       dirname = File.dirname(@options[:saved_filespec])
-      Dir.mkdir dirname unless File.exist?(dirname)
+      Dir.mkdir_p dirname
       (shebang = if @options[:shebang]&.present?
                    "#{@options[:shebang]} #{@options[:shell]}\n"
                  else

data/lib/menu.yml

@@ -1,4 +1,4 @@
-# MDE - Markdown Executor (1.3.1)
+# MDE - Markdown Executor (1.3.2)
 ---
 - :arg_name: NAME
   :compreply: false

data/lib/object_present.rb

@@ -22,7 +22,6 @@ class String
   end
 end
 
-
 # is the value a non-empty string or a binary?
 #
 # :reek:ManualDispatch ### temp

data/lib/tap.rb

@@ -6,8 +6,12 @@ require 'json'
 require 'yaml'
 
 require_relative 'env'
+require_relative 'object_present'
+
 include Env
 
+# rubocop:disable Metrics/ParameterLists
+
 ## application-level debug control
 #
 module Tap
@@ -59,6 +63,7 @@ module Tap
     end
     # puts "$tap_enable: #{$tap_enable}"
     # puts "$tap_mask: #{$tap_mask.to_s(2)}"
+    self
   end
 
   def tap_inspect(name_ = nil, caller0: nil, mask: TDD, name: DN, source: nil, type: nil)
@@ -67,31 +72,46 @@ module Tap
 
     fn = CVT.fetch(type, CVT[:else])
     outs = []
-    outs.push("#{source}") if source
-    outs.push("#{(caller0 || caller[0]).scan(/in `?(\S+)'$/)[0][0]}()") # if (mask & $tap_mask & TP).positive?
-    outs.push("#{name_ || name}: #{method(fn).call}") # if (mask & $tap_mask & TD).positive?
-    puts outs.join(' ') if outs.length.positive?
+    outs.push(source.to_s) if source.present?
+
+    vs = (caller0 || caller[0]).scan(/in `?(\S+)'$/).fetch(0, []).fetch(0, '')
+    outs.push("#{vs}()") if vs.present?
+
+    outs.push(tap_named_value(name_ || name, method(fn).call))
 
+    $stdout.puts(outs.join(' ')) if outs.length.positive?
     self
   end
 
   def tap_print(mask: TDD)
+    return self unless $tap_enable
     return self unless (mask & $tap_mask).positive?
 
-    print self
+    $stdout.print self
+    self
   end
 
-  def tap_puts(name_ = nil, caller0: nil, mask: TDD, name: nil, type: nil)
-    # return self unless (mask & $tap_mask).positive?
+  def tap_puts(name_ = nil, mask: TDD, name: nil)
+    return self unless $tap_enable
+    return self unless (mask & $tap_mask).positive?
 
-    if (name1 = name_ || name).present?
-      puts "#{name1}: #{self}"
-    else
-      puts self
-    end
+    $stdout.puts tap_named_value(name_ || name, self)
+    self
   end
 
   def tap_yaml(name_ = nil, caller0: nil, mask: TDD, name: DN, source: nil)
     tap_inspect name_, caller0: (caller0 || caller[0]), mask: mask, name: name, source: source, type: :yaml
   end
+
+  private
+
+  def tap_named_value(name, value)
+    if name.present?
+      "#{name}: #{value}"
+    else
+      value.to_s
+    end
+  end
 end
+
+# rubocop:enable Metrics/ParameterLists

data/lib/yaml_env_opts.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+# encoding=utf-8
+
+require 'yaml'
+
+require_relative 'env_opts'
+require_relative 'object_present'
+require_relative 'tap'
+
+include Tap #; tap_config
+
+# read configuration YAML file during initalization
+# value priority: menu default < configuration file < environment variable < command argument
+#
+class YamlEnvOpts < EnvOpts
+  def initialize(opts_raw = {}, argv: ARGV, configuration_yaml_filespec: '', values: nil)
+    super(opts_raw || {}, nil)
+    per_values(values)
+    configure_yaml_filespec(configuration_yaml_filespec)
+    set_keys_value_per_environment_as_cast(opts_raw)
+    parse(argv)
+
+    self # rubocop:disable Lint/Void
+  end
+
+  private
+
+  def apply_configuration(settings)
+    settings.tap_inspect 'settings'
+    return if settings.nil?
+
+    settings.each do |name, value|
+      set_key_value_as_cast(name, value)
+    end.tap_inspect
+  end
+
+  def configure_yaml_filespec(configuration_yaml_filespec)
+    apply_configuration(read_configuration_yaml(configuration_yaml_filespec))
+  end
+
+  def per_values(settings)
+    settings.tap_inspect 'settings'
+    return self if settings.nil?
+    return self if settings.count.zero?
+
+    settings.each do |name, value|
+      set_key_value_as_cast(name, value)
+    end
+
+    self
+  end
+
+  def read_configuration_yaml(configuration_yaml_filespec)
+    configuration_yaml_filespec.tap_inspect 'configuration_yaml_filespec'
+    return unless configuration_yaml_filespec.present?
+
+    YAML.safe_load(File.read(configuration_yaml_filespec) || '').tap_inspect
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: markdown_exec
 version: !ruby/object:Gem::Version
-  version: 1.3.1
+  version: 1.3.2
 platform: ruby
 authors:
 - Fareed Stevenson
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-10-29 00:00:00.000000000 Z
+date: 2022-11-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: clipboard
@@ -113,6 +113,7 @@ files:
 - lib/cli.rb
 - lib/colorize.rb
 - lib/env.rb
+- lib/env_opts.rb
 - lib/environment_opt_parse.rb
 - lib/globfiles.rb
 - lib/markdown_exec.rb
@@ -121,6 +122,7 @@ files:
 - lib/object_present.rb
 - lib/shared.rb
 - lib/tap.rb
+- lib/yaml_env_opts.rb
 homepage: https://rubygems.org/gems/markdown_exec
 licenses:
 - MIT