markdown_exec 2.1.0 → 2.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f49177c09809e5635f448181166f2fe60dffe9b942f1c23eeb29b2ecd43b55a8
-  data.tar.gz: 43488e384c44c757e1c7b95ad68e755a60a5bd617f3532c4e3213604984097e5
+  metadata.gz: 32532369e9eec3574b8bff6d6c79097f547e120c7b113c10a765364e20a311a4
+  data.tar.gz: 3773bab7197401361c06bace1921663679bbf53d77f2cbe5daa1c2975c091e87
 SHA512:
-  metadata.gz: 9c923456c84259f80f53a839d48d4ed54c91f3bdc3ddb06fb96a1014b79a4640f21eed0bdb1f58635869fa70a5fb786259745a6e2a46cba2780a0093b81bc3e9
-  data.tar.gz: fbccdda04147b4a9ac0c9dd31bff501a626c60112fd70d0554aa89d2e005494e755abc0f63714c417e25461da23de3a960478cc1dd65fef9c126e927b6bbf037
+  metadata.gz: e6ad41fdae333916ef13870498b6b1b9be7338af8ae39238b4a16a475b42430cb9282c59dbcecd124f422ab218848a70611ce6120e03074660a213a89e054df1
+  data.tar.gz: f9ef27a86c8a7cb4e15b4eb59705d1fdad6a15b8c6af176978b09f1108599569e0f74423b89c1baaa2cfaed249a4ff37fb18c8e7c6c87220d0ecb48a5e4cdd45

data/.rubocop.yml

@@ -14,8 +14,9 @@ Layout/LineContinuationLeadingSpace:
   Enabled: false
 
 Layout/LineLength:  # 2024-01-21 temp disable
-  Enabled: false
-  # Max: 96
+  # Enabled: false
+  # Max: 80
+  Max: 96
   # Max: 120
 
 Lint/Debugger:

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [2.2.0] - 2024-07-27
+
+### Added
+
+- Options to list recent saved assets.
+- Short name for execute-in-own-window option.
+- Short name for load-code option.
+
+### Changed
+
+- Improve handling of variations of block names.
+- Remove functions to select recent saved assets.
+
 ## [2.1.0] - 2024-07-15
 
 ### Added
