markdown_exec 3.3.0 → 3.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a1b653c2db50fe8b7a8de3ea448a49d814b0210fd90090f06b829f30465dc313
-  data.tar.gz: e48016ab6903bf7967c575fa5f3c84893bf2ffb7e35b5b00788a59b5de2257e5
+  metadata.gz: 4a4c6bcbb464222e907cb93cc549ef294d45b83f0f8be5e88e603b87c64eb7a4
+  data.tar.gz: dfce2b71eb6c954e3d438b6036b6543da7bcfe63178ca56971ddb198f49852db
 SHA512:
-  metadata.gz: 8e34466abddbda4228bb45d6bfb75e18e3bf4f9fc664a38eaa89aed3d93aceb0b042463854f02a4c0bb9ccf51e2d03226247e2a5c247315d1bb65954b3635739
-  data.tar.gz: 77bf12764fe5bf436d270a3d8c1763de469fae4fb6741714dedd1d400bb2e11d1fbeb2811cf062460fdd9cfe05ef2a32e9b6bd83b3e77e3f7f720d808a3472ed
+  metadata.gz: c7b2076de902483e3f2362b8319d99f1876c7f41e7ffd1815e92278803d55776f700df721dc16700064c890c7c48628657ef2bf4003ba989b7c6eee1c27a9088
+  data.tar.gz: ed8705a9687dc56cbef235fe0821065653852d5b1e1c05293a9ea53baf08a7a12c24fdc5e909e9dd04047378d664ddb0b8e7d644e38d54c753ef1a470138ce60

data/CHANGELOG.md

@@ -1,5 +1,32 @@
 # Changelog
 
+## [3.5.0] - 2025-11-13
+
+### Added
+
+- MP4 with demonstration of Bash "trap" command.
+- Type casting for tokens in imported documents.
+- Default color for fenced code blocks per type.
+- Shell blocks can require UX blocks.
+- Common markdown patterns for text decorations.
+
+### Changed
+
+- README.md
+
+## [3.4.0] - 2025-09-16
+
+### Added
+
+- Accept line continuation for an import directive.
+- Debug methods for block form and direct evaluation
+- Color families indicate related functionality.
+
+### Changed
+
+- Size table columns to fit.
+- Name key is not required for all UX blocks. Display the formatted string if specified. Display the last key in the echo or exec hash otherwise.
+
 ## [3.3.0] - 2025-09-02
 
 ### Added

data/Gemfile

@@ -12,6 +12,7 @@ gem 'erb'
 gem 'irb'
 gem 'mocha', require: false
 gem 'minitest', require: false
+gem 'minitest-reporters', require: false
 gem 'pry-nav'
 gem 'pry-stack_explorer'
 gem 'railties'

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    markdown_exec (3.3.0)
+    markdown_exec (3.5.0)
       clipboard (~> 1.3.6)
       open3 (~> 0.1.1)
       optparse (~> 0.1.1)
@@ -37,6 +37,7 @@ GEM
       minitest (>= 5.1)
       mutex_m
       tzinfo (~> 2.0)
+    ansi (1.5.0)
     ast (2.4.2)
     base64 (0.2.0)
     bigdecimal (3.1.8)
@@ -98,6 +99,11 @@ GEM
       nokogiri (>= 1.12.0)
     method_source (1.1.0)
     minitest (5.24.1)
+    minitest-reporters (1.7.1)
+      ansi
+      builder
+      minitest (>= 5.0)
+      ruby-progressbar
     mocha (2.4.5)
       ruby2_keywords (>= 0.0.5)
     mutex_m (0.2.0)
@@ -227,6 +233,7 @@ DEPENDENCIES
   irb
   markdown_exec!
   minitest
+  minitest-reporters
   mocha
   pry-nav
   pry-stack_explorer

data/README.md

@@ -1,150 +1,271 @@
 # MarkdownExec
 
