markdown_exec 2.7.1 → 2.7.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2777165b185482931d9fe8e519921490e8e252dcb93d141abf52fc6e53b95ba7
-  data.tar.gz: c5925bd62f6853ad701946a2ecca3bf57c8b967b7f65c9990f72c17748591398
+  metadata.gz: c35f2f729da73920db53053340bbe0ced75bfbb16ad59697fa6ba4016b62ae74
+  data.tar.gz: c20943723250feaa3e1b7218710cede9ebf4da4dd6eebf68584a805b9647b7d4
 SHA512:
-  metadata.gz: 0f534d77704be9418666e804a2bf1ecfd6c41ae4cee8b0c7f3c7753f2967b88b257e1962f3f8dc9565af09a697f75fb823054f062bffea9a7aabef9d9bae885e
-  data.tar.gz: 18bcdb411c4655bb3f99c8e7557adf7d872c0562fcfeef18700134578dcc9c8e8ecf9992c43c82521eb773aad6d97a95e7f6859d90a36ded25a2ac88e3a2babc
+  metadata.gz: 185f571fd39b4bdce955a455695413390b83c3635236871a83098bd595b184b5a79a2cd2b2778fb1fa795d658566237ed251e751fe1981a71aff192ce22da376
+  data.tar.gz: 19248dd05c973d9657362145826312fd2a07a7f6b4ad6834e623a19f289b35dc4d32c9c16401fc73a7e6309f4fc7ba9a5f63cc82a7db78299b623ea0d3b471f0

data/CHANGELOG.md

@@ -1,5 +1,37 @@
 # Changelog
 
+## [2.7.3] - 2025-01-29
+
+### Added
+
+- Automatic loading of multiple Opts and Vars blocks when opening a document.
+
+### Changed
+
+- Fix text displayed when text is wrapped to the next line.
+- Handle and report failure of single tests.
+
+## [2.7.2] - 2025-01-03
+
+### Added
+
+- Block name comparison in FCB class.
+- Option for automatic shell block per document.
+
+### Changed
+
+- Disable command substitution in comments.
+- Fix the source reported by debug function ww0.
+- Inverse the entire line to highlight the active menu line.
+- Return single file if no globs in load block.
+- Update the calculation and use of IDs for blocks used to retrieve the block selected from the menu.
+
+## [2.7.1] - 2024-12-10
+
+### Changed
+
+- Register console dimensions prior to arguments.
+
 ## [2.7.0] - 2024-12-09
 
 ### Added
@@ -399,7 +431,7 @@ Rename options to match use.
   These blocks can be hidden blocks and required in a script.
 
 - Add a "wrap" fenced code block type to facilitate script generation.
-  See document `examples/wrap.md`.
+  See document `examples/wrapped-blocks.md`.
   These blocks are hidden and can be required by one or more blocks.
 
 ### Changed

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    markdown_exec (2.7.1)
+    markdown_exec (2.7.3)
       clipboard (~> 1.3.6)
       open3 (~> 0.1.1)
       optparse (~> 0.1.1)

data/Rakefile

@@ -74,14 +74,38 @@ task :clean do
   system 'rm *.gem'
 end
 
+def execute_with_error_handling(iterator)
+  all_error_level = 0
+  all_failed_files = []
+  
+  iterator.each do |item|
+    command = yield(item)
+    next unless command # Skip if command is nil
+    
+    result = system(command)
+    error_level = $?.exitstatus
+
+    if error_level != 0
+      puts "Error: Command '#{command}' failed with exit status #{error_level}."
+      all_error_level = error_level
+      all_failed_files << command
+    end
+  end
+
+  if all_error_level != 0
+    puts "Error: #{all_failed_files.join(', ')} failed."
+    exit all_error_level
+  end
+end
+
 desc 'bats'
 task :bats do
-  FileList['bats/**/*.bats'].each do |file|
-    next if %w[bats/bats.bats bats/fail.bats].include?(file)
+  execute_with_error_handling(FileList['bats/**/*.bats']) do |file|
+    next nil if %w[bats/bats.bats bats/fail.bats].include?(file)
 
     # temporary clear WW to disable debugging
     # WW pollutes output expected by BATS tests
