jekyll_pre 1.4.1 → 1.4.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f765cdcaf2d5447e9e05c49f02aa47b59feba53ba9dab4133a05eaa35f415555
-  data.tar.gz: 2b742223bfd91ce5dc8349a8dd5a09e8c678890dbb338a347ac2c463d3db9f1d
+  metadata.gz: c9c89dfed1bd63dfb97f8eea204a543d7ea06af6dca9f8b627b2bcf51ad0e65d
+  data.tar.gz: e81ee9721c99b5391d401c6a19fbbd2bca8371225b9cc2bf82ff3bfbcc4ab274
 SHA512:
-  metadata.gz: f4c15e15ee8390c7c429ce94f5913063d16804a2a61be225d66d1186406995eeed6a326e16fe438efac8dcf266f2e649888aec4c3d581fc10217098d1cbea3b9
-  data.tar.gz: 7ae60210e08f23519765d3c1064761838f448e4e04f4dd03f8965361b5243d0cbfa543665370b918bbc4e188c97a3ec96b400d884b7c543d39b1b722afffead5
+  metadata.gz: 79af8ae474c13a9ad92436e1c916f4b21269b2944fc41725f59976ca543da264ebe8fd669cfe9de119c7f882d138b860006dc70c328c7ad6a58c16c700987a53
+  data.tar.gz: 004b17970a50fbe7c9df57d47b38456b36d5786d831db067dba9be7d219fac72823768a63247013beffb02ba9c9a24faa2379323dcdb6e8d1fb08dd99e4c628b

data/.rubocop.yml

@@ -7,15 +7,17 @@ require:
 
 AllCops:
   Exclude:
-    - exe/**/*
+    - binstub/**/*
     - vendor/**/*
     - Gemfile*
   NewCops: enable
-  TargetRubyVersion: 2.6
 
 Gemspec/DeprecatedAttributeAssignment:
   Enabled: false
 
+Gemspec/RequiredRubyVersion:
+  Enabled: false
+
 Gemspec/RequireMFA:
   Enabled: false
 

data/CHANGELOG.md

@@ -1,77 +1,132 @@
+# Change Log
+
+## 1.4.3
+
+* Added the `no_stderr` option, which discards any STDERR output.
+
+
+## 1.4.2
+
+* Added missing `require` in `pre_tag_block.rb`.
+
+
 ## 1.4.1
-  * Fixed problem that caused exec tag to no produce output.
+
+* Fixed problem that caused exec tag to no produce output.
+
 
 ## 1.4.0
-  * Added `dedent` option and config setting.
-  * No longer dies when exec is passed an empty string, or a string with just whitespace.
+
+* Added `dedent` option and config setting.
+* No longer dies when exec is passed an empty string, or a string with just whitespace.
+
 
 ## 1.3.2
-  * No longer strips leading spaces from exec result lines.
+
+* No longer strips leading spaces from exec result lines.
+
 
 ## 1.3.1
-  * Generates outer `div` with `jekyll_pre` class, like this:
-    ```html
-    <div class="jekyll_pre">
-      ... HTML generated by previous versions of `pre` tag here
-    </div>
-    ```
-  * Added `wrapper_class` and `wrapper_style` name/value options.
+
+* Generates outer `div` with `jekyll_pre` class, like this:
+
+  ```html
+  <div class="jekyll_pre">
+    ... HTML generated by previous versions of `pre` tag here
+  </div>
+  ```
+
+* Added `wrapper_class` and `wrapper_style` name/value options.
+
 
 ## 1.3.0
-  * Updated to `jekyll_plugin_support` v0.6.0 for attribution support.
+
+* Updated to `jekyll_plugin_support` v0.6.0 for attribution support.
+
 
 ## 1.2.5
-  * Empty exec commands are detected and reported.
+
+* Empty exec commands are detected and reported.
+
 
 ## 1.2.4
-  * The `exec` tag now evaluates environment variables in the command before execution.
+
+* The `exec` tag now evaluates environment variables in the command before execution.
+
 
 ## 1.2.3
-  * Added `cd` option to `exec` tag.
+
+* Added `cd` option to `exec` tag.
+
 
 ## 1.2.2