-Interactively select and execute fenced code blocks in markdown files. Build complex scripts by naming and requiring blocks. Log resulting scripts and output. Re-run scripts.
-
-* Code blocks may be named. Named blocks can be required by other blocks.
-
-* The user-selected code block, and all required blocks, are arranged into a script in the order they appear in the markdown file. The script can be presented for approval prior to execution.
-
-* Executed scripts can be saved. Saved scripts can be listed, selected, and executed.
-
-* Output from executed scripts can be saved.
-
-## Screenshots
-
-### Select a file
-
-![Select a file](/assets/select_a_file.png)
-
-### Select a block
-
-![Select a block](/assets/select_a_block.png)
-
-### Approve code
-
-![Approve code](/assets/approve_code.png)
-
-### Output
-
-![Output of execution](/assets/output_of_execution.png)
-
-### Example blocks
-
-![Example blocks](/assets/example_blocks.png)
+[![MarkdownExec For Interactive Bash Instruction](https://raw.githubusercontent.com/fareedst/markdown_exec/main/demo/trap.demo1.gif)](https://raw.githubusercontent.com/fareedst/markdown_exec/main/demo/trap.demo1.mp4)
+
+*Click the GIF above to view the full video with audio (MP4)*
+
+Transform static markdown into interactive, executable workflows. Build complex scripts with named blocks, interactive forms, cross-document navigation, and template systems.
+
+## Key Features
+
+### Interactive Code Execution
+- **Named Blocks**: Create reusable code blocks with dependencies
+- **Block Requirements**: Automatically include required blocks in execution order
+- **Interactive Selection**: Choose blocks from intuitive menus
+- **Script Approval**: Review generated scripts before execution
+
+### UX Blocks - Interactive Forms
+- **Variable Input**: Create interactive forms for user input
+- **Validation**: Built-in regex validation with custom transforms
+- **Dynamic Menus**: Selection from allowed values or command output
+- **Auto-initialization**: Set values from environment, commands, or defaults
+- **Dependencies**: Chain UX blocks with complex relationships
+
+### Cross-Document Navigation
+- **Link Blocks**: Navigate between markdown files seamlessly
+- **Variable Passing**: Share data between documents
+- **Inherited Context**: Maintain state across document boundaries
+- **HyperCard-style Navigation**: Create interactive document stacks
+
+### Template System & Imports
+- **Import Directives**: Include content from other files with `@import`
+- **Parameter Substitution**: Replace variables in imported content
+- **Shell Expansions**: Use `${variable}` and `$(command)` syntax throughout documents
+- **Dynamic Content**: Generate content based on user selections
+
+### Advanced Block Types
+- **Shell Blocks**: Execute bash shells
+- **UX Blocks**: Interactive forms with validation, transforms, and dynamic behavior
+- **Vars Blocks**: Define variables in YAML format
+- **Opts Blocks**: Configure document behavior and appearance
+- **Link Blocks**: Cross-document navigation and variable passing
+
+### State Management
+- **Script Persistence**: Save and replay executed scripts
+- **Output Logging**: Capture and review execution results
+- **State Inheritance**: Manage context across sessions
+- **Configuration**: Flexible options via environment, files, or CLI
 
 ## Installation
 
-Install:
-    $ gem install markdown_exec
+```bash
+gem install markdown_exec
+```
 
-## Usage
+## Quick Start
 
-### Help
+### Interactive Mode (Recommended)
+```bash
+mde                    # Process README.md in current folder
+mde my-document.md     # Process specific markdown file
+mde .                  # Select from markdown files in current folder
+```
 
-::: `mde --help`
+### Command Line Mode
+```bash
+mde my-document.md my-block    # Execute specific block directly
+mde --list-blocks              # List all available blocks
+mde --list-docs                # List all markdown documents
+```
 
-Displays help information.
+## Interactive Features
 
-### Basic
+### UX Blocks - Interactive Forms
 
-::: `mde`
+Create interactive forms that prompt users for input:
 
-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].
+<pre><code>```ux
+name: USER_NAME
+prompt: Enter your name
+init: Guest
+```
+</code></pre>
+
+<pre><code>```ux
+name: ENVIRONMENT
+allow:
+  - development
+  - staging
+  - production
+prompt: Select environment
+```
+</code></pre>
 
-::: `mde my.md` or `mde -f my.md`
+<pre><code>```ux
+name: EMAIL
+prompt: Enter email address
+validate: '(?<local>[^@]+)@(?<domain>[^@]+)'
+transform: '%{local}@%{domain}'
+```
+</code></pre>
 
-Select a block to execute from `my.md`.
+### Cross-Document Navigation
 
-::: `mde my.md myblock`
+Navigate between documents while maintaining context:
 
-Execute the block named `myblock` from `my.md`.
+<pre><code>```link
+file: next-document.md
+vars:
+  current_user: ${USER_NAME}
+  environment: ${ENVIRONMENT}
+```
+</code></pre>
 
-::: `mde .` or `mde -p .`
+### Template System
 
-Select a markdown file in the current folder. Select a block to execute from that file.
+Use imports with parameter substitution:
 
-### Report documents and blocks
+```
+@import template.md USER_NAME=John ENVIRONMENT=production
+```
+</code></pre>
 
-::: `mde --list-blocks`
+### Block Dependencies
 
-List all blocks in the all the markdown documents in the current folder.
+Create complex workflows with automatic dependency resolution:
 
-::: `mde --list-docs`
+<pre><code>```bash :deploy +setup +test +deploy
+echo "Deploying to ${ENVIRONMENT}"
+```
+</code></pre>
 
-List all markdown documents in the current folder.
+<pre><code>```bash :setup
+echo "Setting up environment"
+```
+</code></pre>
 
-### Configuration
+<pre><code>```bash :test
+echo "Running tests"
+```
+</code></pre>
 
-::: `mde --list-default-env` or `mde --list-default-yaml`
+## Advanced Usage
 
-List default values that can be set in configuration file, environment, and command line.
+### Configuration
 
-::: `mde -0`
+```
+# Environment variables
+export MDE_SAVE_EXECUTED_SCRIPT=1
+export MDE_USER_MUST_APPROVE=1
 
-Show current configuation values that will be applied to the current run. Does not interrupt processing.
+# Configuration file (.mde.yml)
+save_executed_script: true
+user_must_approve: true
 
-### Save scripts
+# Command line
+mde --save-executed-script 1 --user-must-approve 1
+```
 
-::: `mde --save-executed-script 1`
+### Script Management
 
-Save executed script in saved script folder.
+```bash
+mde --save-executed-script 1      # Save executed scripts
+mde --list-recent-scripts         # List saved scripts
+mde --select-recent-script        # Execute saved script
+mde --save-execution-output 1     # Save execution output
+```
 
-::: `mde --list-recent-scripts`
+## Block Types Reference
 
-List recent saved scripts in saved script folder.
+### Shell Blocks
+<pre><code>```bash
+echo "Hello World"
+```
+</code></pre>
 
-::: `mde --select-recent-script`
+### UX Blocks (Interactive Forms)
+<pre><code>```ux
+name: USER_NAME
+prompt: Enter your name
+init: Guest
+```
+</code></pre>
+
+<pre><code>```ux
+name: ENVIRONMENT
+allow:
+  - development
+  - staging
+  - production
+act: :allow
+```
+</code></pre>
 
-Select and execute a recently saved script in saved script folder.
+<pre><code>```ux
+name: CURRENT_DIR
+exec: basename $(pwd)
+transform: :chomp
+```
+</code></pre>
 
-### Save output
+<pre><code>```ux
+name: EMAIL
+prompt: Enter email address
+validate: '(?<local>[^@]+)@(?<domain>[^@]+)'
+transform: '%{local}@%{domain}'
+```
+</code></pre>
 
-::: `mde --save-execution-output 1`
+### Variable Blocks
+<pre><code>```vars
+DATABASE_URL: postgresql://localhost:5432/myapp
+DEBUG: true
+```
+</code></pre>
 
-Save execution output in saved output folder.
+### Link Blocks (Cross-Document Navigation)
+<pre><code>```link
+file: next-page.md
+vars:
+  current_user: ${USER_NAME}
+```
+</code></pre>
+
+### Data Blocks (YAML)
+<pre><code>```yaml
+users:
+  - name: John
+    role: admin
+  - name: Jane
+    role: user
+```
+</code></pre>
 
-## Behavior
+### Import Directives
+```
+@import template.md USER_NAME=John ENVIRONMENT=production
+```
 
-* If no file and no folder are specified, blocks within `./README.md` are presented.
-* If a file is specified, its blocks are presented.
-* If a folder is specified, its files are presented. When a file is selected, its blocks are presented.
+### Options Blocks
+<pre><code>```opts :(document_opts)
+user_must_approve: true
+save_executed_script: true
+menu_ux_row_format: 'DEFAULT %{name} = ${%{name}}'
+```
+</code></pre>
 
 ## Configuration
 
 ### Environment Variables
-
-When executed, `mde` reads the current environment.
-* Configuration in current and children shells, e.g. `export MDE_SAVE_EXECUTED_SCRIPT=1`.
-* Configuration for the current command, e.g. `MDE_SAVE_EXECUTED_SCRIPT=1 mde`.
+<pre><code>```bash
+export MDE_SAVE_EXECUTED_SCRIPT=1
+export MDE_USER_MUST_APPROVE=1
+```
+</code></pre>
 
 ### Configuration Files
+<pre><code>```yaml
+# .mde.yml
+save_executed_script: true
+user_must_approve: true
+menu_with_inherited_lines: true
+```
+</code></pre>
 
-* Configuration in all shells, e.g. environment variables set in your user's `~/.bashrc` or `~/.bash_profile` files.
-* Configuration in the optional file `.mde.yml` in the current folder. .e.g. `save_executed_script: true`
-* Configuration in a YAML file and read while parsing the inputs, e.g. `--config my_path/my_file.yml`
-
-### Program Arguments
-
-* Configuration in command options, e.g. `mde --save-executed-script 1`
-
-## Representing boolean values
-
-Boolean values expressed as strings are interpreted as:
-| String | Boolean |
-| :---: | :---: |
-| *empty string* | False |
-| `0` | False |
-| `1` | True |
-| *anything else* | True |
-
-E.g. `opt1=1` will set option `opt1` to True.
-
-Boolean options configured with environment variables:
-- Set to `1` or non-empty value to save executed scripts; empty or `0` to disable saving.
-  e.g. `export MDE_SAVE_EXECUTED_SCRIPT=1`
-  e.g. `export MDE_SAVE_EXECUTED_SCRIPT=`
-- Specify variable on command line.
-  e.g. `MDE_SAVE_EXECUTED_SCRIPT=1 mde`
+### Command Line Options
+```bash
+mde --save-executed-script 1 --user-must-approve 1 --config my-config.yml
+```
 
 ## Tab Completion
 
@@ -152,7 +273,7 @@ Boolean options configured with environment variables:
 
 Append a command to load the completion script to your shell configuration file. `mde` must be executable for the command to be composed correctly.
 
-```bash :()
+```bash
 echo "source $(mde --pwd)/bin/tab_completion.sh" >> ~/.bash_profile
 ```
 
@@ -179,29 +300,54 @@ In the table below, tab is indicated by `!`
 | `mde --user-must-approve !` | `mde --user-must-approve .BOOL.`|
 | `mde --user-must-approve .BOOL.!` | `mde --user-must-approve 1` |
 
-## Example Blocks
+## Example: Interactive Workflow
 
-When prompted, select either the `awake` or `asleep` block.
+This example demonstrates a complete interactive workflow with UX blocks, dependencies, and cross-document navigation:
 
-``` :(day)
-export TIME=early
+### Step 1: User Input
+<pre><code>```ux :user-setup
+name: USER_NAME
+prompt: Enter your name
+init: Guest
 ```
-
-``` :(night)
-export TIME=late
+</code></pre>
+
+<pre><code>```ux :environment
+name: ENVIRONMENT
+allow:
+  - development
+  - staging
+  - production
+prompt: Select environment
 ```
+</code></pre>
 
-``` :awake +(day) +(report)
-export ACTIVITY=awake
+### Step 2: Automated Setup
+Prompts the user for both values and generates output.
+<pre><code>```bash :setup +user-setup +environment
+echo "Setting up for user: ${USER_NAME}"
+echo "Environment: ${ENVIRONMENT}"
 ```
-
-``` :asleep +(night) +(report)
-export ACTIVITY=asleep
+</code></pre>
+
+### Step 3: Conditional Logic
+<pre><code>```bash :deploy +setup
+if [ "${ENVIRONMENT}" = "production" ]; then
+  echo "Deploying to production with extra safety checks"
+else
+  echo "Deploying to ${ENVIRONMENT}"
+fi
 ```
-
-``` :(report)
-echo "$TIME -> $ACTIVITY"
+</code></pre>
+
+### Step 4: Cross-Document Navigation
+<pre><code>```link
+file: next-workflow.md
+vars:
+  user: ${USER_NAME}
+  env: ${ENVIRONMENT}
 ```
+</code></pre>
 
 # Testing
 

data/Rakefile

@@ -146,7 +146,8 @@ task :minitest do
     './lib/saved_assets.rb --verbose',
     './lib/saved_files_matcher.rb --verbose',
     './lib/table_extractor.rb --verbose',
-    './lib/text_analyzer.rb --verbose'
+    './lib/text_analyzer.rb --verbose',
+    './lib/ww.rb --verbose'
   ]
 
   execute_with_error_handling(commands) do |command|