-    system "unset WW; bats #{file}"
+    "unset WW; bats #{file}"
   end
 end
 
@@ -118,14 +142,8 @@ task :minitest do
     './lib/dev/process_template.rb --test'
   ]
 
-  commands.each do |command|
-    result = system("bundle exec ruby #{command}")
-    error_level = $?.exitstatus
-
-    if error_level != 0
-      puts "Error: Command '#{command}' failed with exit status #{error_level}."
-      exit error_level
-    end
+  execute_with_error_handling(commands) do |command|
+    "bundle exec ruby #{command}"
   end
 end
 task mini: %i[minitest]

data/bats/block-type-opts.bats

@@ -0,0 +1,23 @@
+#!/usr/bin/env bats
+
+load 'test_helper'
+
+# Type: Opts
+
+@test 'Opts block - before' {
+  skip 'Fails because command executes after the block is processed'
+  spec_mde_xansi_dname_doc_blocks_expect docs/dev/block-type-opts.md \
+   'BEFORE Species_menu_note_format: "AFTER %{line}" '
+}
+
+@test 'Opts block - after' {
+  spec_mde_xansi_dname_doc_blocks_expect docs/dev/block-type-opts.md \
+   '[decorate-note]' \
+   'AFTER Species_menu_note_format: "AFTER %{line}"'
+}
+
+@test 'Opts block - show that menu has changed' {
+  skip 'Unable to show that menu has changed'
+  spec_mde_args_expect docs/dev/block-type-opts.md '[decorate-note]' \
+   'AFTER Species'
+}

data/bats/block-type-vars.bats

@@ -0,0 +1,26 @@
+#!/usr/bin/env bats
+
+load 'test_helper'
+
+# Type: Vars
+
+# includes output from automatic vars blocks
+@test 'Vars block - auto load' {
+  BATS_OUTPUT_FILTER=A
+  spec_mde_args_expect docs/dev/block-type-vars.md show \
+   'Species = Not specified Genus = Not specified  Species: Not specified VAULT:'
+}
+
+# includes output from assignment and from shell block
+@test 'Vars block - set variable' {
+  BATS_OUTPUT_FILTER=A
+  spec_mde_args_expect docs/dev/block-type-vars.md '[set_vault_1]' show \
+   'Species = Not specified Genus = Not specified VAULT = 1  Species: Not specified VAULT: 1'
+}
+
+# handles invalid YAML in block
+@test 'Vars block - invalid YAML' {
+  BATS_OUTPUT_FILTER=A
+  spec_mde_args_expect docs/dev/block-type-vars.md '[invalid_yaml]' show \
+   'Species = Not specified Genus = Not specified  Species: Not specified VAULT:'
+}

data/bats/block-types.bats

@@ -47,26 +47,6 @@ load 'test_helper'
   run_mde_specs_md_args_expect_xansi '[VARIABLE1]' '(echo-VARIABLE1)' ' VARIABLE1: 1   VARIABLE1: 1'
 }
 
-# Type: Opts
-
-@test 'Opts block - before' {
-  skip 'Fails because command executes after the block is processed'
-  spec_mde_xansi_dname_doc_blocks_expect docs/dev/block-type-opts.md \
-   'BEFORE Species_menu_note_format: "AFTER %{line}" '
-}
-
-@test 'Opts block - after' {
-  spec_mde_xansi_dname_doc_blocks_expect docs/dev/block-type-opts.md \
-   '[decorate-note]' \
-   'AFTER Species_menu_note_format: "AFTER %{line}"'
-}
-
-@test 'Opts block - show that menu has changed' {
-  skip 'Unable to show that menu has changed'
-  spec_mde_args_expect docs/dev/block-type-opts.md '[decorate-note]' \
-   'AFTER Species'
-}
-
 # Type: Port
 
 # includes output from assignment and from shell block
@@ -81,19 +61,3 @@ load 'test_helper'
   spec_mde_args_expect docs/dev/block-type-port.md VAULT-is-export show \
    '   VAULT: This variable has not been set.'
 }