-  * Added `exec` tag.
-  * Demarked CSS for the `exec`, `noselect`, and `pre` tags in `demo/assets/css/style.css`
-    within `/* Start of pre tag css */` and `/* End of pre tag css */`.
+
+* Added `exec` tag.
+* Demarked CSS for the `exec`, `noselect`, and `pre` tags in `demo/assets/css/style.css`
+  within `/* Start of pre tag css */` and `/* End of pre tag css */`.
+
 
 ## 1.2.1
-  * Updated to `jekyll_plugin_support` v0.5.1 so the `noselect` tag is more efficient.
+
+* Updated to `jekyll_plugin_support` v0.5.1 so the `noselect` tag is more efficient.
+
 
 ## 1.2.0
-  * Updated to `jekyll_plugin_support` v0.5.0.
+
+* Updated to `jekyll_plugin_support` v0.5.0.
+
 
 ## 1.1.7
-  * Fixed `noselect` tag content handling.
+
+* Fixed `noselect` tag content handling.
+
 
 ## 1.1.6
-  * Added `jekyll_plugin_support` as a dependency.
+
+* Added `jekyll_plugin_support` as a dependency.
+
 
 ## 1.1.5
-  * Added `class` and `style` options to allow for specifying additional CSS classes and inline CSS
-  * Added `clear` option to ensure no images overlap the pre output
+
+* Added `class` and `style` options to allow for specifying additional CSS classes and inline CSS
+* Added `clear` option to ensure no images overlap the pre output
+
 
 ## 1.1.4
-  * Added `highlight` regex option
-  * Now using `lib/jekyll_tag_helper.rb` to parse markup
+
+* Added `highlight` regex option
+* Now using `lib/jekyll_tag_helper.rb` to parse markup
+
 
 ## 1.1.3