data/bats/block-type-shell-require-ux.bats

@@ -0,0 +1,15 @@
+#!/usr/bin/env bats
+
+load 'test_helper'
+
+@test 'initial' {
+  spec_mde_xansi_dname_doc_blocks_expect docs/dev/block-type-shell-require-ux.md \
+   'require-a-UX-block__FULL_NAME='
+}
+
+@test 'activated' {
+  # 2025-11-13 add a '.' block to force the display to update
+  spec_mde_xansi_dname_doc_blocks_expect docs/dev/block-type-shell-require-ux.md \
+   require-a-UX-block . \
+   '__require-a-UX-block_Mythical_Monkey_FULL_NAME=Mythical Monkey'
+}

data/bats/block-type-ux-auto.bats

@@ -4,5 +4,5 @@ load 'test_helper'
 
 @test 'Initial values' {
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/block-type-ux-auto.md \
-   'v1 = _v2 = _v3 = 12_v4 = 21_v5 = markdown_exec_v6 = 31'
+   'v1 = _v2 = _v3 = 12_v4 = 21_v5 = markdown_exec__v6 = 31'
 }

data/bats/block-type-ux-default.bats

@@ -4,5 +4,5 @@ load 'test_helper'
 
 @test 'Initial values' {
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/block-type-ux-default.md \
-   'v1 = _v2 = 11_v3 = 12_v4 = 21_v5 = markdown_exec_v6 = 31'
+   'v1 = _v2 = 11_v3 = 12_v4 = 21_v5 = markdown_exec__v6 = 31'
 }