-
-# Type: Vars
-
-# includes output from automatic vars block
-@test 'Vars block - auto load' {
-  BATS_OUTPUT_FILTER=A
-  spec_mde_args_expect docs/dev/block-type-vars.md show \
-   'Species = Not specified  Species: Not specified VAULT:'
-}
-
-# includes output from assignment and from shell block
-@test 'Vars block - set variable' {
-  BATS_OUTPUT_FILTER=A
-  spec_mde_args_expect docs/dev/block-type-vars.md '[set_vault_1]' show \
-   'Species = Not specified VAULT = 1  Species: Not specified VAULT: 1'
-}

data/bats/border.bats

@@ -0,0 +1,8 @@
+#!/usr/bin/env bats
+
+load 'test_helper'
+
+@test 'Border - ' {
+  spec_mde_xansi_dname_doc_blocks_expect docs/dev/border.md \
+   'A: 1_  B: 2_'
+}

data/bats/document-shell.bats

@@ -0,0 +1,9 @@
+#!/usr/bin/env bats
+
+load 'test_helper'
+
+@test 'document_shell - required' {
+  spec_mde_xansi_dname_doc_blocks_expect docs/dev/document-shell.md \
+   --dump-inherited-lines t '* Exit' \
+   '  inherited_lines_  - : : from required_  - : : from document_shell'
+}

data/bats/line-wrapping.bats

@@ -0,0 +1,8 @@
+#!/usr/bin/env bats
+
+load 'test_helper'
+
+@test 'Text and Headings' {
+  spec_mde_xansi_dname_doc_blocks_expect docs/dev/line-wrapping.md \
+   "          DEMO WRAPPING LONG LINES__MDE detects the screen's dimensions:_height (lines) and width (characters)__Normal document text is displayed as_disabled menu lines. The width of these_lines is limited according to the screen's_width.__Test Indented Lines__  Indented with two spaces, this line_  should wrap in an aesthetically pleasing_  way.__    Indented with a tab, this line should_    wrap in an aesthetically pleasing way.__  SPECIES GENUS FAMILY ORDER CLASS PHYLUM_               KINGDOM DOMAIN_species genus family order class phylum_kingdom domain"
+}

data/bin/tab_completion.sh