@@ -555,7 +568,7 @@ Most options can be configured in multiple ways. In order of use (earliest super
 2. the configuration file `.mde.yml` in the current folder
 3. command line arguments
 
-#### Representing boolean values
+### Representing boolean values
 
 Boolean values for options are specified as strings and interpreted as:
 | Value | Boolean |

data/Gemfile

@@ -9,7 +9,7 @@ gemspec
 gem 'clipboard'
 gem 'debug'
 gem 'erb'
-gem 'irb', '>= 1.8.0'
+gem 'irb'
 gem 'mocha', require: false
 gem 'minitest', require: false
 gem 'pry-nav'
@@ -23,5 +23,5 @@ gem 'rubocop-minitest', require: false
 gem 'rubocop-rake', require: false
 gem 'rubocop-rspec', require: false
 gem 'shellwords'
-gem 'uri', '0.12.2'
-gem 'yaml', '~> 0.2.1'
+gem 'uri'
+gem 'yaml'

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    markdown_exec (2.1.0)
+    markdown_exec (2.2.0)
       clipboard (~> 1.3.6)
       open3 (~> 0.1.1)
       optparse (~> 0.1.1)
@@ -11,64 +11,102 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
-    actionpack (7.0.8)
-      actionview (= 7.0.8)
-      activesupport (= 7.0.8)
-      rack (~> 2.0, >= 2.2.4)
+    actionpack (7.1.3.4)
+      actionview (= 7.1.3.4)
+      activesupport (= 7.1.3.4)
+      nokogiri (>= 1.8.5)
+      racc
+      rack (>= 2.2.4)
+      rack-session (>= 1.0.1)
       rack-test (>= 0.6.3)
-      rails-dom-testing (~> 2.0)
-      rails-html-sanitizer (~> 1.0, >= 1.2.0)
-    actionview (7.0.8)
-      activesupport (= 7.0.8)
+      rails-dom-testing (~> 2.2)
+      rails-html-sanitizer (~> 1.6)
+    actionview (7.1.3.4)
+      activesupport (= 7.1.3.4)
       builder (~> 3.1)
-      erubi (~> 1.4)
-      rails-dom-testing (~> 2.0)
-      rails-html-sanitizer (~> 1.1, >= 1.2.0)
-    activesupport (7.0.8)
+      erubi (~> 1.11)
+      rails-dom-testing (~> 2.2)
+      rails-html-sanitizer (~> 1.6)
+    activesupport (7.1.3.4)
+      base64
+      bigdecimal
       concurrent-ruby (~> 1.0, >= 1.0.2)
+      connection_pool (>= 2.2.5)
+      drb
       i18n (>= 1.6, < 2)
       minitest (>= 5.1)
+      mutex_m
       tzinfo (~> 2.0)
     ast (2.4.2)
-    base64 (0.1.1)
-    binding_of_caller (1.0.0)
-      debug_inspector (>= 0.0.1)
-    builder (3.2.4)
-    cgi (0.3.6)
+    base64 (0.2.0)
+    bigdecimal (3.1.8)
+    binding_of_caller (1.0.1)
+      debug_inspector (>= 1.2.0)
+    builder (3.3.0)
+    cgi (0.4.1)
     clipboard (1.3.6)
     coderay (1.1.3)
-    concurrent-ruby (1.2.2)
+    concurrent-ruby (1.3.3)
+    connection_pool (2.4.1)
     crass (1.0.6)
-    debug (1.9.0)
+    debug (1.9.2)
       irb (~> 1.10)
       reline (>= 0.3.8)
-    debug_inspector (1.1.0)
-    diff-lcs (1.5.0)
-    erb (4.0.3)
+    debug_inspector (1.2.0)
+    diff-lcs (1.5.1)
+    drb (2.2.1)
+    dry-configurable (1.2.0)
+      dry-core (~> 1.0, < 2)
+      zeitwerk (~> 2.6)
+    dry-core (1.0.1)
+      concurrent-ruby (~> 1.0)
+      zeitwerk (~> 2.6)
+    dry-inflector (1.1.0)
+    dry-initializer (3.1.1)
+    dry-logic (1.5.0)
+      concurrent-ruby (~> 1.0)
+      dry-core (~> 1.0, < 2)
+      zeitwerk (~> 2.6)
+    dry-schema (1.13.4)
+      concurrent-ruby (~> 1.0)
+      dry-configurable (~> 1.0, >= 1.0.1)
+      dry-core (~> 1.0, < 2)
+      dry-initializer (~> 3.0)
+      dry-logic (>= 1.4, < 2)
+      dry-types (>= 1.7, < 2)
+      zeitwerk (~> 2.6)
+    dry-types (1.7.2)
+      bigdecimal (~> 3.0)
+      concurrent-ruby (~> 1.0)
+      dry-core (~> 1.0)
+      dry-inflector (~> 1.0)
+      dry-logic (~> 1.4)
+      zeitwerk (~> 2.6)
+    erb (4.0.4)
       cgi (>= 0.3.3)
-    erubi (1.12.0)
-    i18n (1.14.1)
+    erubi (1.13.0)
+    i18n (1.14.5)
       concurrent-ruby (~> 1.0)
-    io-console (0.7.1)
-    irb (1.10.1)
-      rdoc
-      reline (>= 0.3.8)
-    json (2.6.3)
-    kwalify (0.7.2)
+    io-console (0.7.2)
+    irb (1.14.0)
+      rdoc (>= 4.0.0)
+      reline (>= 0.4.2)
+    json (2.7.2)
     language_server-protocol (3.17.0.3)
-    loofah (2.21.3)
+    loofah (2.22.0)
       crass (~> 1.0.2)
       nokogiri (>= 1.12.0)
-    method_source (1.0.0)
-    minitest (5.20.0)
-    mocha (2.1.0)
+    method_source (1.1.0)
+    minitest (5.24.1)
+    mocha (2.4.5)
       ruby2_keywords (>= 0.0.5)
-    nokogiri (1.15.4-arm64-darwin)
+    mutex_m (0.2.0)
+    nokogiri (1.16.6-arm64-darwin)
       racc (~> 1.4)
     open3 (0.1.2)
     optparse (0.1.1)
-    parallel (1.23.0)
-    parser (3.2.2.3)
+    parallel (1.25.1)
+    parser (3.3.4.0)
       ast (~> 2.4.1)
       racc
     pastel (0.8.0)
@@ -81,12 +119,17 @@ GEM
     pry-stack_explorer (0.6.1)
       binding_of_caller (~> 1.0)
       pry (~> 0.13)
-    psych (5.1.1.1)
+    psych (5.1.2)
       stringio
-    racc (1.7.1)
-    rack (2.2.8)
+    racc (1.8.0)
+    rack (3.1.7)
+    rack-session (2.0.0)
+      rack (>= 3.0.0)
     rack-test (2.1.0)
       rack (>= 1.3)
+    rackup (2.1.0)
+      rack (>= 3)
+      webrick (~> 1.8)
     rails-dom-testing (2.2.0)
       activesupport (>= 5.0.0)
       minitest
@@ -94,69 +137,67 @@ GEM
     rails-html-sanitizer (1.6.0)
       loofah (~> 2.21)
       nokogiri (~> 1.14)
-    railties (7.0.8)
-      actionpack (= 7.0.8)
-      activesupport (= 7.0.8)
-      method_source
+    railties (7.1.3.4)
+      actionpack (= 7.1.3.4)
+      activesupport (= 7.1.3.4)
+      irb
+      rackup (>= 1.0.0)
       rake (>= 12.2)
-      thor (~> 1.0)
-      zeitwerk (~> 2.5)
+      thor (~> 1.0, >= 1.2.2)
+      zeitwerk (~> 2.6)
     rainbow (3.1.1)
-    rake (13.0.6)
-    rdoc (6.6.2)
+    rake (13.2.1)
+    rdoc (6.7.0)
       psych (>= 4.0.0)
-    reek (6.1.4)
-      kwalify (~> 0.7.0)
-      parser (~> 3.2.0)
+    reek (6.3.0)
+      dry-schema (~> 1.13.0)
+      parser (~> 3.3.0)
       rainbow (>= 2.0, < 4.0)
-    regexp_parser (2.8.1)
-    reline (0.4.1)
+      rexml (~> 3.1)
+    regexp_parser (2.9.2)
+    reline (0.5.9)
       io-console (~> 0.5)
-    rexml (3.2.6)
-    rspec (3.12.0)
-      rspec-core (~> 3.12.0)
-      rspec-expectations (~> 3.12.0)
-      rspec-mocks (~> 3.12.0)
-    rspec-core (3.12.2)
-      rspec-support (~> 3.12.0)
-    rspec-expectations (3.12.3)
+    rexml (3.3.2)
+      strscan
+    rspec (3.13.0)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.0)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.1)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.12.0)
-    rspec-mocks (3.12.6)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.1)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.12.0)
-    rspec-support (3.12.1)
-    rubocop (1.56.4)
-      base64 (~> 0.1.1)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.1)
+    rubocop (1.65.0)
       json (~> 2.3)
       language_server-protocol (>= 3.17.0)
       parallel (~> 1.10)