data/bats/block-type-ux-echo-hash.bats

@@ -4,11 +4,11 @@ load 'test_helper'
 
 @test 'an automatic block sets multiple variables' {
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/block-type-ux-echo-hash.md \
-   'BASENAME=markdown_exec_DOCUMENTS=markdown_OPERATION=exec_Load Tapanuli Orangutan_Load Psychedelic Frogfish_| Variable | Value |_| -------- | ----- |_| Species  |       |_| Genus    |       |_| Family   |   |'
+   'BASENAME=markdown_exec_DOCUMENTS=markdown_OPERATION=exec_Load Tapanuli Orangutan_Load Psychedelic Frogfish_| Variable | Value |_| -------- | ----- |_| Species  |   |_| Genus    |       |_| Family   |   |'
 }
 
 @test 'an activated block sets multiple variables' {
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/block-type-ux-echo-hash.md \
    'Load Tapanuli Orangutan' \
-   'BASENAME=markdown_exec_DOCUMENTS=markdown_OPERATION=exec_Load Tapanuli Orangutan_Load Psychedelic Frogfish_| Variable | Value               |_| -------- | ------------------- |_| Species  | Pongo tapanuliensis |_| Genus    | Pongo               |_| Family   | Hominidae       |'
+   'BASENAME=markdown_exec_DOCUMENTS=markdown_OPERATION=exec_Load Tapanuli Orangutan_Load Psychedelic Frogfish_| Variable | Value                   |_| -------- | ----------------------- |_| Species  | Pongo tapanuliensis |_| Genus    | Pongo                   |_| Family   | Hominidae           |'
 }

