markdown_exec 2.0.6 → 2.0.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d1b2a98d8279b5a5705ba3dc3221d46f55387c0d834ec4283e93ac54f5929835
-  data.tar.gz: 440070d30a4650c0bb8b9a8b472d91d0bcb4357d18f5330194b10d1c5d6a764d
+  metadata.gz: af8a53f03e48c890798b520b84bd0357ccef4f31d93b97cc7cc8b4b72ca1a035
+  data.tar.gz: cd5983d2ff18ee8e2a29da6bea364c03bdaf6a43871d45b16483a8996d129894
 SHA512:
-  metadata.gz: 32702e459d5eeac152583bd7dd8c5de3f6049b0fa8b2c389441f45afadc132678dabbb6898336297d09fa5411ae44963cd0b2353a69f9dc319eb9b302d4ec2db
-  data.tar.gz: a2ea933810ec3e90ed1cc62eccc9a2e8c94ee5dee1ed8c267b8750a97c67fb4a44bbcf8eb471137a65618b991966692d05684b3f69a97e5911dad3a777a15c60
+  metadata.gz: 47e4e75e5a4e473ab9e9726cb7774aec95eb4a26d1d48035e3f6a69df0162c6b004fa625f5ae9f3c973bb25f732c9e938c0008dd07abb759f3211258d943fcc8
+  data.tar.gz: 306fc1218c64d57b1ca82191060298f87f9ae996e43f278cd72144fa3b839e3e4e4b8d3168f34c2fca4bd1ba9fa8ca1ab0a42659980d115b2d3293edc5e75238

data/.rubocop.yml

@@ -13,8 +13,10 @@ Layout/LeadingCommentSpace:
 Layout/LineContinuationLeadingSpace:
   Enabled: false
 
-Layout/LineLength:
-  Max: 96
+Layout/LineLength:  # 2024-01-21 temp disable
+  Enabled: false
+  # Max: 96
+  # Max: 120
 
 Lint/Debugger:
   Enabled: false
@@ -46,6 +48,9 @@ Metrics/CyclomaticComplexity:
 Metrics/MethodLength:
   Enabled: false
 
+Metrics/ParameterLists:
+  Enabled: false
+
 Metrics/PerceivedComplexity:
   Enabled: false
 
@@ -67,6 +72,9 @@ Style/ClassVars:
 Style/CommentedKeyword:
   Enabled: false
 
+Style/Documentation:  # 2024-01-21 temp disable
+  Enabled: false
+
 Style/DoubleNegation:
   Enabled: false
 

data/CHANGELOG.md

@@ -1,5 +1,32 @@
 # Changelog
 
+## [2.0.7] - 2024-06-04
+
+### Added
+
+- Color names that set foreground and background color.
+  Similar to the existing foreground-only color names.
+  The background colors follow the foreground color values in the name.
+  Two names, to accept values as decimal and hex.
+- Example document for line wrapping.
+- Menu entry to execute shell commands.
+- Option to control menu entry for shell commands.
+- Recognition of nicknames in command line processing.
+- Trap user interrupting executing scripts.
+
+### Changed
+
+- Do not decorate indentations.
+- Line-wrap and center headings.
+  Headings are now centered, the text is case-folded and the color
+  (foreground and background) is according to the level.
+  Centering is based on the console width detected.
+- Line-wrap normal document text and format headings.
+- Parse lines into indentation, text, and trailing whitespace.
+- Update nicknames example to exercise hidden blocks from the command line.
+- The optional prompt to exit after execution is now more frequent.
+- Set characters used in saved file names
+
 ## [2.0.6] - 2024-05-28
 
 ### Added

data/Gemfile.lock

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

data/bin/tab_completion.sh

