markdown_exec 1.4.1 → 1.6

data/lib/menu.src.yml

@@ -2,16 +2,19 @@
 - :description: Show current configuration values
   :procname: show_config
   :short_name: '0'
+
 - :arg_name: BOOL
   :default: false
   :description: Display only blocks of type "bash"
   :env_var: MDE_BASH_ONLY
   :opt_name: bash_only
   :procname: val_as_bool
+
 - :default: "%\\([^\\)]+\\)"
   :env_var: MDE_BLOCK_CALLS_SCAN
   :opt_name: block_calls_scan
   :procname: val_as_str
+
 - :arg_name: NAME
   :compreply: false
   :description: Name of block
@@ -20,46 +23,56 @@
   :opt_name: block_name
   :procname: val_as_str
   :short_name: b
+
 - :default: "^-.+-$"
   :description: Pattern for blocks to hide from user-selection
   :env_var: MDE_BLOCK_NAME_HIDDEN_MATCH
   :opt_name: block_name_hidden_match
   :procname: val_as_str
+
 - :default: "^[\\(\\[].*[\\)\\]]$"
   :description: Pattern for blocks to hide from user-selection
   :env_var: MDE_BLOCK_NAME_INCLUDE_MATCH
   :opt_name: block_name_include_match
   :procname: val_as_str
+
 - :default: ":(?<title>\\S+)( |$)"
   :env_var: MDE_BLOCK_NAME_MATCH
   :opt_name: block_name_match
   :procname: val_as_str
+
 - :default: "^{.+}$"
   :description: Pattern for block names to use as wrappers
   :env_var: MDE_BLOCK_NAME_WRAPPER_MATCH
   :opt_name: block_name_wrapper_match
   :procname: val_as_str
+
 - :default: "\\+\\S+"
   :env_var: MDE_BLOCK_REQUIRED_SCAN
   :opt_name: block_required_scan
   :procname: val_as_str
+
 - :default: "<(?<full>(?<type>\\$)?(?<name>[A-Za-z_\\-\\.\\w]+))"
   :env_var: MDE_BLOCK_STDIN_SCAN
   :opt_name: block_stdin_scan
   :procname: val_as_str
+
 - :default: ">(?<full>(?<type>\\$)?(?<name>[A-Za-z_\\-\\.\\w]+))"
   :env_var: MDE_BLOCK_STDOUT_SCAN
   :opt_name: block_stdout_scan
   :procname: val_as_str
+
 - :default: ": ${%{key}:=%{value}}"
   :env_var: MDE_BLOCK_TYPE_PORT_SET_FORMAT
   :opt_name: block_type_port_set_format
   :procname: val_as_str
+
 - :arg_name: PATH
   :default: "."
   :description: Read configuration file
   :long_name: config
   :procname: path
+
 - :arg_name: BOOL
   :default: false
   :description: Debug output
@@ -67,40 +80,56 @@
   :long_name: debug
   :procname: debug
   :short_name: d
+
 - :default: "> "
   :env_var: MDE_DISPLAY_LEVEL_XBASE_PREFIX
   :opt_name: display_level_xbase_prefix
   :procname: val_as_str
+
+- :default: "(document_options)"
+  :description: Name of Opts block to load with the document
+  :env_var: MDE_DOCUMENT_LOAD_OPTS_BLOCK_NAME
+  :opt_name: document_load_opts_block_name
+  :procname: val_as_str
+
 - :arg_name: REGEX
   :default:
   :description: Exclude blocks with name matching
   :env_var: MDE_EXCLUDE_BY_NAME_REGEX
   :opt_name: exclude_by_name_regex
   :procname: val_as_str
+
 - :arg_name: REGEX
   :default:
   :description: Exclude blocks with shell matching
   :env_var: MDE_EXCLUDE_BY_SHELL_REGEX
   :opt_name: exclude_by_shell_regex
   :procname: val_as_str