-  * Documented the `data-lt-active="false"` attribute.
-  * Added the `dark` option, and [provided CSS](https://www.mslinn.com/blog/2020/10/03/jekyll-plugins.html#pre_css).
+
+* Documented the `data-lt-active="false"` attribute.
+* Added the `dark` option, and [provided CSS](https://www.mslinn.com/blog/2020/10/03/jekyll-plugins.html#pre_css).
+
 
 ## 1.1.2 / 2022-04-05
-  * Updated to `jekyll_plugin_logger` v2.1.0
+
+* Updated to `jekyll_plugin_logger` v2.1.0
+
 
 ## 1.1.1 / 2022-03-31
-  * Added `numbered_line` CSS class for unselectable line numbers
+
+* Added `numbered_line` CSS class for unselectable line numbers
+
 
 ## 1.1.0 / 2022-03-31
-  * Added `number` option, which generates unselectable line numbers for contents
+
+* Added `number` option, which generates unselectable line numbers for contents
+
 
 ## 1.0.0 / 2022-03-13
-  * Made into a Ruby gem and published on RubyGems.org as [jekyll_pre](https://rubygems.org/gems/jekyll_pre).
-  * `bin/attach` script added for debugging
-  * Rubocop standards added
-  * Proper versioning and CHANGELOG.md added
+
+* Made into a Ruby gem and published on RubyGems.org as [jekyll_pre](https://rubygems.org/gems/jekyll_pre).
+* `bin/attach` script added for debugging
+* Rubocop standards added
+* Proper versioning and CHANGELOG.md added
+
 
 ## 2020-12-29
-  * Initial version published
+
+* Initial version published

data/README.md

@@ -1,65 +1,83 @@
-Jekyll_pre
-[![Gem Version](https://badge.fury.io/rb/jekyll_pre.svg)](https://badge.fury.io/rb/jekyll_pre)
-===========
+# Jekyll_pre [![Gem Version](https://badge.fury.io/rb/jekyll_pre.svg)](https://badge.fury.io/rb/jekyll_pre)
 
 This Jekyll plugin provides 3 new Liquid tags that work together:
 
-  * A `pre` block tag that can be displayed various ways.
-    ```
-    {% pre [Options] [free text label] %}
-    Contents of pre tag
-    {% endpre %}
-    ```
-    `Options` are:
-     - `class="class1 class2"` – Apply CSS classes
-     - `clear` – Line break after floating HTML elements
-     - `copyButton` – Generate a copy button
-     - `dark` – Dark mode
-     - `dedent` &ndash; Remove leading spaces common to all lines, like Ruby's <<~ squiggly heredoc (default is false)
-     - `label='This is a label'` &ndash; Apply text above `pre` tag.
-        The `label` parameter value can also be specified in free text.
-        For example, the following produce the same results:
-
-        - {% pre label="This is a label" %}<br>Contents of pre tag<br>{% endpre %}
-
-        - {% pre This is a label %}<br>Contents of pre tag<br>{% endpre %}
-     - `number` &ndash; Number the lines
-     - `shell` &ndash; Equivalent to `label='Shell'`
-     - `style` &ndash; Apply inline CSS styles
-
-    The generated &lt;pre>&lt;/pre> tag has an `data-lt-active="false"` attribute, so [LanguageTool](https://forum.languagetool.org/t/avoid-spell-check-on-certain-html-inputs-manually/3944) does not check the spelling or grammar of the contents.
-
-  * A `noselect` tag that can renders HTML content passed to it unselectable,
-    and generates a <code>$</code> prompt if no content is provided.
-    ```
-    {% pre %}
-    {% noselect [optional text string, defaults to $]%}Command
-    {% noselect unselectable output goes here %}
-    {% endpre %}
-    ```
-
-  * An `exec` tag that executes shell commands and incorporates the command and its output into the content of the `pre` tag.
-    Environment variables are evaluated,
-    output data is escaped, whitespace is condensed, and wrapped in the same `unselectable` class as does `unselectable`.
-    ```
-    {% exec [Options] [shell command] %}
-    ```
-    `Options` are:
-
-     - `cd="relative/or/absolute/directory"` - Change to specified directory before executing shell command.
-       Environment variables in the directory path will be expanded.
-     - `die_if_nonzero` – Set `false` to treat non-zero return codes as non-fatal.
-       Instead of terminating Jekyll with an error message,
-       the message will be displayed as an error by the Jekyll logger,
-       and a red message will appear in place of the result on the web page.
-     - `die_if_error` – Set `false` to treat exceptions generated by this plugin as non-fatal.
-       Instead of terminating Jekyll with an error message, the message will be displayed as an error by the Jekyll logger.
-     - `no_escape` – Do not HTML escape the result of running the shell command.
-     - `no_strip` – Do not remove leading and trailing whitespace from the result.
-     - `wrapper_class` class applied to outer `div`.
-     - `wrapper_style` style applied to outer `div`.
+* A `pre` block tag that can be displayed various ways.
+
+  ```html
+  {% pre [Options] [free text label] %}
+  Contents of pre tag
+  {% endpre %}
+  ```
+
+  `Options` are:
+
+    - `class="class1 class2"` &ndash; Apply CSS classes
+    - `clear` &ndash; Line break after floating HTML elements
+    - `copyButton` &ndash; Generate a copy button
+    - `dark` &ndash; Dark mode
+    - `dedent` &ndash; Remove leading spaces common to all lines, like Ruby's <<~ squiggly heredoc (default is false)
+    - `label='This is a label'` &ndash; Apply text above `pre` tag.
+      The `label` parameter value can also be specified in free text.
+      For example, the following produce the same results:
+
+      - {% pre label="This is a label" %}<br>Contents of pre tag<br>{% endpre %}
+
+      - {% pre This is a label %}<br>Contents of pre tag<br>{% endpre %}
+    - `number` &ndash; Number the lines
+    - `shell` &ndash; Equivalent to `label='Shell'`
+    - `style` &ndash; Apply inline CSS styles
+
+  The generated &lt;pre>&lt;/pre> tag has an `data-lt-active="false"` attribute, so
+  [LanguageTool](https://forum.languagetool.org/t/avoid-spell-check-on-certain-html-inputs-manually/3944)
+  does not check the spelling or grammar of the contents.
+
+* A `noselect` tag that can renders HTML content passed to it unselectable,
+  and generates a <code>$</code> prompt if no content is provided.
+
+  ```html
+  {% pre %}
+  {% noselect [optional text string, defaults to $]%}Command
+  {% noselect unselectable output goes here %}
+  {% endpre %}
+  ```
+
+* An `exec` tag that executes shell commands and incorporates the command and its output into the content of the `pre` tag.
+  Environment variables are evaluated,
+  output data is escaped, whitespace is condensed, and wrapped in the same `unselectable` class as does `unselectable`.
+
+  ```html
+  {% exec [Options] [shell command] %}
+  ```
+
+  `Options` are:
+
+    - `cd="relative/or/absolute/directory"` - Change to specified directory before executing shell command.
+      Environment variables in the directory path will be expanded.
+    - `die_if_nonzero` – Set `false` to treat non-zero return codes as non-fatal.
+      Instead of terminating Jekyll with an error message,
+      the message will be displayed as an error by the Jekyll logger,
+      and a red message will appear in place of the result on the web page.
+    - `die_if_error` – Set `false` to treat exceptions generated by this plugin as non-fatal.
+      Instead of terminating Jekyll with an error message, the message will be displayed as an error by the Jekyll logger.
+    - `no_escape` – Do not HTML escape the result of running the shell command.
+    - `no_stderr` - Discard STDERR output.
+      This is helpful for suppressing annoying `groff` error messages that are emitted when the `exec` subcommand runs `man`.
+      Use it like this:
+
+      ```html
+      {% pre copyButton dedent shell %}
+      {% noselect %}{% exec no_stderr man netplan %}
+      {% endpre %}
+      ```
+
+    - `no_strip` – Do not remove leading and trailing whitespace from the result.
+    - `wrapper_class` class applied to outer `div`.
+    - `wrapper_style` style applied to outer `div`.
+
 
 ## Keyword Options
+
 For all keyword options, including keyword options for the `pre` and `exec` tags:
 
  - Option values specified in the document *may* be provided.
@@ -70,19 +88,24 @@ For all keyword options, including keyword options for the `pre` and `exec` tags
    Values that do not contain special characters *may* be wrapped in single or double quotes.
 
 ### Examples
+
 #### Specifying Tag Option Values
+
 The following sets `die_if_error` `true`:
-```
+
+```html
 {% pre die_if_error %} ... {% endpre %}
 ```
 
 The above is the same as writing:
-```
+
+```html
 {% pre die_if_error='true' %} ... {% endpre %}
 ```
 
 Or writing:
-```
+
+```html
 {% pre die_if_error="true" %} ... {% endpre %}
 ```
 
@@ -92,23 +115,27 @@ For the `pre` tag, this means the erroneous string becomes part of the `label` v
 For the `exec` tag, this means the erroneous string becomes part of the command to execute.
 The following demonstrates the error.
 
-```
+```html
 {% pre die_if_error=false %} ... {% endpre %}
 ```
+
 The above causes the label to be `die_if_error=false`.
 
-```
+```html
 {% exec die_if_error=false ls %} ... {% endpre %}
 ```
+
 The above causes the command to be executed to be `die_if_error=false ls` instead of `ls`.
 
 
 ## CSS
+
 See [`demo/assets/css/style.css`](demo/assets/css/style.css) for the CSS declarations,
 between `/* Start of pre tag css */` and `/* End of pre tag css */`.
 
 
 ## Configuration
+
 Default options can be set for the `pre` tag by entries in `_config.yml`.
 The following demonstrates setting a default value for every possible option:
 
@@ -137,8 +164,10 @@ pre:
 ```
 
 
-#### Specifying Default Option Values
+### Specifying Default Option Values
+
 Specifying a default value for `die_if_error` in `_config.yml` could be done as follows:
+
 ```yaml
 pre:
   die_if_error: true
@@ -156,6 +185,7 @@ pre:
 
 
 ## Additional Information
+
 More information is available on
 [Mike Slinn&rsquo;s website](https://www.mslinn.com/jekyll_plugins/jekyll_pre.html).
 
@@ -172,26 +202,33 @@ end
 
 And then execute:
 
-    $ bundle
+```shell
+$ bundle
+```
 
 
 ## Usage
+
 The following examples are rendered on
 [Mike Slinn&rsquo;s website](https://www.mslinn.com/jekyll_plugins/jekyll_pre.html).
 
 ### Example 0
+
 <pre data-lt-active="false" class="maxOneScreenHigh copyContainer" id="id110c50d624b4">{% pre dedent %}
     This line was indented 4 spaces
       This line was indented 6 spaces
     This line was indented 4 spaces
 {% endpre %}</pre>
+
 Which renders as:
 
 <pre data-lt-active="false" class="maxOneScreenHigh copyContainer" id="id377433c30186">This line was indented 4 spaces
   This line was indented 6 spaces
 This line was indented 4 spaces</pre>
 
+
 ### Example 1
+
 This example does not generate a copy button and does not demonstrate `noselect`.
 <pre data-lt-active="false" class="maxOneScreenHigh copyContainer" id="id110c50d624b4">{% pre %}
 Contents of pre tag
@@ -206,11 +243,12 @@ Which renders as:
 
 
 ### Example 2
+
 This example generates a copy button and does not demonstrate `noselect`.
 
-    {% pre copyButton %}
-    Contents of pre tag
-    {% endpre %}
+{% pre copyButton %}
+Contents of pre tag
+{% endpre %}
 
 Generates:
 <pre data-lt-active="false" class="maxOneScreenHigh copyContainer" id="id08a5d26db177">&lt;pre data-lt-active='false' class='maxOneScreenHigh copyContainer' id='id6a831a3e8992'&gt;&lt;button class='copyBtn' data-clipboard-target='#id6a831a3e8992' title='Copy to clipboard'&gt;&lt;img src='images/clippy.svg' alt='Copy to clipboard' style='width: 13px'&gt;&lt;/button&gt;Contents of pre tag&lt;/pre&gt;</pre>
@@ -220,8 +258,10 @@ Which renders as (note the clipboard icon at the far right):
 
 
 ### Example 3
+
 This example generates a copy button and does demonstrates the default usage of `noselect`, which renders an unselectable dollar sign followed by a space.
-```
+
+```html
 {% pre copyButton %}
 {% noselect %}Contents of pre tag
 {% endpre %}
@@ -229,7 +269,7 @@ This example generates a copy button and does demonstrates the default usage of
 
 Generates:
 
-```
+```html
 <pre data-lt-active='false' class='maxOneScreenHigh copyContainer' id='id1e4a8fe53480'><button class='copyBtn' data-clipboard-target='#id1e4a8fe53480' title='Copy to clipboard'><img src='/assets/images/clippy.svg' alt='Copy to clipboard' style='width: 13px'></button><span class='unselectable'>$ </span>Contents of pre tag</pre>
 ```
 
@@ -239,11 +279,12 @@ Which renders as:
 
 
 ### Example 4
+
 This example generates a copy button and does demonstrates the `noselect` being used twice:
 the first time to render an unselectable custom prompt,
 and the second time to render unselectable output.
 
-```
+```html
 {% pre copyButton %}
 {% noselect &gt;&gt;&gt; %}Contents of pre tag
 {% noselect How now brown cow%}
@@ -251,7 +292,8 @@ and the second time to render unselectable output.
 ```
 
 Generates:
-```
+
+```html
 <pre data-lt-active='false' class='maxOneScreenHigh copyContainer' id='idb58a6cf1761c'><button class='copyBtn' data-clipboard-target='#idb58a6cf1761c' title='Copy to clipboard'><img src='/assets/images/clippy.svg' alt='Copy to clipboard' style='width: 13px'></button><span class='unselectable'>>>> </span>contents of pre tag
 <span class='unselectable'>How now brown cow</span></pre>
 ```
@@ -262,6 +304,7 @@ Which renders as:
 
 
 ### Example 5
+
 A regular expression can be passed to the `highlight` option.
 This causes text that matches the regex pattern to be wrapped within a &lt;span class="bg_yellow">&lt;/span> tag.
 
@@ -274,9 +317,11 @@ The CSS stylesheet used for this page contains the following:
 }
 ```
 
-This example demonstrates highlighting text that matches a regular expression. Regular expressions match against lines, which are delimited via newlines (\n).
+This example demonstrates highlighting text that matches a regular expression.
+Regular expressions match against lines,
+which are delimited via newlines (\n).
 
-```
+```html
 {% pre copyButton highlight="Line 2" %}
 Line 1
   Line 2
@@ -290,11 +335,12 @@ Line 7
 
 
 ### Example 6
+
 Regular expressions match against lines, which are delimited via newlines (`\n`).
 Thus to match an entire line that contains a phrase, specify the regex as `.*phrase.*`.
 The following matches 3 possible phrases (`2`, `4` or `6`), then selects the entire line if matched.
 
-```
+```html
 {% pre copyButton highlight=".*(2|4|6).*" %}
 Line 1
   Line 2
@@ -308,10 +354,11 @@ Line 7
 
 
 ### Example 7
+
 This example floats an image to the right.
 The `jekyll_pre plugin`’s `clear` option moves the generated HTML below the image.
 
-```
+```html
 &lt;img src="jekyll.webp" style="float: right; width: 100px; height: auto;">
 {% pre clear copyButton label='Clear example' %}
 Using clear, copyButton and label parameters
@@ -319,27 +366,30 @@ Using clear, copyButton and label parameters
 ```
 
 ### Example 8
+
 The following executes `ls -alF /` and displays the output.
 
-```
+```html
 {% pre clear copyButton label='Exec without error' %}
 {% noselect %}{% exec die_if_nonzero='false' ls -alF / %}
 {% endpre %}
 ```
 
 ### Example 9
+
 The following changes to the home directory (`$HOME`), then executes `pwd` and displays the output.
 
-```
+```html
 {% pre clear copyButton label='Exec without error' %}
 {% noselect %}{% exec cd="$HOME" die_if_nonzero='false' pwd %}
 {% endpre %}
 ```
 
 ### Example 10
+
 The following executes `echo $USER` and displays the output.
 
-```
+```html
 {% pre clear copyButton label='Exec display &dollar;USER' %}
 {% noselect %}{% exec die_if_nonzero='false' echo $USER %}
 {% endpre %}
@@ -347,10 +397,11 @@ The following executes `echo $USER` and displays the output.
 
 
 ### Comprehensive Example
+
 The code I wrote to generate the above CSS was a good example of how the plugins work together with
 the `from` and `to` tags from my [`from_to_until`](https://github.com/mslinn/jekyll_from_to_until) plugin:
 
-```
+```html
 {% capture css %}{% flexible_include '_sass/mystyle.scss' %}{% endcapture %}
 {% pre copyButton %}{{ css | from: '.copyBtn' | to: '^$' | strip }}
 
@@ -371,20 +422,22 @@ You can also run `bin/console` for an interactive prompt that will allow you to
 
 
 ## Test
+
 A test website is provided in the `demo` directory.
- 1. Set breakpoints.
 
- 2. Initiate a debug session from the command line:
-    ```shell
-    $ bin/attach demo
-    ```
+1. Set breakpoints.
+2. Initiate a debug session from the command line:
 
-  3. Once the `Fast Debugger` signon appears, launch the Visual Studio Code launch configuration called `Attach rdebug-ide`.
+   ```shell
+   $ bin/attach demo
+   ```
 
-  4. View the generated website at [`http://localhost:4444`](http://localhost:4444)
+3. Once the `Fast Debugger` signon appears, launch the Visual Studio Code launch configuration called `Attach rdebug-ide`.
+4. View the generated website at [`http://localhost:4444`](http://localhost:4444)
 
 
 ### Build and Install Locally
+
 To build and install this gem onto your local machine, run:
 
 ```shell
@@ -392,6 +445,7 @@ $ bundle exec rake install
 ```
 
 Examine the newly built gem:
+
 ```shell
 $ gem info jekyll_pre
 
@@ -409,18 +463,23 @@ jekyll_pre (1.0.0)
 
 
 ### Build and Push to RubyGems
+
 To release a new version,
+
   1. Update the version number in `version.rb`.
   2. Commit all changes to git; if you don't the next step might fail with an unexplainable error message.
   3. Run the following:
+
      ```shell
      $ bundle exec rake release
      ```
+
      The above creates a git tag for the version, commits the created tag,
      and pushes the new `.gem` file to [RubyGems.org](https://rubygems.org).
 
 
 ## Contributing
+
 1. Fork the project
 2. Create a descriptively named feature branch
 3. Add your feature

data/lib/exec_tag.rb

@@ -77,31 +77,44 @@ module JekyllPreModule
 
       @no_escape      = @helper.parameter_specified? 'no_escape'
       @no_strip       = @helper.parameter_specified? 'no_strip'
+      @no_stderr      = @helper.parameter_specified? 'no_stderr'
       @die_if_nonzero = @helper.parameter_specified?('die_if_nonzero') # Implies die_if_error
       @die_if_error   = @helper.parameter_specified?('die_if_error') | @die_if_nonzero
     end
 
     # References @cd
     # Defines @child_status
+    # Ignores stderr output
     # @return result of running command
     # @param command [String] Shell command to execute
     def run_command(command)
-      result = if @cd
-                 Dir.chdir(@cd) do
-                   `#{command}`
-                 end
-               else
-                 `#{command}`
-               end
-      @child_status = $CHILD_STATUS
-      result
+      stdout_str = ''
+      stderr_str = ''
+      if @cd
+        Dir.chdir(@cd) do
+          @logger.debug { "Executing '#{command}' from '#{@cd}'" }
+          stdout_str, stderr_str, @child_status = Open3.capture3 command
+        end
+      else
+        @logger.debug { "Executing '#{command}'" }
+        stdout_str, stderr_str, @child_status = Open3.capture3 command
+      end
+      unless @no_stderr
+        stderr_str.strip!
+        unless stderr_str.empty?
+          @logger.info do
+            "'#{command}' STDERR=#{stderr_str}\nThe exec subcommand's 'no_stderr' option suppresses this message."
+          end
+        end
+      end
+      stdout_str
     rescue StandardError => e
       msg = self.class.remove_html_tags(e.message) +
             " from executing '#{@original_command}' on line #{@line_number} (after front matter) of #{@page['path']}"
       raise PreError, msg.red, [] if @die_if_error
     ensure
       @child_status = $CHILD_STATUS
-      result
+      stdout_str
     end
 
     JekyllPluginHelper.register(self, 'exec')

data/lib/jekyll_pre/version.rb

@@ -1,3 +1,3 @@
 module JekyllPreVersion
-  VERSION = '1.4.1'.freeze
+  VERSION = '1.4.3'.freeze
 end

data/lib/pre_tag_block.rb

@@ -1,4 +1,5 @@
 require 'jekyll_plugin_support'
+require 'securerandom'
 require_relative 'jekyll_pre/version'
 
 module JekyllPreModule

data/spec/spec_helper.rb

@@ -10,9 +10,8 @@ require_relative '../lib/jekyll_pre'
 Jekyll.logger.log_level = :info
 
 RSpec.configure do |config|
-  config.filter_run :focus
+  config.filter_run_when_matching focus: true
   # config.order = 'random'
-  config.run_all_when_everything_filtered = true
 
   # See https://relishapp.com/rspec/rspec-core/docs/command-line/only-failures
   config.example_status_persistence_file_path = 'spec/status_persistence.txt'

data/spec/status_persistence.txt

@@ -1,13 +1,8 @@
-example_id                                                      | status | run_time        |
---------------------------------------------------------------- | ------ | --------------- |
-./spec/exec_spec.rb[1:1]                                        | passed | 0.00377 seconds |
-./spec/pre_spec.rb[1:1]                                         | passed | 0.00014 seconds |
-./spec/pre_spec.rb[1:2]                                         | passed | 0.00351 seconds |
-./spec/pre_spec.rb[1:3]                                         | passed | 0.00016 seconds |
-./spec/pre_spec.rb[1:4]                                         | passed | 0.00011 seconds |
-/mnt/_/work/jekyll/my_plugins/jekyll_pre/spec/exec_spec.rb[1:1] | passed | 0.00457 seconds |
-/mnt/_/work/jekyll/my_plugins/jekyll_pre/spec/pre_spec.rb[1:1]  | passed | 0.00326 seconds |
-/mnt/_/work/jekyll/my_plugins/jekyll_pre/spec/pre_spec.rb[1:2]  | passed | 0.00067 seconds |
-/mnt/_/work/jekyll/my_plugins/jekyll_pre/spec/pre_spec.rb[1:3]  | passed | 0.00362 seconds |
-/mnt/_/work/jekyll/my_plugins/jekyll_pre/spec/pre_spec.rb[1:4]  | passed | 0.00033 seconds |
-/mnt/_/work/jekyll/my_plugins/jekyll_pre/spec/pre_spec.rb[1:5]  | passed | 0.00083 seconds |
+example_id               | status | run_time        |
+------------------------ | ------ | --------------- |
+./spec/exec_spec.rb[1:1] | passed | 0.00133 seconds |
+./spec/pre_spec.rb[1:1]  | passed | 0.00007 seconds |
+./spec/pre_spec.rb[1:2]  | passed | 0.00003 seconds |
+./spec/pre_spec.rb[1:3]  | passed | 0.00133 seconds |
+./spec/pre_spec.rb[1:4]  | passed | 0.00005 seconds |
+./spec/pre_spec.rb[1:5]  | passed | 0.00004 seconds |

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jekyll_pre
 version: !ruby/object:Gem::Version
-  version: 1.4.1
+  version: 1.4.3
 platform: ruby
 authors:
 - Mike Slinn
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-06-25 00:00:00.000000000 Z
+date: 2023-12-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll
@@ -104,7 +104,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.3
+rubygems_version: 3.3.7
 signing_key:
 specification_version: 4
 summary: Jekyll tags pre and noselect, for HTML <pre/> tag, prompts and unselectable