-      parser (>= 3.2.2.3)
+      parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
-      regexp_parser (>= 1.8, < 3.0)
+      regexp_parser (>= 2.4, < 3.0)
       rexml (>= 3.2.5, < 4.0)
-      rubocop-ast (>= 1.28.1, < 2.0)
+      rubocop-ast (>= 1.31.1, < 2.0)
       ruby-progressbar (~> 1.7)
       unicode-display_width (>= 2.4.0, < 3.0)
-    rubocop-ast (1.29.0)
-      parser (>= 3.2.1.0)
-    rubocop-capybara (2.19.0)
-      rubocop (~> 1.41)
-    rubocop-factory_bot (2.24.0)
-      rubocop (~> 1.33)
-    rubocop-minitest (0.32.2)
-      rubocop (>= 1.39, < 2.0)
+    rubocop-ast (1.31.3)
+      parser (>= 3.3.1.0)
+    rubocop-minitest (0.35.1)
+      rubocop (>= 1.61, < 2.0)
+      rubocop-ast (>= 1.31.1, < 2.0)
     rubocop-rake (0.6.0)
       rubocop (~> 1.0)
-    rubocop-rspec (2.24.1)
-      rubocop (~> 1.33)
-      rubocop-capybara (~> 2.17)
-      rubocop-factory_bot (~> 2.22)
+    rubocop-rspec (3.0.3)
+      rubocop (~> 1.61)
     ruby-progressbar (1.13.0)
     ruby2_keywords (0.0.5)