+
 - :arg_name: BOOL
   :default: true
   :description: Hide all blocks of type "expect"
   :env_var: MDE_EXCLUDE_EXPECT_BLOCKS
   :opt_name: exclude_expect_blocks
   :procname: val_as_bool
+
 - :description: Exit app
   :long_name: exit
   :procname: exit
   :short_name: x
-- :default: "^`{3,}"
+
+## match fenced code indented by spaces
+#
+- :default: "^(?<indent> *)`{3,}"
   :env_var: MDE_FENCED_START_AND_END_REGEX
   :opt_name: fenced_start_and_end_regex
   :procname: val_as_str
-- :default: "^`{3,}(?<shell>[^`\\s]*) *:?(?<name>[^\\s]*) *(?<rest>.*) *$"
+
+- :default: "^(?<indent> *)`{3,}(?<shell>[^`\\s]*) *:?(?<name>[^\\s]*) *(?<rest>.*) *$"
   :env_var: MDE_FENCED_START_EXTENDED_REGEX
   :opt_name: fenced_start_extended_regex
   :procname: val_as_str
+
 - :arg_name: RELATIVE_PATH
   :compreply: "."
   :description: Name of document
@@ -109,22 +138,27 @@
   :opt_name: filename
   :procname: val_as_str
   :short_name: f
+
 - :default: "^# *(?<name>[^#]*?) *$"
   :env_var: MDE_HEADING1_MATCH
   :opt_name: heading1_match
   :procname: val_as_str
+
 - :default: "^## *(?<name>[^#]*?) *$"
   :env_var: MDE_HEADING2_MATCH
   :opt_name: heading2_match
   :procname: val_as_str
+
 - :default: "^### *(?<name>.+?) *$"
   :env_var: MDE_HEADING3_MATCH
   :opt_name: heading3_match
   :procname: val_as_str
+
 - :description: App help
   :long_name: help
   :procname: help
   :short_name: h
+
 - :arg_name: BOOL
   :default: true
   :description: |-
@@ -133,22 +167,27 @@
   :env_var: MDE_HIDE_BLOCKS_BY_NAME
   :opt_name: hide_blocks_by_name
   :procname: val_as_bool
+
 - :default: "|"
   :env_var: MDE_HISTORY_DOCUMENT_SEPARATOR
   :opt_name: history_document_separator
   :procname: val_as_str
+
 - :default: "&"
   :env_var: MDE_HISTORY_PROPERTY_SEPARATOR
   :opt_name: history_property_separator
   :procname: val_as_str
+
 - :default: "^ *@import (.+)$"
   :env_var: MDE_IMPORT_PATTERN
   :opt_name: import_pattern
   :procname: val_as_str
+
 - :description: List blocks
   :long_name: list-blocks
   :opt_name: list_blocks
   :procname: val_as_bool
+
 - :arg_name: INT.1-
   :default: 32
   :description: Max. items to return in list
@@ -156,190 +195,270 @@
   :long_name: list-count
   :opt_name: list_count
   :procname: val_as_int
+
 - :description: List default configuration as environment variables
   :long_name: list-default-env
   :opt_name: list_default_env
+
 - :description: List default configuration as YAML
   :long_name: list-default-yaml
   :opt_name: list_default_yaml
+
 - :description: List docs in current folder
   :long_name: list-docs
   :opt_name: list_docs
   :procname: val_as_bool
+
 - :description: List recent saved output
   :long_name: list-recent-output
   :opt_name: list_recent_output
   :procname: val_as_bool
+
 - :description: List recent saved scripts
   :long_name: list-recent-scripts
   :opt_name: list_recent_scripts
   :procname: val_as_bool
+
 - :arg_name: PREFIX
   :default: mde
   :description: Name prefix for stdout files
   :env_var: MDE_LOGGED_STDOUT_FILENAME_PREFIX
   :opt_name: logged_stdout_filename_prefix
   :procname: val_as_str