@@ -13,7 +13,7 @@ __filedirs_all()
 }
 
 _mde_echo_version() {
-  echo "2.0.6"
+  echo "2.0.7"
 }
 
 _mde() {
@@ -178,4 +178,4 @@ _mde() {
 
 complete -o filenames -o nospace -F _mde mde
 # _mde_echo_version
-# echo "Updated: 2024-05-31 07:22:55 UTC"
+# echo "Updated: 2024-06-05 03:00:42 UTC"

data/examples/interrupt.md

@@ -0,0 +1,9 @@
+```opts :(document_options)
+pause_after_script_execution: false
+```
+```bash
+tail -f ~/.bash_profile
+```
+```bash
+tail -f ~/.profile
+```

data/examples/line-wrapping.md

@@ -0,0 +1,17 @@
+# Demo wrapping long lines
+
+MDE detects the screen's dimensions: height (lines) and width (characters)
+
+If `select_page_height` is positive, the height of the MDE menu is fixed. Otherwise, the height is derived from the screen's height.
+
+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 two spaces, this line should wrap in an aesthetically pleasing way.
+
+	Indented with a tab, this line should wrap in an aesthetically pleasing way. Indented with a tab, this line should wrap in an aesthetically pleasing way.
+
+# Heading 1 - UPPER lower Mixed - Alpha Beta Gamma Delta Epsilon Zeta Eta Theta Iota Kappa Lambda Mu Nu Xi Omicron Pi Rho Sigma Tau Upsilon Phi Chi Psi Omega
+## Heading 2 - UPPER lower Mixed - Alpha Beta Gamma Delta Epsilon Zeta Eta Theta Iota Kappa Lambda Mu Nu Xi Omicron Pi Rho Sigma Tau Upsilon Phi Chi Psi Omega
+### Heading 3 - UPPER lower Mixed - Alpha Beta Gamma Delta Epsilon Zeta Eta Theta Iota Kappa Lambda Mu Nu Xi Omicron Pi Rho Sigma Tau Upsilon Phi Chi Psi Omega

data/examples/nickname.md

@@ -1,26 +1,63 @@
 # Demo block nicknames
 
 ```opts :(document_options)
-save_executed_script: true
+pause_after_script_execution: true
 ```
 
+## Blocks with no name
 ::: This block has no name.
 ::: The code block is displayed.
 
 ```bash
-echo Unnamed block
+echo This block has no name.
 ```
 
-::: These blocks use nicknames.
-::: The code blocks are displayed.
-::: The nicknames can be used for requiring blocks.
+## Blocks with nicknames
+::: The code block is displayed.
+::: The nickname can be used to require the block.
 
 ```bash :[A]
-echo From the required block 2
+echo 'This block has a nickname: [A].'
+echo The full block is displayed in the menu.
 ```
 
-::: Execute this block that requires the block above.
-
+### Nicknames in documents
+::: Execute this block that requires the block above by its nickname.
 ```bash :[B] +[A]
-echo From the parent block 1
+echo 'This block has a nickname: [B].'
+echo 'This block requires block [A].'
+```
+
+### Nicknames from the command line
+Block `[A]` is called from the command line.
+```bash
+mde examples/nickname.md '[A]'
+```
+
+## Blocks with hidden names
+### There is a hidden block here.
+::: This block has a hidden name: (C).
+::: This block does not appear in the menu.
+::: This block requires the block above by its nickname.
+```bash :(C) +[A]
+echo 'This block has a hidden name: (C).'
+echo This block is hidden from the menu.
+echo 'This block requires block [A].'
+```
+
+### Hidden names from the command line
+Block `(C)` is called from the command line.
+```bash
+mde examples/nickname.md '(C)'
+```
+
+### Block without a name
+::: This block does not have a name.
+::: It requires hidden block (D).
+```bash +(D)
+echo "Block without a name"
+```
+::: This block has a hidden name: (D).
+```bash :(D)
+echo "Block D"
 ```

data/examples/pause-after-execution.md

@@ -0,0 +1,9 @@
+# Demonstrate pause for user approval before returning to the menu
+Controlled by option `pause_after_script_execution`.
+```opts :(document_options)
+pause_after_script_execution: true
+```
+
+```bash
+echo `date`
+```

data/lib/colorize.rb

@@ -13,6 +13,11 @@ class String
   # @return [String] The formatted string.
   def method_missing(method_name, *args, &block)
     case method_name.to_s
+    when /^fg_bg_rgb_/
+      bytes = $'.split('_')
+      fg_bg_rgb_color(bytes[0..2].join(';'), bytes[3..5].join(';'))
+    when /^fg_bg_rgbh_/
+      hex_to_fg_bg_rgb($')
     when /^fg_rgb_/
       fg_rgb_color($'.gsub('_', ';'))
     when /^fg_rgbh_/
@@ -29,6 +34,14 @@ class String
     "\033[#{self}\033[0m"
   end
 
+  # Applies a 24-bit RGB foreground color to the string.
+  #
+  # @param rgb [String] The RGB color, expressed as a string like "1;2;3".
+  # @return [String] The string with the applied RGB foreground color.
+  def fg_bg_rgb_color(fg_rgb, bg_rgb)
+    "38;2;#{fg_rgb}m\033[48;2;#{bg_rgb}m#{self}".ansi_control_sequence
+  end
+
   # Applies a 24-bit RGB foreground color to the string.
   #
   # @param rgb [String] The RGB color, expressed as a string like "1;2;3".
@@ -37,6 +50,18 @@ class String
     "38;2;#{rgb}m#{self}".ansi_control_sequence
   end
 
+  # Converts hex color codes to RGB and applies them to the string.
+  #
+  # @param hex_str [String] The RGB color, expressed as a hex string like "FF00FF".
+  # @return [String] The string with the applied RGB foreground color.
+  def hex_to_fg_bg_rgb(hex_str)
+    values = hex_str.split('_').map { |hex| hex.to_i(16).to_s }
+    fg_bg_rgb_color(
+      values[0..2].join(';'),
+      values[3..5].join(';')
+    )
+  end
+
   # Converts hex color codes to RGB and applies them to the string.
   #
   # @param hex_str [String] The RGB color, expressed as a hex string like "FF00FF".

data/lib/constants.rb

@@ -50,6 +50,7 @@ class MenuState
   EXIT = :exit
   LOAD = :load
   SAVE = :save
+  SHELL = :shell
   VIEW = :view
 end
 

data/lib/fcb.rb

@@ -3,6 +3,21 @@
 
 # encoding=utf-8
 
+class Hash
+  # block name in commands and documents
+  def pub_name
+    fetch(:nickname, nil) || fetch(:oname, nil)
+  end
+end
+# require 'ostruct'
+
+# class BlkS < OpenStruct
+#   # Method to fetch the value associated with the attribute :nickname or :oname
+#   def pub_name
+#     self.nickname || self.oname
+#   end
+# end
+
 module MarkdownExec
   class Error < StandardError; end