data/bats/block-type-ux-exec-hash.bats

@@ -4,12 +4,12 @@ load 'test_helper'
 
 @test 'automatic' {
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/block-type-ux-exec-hash.md \
-   'A single named variable is set automatically as the_output of the exec string._Common_Name=Yeti Crab_Common_Name=Yeti Crab_ Y  e  t  i     C  r  a  b  _ _ 59 65 74 69 20 43 72 61 62 0A__Multiple variables are set automatically as the_output of each exec string._One variable is temporary/not stored to inherited lines_but available for calculations within the block._Domain=ukaryota____D=_Domain=ukaryota_ u  k  a  r  y  o  t  a  _   _ _ 75 6B 61 72 79 6F 74 61 0A 0A__A single named variable is set interactively as the_output of the exec string._Year_Discovered=_Year_Discovered=_$(hexdump_format "$Year_Discovered")__Multiple variables are set interactively as the_output of the exec string._Genus=_Species=_$(hexdump_format "$Species")_Genus=_$(hexdump_format "$Genus")__A single named variable is set automatically as the_first line of the output of the first element in the echo_hash._Kingdom=Animalia_Kingdom=Animalia_ A  n  i  m  a  l  i  a_ 41 6E 69 6D 61 6C 69 61__A single named variable is set automatically as the_first line of the output of the first element in the exec_hash._Class=Malacostraca_Class=Malacostraca_ M  a  l  a  c  o  s  t  r  a  c  a_ 4D 61 6C 61 63 6F 73 74 72 61 63 61'
+   'A single named variable is set automatically as the_output of the exec string._Common_Name=Yeti Crab__Common_Name=Yeti Crab_ Y  e  t  i     C  r  a  b  _ _ 59 65 74 69 20 43 72 61 62 0A__Multiple variables are set automatically as the_output of each exec string._One variable is temporary/not stored to inherited lines_but available for calculations within the block._Domain=ukaryota_____D=_Domain=ukaryota_ u  k  a  r  y  o  t  a  _   _ _ 75 6B 61 72 79 6F 74 61 0A 0A__A single named variable is set interactively as the_output of the exec string._Year_Discovered=_Year_Discovered=_$(hexdump_format "$Year_Discovered")__Multiple variables are set interactively as the_output of the exec string._Genus=_Species=_$(hexdump_format "$Species")_Genus=_$(hexdump_format "$Genus")__A single named variable is set automatically as the_first line of the output of the first element in the echo_hash._Kingdom=Animalia_Kingdom=Animalia_ A  n  i  m  a  l  i  a_ 41 6E 69 6D 61 6C 69 61__A single named variable is set automatically as the_first line of the output of the first element in the exec_hash._Class=Malacostraca_Class=Malacostraca_ M  a  l  a  c  o  s  t  r  a  c  a_ 4D 61 6C 61 63 6F 73 74 72 61 63 61'
 }
 
 @test 'interactive' {
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/block-type-ux-exec-hash.md \
    '[Year_Discovered]' \
    '[Genus]' \
-   'A single named variable is set automatically as the_output of the exec string._Common_Name=Yeti Crab_Common_Name=Yeti Crab_ Y  e  t  i     C  r  a  b  _ _ 59 65 74 69 20 43 72 61 62 0A__Multiple variables are set automatically as the_output of each exec string._One variable is temporary/not stored to inherited lines_but available for calculations within the block._Domain=ukaryota____D=_Domain=ukaryota_ u  k  a  r  y  o  t  a  _   _ _ 75 6B 61 72 79 6F 74 61 0A 0A__A single named variable is set interactively as the_output of the exec string._Year_Discovered=2005_Year_Discovered=2005_ 2  0  0  5  _ _ 32 30 30 35 0A__Multiple variables are set interactively as the_output of the exec string._Genus=Kiwa__Species=Kiwa hirsuta_ K  i  w  a     h  i  r  s  u  t  a  _ _ 4B 69 77 61 20 68 69 72 73 75 74 61 0A_Genus=Kiwa_ K  i  w  a  _   _ _ 4B 69 77 61 0A 0A__A single named variable is set automatically as the_first line of the output of the first element in the echo_hash._Kingdom=Animalia_Kingdom=Animalia_ A  n  i  m  a  l  i  a_ 41 6E 69 6D 61 6C 69 61__A single named variable is set automatically as the_first line of the output of the first element in the exec_hash._Class=Malacostraca_Class=Malacostraca_ M  a  l  a  c  o  s  t  r  a  c  a_ 4D 61 6C 61 63 6F 73 74 72 61 63 61'
+   'A single named variable is set automatically as the_output of the exec string._Common_Name=Yeti Crab__Common_Name=Yeti Crab_ Y  e  t  i     C  r  a  b  _ _ 59 65 74 69 20 43 72 61 62 0A__Multiple variables are set automatically as the_output of each exec string._One variable is temporary/not stored to inherited lines_but available for calculations within the block._Domain=ukaryota_____D=_Domain=ukaryota_ u  k  a  r  y  o  t  a  _   _ _ 75 6B 61 72 79 6F 74 61 0A 0A__A single named variable is set interactively as the_output of the exec string._Year_Discovered=2005__Year_Discovered=2005_ 2  0  0  5  _ _ 32 30 30 35 0A__Multiple variables are set interactively as the_output of the exec string._Genus=Kiwa___Species=Kiwa hirsuta_ K  i  w  a     h  i  r  s  u  t  a  _ _ 4B 69 77 61 20 68 69 72 73 75 74 61 0A_Genus=Kiwa_ K  i  w  a  _   _ _ 4B 69 77 61 0A 0A__A single named variable is set automatically as the_first line of the output of the first element in the echo_hash._Kingdom=Animalia_Kingdom=Animalia_ A  n  i  m  a  l  i  a_ 41 6E 69 6D 61 6C 69 61__A single named variable is set automatically as the_first line of the output of the first element in the exec_hash._Class=Malacostraca_Class=Malacostraca_ M  a  l  a  c  o  s  t  r  a  c  a_ 4D 61 6C 61 63 6F 73 74 72 61 63 61'
 }