+
 - :default: "*.[Mm][Dd]"
   :env_var: MDE_MD_FILENAME_GLOB
   :opt_name: md_filename_glob
   :procname: val_as_str
+
 - :default: ".+\\.md"
   :env_var: MDE_MD_FILENAME_MATCH
   :opt_name: md_filename_match
   :procname: val_as_str
+
 - :arg_name: BOOL
   :default: true
   :description: Display Back option at top of menu (vs bottom)
   :env_var: MDE_MENU_BACK_AT_TOP
   :opt_name: menu_back_at_top
   :procname: val_as_bool
+
 - :default: plain
   :description: Color of menu bash
   :env_var: MDE_MENU_BASH_COLOR
   :opt_name: menu_bash_color
   :procname: val_as_str
+
 - :arg_name: BOOL
   :default: false
   :description: Display document name in block selection menu
   :env_var: MDE_MENU_BLOCKS_WITH_DOCNAME
   :opt_name: menu_blocks_with_docname
   :procname: val_as_bool
+
 - :arg_name: BOOL
   :default: false
   :description: Display headings (levels 1,2,3) in block selection menu
   :env_var: MDE_MENU_BLOCKS_WITH_HEADINGS
   :opt_name: menu_blocks_with_headings
   :procname: val_as_bool
+
+- :default: fg_rgbh_aa_bb_aa
+  :description: Color of menu chrome
+  :env_var: MDE_MENU_CHROME_COLOR
+  :opt_name: menu_chrome_color
+  :procname: val_as_str
+
+- :default: "%{line}"
+  :description: format for menu chromes
+  :env_var: MDE_MENU_CHROME_FORMAT
+  :opt_name: menu_chrome_format
+  :procname: val_as_str
+
 - :default: magenta
   :description: Color of menu divider
   :env_var: MDE_MENU_DIVIDER_COLOR
   :opt_name: menu_divider_color
   :procname: val_as_str
-- :default: "-:=   %s   =:-"
+
+- :default: "-:=   %{line}   =:-"
   :description: format for menu dividers and demarcations
   :env_var: MDE_MENU_DIVIDER_FORMAT
   :opt_name: menu_divider_format
   :procname: val_as_str
-- :default: "^::: +(?<name>.+?)$"
+
+- :default: "^::: +(?<line>.+?)$"
   :description: Pattern for topics/dividers in block selection menu
   :env_var: MDE_MENU_DIVIDER_MATCH
   :opt_name: menu_divider_match
   :procname: val_as_str
+
 - :default: ">"
   :description: Symbol before each divider
   :env_var: MDE_MENU_DIVIDER_SYMBOL
   :opt_name: menu_divider_symbol
   :procname: val_as_str
+
 - :arg_name: BOOL
   :default: true
   :description: Display Exit option at top of menu (vs bottom)
   :env_var: MDE_MENU_EXIT_AT_TOP
   :opt_name: menu_exit_at_top
   :procname: val_as_bool
-- :default: "~~~"
+
+- :default:
+    :line: "~~~"
   :description: closing demarcations for menu
   :env_var: MDE_MENU_FINAL_DIVIDER
   :opt_name: menu_final_divider
   :procname: val_as_str
-- :default: ''
+
+- :default:
+    :line: ""
   :description: opening demarcation for menu
   :env_var: MDE_MENU_INITIAL_DIVIDER
   :opt_name: menu_initial_divider
   :procname: val_as_str
+
 - :default: red
   :description: Color of menu link
   :env_var: MDE_MENU_LINK_COLOR
   :opt_name: menu_link_color
   :procname: val_as_str