-    shellwords (0.1.0)
-    stringio (3.1.0)
-    thor (1.2.2)
+    shellwords (0.2.0)
+    stringio (3.1.1)
+    strscan (3.1.0)
+    thor (1.3.1)
     tty-color (0.6.0)
     tty-cursor (0.7.1)
     tty-prompt (0.23.1)
@@ -166,14 +207,15 @@ GEM
       tty-cursor (~> 0.7)
       tty-screen (~> 0.8)
       wisper (~> 2.0)
-    tty-screen (0.8.1)
+    tty-screen (0.8.2)
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
     unicode-display_width (2.5.0)
-    uri (0.12.2)
+    uri (0.13.0)
+    webrick (1.8.1)
     wisper (2.0.1)
     yaml (0.2.1)
-    zeitwerk (2.6.12)
+    zeitwerk (2.6.16)
 
 PLATFORMS
   arm64-darwin-21
@@ -182,7 +224,7 @@ DEPENDENCIES
   clipboard
   debug
   erb
-  irb (>= 1.8.0)
+  irb
   markdown_exec!
   minitest
   mocha
@@ -197,8 +239,8 @@ DEPENDENCIES
   rubocop-rake
   rubocop-rspec
   shellwords
-  uri (= 0.12.2)
-  yaml (~> 0.2.1)
+  uri
+  yaml
 
 BUNDLED WITH
    2.4.13

data/README.md

@@ -41,65 +41,65 @@ Install:
 
 ### Help
 
-#### `mde --help`
+::: `mde --help`
 
 Displays help information.
 
 ### Basic
 
-#### `mde`
+::: `mde`
 
 Process `README.md` file in the current folder. Displays all the blocks in the file and allows you to select using [up], [down], and [return].
 
-#### `mde my.md` or `mde -f my.md`
+::: `mde my.md` or `mde -f my.md`
 
 Select a block to execute from `my.md`.
 
-#### `mde my.md myblock`
+::: `mde my.md myblock`
 
 Execute the block named `myblock` from `my.md`.
 
-#### `mde .` or `mde -p .`
+::: `mde .` or `mde -p .`
 
 Select a markdown file in the current folder. Select a block to execute from that file.
 
 ### Report documents and blocks
 
-#### `mde --list-blocks`
+::: `mde --list-blocks`
 
 List all blocks in the all the markdown documents in the current folder.
 
-#### `mde --list-docs`
+::: `mde --list-docs`
 
 List all markdown documents in the current folder.
 
 ### Configuration
 
-#### `mde --list-default-env` or `mde --list-default-yaml`
+::: `mde --list-default-env` or `mde --list-default-yaml`
 
 List default values that can be set in configuration file, environment, and command line.
 
-#### `mde -0`
+::: `mde -0`
 
 Show current configuation values that will be applied to the current run. Does not interrupt processing.
 
 ### Save scripts
 