@@ -13,7 +13,7 @@ __filedirs_all()
 }
 
 _mde_echo_version() {
-  echo "2.7.1"
+  echo "2.7.3"
 }
 
 _mde() {

data/docs/dev/block-type-opts.md

@@ -6,6 +6,9 @@ menu_note_format: "AFTER %{line}"
 ```opts :(document_opts)
 menu_final_divider:
 menu_for_saved_lines: false
+```
+/ Demonstrate multiple (document_opts) in a single file
+```opts :(document_opts)
 menu_initial_divider:
 menu_note_format: "BEFORE %{line}"
-```
+```

data/docs/dev/block-type-vars.md

@@ -1,11 +1,22 @@
+```vars :(document_vars)
+Species: Not specified
+```
+```vars :(document_vars)
+Genus: Not specified
+```
 ```vars :[set_vault_1]
 VAULT: 1
 ```
+```vars :[invalid_yaml]
+this is not yaml
+```
 ```bash :show
 echo "Species: $Species"
 echo "VAULT: $VAULT"
 ```
-@import bats-document-configuration.md
-```vars :(document_vars)
-Species: Not specified
-```
+| Variable| Value
+| -| -
+| Species| ${Species}
+| Genus| ${Genus}
+| VAULT| ${VAULT}
+@import bats-document-configuration.md

data/docs/dev/border.md

@@ -0,0 +1,7 @@
+```vars
+A: 1
+B: 2
+```
+@import bats-document-configuration.md
+```opts :(document_opts)
+```

data/docs/dev/command-substitution.md

@@ -11,6 +11,7 @@ echo "current base name is now $(basename `pwd`)"
 ```link
 load: file_$(basename `pwd`).sh
 ```
+/ This should not be evaluated $(err). It errs with "Error: HashDelegator.blocks_from_nested_files -- Shell script execution failed: /bin/bash: line 2: err: command not found"
 @import bats-document-configuration.md
 ```opts :(document_opts)
 heading1_center: false

data/docs/dev/document-shell.md

@@ -0,0 +1,6 @@
+```bash :(required)
+: from required
+```
+```bash :(document_shell) +(required)
+: from document_shell
+```

data/docs/dev/line-wrapping.md

@@ -0,0 +1,24 @@
+# Demo wrapping long lines
+
+MDE detects the screen's dimensions: height (lines) and width (characters)
+
+Normal document text is displayed as disabled menu lines. The width of these lines is limited according to the screen's width.
+
+::: Test Indented Lines
+
+  Indented with two spaces, this line should wrap in an aesthetically pleasing way.
+
+	Indented with a tab, this line should wrap in an aesthetically pleasing way.
+
+# species genus family order class phylum kingdom domain
+## species genus family order class phylum kingdom domain
+@import bats-document-configuration.md
+```opts :(document_opts)
+divider4_center: false
+heading1_center: true
+heading2_center: false
+screen_width: 48
+
+menu_note_match: "^(?<indent>[ \t]*)(?<line>(?!/)(?<text>.*?)(?<trailing>[ \t]*))?$"
+
+```

data/examples/link-blocks-vars.md

@@ -1,59 +1,87 @@
-# Demonstrate link blocks set variables
-@import example-document-opts.md
-```opts :(document_opts)
-execute_in_own_window: false
-menu_with_inherited_lines: true
-output_execution_report: false
-output_execution_summary: false
-pause_after_script_execution: true
+# Demonstrate Setting Variables in the Inherited Lines
+
+```link :select-a-folder +(select-a-folder)
+eval: true
+```
+```bash :(select-a-folder)
+echo "PT=$(osascript -e 'do shell script "echo " & quoted form of POSIX path of (choose folder with prompt "Please select a folder:")' 2>/dev/null)"
 ```
 
-## Demonstrate a link block that sets a variable
-::: Select below to trigger. If it prints "VARIABLE1: 1", the Link block was processed.
+This table displays the value of variables in the context of the current inherited lines. At first, the variable is empty unless it exists in the current shell environment.
 
 | Variable| Value
 | -| -
-| VARIABLE1| ${VARIABLE1}
+| SPECIES| ${SPECIES}
+
+## Current Inherited Lines
+
+```view
+View the current inherited lines.
+```
+
+The inherited lines can also be displayed automatically within the menu by enabling this option:
+
+```opts
+menu_with_inherited_lines: true
+```
+
+## Setting Variables in the Inherited Lines
+
+You can set environment variables in the inherited lines by adding shell expressions. For example, a line such as `SPECIES=Unknown` in the inherited lines defines a variable that can be used in the rest of the executed script.
+
+Below are several ways to add such expressions to the inherited lines:
+
+### Vars Block
+
+This block (YAML) adds a variable and its value to the inherited lines:
+
+```vars
+SPECIES: Tapanuli Orangutan
+```
+
+### Link Block
+
+This block (YAML) also adds a variable and its value to the inherited lines:
 
-The block sets VARIABLE1.
-For each environment variable in `vars`, append an inherited line that assigns the variable the specified value.
     ```link
     vars:
-      VARIABLE1: 1
+      SPECIES: Psychedelic Frogfish
     ```
 
-## Demonstrate a link block that requires a shell block that sets a variable
-This block "[bash_set_to_3]" is required below. It sets the variable "ALPHA".
-    ```bash :[bash_set_to_3]
-    ALPHA=3
-    ```
-::: Select below to trigger. If it prints "ALPHA: 3", the Link block was processed.
-These blocks require the *code* of the named shell block.
-    ```link +[bash_set_to_3]
-    block: "(display_variable_ALPHA)"
-    ```
-    ```link +[bash_set_to_3]
-    next_block: "(display_variable_ALPHA)"
-    ```
+### Link+Bash Blocks
 
-This block "[bash_set_to_4]" is required below. It prints a command that sets the variable "ALPHA".
-    ```bash :[bash_set_to_4]
-    echo "ALPHA=4"
-    ```
-::: Select below to trigger. If it prints "ALPHA: 4", the Link block was processed.
-These blocks require the *output* of the execution of the code in the named shell block.
-    ```link +[bash_set_to_4]
-    eval: true
-    block: "(display_variable_ALPHA)"
+::: Adding Code to the Inherited Lines
+
+This Link block (YAML) appends the Bash code defined in the referenced block to the inherited lines:
+
+    ```link :add-bash-code +[bash_species]
     ```
-    ```link +[bash_set_to_4]
+        ```bash :[bash_species] @disable
+        SPECIES='Ruby Seadragon'
+        ```
+
+If necessary to extract environment variable values displayed in the menu, inherited lines are executed every time the menu displayed. Therefore, do add code that has unwanted side effects when executed multiple times.
+
+::: Adding Evaluated Code Output to the Inherited Lines
+
+This Link block (YAML) appends the output of the Bash code to the inherited lines. The Bash code is executed first to generate the output:
+
+    ```link :add-evaluated-bash-code +[bash_species_code]
     eval: true
-    next_block: "(display_variable_ALPHA)"
     ```
+        ```bash :[bash_species_code] @disable
+        echo "SPECIES='Illacme tobini (Millipede)'"
+        ```
 
 | Variable| Value
 | -| -
-| ALPHA| ${ALPHA}
+| SPECIES| ${SPECIES}
 
-```bash :(display_variable_ALPHA)
-```
+@import example-document-opts.md
+```opts :(document_opts)
+execute_in_own_window: false
+menu_with_inherited_lines: false
+output_execution_report: false
+output_execution_summary: false
+pause_after_script_execution: true
+```

data/lib/colorize.rb

@@ -13,23 +13,15 @@ class String
   # @return [String] The formatted string.
   def method_missing(method_name, *args, &block)
     case method_name.to_s
-    # when /^bg_rgb_/
-    #   bytes = $'.split('_')
-    #   bg_rgb_color(bytes[0..2].join(';'))
     when /^fg_bg_rgb_/
-      pp [__LINE__, caller[0]]; binding.irb
       bytes = $'.split('_')
       fg_bg_rgb_color(bytes[0..2].join(';'), bytes[3..5].join(';'))
     when /^fg_bg_rgbh_/
-      pp [__LINE__, caller[0]]; binding.irb
       hex_to_fg_bg_rgb($')
     when /^fg_rgb_/
-      pp [__LINE__, caller[0]]; binding.irb
       fg_rgb_color($'.gsub('_', ';'))
     when /^fg_rgbh_/
-      pp [__LINE__, caller[0]]; binding.irb
       hex_to_rgb($')
-
     when 'to_a', 'to_ary', 'to_hash', 'to_int', 'to_io', 'to_regexp'
       nil
     else
@@ -41,24 +33,14 @@ class String
   #
   # @return [String] The string wrapped in an ANSI control sequence.
   def ansi_control_sequence
-    pp [__LINE__, caller[0]]; binding.irb
     "\033[#{self}\033[0m"
   end
 
-  # # Applies a 24-bit RGB background color to the string.
-  # #
-  # # @param rgb [String] The RGB color, expressed as a string like "1;2;3".
-  # # @return [String] The string with the applied RGB foreground color.
-  # def bg_rgb_color(rgb)
-  #   "48;2;#{rgb}m#{self}".ansi_control_sequence
-  # end
-
   # Applies a 24-bit RGB foreground color to the string.
   #
   # @param rgb [String] The RGB color, expressed as a string like "1;2;3".
   # @return [String] The string with the applied RGB foreground color.
   def fg_bg_rgb_color(fg_rgb, bg_rgb)
-    pp [__LINE__, caller[0]]; binding.irb
     "38;2;#{fg_rgb}m\033[48;2;#{bg_rgb}m#{self}".ansi_control_sequence
   end
 
@@ -67,7 +49,6 @@ class String
   # @param rgb [String] The RGB color, expressed as a string like "1;2;3".
   # @return [String] The string with the applied RGB foreground color.
   def fg_rgb_color(rgb)
-    pp [__LINE__, caller[0]]; binding.irb
     "38;2;#{rgb}m#{self}".ansi_control_sequence
   end
 
@@ -76,7 +57,6 @@ class String
   # @param hex_str [String] The RGB color, expressed as a hex string like "FF00FF".
   # @return [String] The string with the applied RGB foreground color.
   def hex_to_fg_bg_rgb(hex_str)
-    pp [__LINE__, caller[0]]; binding.irb
     values = hex_str.split('_').map { |hex| hex.to_i(16).to_s }
     fg_bg_rgb_color(
       values[0..2].join(';'),
@@ -89,7 +69,6 @@ class String
   # @param hex_str [String] The RGB color, expressed as a hex string like "FF00FF".
   # @return [String] The string with the applied RGB foreground color.
   def hex_to_rgb(hex_str)
-    pp [__LINE__, caller[0]]; binding.irb
     fg_rgb_color(
       hex_str.split('_').map { |hex| hex.to_i(16).to_s }.join(';')
     )
@@ -99,7 +78,6 @@ class String
   #
   # @return [String] The original string.
   def plain
-    pp [__LINE__, caller[0]]; binding.irb
     self
   end
 
@@ -126,20 +104,16 @@ class String
   def violet;  fg_rgbh_94_00_D3; end
   def yellow;  fg_rgbh_FF_FF_00; end
 
-  def x
-    pp [__LINE__, caller[1]]; binding.irb
-  end
-
   # graphics modes
-  def bold;             x; "\033[1m#{self}\033[22m"; end
-  def bold_italic;      x; "\033[1m\033[3m#{self}\033[22m\033[23m"; end
-  def bold_underline;   x; "\033[1m\033[4m#{self}\033[22m\033[24m"; end
-  def dim;              x; "\033[2m#{self}\033[22m"; end
-  def italic;           x; "\033[3m#{self}\033[23m"; end
-  def underline;        x; "\033[4m#{self}\033[24m"; end
-  def underline_italic; x; "\033[4m\033[3m#{self}\033[23m\033[24m"; end
-  def blinking;         x; "\033[5m#{self}\033[25m"; end
-  def inverse;          x; "\033[7m#{self}\033[27m"; end
-  def hidden;           x; "\033[8m#{self}\033[28m"; end
-  def strikethrough;    x; "\033[9m#{self}\033[29m"; end
+  def bold;             "\033[1m#{self}\033[22m"; end
+  def bold_italic;      "\033[1m\033[3m#{self}\033[22m\033[23m"; end
+  def bold_underline;   "\033[1m\033[4m#{self}\033[22m\033[24m"; end
+  def dim;              "\033[2m#{self}\033[22m"; end
+  def italic;           "\033[3m#{self}\033[23m"; end
+  def underline;        "\033[4m#{self}\033[24m"; end
+  def underline_italic; "\033[4m\033[3m#{self}\033[23m\033[24m"; end
+  def blinking;         "\033[5m#{self}\033[25m"; end
+  def inverse;          "\033[7m#{self}\033[27m"; end
+  def hidden;           "\033[8m#{self}\033[28m"; end
+  def strikethrough;    "\033[9m#{self}\033[29m"; end
 end

data/lib/fcb.rb

@@ -35,6 +35,14 @@ module MarkdownExec
       }.merge(options)
     end
 
+    def code_name_included?(*names)
+      names.include?(@attrs[:oname])
+    end
+
+    def code_name_exp?(regexp)
+      Regexp.new(regexp) =~ @attrs[:oname]
+    end
+
     # Derives a title from the body of an FCB object.
     # @param fcb [Object] The FCB object whose title is to be derived.
     # @return [String] The derived title.
@@ -152,23 +160,27 @@ module MarkdownExec
       @attrs.to_yaml
     end
 
-    # Expand variables in `dname` and `body` attributes
+    # Expand variables in attributes
+    ####
     def expand_variables_in_attributes!(pattern, replacements)
-      ### update name, nickname, title, label ???
-
-      # Replace variables in `dname` using the replacements dictionary
+      @attrs[:raw_dname] ||= @attrs[:dname]
       @attrs[:dname] = @attrs[:dname]&.gsub(pattern) do |match|
         replacements[match]
       end
+
+      @attrs[:raw_s0printable] ||= @attrs[:s0printable]
       @attrs[:s0printable] = @attrs[:s0printable]&.gsub(pattern) do |match|
         replacements[match]
       end
+
+      @attrs[:raw_s1decorated] ||= @attrs[:s1decorated]
       @attrs[:s1decorated] = @attrs[:s1decorated]&.gsub(pattern) do |match|
         replacements[match]
       end
 
       # Replace variables in each line of `body` if `body` is present
       if @attrs[:body]
+        @attrs[:raw_body] ||= @attrs[:body]
         @attrs[:body] = @attrs[:body]&.map do |line|
           if line.empty?
             line