-- :default: "* Back"
+
+- :default: "%{line}"
+  :description: format for menu link
+  :env_var: MDE_MENU_LINK_FORMAT
+  :opt_name: menu_link_format
+  :procname: val_as_str
+
+- :default: fg_rgbh_88_88_88
+  :description: Color of menu note
+  :env_var: MDE_MENU_NOTE_COLOR
+  :opt_name: menu_note_color
+  :procname: val_as_str
+
+- :default: "%{line}"
+  :description: format for menu notes
+  :env_var: MDE_MENU_NOTE_FORMAT
+  :opt_name: menu_note_format
+  :procname: val_as_str
+
+## all non-blank lines are notes
+#
+- :default: "^(?<line>.*?) *$"
+  :description: Pattern for notes in block selection menu
+  :env_var: MDE_MENU_NOTE_MATCH
+  :opt_name: menu_note_match
+  :procname: val_as_str
+
+- :default:
+    :line: "* Back"
   :description: Text for Back option
   :env_var: MDE_MENU_OPTION_BACK_NAME
   :opt_name: menu_option_back_name
   :procname: val_as_str
-- :default: "* Exit"
+
+- :default:
+    :line: "* Exit"
   :description: Text for Exit option
   :env_var: MDE_MENU_OPTION_EXIT_NAME
   :opt_name: menu_option_exit_name
   :procname: val_as_str
+
 - :default: blue
   :description: Color of menu opts
   :env_var: MDE_MENU_OPTS_COLOR
   :opt_name: menu_opts_color
   :procname: val_as_str
+
 - :default: cyan
   :description: Color of menu opts
   :env_var: MDE_MENU_OPTS_SET_COLOR
   :opt_name: menu_opts_set_color
   :procname: val_as_str
+
 - :default: "%{key} = %{value}\n"
   :description: format for menu opts output
   :env_var: MDE_MENU_OPTS_SET_FORMAT
   :opt_name: menu_opts_set_format
   :procname: val_as_str
+
 - :default: cyan
   :description: Color of menu task
   :env_var: MDE_MENU_TASK_COLOR
   :opt_name: menu_task_color
   :procname: val_as_str
+
 - :default: "%{name} [%{status}]"
   :description: format for menu tasks and demarcations
   :env_var: MDE_MENU_TASK_FORMAT
   :opt_name: menu_task_format
   :procname: val_as_str
+
 - :default: "^ *\\[(?<status>.{1,4})\\] *(?<name>.*) *$"
   :description: Pattern for tasks
   :env_var: MDE_MENU_TASK_MATCH
   :opt_name: menu_task_match
   :procname: val_as_str
+
 - :default: ">"
   :description: Symbol before each task
   :env_var: MDE_MENU_TASK_SYMBOL
   :opt_name: menu_task_symbol
   :procname: val_as_str
+
 - :default: blue
   :description: Color of menu vars
   :env_var: MDE_MENU_VARS_COLOR
   :opt_name: menu_vars_color
   :procname: val_as_str
+
 - :default: cyan
   :description: Color of menu vars
   :env_var: MDE_MENU_VARS_SET_COLOR
   :opt_name: menu_vars_set_color
   :procname: val_as_str
+
 - :default: "%{key} = %{value}\n"
   :description: format for menu vars output
   :env_var: MDE_MENU_VARS_SET_FORMAT
   :opt_name: menu_vars_set_format
   :procname: val_as_str
+
 - :arg_name: BOOL
   :default: true
   :description: Display Back option in menu
   :env_var: MDE_MENU_WITH_BACK
   :opt_name: menu_with_back
   :procname: val_as_bool
+
 - :arg_name: BOOL
   :default: true
   :description: Display Exit option in menu
   :env_var: MDE_MENU_WITH_EXIT
   :opt_name: menu_with_exit
   :procname: val_as_bool
+
 - :arg_name: BOOL
   :default: false
   :description: Hide decorative menu entries
   :env_var: MDE_NO_CHROME
   :opt_name: no_chrome
   :procname: val_as_bool