-#### `mde --save-executed-script 1`
+::: `mde --save-executed-script 1`
 
 Save executed script in saved script folder.
 
-#### `mde --list-recent-scripts`
+::: `mde --list-recent-scripts`
 
 List recent saved scripts in saved script folder.
 
-#### `mde --select-recent-script`
+::: `mde --select-recent-script`
 
 Select and execute a recently saved script in saved script folder.
 
 ### Save output
 
-#### `mde --save-execution-output 1`
+::: `mde --save-execution-output 1`
 
 Save execution output in saved output folder.
 

data/bin/tab_completion.sh

@@ -13,7 +13,7 @@ __filedirs_all()
 }
 
 _mde_echo_version() {
-  echo "2.1.0"
+  echo "2.2.0"
 }
 
 _mde() {
@@ -50,6 +50,10 @@ _mde() {
             
               --dump-selected-block) COMPREPLY="0"; return 0 ;;
             
+              --execute_in_own_window) COMPREPLY="0"; return 0 ;;
+            
+              -w) COMPREPLY="0"; return 0 ;;
+            
               --filename) COMPREPLY="."; return 0 ;;
             
               -f) COMPREPLY="."; return 0 ;;
@@ -68,6 +72,8 @@ _mde() {
             
               --load-code) COMPREPLY="''"; return 0 ;;
             
+              -l) COMPREPLY="''"; return 0 ;;
+            
               --open) COMPREPLY="''"; return 0 ;;
             
               -o) COMPREPLY="''"; return 0 ;;
@@ -94,7 +100,7 @@ _mde() {
   # present matching option names
   #
   if [[ ${cur} == -* ]] ; then
-    opts=("--block-name" "--config" "--debug" "--dump-delegate-object" "--dump-blocks-in-file" "--dump-inherited-block_names" "--dump-inherited-dependencies" "--dump-inherited-lines" "--dump-menu-blocks" "--dump-selected-block" "--exit" "--filename" "--find" "--find-path" "--help" "--how" "--list-blocks" "--list-count" "--list-default-env" "--list-default-yaml" "--list-docs" "--list-recent-output" "--list-recent-scripts" "--load-code" "--open" "--output-script" "--output-stdout" "--path" "--pwd" "--run-last-script" "--select-recent-output" "--select-recent-script" "--tab-completions" "--user-must-approve" "--version" "--display-level")
+    opts=("--block-name" "--config" "--debug" "--dump-delegate-object" "--dump-blocks-in-file" "--dump-inherited-block_names" "--dump-inherited-dependencies" "--dump-inherited-lines" "--dump-menu-blocks" "--dump-selected-block" "--execute_in_own_window" "--exit" "--filename" "--find" "--find-path" "--help" "--how" "--list-blocks" "--list-count" "--list-default-env" "--list-default-yaml" "--list-docs" "--list-recent-output" "--list-recent-scripts" "--load-code" "--open" "--output-script" "--output-stdout" "--path" "--pwd" "--run-last-script" "--tab-completions" "--user-must-approve" "--version" "--display-level")
     COMPREPLY=( $(compgen -W "$(printf "'%s' " "${opts[@]}")" -- "${cur}") )
 
     return 0
@@ -131,6 +137,10 @@ _mde() {
         
           --dump-selected-block) COMPREPLY=".BOOL."; return 0 ;;
         
+          --execute_in_own_window) COMPREPLY=".BOOL."; return 0 ;;
+        
+          -w) COMPREPLY=".BOOL."; return 0 ;;
+        
           --filename) COMPREPLY=".RELATIVE_PATH."; return 0 ;;
         
           -f) COMPREPLY=".RELATIVE_PATH."; return 0 ;;
@@ -149,6 +159,8 @@ _mde() {
         
           --load-code) COMPREPLY=".PATH."; return 0 ;;
         
