markdown_exec 3.5.1 → 3.5.2

data/bats/border.bats

@@ -2,7 +2,7 @@
 
 load 'test_helper'
 
-@test 'Border - ' {
+@test 'renders border between blocks' {
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/border.md \
    'A: 1_B: 2'
 }

data/bats/cli.bats

@@ -8,21 +8,21 @@ load 'test_helper'
    ' ARGS: 1 23'
 }
 
-@test 'Position 0 File Name - file does not exist; string not found; select a file from the current directory' {
+@test 'searches current directory when file not found' {
   skip 'algorithm to exit waiting MDE is not ready'
   BATS_OUTPUT_FILTER=A
   BATS_SLEEP=8
   spec_mde_args_expect NotFoundAnywhere 'Searching in: .'
 }
 
-@test 'Position 1 Block Name - block does not exist' {
+@test 'reports error when block not found' {
   BATS_OUTPUT_FILTER=A
   BATS_STATUS=1
   spec_mde_args_expect docs/dev/pass-through-arguments.md NonExistentBlock \
    ' Error: Block not found -- name: NonExistentBlock'
 }
 
-@test 'block named in link does not exist' {
+@test 'reports error when linked block missing' {
   BATS_STATUS=1
   spec_mde_args_expect docs/dev/requiring-blocks.md '[link-missing-local-block]' \
    'Block missing'
@@ -30,46 +30,46 @@ load 'test_helper'
 
 # Requiring blocks
 
-@test 'bash block setting an environment variable requires a bash block' {
+@test 'bash block requires another bash block' {
   BATS_OUTPUT_FILTER=A
   spec_mde_args_expect docs/dev/requiring-blocks.md '[set-env]' \
    ' ARG1: 37'
 }
 
-@test 'vars in link block are appended to inherited lines - local link' {
+@test 'appends vars from link block to inherited lines - local' {
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/requiring-blocks.md \
    '[link-local-block-with-vars]' \
    '* Exit_# [link-local-block-with-vars]_ARG1="37"_block: echo-ARG1_  file: docs/dev/linked-file.md_  vars:_    ARG1: arg1-from-link-file_block: output_arguments_  vars:_    ARG1: 37_block: missing_ARG1=37_output_arguments'
 }
 
-@test 'vars in link block are appended to inherited lines - external file' {
+@test 'appends vars from link block to inherited lines - external' {
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/requiring-blocks.md \
    '[link-file-block-with-vars]' \
    '* Exit_# [link-file-block-with-vars]_ARG1="arg1-from-link-file"_echo-ARG1'
 }
 
 # the last block is a link block, so menu is displayed
-@test 'link block setting an environment variable requires a bash block' {
+@test 'link block requires bash block' {
   BATS_OUTPUT_FILTER=A
   spec_mde_args_expect docs/dev/requiring-blocks.md '[link-local-block-with-vars]' $EXIT_MENU \
    ' ARG1: 37'
 }
 
 # the last block is a link block, so menu is displayed
-@test 'link block setting an environment variable calls a bash block in a file' {
+@test 'link block calls bash block in external file' {
   BATS_OUTPUT_FILTER=A
   spec_mde_args_expect docs/dev/requiring-blocks.md '[link-file-block-with-vars]' $EXIT_MENU \
    ' ARG1: arg1-from-link-file'
 }
 
-@test 'history' {
+@test 'lists history files' {
   file_name="$(most_recent_history_file_name)"
   BATS_OUTPUT_GREP="$file_name"
   spec_mde_args_expect examples/save.md --history \
    "$file_name"
 }
 
-@test 'sift - format text' {
+@test 'sifts history with text format' {
   file_name="$(most_recent_history_file_name)"
   date="$(date_from_history_file_name "$file_name")"
   BATS_OUTPUT_GREP="$file_name"
@@ -77,7 +77,7 @@ load 'test_helper'
    "$file_name"
 }
 
-@test 'sift - format yaml' {
+@test 'sifts history with yaml format' {
   file_name="$(most_recent_history_file_name)"
   date="$(date_from_history_file_name "$file_name")"
   BATS_OUTPUT_GREP="$file_name"

data/bats/command-substitution-options.bats

@@ -2,13 +2,13 @@
 
 load 'test_helper'
 
-@test 'Operator $' {
+@test 'uses $ operator for variable expansion' {
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/command-substitution-options.md \
    'operator_$' \
    'Command substitution__The current value of environment variable Common_Name_is displayed using two different operators._The command echo $SHLVL is executed via command_substitution, using two different operators.__| Operator | Variable Expansion | Command Substitution |_| -------- | ------------------ | -------------------- |_| $        | Tapanuli Orangutan | Pongo tapanuliensis  |_| @        | @{Common_Name}     | @(echo $Species)     |__Toggle between operators.__operator_$__operator_@'
 }
 
-@test 'Operator @' {
+@test 'uses @ operator for command substitution' {
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/command-substitution-options.md \
    'Command substitution__The current value of environment variable Common_Name_is displayed using two different operators._The command echo $SHLVL is executed via command_substitution, using two different operators.__| Operator | Variable Expansion | Command Substitution |_| -------- | ------------------ | -------------------- |_| $        | ${Common_Name}     | $(echo $Species)     |_| @        | Tapanuli Orangutan | Pongo tapanuliensis  |__Toggle between operators.__operator_$__operator_@'
 }

data/bats/command-substitution.bats

@@ -2,7 +2,7 @@
 
 load 'test_helper'
 
-@test 'Command substitution' {
+@test 'substitutes command output in variables' {
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/command-substitution.md \
    'CURRENT BASE NAME IS: MARKDOWN_EXEC_current base name is: markdown_exec_current base name is: markdown_exec_| current base name |_| ----------------- |_| markdown_exec     |_: notice the string is not expanded in Shell block types (names or body)._echo "current base name is now $(basename `pwd`)"_load: file_markdown_exec.sh_Status not zero: $(err)'
 }

data/bats/document-shell.bats

@@ -2,7 +2,7 @@
 
 load 'test_helper'
 
-@test 'document_shell - required' {
+@test 'requires document_shell for inherited lines' {
   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/history.bats

@@ -2,32 +2,32 @@
 
 load 'test_helper'
 
-@test 'Options - history, sorted' {
+@test 'lists history files sorted' {
   local log_files="$(ls -1t logs/*examples_save_md*)"
   spec_mde_args_expect examples/save.md --history \
    "$log_files"
 }
 
-@test 'Options - history, dig' {
+@test 'digs through all history files' {
   skip 'test hangs on menu'
   local log_files="$(ls -1 logs/*)"
   spec_mde_args_expect --history --dig \
    "$log_files"
 }
 
-@test 'Options - history, probe' {
+@test 'probes history files for pattern' {
   local log_files="$(grep --files-with-matches '04:31' logs/* 2>/dev/null)"
   spec_mde_args_expect examples/save.md --probe '04:31' --history \
    "$log_files"
 }
 
-@test 'Options - history, sift' {
+@test 'sifts history files by date pattern' {
   local log_files="$(ls -1 logs/*-31-*examples_save_md*)"
   spec_mde_args_expect examples/save.md --sift -31- --history \
    "$log_files"
 }
 
-@test 'Options - history, sift and probe' {
+@test 'sifts and probes history files' {
   local log_files="$(grep --files-with-matches 'e' logs/*-31-*examples_save_md* 2>/dev/null)"
   spec_mde_args_expect examples/save.md --sift -31- --probe e --history \
    "$log_files"

data/bats/import-conflict.bats

@@ -2,7 +2,7 @@
 
 load 'test_helper'
 
-@test 'Import and require blocks with duplicate names - blocks with same name have different requirements' {
+@test 'executes blocks with same name but different requirements' {
   BATS_OUTPUT_FILTER=A
   BATS_SAFE=_
   spec_mde_args_expect docs/dev/import-conflict-0.md \

data/bats/import-directive-line-continuation.bats

@@ -2,7 +2,7 @@
 
 load 'test_helper'
 
-@test '' {
+@test 'handles line continuation in import directive' {
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/import-directive-line-continuation.md \
    --blocks dname \
    'Stem: U1_Species: Illacme tobini'

data/bats/import-directive-parameter-symbols.bats

@@ -2,7 +2,7 @@
 
 load 'test_helper'
 
-@test '' {
+@test 'expands parameter symbols in import directive' {
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/import-directive-parameter-symbols.md \
    --blocks dname \
    'Stem: U1_Species: Illacme tobini_Stem: U2_Species: Hydrodynastes bicinctus'

data/bats/import-duplicates.bats

@@ -4,7 +4,7 @@ load 'test_helper'
 
 # Imported blocks `[du]1.*` appear before principal blocks `[du]0.*` in the code evaluated because the import of `import-duplicates-1.md` is above the `0.*` definitions in the principal file.
 
-@test 'Import and require blocks with duplicate names - unique in main 0' {
+@test 'executes unique block from main file 0' {
   BATS_OUTPUT_FILTER=A
   BATS_SAFE=_
   spec_mde_args_expect docs/dev/import-duplicates-0.md \
@@ -12,7 +12,7 @@ load 'test_helper'
    '_d1.0_d1.1_d0.0_d0.1_u0.0'
 }
 
-@test 'Import and require blocks with duplicate names - unique in main 1' {
+@test 'executes unique block from main file 1' {
   BATS_OUTPUT_FILTER=A
   BATS_SAFE=_
   spec_mde_args_expect docs/dev/import-duplicates-0.md \
@@ -21,7 +21,7 @@ load 'test_helper'
 }
 
 # a name in the CLI that matches multiple blocks only loads the first
-@test 'Import and require blocks with duplicate names - duplicate 0' {
+@test 'executes first matching duplicate block 0' {
   BATS_OUTPUT_FILTER=A
   BATS_SAFE=_
   spec_mde_args_expect docs/dev/import-duplicates-0.md \
@@ -30,7 +30,7 @@ load 'test_helper'
 }
 
 # a name in the CLI that matches multiple blocks only loads the first
-@test 'Import and require blocks with duplicate names - duplicate 1' {
+@test 'executes first matching duplicate block 1' {
   BATS_OUTPUT_FILTER=A
   BATS_SAFE=_
   spec_mde_args_expect docs/dev/import-duplicates-0.md \
@@ -38,7 +38,7 @@ load 'test_helper'
    '_d1.1'
 }
 
-@test 'Import and require blocks with duplicate names - unique in import 0' {
+@test 'executes unique block from imported file 0' {
   BATS_OUTPUT_FILTER=A
   BATS_SAFE=_
   spec_mde_args_expect docs/dev/import-duplicates-0.md \
@@ -46,7 +46,7 @@ load 'test_helper'
    '_d1.0_d1.1_u1.0_d0.0_d0.1'
 }
 
-@test 'Import and require blocks with duplicate names - unique in import 1' {
+@test 'executes unique block from imported file 1' {
   BATS_OUTPUT_FILTER=A
   BATS_SAFE=_
   spec_mde_args_expect docs/dev/import-duplicates-0.md \

data/bats/import-parameter-symbols.bats

@@ -2,7 +2,7 @@
 
 load 'test_helper'
 
-@test 'Initial values' {
+@test 'expands parameter symbols in import directives' {
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/import-parameter-symbols.md \
    'COMMON_NAME=Tapanuli Orangutan_Evaluated expression: Tapanuli Orangutan_echo "Evaluated expression: $(printf %s "$COMMON_NAME")"__Raw literal: Tapanuli Orangutan_echo "Raw literal: Tapanuli Orangutan"__Force-quoted literal: Tapanuli Orangutan_echo "Force-quoted literal: Tapanuli Orangutan"__Variable reference: Tapanuli Orangutan_echo "Variable reference: ${COMMON_NAME}"'
 }

data/bats/import-with-text-substitution.bats

@@ -2,7 +2,7 @@
 
 load 'test_helper'
 
-@test 'enhanced @import functionality with text substitution' {
+@test 'substitutes text in enhanced import directives' {
   BATS_OUTPUT_FILTER=A
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/import-with-text-substitution.md \
    'IMPORT SUBSTITUTION COMPREHENSIVE TEST__Tests enhanced @import ./functionality with text_substitution using biological entity data.__Basic Import (Backward Compatibility)__Basic import without parameters.__Content: Static biological reference data._Source: Living entities research database._Format: Markdown with embedded data. __Raw Replacement - Simple Parameters__Genus: Pongo_Family: Hominidae  _Order: Primates__Classification hierarchy shows Pongo within Hominidae of_Primates.__Raw Replacement - Quoted Values__Common Name: Tapanuli Orangutan_Scientific Name: Pongo tapanuliensis_Discovery Location: Sumatra, Indonesia__Organism Tapanuli Orangutan (Pongo tapanuliensis) found_in Sumatra, Indonesia.__Note: Tapanuli Orangutan contains spaces, Pongo_tapanuliensis contains spaces, Sumatra, Indonesia_contains punctuation.__Raw Replacement - Mixed Parameters__Species: Psychedelic Frogfish (Histiophryne psychedelica)_Discovery: 2009_Depth Range: 15-65 meters_Habitat: Coral reefs__Marine organism Psychedelic Frogfish discovered in 2009._Lives at 15-65 meters in Coral reefs environment.__Test: 2009 is numeric, 15-65 meters contains units, Coral_reefs contains spaces.__Raw Replacement - Numbers and Special Characters__Organism: Yeti Crab_Year: 2005  _Depth: 2200 meters_Temperature: 2°C_Location: Easter Island microplate__Discovery data: Yeti Crab found 2005 at 2200 meters depth._Environment: 2°C water near Easter Island microplate.__Tests: Numbers (2005, 2200), special chars (2°C °C),_complex location.__Raw Replacement - Long Scientific Names__Classification of Ecuadorian Glassfrog:__Scientific Name: Hyalinobatrachium yaku_Genus: Hyalinobatrachium_Family: Centrolenidae_Order: Anura  _Class: Amphibia__Full classification: Amphibia > Anura > Centrolenidae >_Hyalinobatrachium > Hyalinobatrachium yaku__Long names test: Hyalinobatrachium and Centrolenidae are_lengthy taxonomic terms._Species Hyalinobatrachium yaku demonstrates complex_scientific nomenclature.__Raw Replacement - Plant Data__Plant Species: Spiny Dandelion (Taraxacum japonicum)__Kingdom: Plantae_Phylum: Tracheophyta  _Class: Magnoliopsida__Plant classification differs from animal taxonomy._Spiny Dandelion belongs to Plantae with phylum_Tracheophyta._Classification ends at Magnoliopsida level for this plant.__Test: Plant-specific taxonomic structure. __Raw Replacement - Multiple Species Comparison__Species Comparison:__Species A: Kiwa hirsuta (2005)_Species B: Phyllopteryx dewysea (2015)__Habitat A: Deep sea_Habitat B: Coastal waters__Discovery timeline: Kiwa hirsuta found 2005, Phyllopteryx_dewysea found 2015._Environment: Deep sea vs Coastal waters.__Test: Numbered parameters (Kiwa hirsuta/Phyllopteryx_dewysea) and temporal data.__Raw Replacement - Taxonomic Hierarchy__Complete Taxonomic Classification:__Domain: Eukaryota_Kingdom: Animalia_Phylum: Chordata_Class: Mammalia_Order: Primates_Family: Hominidae_Genus: Homo_Species: Homo luzonensis__Full hierarchy: Eukaryota > Animalia > Chordata >_Mammalia > Primates > Hominidae > Homo > Homo luzonensis__Test: Complete 8-level taxonomic classification with all_major ranks.__Raw Replacement - Research Data__Research Study:__Lead Researcher: Dr. Matthew Leach_Institution: California Academy of Sciences_Method: Genetic analysis_Sample Size: 47 specimens__Study conducted by Dr. Matthew Leach at California_Academy of Sciences._Used Genetic analysis with 47 total samples.__Test: Researcher names, institution names, methodology_terms, numeric data.__Export and Variables__Organism Data Export:__export Illacme tobini_NAME="Illacme tobini"_export 2016=2016_export 414=414_export California="California"_export Endemic="Endemic"__echo "Processing Illacme tobini from 2016"_echo "Characteristics: 414 legs"_echo "Location: California (Endemic)"__Variable assignment test: Illacme tobini has 414 legs,_found in California._Status: Endemic as of 2016 discovery.__Test: Shell exports, numeric values, status terms. __Expected output shows proper text substitution with word_boundary protection.'

data/bats/import.bats

@@ -2,20 +2,20 @@
 
 load 'test_helper'
 
-@test 'Directives - import, indented' {
+@test 'lists indented blocks from imported file' {
   BATS_OUTPUT_FILTER=A
   spec_mde_args_expect docs/dev/import.md \
    --list-blocks-message indent --list-blocks \
    '              '
 }
 
-@test 'Directives - import, missing' {
+@test 'reports error when imported file missing' {
   BATS_OUTPUT_FILTER=A
   spec_mde_args_expect docs/dev/import-missing.md \
    ' Error: CachedNestedFileReader.readlines -- No such file or directory - this-is-missing.md @@ '
 }
 
-@test 'Directives - import; list block ids' {
+@test 'lists block ids from imported file' {
   BATS_OUTPUT_FILTER=A
   BATS_SAFE=_
   spec_mde_args_expect docs/dev/import.md \

data/bats/indented-block-type-vars.bats

@@ -2,7 +2,7 @@
 
 load 'test_helper'
 
-@test 'an indented block with multiple lines' {
+@test 'renders indented vars block with multiple lines' {
   BATS_OUTPUT_FILTER=A
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/indented-block-type-vars.md \
    '  Species: Pongo tapanuliensis_  Genus: Pongo'

data/bats/indented-multi-line-output.bats

@@ -2,7 +2,7 @@
 
 load 'test_helper'
 
-@test 'Retain whitespace in output from shell blocks' {
+@test 'retains whitespace in shell block output' {
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/indented-multi-line-output.md \
    '[make-output]' \
    '_Species_ Genus_  Family_Order'

data/bats/line-decor-dynamic.bats

@@ -2,7 +2,7 @@
 
 load 'test_helper'
 
-@test 'Line decor, dynamic - new pattern, line_decor_pre, ansi' {
+@test 'applies dynamic line decoration with ANSI codes' {
   spec_mde_dname_doc_blocks_expect docs/dev/line-decor-dynamic.md \
    $'\e[1m\e[3m\e[38;2;200;200;33m\e[48;2;60;60;32mSpecies\e[22;23;0m'
 }

data/bats/line-wrapping.bats

@@ -2,7 +2,7 @@
 
 load 'test_helper'
 
-@test 'Text and Headings' {
+@test 'wraps text and headings to screen width' {
   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/bats/load-vars-state-demo.bats

@@ -2,24 +2,24 @@
 
 load 'test_helper'
 
-@test 'document initial state' {
+@test 'displays document initial state' {
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/load-vars-state-demo.md \
    'var1 = line1_var3 = line6_  inherited_lines_  - : var1="line1"_  - : var3="line6"_            LOAD BLOCK STATE MODIFICATION DEMO__This document demonstrates how a LOAD block can modify_the inherited state that was initially set by VARS_blocks.__First, establish baseline variables using a VARS block:__Use a LOAD block to modify the initial state:__load-mode-default_load-mode-append_load-mode-replace'
 }
 
-@test 'load-mode-default' {
+@test 'applies load-mode-default to inherited state' {
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/load-vars-state-demo.md \
    load-mode-default \
    'var1 = line1_var3 = line6_  inherited_lines_  - : var1="line1"_  - : var3="line6"_  inherited_lines_  - : var1="line1"_  - : var3="line6"_  - : # line 1_  - : var1=line2_  - : # line 3_  - : var2=line4_  - : # line 5_            LOAD BLOCK STATE MODIFICATION DEMO__This document demonstrates how a LOAD block can modify_the inherited state that was initially set by VARS_blocks.__First, establish baseline variables using a VARS block:__Use a LOAD block to modify the initial state:__load-mode-default_load-mode-append_load-mode-replace'
 }
 
-@test 'load-mode-append' {
+@test 'appends to inherited state with load-mode-append' {
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/load-vars-state-demo.md \
    load-mode-append \
    'var1 = line1_var3 = line6_  inherited_lines_  - : var1="line1"_  - : var3="line6"_  inherited_lines_  - : var1="line1"_  - : var3="line6"_  - : # line 1_  - : var1=line2_  - : # line 3_  - : var2=line4_  - : # line 5_            LOAD BLOCK STATE MODIFICATION DEMO__This document demonstrates how a LOAD block can modify_the inherited state that was initially set by VARS_blocks.__First, establish baseline variables using a VARS block:__Use a LOAD block to modify the initial state:__load-mode-default_load-mode-append_load-mode-replace'
 }
 
-@test 'load-mode-replace' {
+@test 'replaces inherited state with load-mode-replace' {
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/load-vars-state-demo.md \
    load-mode-replace \
    'var1 = line1_var3 = line6_  inherited_lines_  - : var1="line1"_  - : var3="line6"_  inherited_lines_  - : # line 1_  - : var1=line2_  - : # line 3_  - : var2=line4_  - : # line 5_            LOAD BLOCK STATE MODIFICATION DEMO__This document demonstrates how a LOAD block can modify_the inherited state that was initially set by VARS_blocks.__First, establish baseline variables using a VARS block:__Use a LOAD block to modify the initial state:__load-mode-default_load-mode-append_load-mode-replace'

data/bats/markup.bats

@@ -4,17 +4,17 @@ load 'test_helper'
 
 # Text Decoration
 
-@test 'Options - list blocks - 1 plain' {
+@test 'displays text decoration with markup' {
  spec_mde_xansi_oname_doc_blocks_expect docs/dev/text-decoration.md \
   '- **_Bold-Underline_**_- **Bold**_- **~Bold-Italic~**_- __Underline___- _~Underline-Italic~__- `Italic`_- ~~Strikethrough~~'
 }
 
-@test 'Options - list blocks - 2 extracts markup' {
+@test 'extracts markup from text decoration' {
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/text-decoration.md \
    '- Bold-Underline_- Bold_- Bold-Italic_- Underline_- Underline-Italic_- Italic_- Strikethrough'
 }
 
-@test 'Options - list blocks - 3 decorates' {
+@test 'applies ANSI decoration to text' {
   spec_mde_args_expect docs/dev/text-decoration.md \
    --blocks dname \
    $'\x1b\x5b\x33\x38\x3b\x32\x3b\x31\x39\x32\x3b\x31\x39\x32\x3b\x31\x39\x32\x6d\x2d\x20\x1b\x5b\x30\x6d\x1b\x5b\x31\x6d\x1b\x5b\x34\x6d\x42\x6f\x6c\x64\x2d\x55\x6e\x64\x65\x72\x6c\x69\x6e\x65\x1b\x5b\x32\x32\x6d\x1b\x5b\x32\x34\x6d\x0a\x1b\x5b\x33\x38\x3b\x32\x3b\x31\x39\x32\x3b\x31\x39\x32\x3b\x31\x39\x32\x6d\x2d\x20\x1b\x5b\x30\x6d\x1b\x5b\x31\x6d\x42\x6f\x6c\x64\x1b\x5b\x32\x32\x6d\x0a\x1b\x5b\x33\x38\x3b\x32\x3b\x31\x39\x32\x3b\x31\x39\x32\x3b\x31\x39\x32\x6d\x2d\x20\x1b\x5b\x30\x6d\x1b\x5b\x31\x6d\x1b\x5b\x33\x6d\x42\x6f\x6c\x64\x2d\x49\x74\x61\x6c\x69\x63\x1b\x5b\x32\x32\x6d\x1b\x5b\x32\x33\x6d\x0a\x1b\x5b\x33\x38\x3b\x32\x3b\x31\x39\x32\x3b\x31\x39\x32\x3b\x31\x39\x32\x6d\x2d\x20\x1b\x5b\x30\x6d\x1b\x5b\x34\x6d\x55\x6e\x64\x65\x72\x6c\x69\x6e\x65\x1b\x5b\x32\x34\x6d\x0a\x1b\x5b\x33\x38\x3b\x32\x3b\x31\x39\x32\x3b\x31\x39\x32\x3b\x31\x39\x32\x6d\x2d\x20\x1b\x5b\x30\x6d\x1b\x5b\x34\x6d\x1b\x5b\x33\x6d\x55\x6e\x64\x65\x72\x6c\x69\x6e\x65\x2d\x49\x74\x61\x6c\x69\x63\x1b\x5b\x32\x33\x6d\x1b\x5b\x32\x34\x6d\x0a\x1b\x5b\x33\x38\x3b\x32\x3b\x31\x39\x32\x3b\x31\x39\x32\x3b\x31\x39\x32\x6d\x2d\x20\x1b\x5b\x30\x6d\x1b\x5b\x33\x6d\x49\x74\x61\x6c\x69\x63\x1b\x5b\x32\x33\x6d\x0a\x1b\x5b\x33\x38\x3b\x32\x3b\x31\x39\x32\x3b\x31\x39\x32\x3b\x31\x39\x32\x6d\x2d\x20\x1b\x5b\x30\x6d\x1b\x5b\x39\x6d\x53\x74\x72\x69\x6b\x65\x74\x68\x72\x6f\x75\x67\x68\x1b\x5b\x32\x39\x6d'
@@ -32,7 +32,7 @@ load 'test_helper'
 # }
 
 # test ANSI escape sequence removal within BATS
-@test "comparison with ANSI removal" {
+@test 'removes ANSI escape sequences' {
   actual="Hello, \e[31mWorld\e[0m!"
   echo 'actual'
   echo -en "$actual" | hexdump -C

data/bats/mde.bats

@@ -4,14 +4,14 @@ load 'test_helper'
 
 # Directives
 
-@test 'Directives - Import' {
+@test 'executes block from imported file' {
   # this shell block is in the import, not the primary document
   run_mde_specs_md_args_expect_xansi 'shell-block-in-import' ' shell-block-in-import'
 }
 
 # Blocks, Wrapped
 
-@test 'Shell blocks - wrapped block; nested; inverted' {
+@test 'executes wrapped blocks with nested and inverted nesting' {
   run_mde_specs_md_args_expect_xansi '[single]' ' outer-before single-body outer-after'
   run_mde_specs_md_args_expect_xansi '[nested]' ' outer-before inner-before nested-body inner-after outer-after'
   run_mde_specs_md_args_expect_xansi '[inverted-nesting]' ' inner-before outer-before inverted-nesting outer-after inner-after'
@@ -19,11 +19,11 @@ load 'test_helper'
 
 # Blocks, Wrapped, Imported
 
-@test 'Shell blocks - wrapped block; imported' {
+@test 'executes wrapped block from imported file' {
   # the wrap blocks are in the import, not the primary document
   run_mde_specs_md_args_expect_xansi '[test-wrap-from-import]' ' wrap-from-import-before test-wrap-from-import wrap-from-import-after'
 }
 
-@test 'Shell blocks - required; wrapped block' {
+@test 'executes required wrapped block' {
   run_mde_specs_md_args_expect_xansi '[test-require-wrapped-block]' ' outer-before single-body outer-after test-require-wrapped-block'
 }

data/bats/option-expansion.bats

@@ -2,7 +2,7 @@
 
 load 'test_helper'
 
-@test '' {
+@test 'expands options in table columns' {
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/option-expansion.md \
    '_| Opti | Description                  | Valu | Va | Defau |_| ---- | ---------------------------- | ---- | -- | ----- |_| scre | Screen width for document an | 2    | 64 | 0     |_| tabl |                              | 5    | fa | true  |'
 }

data/bats/options-collapse.bats

@@ -2,24 +2,24 @@
 
 load 'test_helper'
 
-@test 'Options - Collapsible - Document options' {
+@test 'collapses document options by default' {
   spec_mde_xansi_oname_doc_blocks_expect docs/dev/options-collapse.md \
    'H1.1_L1.1_H2.1_H1.2_H1.3_L1.3_H2.3_L2.3_h3.3_L3.3_D4.3_L4.3'
 }
 
-@test 'Options - Collapsible Heading - Expand' {
+@test 'expands collapsible heading when selected' {
   spec_mde_xansi_oname_doc_blocks_expect docs/dev/options-collapse.md \
    H2.1 \
    'H1.1_L1.1_H2.1_L2.1_h3.1_L3.1_D4.1_L4.1_H1.2_H1.3_L1.3_H2.3_L2.3_h3.3_L3.3_D4.3_L4.3'
 }
 
-@test 'Options - Collapsible Divider' {
+@test 'expands collapsible divider when selected' {
   spec_mde_xansi_oname_doc_blocks_expect docs/dev/options-collapse.md \
    D4.3 \
    'H1.1_L1.1_H2.1_H1.2_H1.3_L1.3_H2.3_L2.3_h3.3_L3.3_D4.3'
 }
 
-@test 'Options - Reveal' {
+@test 'reveals multiple collapsed sections' {
   spec_mde_xansi_oname_doc_blocks_expect docs/dev/options-collapse.md \
    H1.2 H2.2 h3.2 D4.2 \
    'H1.1_L1.1_H2.1_H1.2_L1.2_H2.2_L2.2_h3.2_L3.2_D4.2_L4.2_H1.3_L1.3_H2.3_L2.3_h3.3_L3.3_D4.3_L4.3'

data/bats/options.bats

@@ -4,59 +4,89 @@ load 'test_helper'
 
 # Defaults
 
-@test 'Options - document and block name' {
+@test 'executes block from document' {
   run_mde_specs_md_args_expect_xansi bash1 \
    ' bash1!'
 }
 
 # Options
 
-@test 'Options - block-name' {
+@test 'executes block using block-name option' {
   BATS_OUTPUT_FILTER=A
   spec_mde_args_expect --block-name bash1 docs/dev/specs.md \
    ' bash1!'
 }
 
-@test 'Options - find, find-path in directory names' {
+@test 'find-path searches directory names' {
   run_mde_specs_md_args_expect_xansi --find-path ./docs --find search \
    'Searching in: ./docs In directory names ./docs/research In file names ./docs/dev/import-substitution-research.md'
 }
 
-@test 'Options - find, find-path in file names' {
+@test 'find-path searches file names' {
   run_mde_specs_md_args_expect_xansi --find-path ./examples --find search \
    'Searching in: ./examples In file names ./examples/search.md'
 }
 
-@test 'Options - list blocks' {
+@test 'lists blocks' {
   BATS_OUTPUT_FILTER=A
   spec_mde_args_expect --list-blocks-message oname --list-blocks-type 0 examples/colors.md --list-blocks \
    'load_colors load_colors2 Unspecified1 Unknown1 Bash1 Edit-inherited-blocks History1 Link1 Load1 Opts1 Port1 Save1  Vars1'
 }
 
-@test 'Options - list blocks, eval' {
+@test 'lists blocks with eval' {
   BATS_OUTPUT_FILTER=A
   spec_mde_args_expect --list-blocks-eval block.oname examples/colors.md --list-blocks \
    'load_colors load_colors2 Unspecified1 Unknown1 Bash1 Edit-inherited-blocks History1 Link1 Load1 Opts1 Port1 Save1  Vars1'
 }
 
-@test 'Options - how' {
+@test 'shows how option format' {
   spec_mde_args_expect --how how \
-   "prompt_show_expr_format: 'Expr: %{expr}'      # prompt_show_expr_format"
+   "prompt_show_expr_format: 'Expr: %{expr}'      # Format string for displaying expression values in prompts"
 }
 
-@test 'Options - list-default-env' {
+@test 'hide_shebang default value in environment variables output' {
+  # [REQ:SHEBANG_HIDING] Verify hide_shebang option appears with default value in env output
+  # [IMPL:CLI_OPTION_IMPLEMENTATION] [ARCH:CLI_OPTION_DESIGN] [REQ:SHEBANG_HIDING]
   BATS_OUTPUT_GREP=SHEBANG
   spec_mde_args_expect --list-default-env \
-   "MDE_SHEBANG=\#\!/usr/bin/env      # Shebang for saved scripts"
+   "MDE_HIDE_SHEBANG=t      # Hide shebang lines in document output
+MDE_SHEBANG=\#\!/usr/bin/env      # Shebang for saved scripts"
 }
 
-@test 'Options - list-default-yaml' {
+@test 'hide_shebang default value in YAML output' {
+  # [REQ:SHEBANG_HIDING] Verify hide_shebang option appears with default value in YAML output
+  # [IMPL:CLI_OPTION_IMPLEMENTATION] [ARCH:CLI_OPTION_DESIGN] [REQ:SHEBANG_HIDING]
+  BATS_OUTPUT_FILTER=A
   BATS_OUTPUT_GREP=shebang
   spec_mde_args_expect --list-default-yaml \
-   "shebang: '#!/usr/bin/env'      # Shebang for saved scripts"
+   "hide_shebang: true      # Hide shebang lines in document output shebang: '#!/usr/bin/env'      # Shebang for saved scripts"
+}
+
+@test 'shebang lines hidden by default in document processing' {
+  # [REQ:SHEBANG_HIDING] Verify shebang lines are filtered from document output by default
+  # [IMPL:SHEBANG_FILTERING] [ARCH:SHEBANG_EXTRACTION] [REQ:SHEBANG_HIDING]
+  BATS_OUTPUT_FILTER=A
+  spec_mde_args_expect docs/dev/shebang.md --blocks dname \
+    'Demonstrate opening the document via Shebang. print-test'
+}
+
+@test 'markdown file with shebang executable directly' {
+  # [REQ:SHEBANG_HIDING] Verify markdown files with shebang can be executed directly
+  # [ARCH:SHEBANG_EXTRACTION] [REQ:SHEBANG_HIDING]
+  output="$(./docs/dev/shebang.md --blocks dname)"
+  output="$(remove_ansi_escape_sequences "$output")"
+  [[ "$output" == "Demonstrate opening the document via Shebang. print-test" ]]
+}
+
+@test 'shebang file executes specified block name directly' {
+  # [REQ:SHEBANG_HIDING] Verify shebang files can execute specific blocks when block name provided
+  # [ARCH:SHEBANG_EXTRACTION] [REQ:SHEBANG_HIDING]
+  output="$(./docs/dev/shebang.md print-test)"
+  output="$(remove_ansi_escape_sequences "$output")"
+  [[ "$output" == " Test" ]]
 }
 
-@test 'Options - list-docs, path' {
+@test 'lists documents in path' {
   BATS_OUTPUT_FILTER=A
   BATS_OUTPUT_GREP=specs
   spec_mde_args_expect --path docs/dev --list-docs \
@@ -71,26 +101,26 @@ load 'test_helper'
 #     "?"
 # }
 
-@test 'Options - load-code' {
+@test 'loads code from file' {
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/load_code.md \
    --load-code docs/dev/load1.sh \
    --blocks dname \
    'Demonstrate loading inherited code via the command line.__Run this command to display the inherited code._mde --load-code docs/dev/load1.sh docs/dev/load_code.md__| Variable | Value |_| -------- | ----- |_| var1     | line2 |_| var2     | line4 |'
 }
 
-@test 'Options - pwd' {
+@test 'prints working directory' {
   spec_mde_args_expect --pwd \
    $(pwd)
 }
 
-@test 'Options - tab-completions' {
+@test 'shows tab completions' {
   BATS_OUTPUT_FILTER=A
   BATS_OUTPUT_GREP=find
   spec_mde_args_expect --tab-completions \
    '--find --find-path'
 }
 
-@test 'Options - version' {
+@test 'displays version' {
   version=$(grep VERSION "lib/markdown_exec/version.rb" | cut -d "'" -f 2)
   spec_mde_args_expect --version \
    "$version"

data/bats/plain.bats

@@ -2,7 +2,7 @@
 
 load 'test_helper'
 
-@test 'no-active-elements' {
+@test 'renders document with no active elements' {
   spec_mde_xansi_dname_doc_blocks_expect docs/dev/no-active-elements.md \
    'DEMONSTRATE A DOCUMENT WITH NO ACTIVE ELEMENTS_A document with no active elements.'
 }