+
 - :default: " #=#=#"
   :description: Output divider
   :env_var: MDE_OUTPUT_DIVIDER
   :opt_name: output_divider
   :procname: val_as_str
+
 - :default: yellow
   :description: Color of output divider
   :env_var: MDE_OUTPUT_DIVIDER_COLOR
   :opt_name: output_divider_color
   :procname: val_as_str
+
 - :arg_name: BOOL
   :default: false
   :description: Display summary for execution
@@ -347,12 +466,14 @@
   :long_name: output-execution-summary
   :opt_name: output_execution_summary
   :procname: val_as_bool
+
 - :arg_name: BOOL
   :default: false
   :description: Output saved script filename at end of execution
   :env_var: MDE_OUTPUT_SAVED_SCRIPT_FILENAME
   :opt_name: output_saved_script_filename
   :procname: val_as_bool
+
 - :arg_name: BOOL
   :default: false
   :description: Display script prior to execution
@@ -360,6 +481,7 @@
   :long_name: output-script
   :opt_name: output_script
   :procname: val_as_bool
+
 - :arg_name: BOOL
   :default: true
   :description: Display standard output from execution
@@ -367,10 +489,12 @@
   :long_name: output-stdout
   :opt_name: output_stdout
   :procname: val_as_bool
+
 - :description: Options for viewing saved output file
   :env_var: MDE_OUTPUT_VIEWER_OPTIONS
   :opt_name: output_viewer_options
   :procname: val_as_str
+
 - :arg_name: RELATIVE_PATH
   :default: "."
   :description: Path to documents
@@ -379,54 +503,84 @@
   :opt_name: path
   :procname: val_as_str
   :short_name: p
+
+- :arg_name: BOOL
+  :default: true
+  :description: Pause afte executing a BASH block
+  :env_var: MDE_PAUSE_AFTER_BASH_EXEC
+  :opt_name: pause_after_bash_exec
+  :procname: val_as_bool
+
+- :default: Continue?
+  :description: Prompt to continue
+  :env_var: MDE_PROMPT_AFTER_BASH_EXEC
+  :opt_name: prompt_after_bash_exec
+  :procname: val_as_str
+
 - :default: Process?
   :description: Prompt to approve a block
   :env_var: MDE_PROMPT_APPROVE_BLOCK
   :opt_name: prompt_approve_block
   :procname: val_as_str
+
+- :default: Exit
+  :description: Prompt to exit app
+  :env_var: MDE_PROMPT_EXIT
+  :opt_name: prompt_exit
+  :procname: val_as_str
+
 - :default: 'No'
   :description: Prompt for no
   :env_var: MDE_PROMPT_NO
   :opt_name: prompt_no
   :procname: val_as_str
+
 - :default: Save script
   :description: Prompt to save script
   :env_var: MDE_PROMPT_SAVE_SCRIPT
   :opt_name: prompt_save_script
   :procname: val_as_str
+
 - :default: Copy script to clipboard
   :description: Prompt to copy script to clipboard
   :env_var: MDE_PROMPT_SCRIPT_TO_CLIPBOARD
   :opt_name: prompt_script_to_clipboard
   :procname: val_as_str
+
 - :default: 'Choose a block:'
   :description: Prompt to select a block
   :env_var: MDE_PROMPT_SELECT_BLOCK
   :opt_name: prompt_select_block
   :procname: val_as_str
+
 - :default: 'Choose a file:'
   :description: Prompt to select a markdown document
   :env_var: MDE_PROMPT_SELECT_MD
   :opt_name: prompt_select_md
   :procname: val_as_str
+
 - :default: 'Choose a file:'
   :description: Prompt to select a saved file
   :env_var: MDE_PROMPT_SELECT_OUTPUT
   :opt_name: prompt_select_output
   :procname: val_as_str
+
 - :default: 'Yes'
   :description: Prompt for yes
   :env_var: MDE_PROMPT_YES
   :opt_name: prompt_yes
   :procname: val_as_str