+          -l) COMPREPLY=".PATH."; return 0 ;;
+        
           --open) COMPREPLY=".OPEN."; return 0 ;;
         
           -o) COMPREPLY=".OPEN."; return 0 ;;
@@ -178,4 +190,3 @@ _mde() {
 
 complete -o filenames -o nospace -F _mde mde
 # _mde_echo_version
-# echo "Updated: 2024-07-16 20:54:59 UTC"

data/bin/tab_completion.sh.erb

@@ -105,4 +105,3 @@ _mde() {
 
 complete -o filenames -o nospace -F _mde mde
 # _mde_echo_version
-# echo "Updated: <%= Time.now.utc %>"

data/examples/bash-blocks.md

@@ -0,0 +1,58 @@
+# Demonstrate requiring shell blocks
+## Requiring a named block
+::: Click below to trigger. If it prints "species", "genus", the required block was processed.
+The un-named block prints "species" and requires block "genus".
+    ```bash +genus
+    echo "species"
+    ```
+::: Click below to trigger. If it prints "genus", the block was processed.
+The named block prints "genus".
+    ```bash :genus
+    echo "genus"
+    ```
+
+## Requiring a block with a nickname and a hidden block
+::: Click below to trigger. If it prints "family", "order", "class" the required blocks were processed.
+The named block prints "family" and requires blocks "[order]" and "(class)".
+    ```bash :family +[order] +(class)
+    echo "family"
+    ```
+The nick-named block "[order]" is required above. It prints "order".
+    ```bash :[order]
+    echo "order"
+    ```
+The hidden block "(class)" is required above. It prints "class".
+    ```bash :(class)
+    echo "class"
+    ```
+
+## Requiring a before-and-after block pair
+The hidden block "{phylum-domain}", prints "phylum".
+    ```bash :{phylum-domain}
+    echo "phylum"
+    ```
+The hidden block "{phylum-domain-after}", prints "domain".
+    ```bash :{phylum-domain-after}
+    echo "domain"
+    ```
+The hidden block "(biology)" prints "biology".
+    ```bash :(biology)
+    echo "biology"
+    ```
+::: Click below to trigger. If it prints "biology", "phylum", "kingdom", "domain", and "taxonomy" the required blocks were processed.
+The named block prints "kingdom" and requires blocks wrapper blocks "{phylum-domain}" and "{phylum-domain-after}".
+Notice the wrapper blocks are exclusive to the single block with the requirement.
+    ```bash :kingdom +{phylum-domain} +(biology) +(taxonomy)
+    echo "kingdom"
+    ```
+The hidden block "(taxonomy)" prints "taxonomy".
+    ```bash :(taxonomy)
+    echo "taxonomy"
+    ```
+
+```opts :(document_options)
+execute_in_own_window: false
+output_execution_report: false
+output_execution_summary: false
+pause_after_script_execution: true
+```

data/examples/block-names.md

@@ -0,0 +1,27 @@
+## Demonstrate handling of special characters in block names
+The hidden block "(success)" is required below. It prints "Success".
+```bash :(success)
+echo "Success"
+```
+Block names with all chars.
+/ UTF-8
+/   !"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~
+/   ¡¢£¤¥¦§¨©ª«¬®¯°±²³´µ¶·¸¹º»¼½¾¿ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖ×ØÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõö÷øùúûüýþÿ
+::: Click below to trigger. If it prints "Success", the Link block was processed.
+This block name uses the printable characters in the first 128 values. It is executable.
+    ```link :!"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~
+    block: (success)
+    ```
+This block name uses the printable characters in the second 128 values. It is executable.
+    ```link :¡¢£¤¥¦§¨©ª«¬®¯°±²³´µ¶·¸¹º»¼½¾¿ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖ×ØÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõö÷øùúûüýþÿ
+    block: (success)
+    ```
+
+## Block formatting
+The un-named block should display correctly.
+    ```link
+    file: examples/linked2.md
+    block: show_vars
+    vars:
+      page2_var_via_environment: for_page2_from_page1_via_current_environment
+    ```