data/bats/block-type-ux-exec.bats

@@ -4,5 +4,5 @@ load 'test_helper'
 
 @test 'Output of executed commands as initial value' {
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/block-type-ux-exec.md \
-   "ux0=_ux1=Unknown_ux2=markdown_exec_ux3=markdown_exec_ux4=Xform: 'markdown'"
+   "ux0=_ux1=Unknown_ux2=markdown_exec__ux3=markdown_exec__ux4=Xform: 'markdown'"
 }

data/bats/block-type-ux-no-name.bats

@@ -0,0 +1,8 @@
+#!/usr/bin/env bats
+
+load 'test_helper'
+
+@test 'displays last key in hash' {
+  spec_mde_xansi_dname_doc_blocks_expect docs/dev/block-type-ux-no-name.md \
+   'OPERATION1=exec_OPERATION2=exec__'
+}

data/bats/block-type-ux-require-context.bats

@@ -0,0 +1,14 @@
+#!/usr/bin/env bats
+
+load 'test_helper'
+
+@test 'initial' {
+  spec_mde_xansi_dname_doc_blocks_expect docs/dev/block-type-ux-require-context.md \
+   'Get the common name..._Entity: _ENTITY2: _UX1: _Common name: '
+}
+
+@test 'activated' {
+  spec_mde_xansi_dname_doc_blocks_expect docs/dev/block-type-ux-require-context.md \
+   \[ux1\] \
+   'Get the common name..._Entity: _ENTITY2: Mythical Monkey_UX1: Mythical Monkey_Common name: Mythical Monkey'
+}

data/bats/block-type-ux-row-format.bats

@@ -4,5 +4,5 @@ load 'test_helper'
 
 @test 'Row format merges with prior table' {
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/block-type-ux-row-format.md \
-   "   | Variable    | Value                 | Prompt             |_   | ----------- | --------------------- | ------------------ |_   | Species     | Pongo tapanuliensis   | New species?       |_   | Name: Genus | Value: Xform: 'Pongo' | Prompt: New genus? |_   | Family      | Hominidae             | Enter a value: |"
+   "   | Variable    | Value                 | Prompt                 |_   | ----------- | --------------------- | ---------------------- |_   | Species     | Pongo tapanuliensis   | New species?       |_   | Name: Genus | Value: Xform: 'Pongo' | Prompt: New genus? |_   | Family      | Hominidae             | Enter a value:     |"
 }