+
 - :description: Gem home folder
   :long_name: pwd
   :opt_name: pwd
   :procname: val_as_bool
+
 - :description: Run most recently saved script
   :long_name: run-last-script
   :opt_name: run_last_script
   :procname: val_as_bool
+
 - :arg_name: BOOL
   :default: false
   :description: Save executed script
@@ -434,6 +588,7 @@
   :long_name: save-executed-script
   :opt_name: save_executed_script
   :procname: val_as_bool
+
 - :arg_name: BOOL
   :default: false
   :description: Save standard output of the executed script
@@ -441,18 +596,21 @@
   :long_name: save-execution-output
   :opt_name: save_execution_output
   :procname: val_as_bool
+
 - :arg_name: INT
   :default: 493
   :description: chmod for saved scripts
   :env_var: MDE_SAVED_SCRIPT_CHMOD
   :opt_name: saved_script_chmod
   :procname: val_as_int
+
 - :arg_name: PREFIX
   :default: mde
   :description: Name prefix for saved scripts
   :env_var: MDE_SAVED_SCRIPT_FILENAME_PREFIX
   :opt_name: saved_script_filename_prefix
   :procname: val_as_str
+
 - :arg_name: RELATIVE_PATH
   :default: logs
   :description: Saved script folder
@@ -460,12 +618,14 @@
   :long_name: saved-script-folder
   :opt_name: saved_script_folder
   :procname: val_as_str
+
 - :arg_name: GLOB
   :default: mde_*.sh
   :description: Glob matching saved scripts
   :env_var: MDE_SAVED_SCRIPT_GLOB
   :opt_name: saved_script_glob
   :procname: val_as_str
+
 - :arg_name: RELATIVE_PATH
   :default: logs
   :description: Saved stdout folder
@@ -473,51 +633,61 @@
   :long_name: saved-stdout-folder
   :opt_name: saved_stdout_folder
   :procname: val_as_str
+
 - :arg_name: GLOB
   :default: mde_*.out.txt
   :description: Glob matching saved outputs
   :env_var: MDE_SAVED_STDOUT_GLOB
   :opt_name: saved_stdout_glob
   :procname: val_as_str
+
 - :arg_name: REGEX
   :default:
   :description: Select blocks with name matching
   :env_var: MDE_SELECT_BY_NAME_REGEX
   :opt_name: select_by_name_regex
   :procname: val_as_str
+
 - :arg_name: REGEX
   :default:
   :description: Select blocks with shell matching
   :env_var: MDE_SELECT_BY_SHELL_REGEX
   :opt_name: select_by_shell_regex
   :procname: val_as_str
+
 - :default: 36
   :description: 'Maximum # of rows in select list'
   :env_var: MDE_SELECT_PAGE_HEIGHT
   :opt_name: select_page_height
   :procname: val_as_int
+
 - :description: Select and execute a recently saved output
   :long_name: select-recent-output
   :opt_name: select_recent_output
   :procname: val_as_bool
+
 - :description: Select and execute a recently saved script
   :long_name: select-recent-script
   :opt_name: select_recent_script
   :procname: val_as_bool
+
 - :default: "#!/usr/bin/env"
   :description: Shebang for saved scripts
   :env_var: MDE_SHEBANG
   :opt_name: shebang
   :procname: val_as_str
+
 - :default: bash
   :description: Shell for launched scripts
   :env_var: MDE_SHELL
   :opt_name: shell
   :procname: val_as_str
+
 - :description: List tab completions
   :long_name: tab-completions
   :opt_name: tab_completions
   :procname: val_as_bool
+
 - :arg_name: BOOL
   :default: true
   :description: Pause for user to approve script
@@ -526,6 +696,7 @@
   :opt_name: user_must_approve
   :procname: val_as_bool
   :short_name: q
+
 - :description: Print the gem's version
   :long_name: version
   :procname: version