jekyll_plugin_support 0.5.2 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 75b8116adff0e7869b3d9d05def0b7cb702b67860e596e3b9901dce1f43182e7
-  data.tar.gz: 86da2a9936cbeffb9f381d3d2031f58acee7f79d8efd7a37b2f4864c3201b20e
+  metadata.gz: 1ce28127788362fc89e19bc132113bbc169c4bfe0501e08821a2c425451d29c6
+  data.tar.gz: 2e98d5294e503b7b510463037e8c93f7318df64f2e3a7728ebfd1fe82a397e6b
 SHA512:
-  metadata.gz: f944740ed80b93a8d5fa6e0e4d3a4b0fe04761aa546d2dfea10b3929d7650daf87afdcd295b3698d80ded0f50209fe04a9c918914f216cfcabc335314da7454a
-  data.tar.gz: c5d1f11b7fb11900a94ba1430faca977794d84fd4073e793cc50128e922c401adaee2ea5ecdc2eef16b3ed1450e0ac98e5eeff1b8dc96fcc9fda1610b04dc2f8
+  metadata.gz: 916d5b3f843c68faec816a307491038d1eb670015e8c38f536e0b1b9fdba0162d428477a1a592975da56dd8b26f90a9bcb16c66db7cd2cb7cbde2e041c402ff9
+  data.tar.gz: 3e7b7670207a9b552e28cb714ce2d3bc46c16b72259a2e58c987db41ab3e47debddcd8be2ef49b84a17c4434638ad67cd4222df18bc1d647b4ea481700aaf23b

data/.rubocop.yml

@@ -1,61 +1,67 @@
-require:
-  - rubocop-rspec
-  - rubocop-rake
-  # - rubocop-jekyll
+  require:
+    - rubocop-md
+    - rubocop-performance
+    - rubocop-rake
+    - rubocop-rspec
+    # - rubocop-jekyll
 
-AllCops:
-  Exclude:
-    - demo/_site/**/*
-    - exe/**/*
-    - vendor/**/*
-    - Gemfile*
-  NewCops: enable
-  TargetRubyVersion: 2.6
+  AllCops:
+    Exclude:
+      - demo/_site/**/*
+      - exe/**/*
+      - vendor/**/*
+      - Gemfile*
+    NewCops: enable
+    TargetRubyVersion: 2.6
 
-Gemspec/DeprecatedAttributeAssignment:
-  Enabled: false
+  Gemspec/DeprecatedAttributeAssignment:
+    Enabled: false
 
-Gemspec/RequireMFA:
-  Enabled: false
+  Gemspec/RequireMFA:
+    Enabled: false
 
-Layout/HashAlignment:
-  EnforcedHashRocketStyle: table
+  Layout/HashAlignment:
+    EnforcedColonStyle: table
+    EnforcedHashRocketStyle: table
 
-Layout/LineLength:
-  Max: 150
+  Layout/LineLength:
+    Max: 150
 
-Layout/CommentIndentation:
-  Exclude:
-    - spec/**/*
+  Layout/CommentIndentation:
+    Exclude:
+      - spec/**/*
 
-Layout/MultilineMethodCallIndentation:
-  Enabled: false
+  Layout/MultilineMethodCallIndentation:
+    Enabled: false
 
-Lint/RedundantCopDisableDirective:
-  Exclude:
-    - jekyll_plugin_support.gemspec
+  Lint/RedundantCopDisableDirective:
+    Exclude:
+      - jekyll_plugin_support.gemspec
 
-Metrics/AbcSize:
-  Max: 30
+  Metrics/AbcSize:
+    Max: 30
 
-Metrics/BlockLength:
-  Exclude:
-    - jekyll_plugin_support.gemspec
+  Metrics/BlockLength:
+    Exclude:
+      - jekyll_plugin_support.gemspec
 
-Metrics/MethodLength:
-  Max: 25
+  Metrics/CyclomaticComplexity:
+    Max: 20
 
-RSpec/ExampleLength:
-  Max: 20
+  Metrics/MethodLength:
+    Max: 40
 
-RSpec/MultipleExpectations:
-  Max: 15
+  RSpec/ExampleLength:
+    Max: 20
 
-Style/Documentation:
-  Enabled: false
+  RSpec/MultipleExpectations:
+    Max: 15
 
-Style/FrozenStringLiteralComment:
-  Enabled: false
+  Style/Documentation:
+    Enabled: false
 
-Style/TrailingCommaInHashLiteral:
-  EnforcedStyleForMultiline: comma
+  Style/FrozenStringLiteralComment:
+    Enabled: false
+
+  Style/TrailingCommaInHashLiteral:
+    EnforcedStyleForMultiline: comma

data/ATTIBUTION_NOTES.md

@@ -0,0 +1,4 @@
+# Notes on Attribution
+
+The following additional public methods could be supported for the attribution string:
+`full_name`, `conflicts`, `dependencies`, `platform`, `specification_version`, `summary`, `cert_chain`, `description`, `email`, `extensions`, `licenses`, `metadata`, `post_install_message`, `rg_full_gem_path`, `location`, `git_version`, `rg_extension_dir`, `nondevelopment_dependencies`, `default_executable`, `original_platform`, `gems_dir`, `groups`, `requirements`, `bin_file`, `executables`, `bindir`, `loaded_from`, `hash`, `files`, `spec_file`, `abbreviate`, `bin_dir`, `default_value`, `doc_dir`, `mark_version`, `executable`, `file_name`, `rubygems_version`, `lib_files`, `license`, `name_tuple`,  `original_name`, `require_path`, `ri_dir`, `spec_dir`, `spec_name`, `source`, `validate_permissions`, `extension_dir`, `full_gem_path`, `remote`, `base_dir`, `gem_dir`, `normalize`, `match_platform`, `plugins`, `source_paths`, `datadir`, `require_paths`, and `this`.

data/CHANGELOG.md

@@ -1,3 +1,14 @@
+## 0.6.0 / 2023-04-05
+  * Added attribution support
+  * Renamed `jekyll_plugin_support_helper.rb` to `jekyll_plugin_helper.rb`.
+  * Now returns `undefined` instead of `false'` when `@keys_values.empty?`
+    and parameter is not specified.
+
+## 0.5.3 / 2023-03-19
+  * Added properties `argv_original`, `keys_values_original`, `remaining_markup_original`,
+    and `params_original`, which are the original values of `argv`, `keys_values`,
+    `remaining_markup`, and `params`, before environment variable expansion.
+
 ## 0.5.2 / 2023-03-17
   * Added `@helper.remaining_markup` public method, which returns remaining markup passed to your tag, after keyword and name/value parsing is complete.
   * Finally wrote proper `rspec` tests.

data/README.md

@@ -5,8 +5,11 @@
 `Jekyll_plugin_support` is a Ruby gem that facilitates writing and testing Jekyll plugins.
 At present, only Jekyll tags and blocks are supported.
 
+
 ## Installation
+`Jekyll_plugin_support` can be used to create simple Jekyll plugins in the `_plugins/` directory, or gem-based Jekyll plugins.
 
+### Simple `_plugins`
 Add this line to your Jekyll plugin's Gemfile:
 
 ```ruby
@@ -19,6 +22,19 @@ And then execute:
 
     $ bundle install
 
+
+### Gem-Based Plugins
+Add this line to your Jekyll plugin's `.gemspec`:
+
+```ruby
+spec.add_dependency 'jekyll_plugin_support'
+```
+
+And then execute:
+
+    $ bundle install
+
+
 ## General Usage
 `JekyllSupport::JekyllBlock` and `JekyllSupport::JekyllTag`
 provide support for Jekyll tag blocks and Jekyll tags, respectively.
@@ -56,7 +72,10 @@ module Jekyll
     VERSION = '0.1.0'.freeze
 
     def render_impl
-      # Your code here
+      my_output = "<p>blah blah</p>"
+      <<~END_OUTPUT
+        #{my_output}
+      END_OUTPUT
     end
 
     JekyllPluginHelper.register(self, 'demo_tag')
@@ -72,8 +91,13 @@ module Jekyll
   class MyBlock < JekyllSupport::JekyllBlock
     VERSION = '0.1.0'.freeze
 
-    def render_impl(text)
-      # Your code here
+    def render_impl(content)
+      @helper.gem_file __FILE__ # Enables attribution
+      my_output = "<p>blah blah</p>"
+      <<~END_OUTPUT
+        #{my_output}
+        #{@helper.attribute if @helper.attribution}
+      END_OUTPUT
     end
 
     JekyllPluginHelper.register(self, 'demo_block')
@@ -101,7 +125,12 @@ module Jekyll
     include MyPluginVersion
 
     def render_impl(text)
-      # Your code here
+      @helper.gem_file __FILE__ # Enables attribution
+      my_output = "<p>blah blah</p>"
+      <<~END_OUTPUT
+        #{my_output}
+        #{@helper.attribute if @helper.attribution}
+      END_OUTPUT
     end
 
     JekyllPluginHelper.register(self, 'demo_tag')
@@ -168,9 +197,56 @@ without tokenization, and you expect that the plugin might be invoked with large
 derive your plugin from `JekyllBlockNoArgParsing` or `JekyllTagNoArgParsing`.
 
 
+## Subclass Attribution
+`JekyllTag` and `JekyllBlock` subclasses of `jekyll_plugin_support` can utilize the `attribution` option IFF they are published as a gem.
+`JekyllTagNoArgParsing` and `JekyllBlockNoArgParsing` subclasses cannot.
+
+ - When used as a keyword option, a default value is used for the attribution string.
+ - When used as a name/value option, the attribution string can be specified.
+
+Using the `attribution` option cause subclasses to replace their usual output with HTML that looks like:
+
+```html
+<div id="jps_attribute_12345" class="jps_attribute">
+  <a href="https://github.com/mslinn/jekyll_outline">
+    <b>Generated by <code>jekyll_outline</code>.
+  </a>
+</div>
+```
+
+The `id` attribute is in the sample HTML above is randomized so more than one attribution can appear on a page.
+
+
+### Usage
+Typical usage for the `attribution` tag is:
+
+```
+{% my_tag attribution %}
+```
+
+Normal processing of `my_tag` is augmented by interpolating the attribution format string,
+which is a Ruby-compatible interpolated string.
+
+The default attribution format string is:
+
+```ruby
+"Generated by the #{name} #{version} Jekyll plugin, written by #{author} #{date}."
+```
+
+Because `jekyll_plugin_suppprt` subclasses are `gem`s, their `gemfile`s define values for
+`name`, `version`, `homepage`, and `authors`, as well as many other properties.
+The `date` property is obtained from the plugin/gem publishing date.
+
+An alternative attribution string can be specified properties can be output using any of the above properties:
+
+```
+{% my_tag attribution="Generated by the #{name} #{version} Jekyll plugin, written by #{author} #{date}" %}
+```
+
+
 ## Additional Information
 More information is available on
-[Mike Slinn&rsquo;s website](https://www.mslinn.com/blog/2020/10/03/jekyll-plugins.html).
+[Mike Slinn&rsquo;s website](https://www.mslinn.com/jekyll/10200-jekyll-plugin-support.html).
 
 
 ## Development
@@ -204,16 +280,28 @@ jekyll_plugin_support (0.1.0)
 ```
 
 
-## Test
-A test website is provided in the `demo` directory.
- 1. Set breakpoints.
+## Demo
+A demo / test website is provided in the `demo` directory.
+It can be used to debug the plugin or to run freely.
+
+### Run Freely
+ 1. Run from the command line:
+    ```shell
+    $ demo/_bin/debug -r
+    ```
+
+  2. View the generated website at [`http://localhost:4444`](http://localhost:4444)
+
+### Plugin Debugging
+ 1. Set breakpoints in Visual Studio Code.
 
  2. Initiate a debug session from the command line:
     ```shell
-    $ bin/attach demo
+    $ demo/_bin/debug
     ```
 
-  3. Once the `Fast Debugger` signon appears, launch the Visual Studio Code launch configuration called `Attach rdebug-ide`.
+  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)
 

data/jekyll_plugin_support.gemspec

@@ -7,7 +7,7 @@ Gem::Specification.new do |spec| # rubocop:disable Metrics/BlockLength
   spec.authors = ['Mike Slinn']
   spec.email = ['mslinn@mslinn.com']
   spec.files = Dir['.rubocop.yml', 'LICENSE.*', 'Rakefile', '{lib,spec}/**/*', '*.gemspec', '*.md']
-  spec.homepage = 'https://www.mslinn.com/blog/2020/10/03/jekyll-plugins.html#quote'
+  spec.homepage = 'https://www.mslinn.com/jekyll/10200-jekyll-plugin-support.html'
   spec.license = 'MIT'
   spec.metadata = {
     'allowed_push_host' => 'https://rubygems.org',
@@ -28,6 +28,7 @@ Gem::Specification.new do |spec| # rubocop:disable Metrics/BlockLength
   spec.test_files = spec.files.grep %r{^(test|spec|features)/}
   spec.version = JekyllPluginSupportVersion::VERSION
 
+  spec.add_dependency 'facets'
   spec.add_dependency 'jekyll', '>= 3.5.0'
   spec.add_dependency 'jekyll_plugin_logger'
   spec.add_dependency 'key-value-parser'

data/lib/call_chain.rb

@@ -0,0 +1,42 @@
+# TODO: File not used, delete
+
+# See https://stackoverflow.com/a/23363883/553865
+module CallChain
+  ACaller = Struct.new(:filepath, :line, :method_name)
+
+  def self.caller_method(depth = 1)
+    parse_caller(caller(depth + 1).first).method_name
+  end
+
+  def self.parse_caller(at)
+    return unless /^(.+?):(\d+)(?::in `(.*)')?/ =~ at
+
+    last_match = Regexp.last_match.to_a
+    ACaller.new(
+      last_match[1],
+      last_match[2].to_i,
+      last_match[3]
+    )
+  end
+
+  # Return ACaller prior to jekyll_plugin_support
+  def self.jpsh_subclass_caller
+    state = :nothing_found
+    call_sequence = caller
+    call_sequence.each do |caller_|
+      parsed_caller = parse_caller caller_
+      filepath = parsed_caller.filepath
+      dirname = File.dirname filepath
+      jpsh = dirname.match? %r{jekyll_plugin_support[.0-9-]*/lib\z}
+      liquid = dirname.match? %r{liquid[.0-9-]*/lib/\z}
+      case state
+      when :nothing_found
+        state = :jpsh_found if jpsh
+      when :jpsh_found
+        # puts "Called from #{parsed_caller.filepath}, on line #{parsed_caller.line}, by method '#{parsed_caller.method_name}'" unless jpsh
+        return parsed_caller unless jpsh || liquid
+      end
+    end
+    nil
+  end
+end

data/lib/gem_support.rb

@@ -0,0 +1,18 @@
+# See https://stackoverflow.com/a/75890279/553865
+module GemSupport
+  # @param file must be a fully qualified file name that points to a file within a gem.
+  # @return Gem::Specification of gem that file points into, or nil if not called from a gem
+  def self.current_spec(file)
+    searcher = if Gem::Specification.respond_to?(:find)
+                 Gem::Specification
+               elsif Gem.respond_to?(:searcher)
+                 Gem.searcher.init_gemspecs
+               end
+
+    searcher&.find do |spec|
+      # The File.fnmatch pattern ** means to match directories recursively or files expansively.
+      # This makes the method return the proper Gem::Specification when pointed at any file in any directory within a gem.
+      File.fnmatch(File.join(spec.full_gem_path, '**'), file)
+    end
+  end
+end

data/lib/{jekyll_plugin_support_helper.rb → jekyll_plugin_helper.rb}

@@ -1,9 +1,13 @@
-require 'shellwords'
+require 'facets/string/interpolate'
 require 'key_value_parser'
+require 'shellwords'
+require_relative 'gem_support'
 
 # Base class for all types of Jekyll plugin helpers
-class JekyllPluginHelper
-  attr_reader :argv, :keys_values, :liquid_context, :logger, :markup, :no_arg_parsing, :params, :tag_name
+class JekyllPluginHelper # rubocop:disable Metrics/ClassLength
+  attr_accessor :liquid_context
+  attr_reader :argv, :attribution, :keys_values, :logger, :markup, :no_arg_parsing, :params, :tag_name,
+              :argv_original, :keys_values_original, :params_original, :jpsh_subclass_caller
 
   # Expand an environment variable reference
   def self.expand_env(str, die_if_undefined: false)
@@ -24,7 +28,7 @@ class JekyllPluginHelper
 
     abort("Error: The #{name} plugin is not an instance of JekyllSupport::JekyllBlock or JekyllSupport::JekyllTag") \
       unless klass.instance_of?(Class) &&
-             (klass.ancestors.include?(JekyllSupport::JekyllBlock) || \
+             (klass.ancestors.include?(JekyllSupport::JekyllBlock) ||
               klass.ancestors.include?(JekyllSupport::JekyllTag))
 
     Liquid::Template.register_tag(name, klass)
@@ -50,15 +54,53 @@ class JekyllPluginHelper
     @logger = logger
     @no_arg_parsing = no_arg_parsing
     reinitialize(markup.strip)
+
+    @attribution = parameter_specified?('attribution') || false unless no_arg_parsing
     @logger.debug { "@keys_values='#{@keys_values}'" }
+  rescue StandardError => e
+    @logger.error { "#{self.class} died with a #{e.full_message}" }
   end
 
-  def warn_fetch(variable)
-    abort "Error: Argument parsing was suppressed, but an attempt to obtain the value of #{variable} was made"
+  def attribute
+    return unless @current_gem
+
+    <<~END_OUTPUT
+      <div id="jps_attribute_#{rand(999_999)}" class="jps_attribute">
+        <div>
+          <a href="#{@homepage}" target="_blank" rel="nofollow">
+            #{attribution_string}
+          </a>
+        </div>
+      </div>
+    END_OUTPUT
   end
 
-  def warn_parse(meth)
-    abort "Error: Argument parsing was suppressed, but an attempt to invoke #{meth} was made"
+  def default_attribution
+    authors = @authors&.join(', ')
+    result = "Generated by the \#{@name} v\#{@version} Jekyll plugin"
+    result << ", written by #{authors}" if authors
+    result << " \#{@published_date}" if @published_date
+    result << '.'
+    result
+  end
+
+  # Sets @current_gem if file points at a uniquely named file within a gem.
+  # @param file must be a fully qualified file name in a gem, for example: __FILE__
+  def gem_file(file)
+    @current_gem = GemSupport.current_spec file
+    @logger.debug "No gem found for '#{file} was found." unless @current_gem
+    annotate_globals if @attribution && @current_gem
+  end
+
+  # @return undefined if parameter was specified, removes it from the available tokens and returns value
+  def parameter_specified?(name, delete_param: true)
+    return if @keys_values.empty?
+
+    key = name
+    key = name.to_sym if @keys_values.first.first.instance_of?(Symbol)
+    value = @keys_values[key]
+    delete_parameter(name) if delete_param
+    value
   end
 
   def reinitialize(markup)
@@ -71,11 +113,7 @@ class JekyllPluginHelper
       define_singleton_method(:parameter_specified?) { |_name| warn_parse(:parameter_specified?) }
       define_singleton_method(:delete_parameter) { |_name| warn_parse(:delete_parameter) }
     else
-      @argv = Shellwords.split(self.class.expand_env(markup))
-      @keys_values = KeyValueParser \
-        .new({}, { array_values: false, normalize_keys: false, separator: /=/ }) \
-        .parse(@argv)
-      @params = @keys_values.map { |k, _v| lookup_variable(k) } unless respond_to?(:no_arg_parsing) && no_arg_parsing
+      parse markup
     end
   end
 
@@ -84,23 +122,50 @@ class JekyllPluginHelper
     @argv.join(' ')
   end
 
+  def remaining_markup_original
+    @argv_original.join(' ')
+  end
+
+  def warn_fetch(variable)
+    abort "Error: Argument parsing was suppressed, but an attempt to obtain the value of #{variable} was made"
+  end
+
+  def warn_parse(meth)
+    abort "Error: Argument parsing was suppressed, but an attempt to invoke #{meth} was made"
+  end
+
+  private
+
+  def attribution_string
+    string = if @attribution == true
+               default_attribution
+             else
+               @attribution
+             end
+    puts { "Interpolationg #{string}" }
+    String.interpolate { string }
+  end
+
+  def annotate_globals
+    return unless @current_gem
+
+    @name           = @current_gem.name
+    @authors        = @current_gem.authors
+    @homepage       = @current_gem.homepage
+    @published_date = @current_gem.date.to_date.to_s
+    @version        = @current_gem.version
+  end
+
   def delete_parameter(key)
     return if @keys_values.empty? || @params.nil?
 
     @params.delete(key)
     @argv.delete_if { |x| x == key or x.start_with?("#{key}=") }
     @keys_values.delete(key)
-  end
-
-  # @return if parameter was specified, removes it from the available tokens and returns value
-  def parameter_specified?(name)
-    return false if @keys_values.empty?
 
-    key = name
-    key = name.to_sym if @keys_values.first.first.instance_of?(Symbol)
-    value = @keys_values[key]
-    delete_parameter(name)
-    value
+    @params_original.delete(key)
+    @argv_original.delete_if { |x| x == key or x.start_with?("#{key}=") }
+    @keys_values_original.delete(key)
   end
 
   PREDEFINED_SCOPE_KEYS = %i[include page].freeze
@@ -126,11 +191,6 @@ class JekyllPluginHelper
     value
   end
 
-  # Sets @params by replacing any Liquid variable names with their values
-  def liquid_context=(context)
-    @liquid_context = context
-  end
-
   def lookup_variable(symbol)
     string = symbol.to_s
     return string unless string.start_with?('{{') && string.end_with?('}}')
@@ -141,4 +201,25 @@ class JekyllPluginHelper
   def page
     @liquid_context.registers[:page]
   end
+
+  # rubocop:disable Style/IfUnlessModifier
+  def parse(markup)
+    @argv_original = Shellwords.split(markup)
+    @keys_values_original = KeyValueParser
+      .new({}, { array_values: false, normalize_keys: false, separator: /=/ })
+      .parse(@argv_original)
+    unless respond_to?(:no_arg_parsing) && no_arg_parsing
+      @params_original = @keys_values_original.map { |k, _v| lookup_variable(k) }
+    end
+
+    @argv = Shellwords.split(self.class.expand_env(markup))
+    @keys_values = KeyValueParser
+      .new({}, { array_values: false, normalize_keys: false, separator: /=/ })
+      .parse(@argv)
+
+    return if respond_to?(:no_arg_parsing) && no_arg_parsing
+
+    @params = @keys_values.map { |k, _v| lookup_variable(k) }
+  end
+  # rubocop:enable Style/IfUnlessModifier
 end

data/lib/jekyll_plugin_support/version.rb

@@ -1,3 +1,3 @@
 module JekyllPluginSupportVersion
-  VERSION = '0.5.2'.freeze
+  VERSION = '0.6.0'.freeze
 end

data/lib/jekyll_plugin_support.rb

@@ -1,6 +1,6 @@
 require 'jekyll'
 require 'jekyll_plugin_logger'
-require_relative 'jekyll_plugin_support_helper'
+require_relative 'jekyll_plugin_helper'
 require_relative 'jekyll_plugin_support/version'
 
 # @author Copyright 2022 Michael Slinn
@@ -31,7 +31,7 @@ module JekyllSupport
       @argument_string = argument_string
       @logger = PluginMetaLogger.instance.new_logger(self, PluginMetaLogger.instance.config)
       @logger.debug { "#{self.class}: respond_to?(:no_arg_parsing) #{respond_to?(:no_arg_parsing) ? 'yes' : 'no'}." }
-      @helper = JekyllPluginHelper.new(tag_name, argument_string, @logger, respond_to?(:no_arg_parsing))
+      @helper = JekyllPluginHelper.new tag_name, argument_string, @logger, respond_to?(:no_arg_parsing)
     end
 
     # Method prescribed by the Jekyll plugin lifecycle.
@@ -47,6 +47,11 @@ module JekyllSupport
       @mode = @config['env']['JEKYLL_ENV'] || 'development'
 
       render_impl text
+    rescue StandardError => e
+      @logger.error { "#{self.class} died with a #{e.full_message}" }
+      # raise SystemExit, 3, []
+      e.set_backtrace []
+      raise e
     end
 
     # Jekyll plugins should override this method, not render, so their plugin can be tested more easily
@@ -65,6 +70,9 @@ module JekyllSupport
 
       super
       @logger.debug { "#{self.class}: respond_to?(:o_arg_parsing) #{respond_to?(:no_arg_parsing) ? 'yes' : 'no'}." }
+    rescue StandardError => e
+      @logger.error { "#{self.class} died with a #{e.full_message}" }
+      exit 2
     end
   end
 
@@ -107,6 +115,9 @@ module JekyllSupport
       @mode = @config['env']['JEKYLL_ENV'] || 'development'
 
       render_impl
+    rescue StandardError => e
+      @logger.error { "#{self.class} died with a #{e.full_message}" }
+      exit 3
     end
 
     # Jekyll plugins must override this method, not render, so their plugin can be tested more easily

data/spec/jekyll_plugin_helper_call_spec.rb

@@ -0,0 +1,21 @@
+require 'jekyll_plugin_logger'
+require 'rspec/match_ignoring_whitespace'
+require_relative '../lib/jekyll_plugin_support'
+require_relative '../lib/jekyll_plugin_support_spec_support'
+
+class JekyllPluginHelperCallTest
+  RSpec.describe JekyllPluginHelper do
+    it 'might not return jpsh_subclass_caller value' do
+      jpsh_subclass_caller = CallChain.jpsh_subclass_caller
+      expect(jpsh_subclass_caller).to be_nil
+    end
+
+    it 'asf' do
+      logger = PluginMetaLogger.instance.new_logger(self, PluginMetaLogger.instance.config)
+      jph = described_class.new('my_tag', 'attribution', logger, false)
+      actual = jph.jpsh_subclass_caller
+      expected = [__FILE__, 15, 'new'] # The 2nd element value depends on the line # of two lines up
+      expect(actual).to match_array(expected)
+    end
+  end
+end

data/spec/{jekyll_block_plugin_support_spec.rb → jekyll_plugin_helper_options_spec.rb}

@@ -3,7 +3,7 @@ require 'rspec/match_ignoring_whitespace'
 require_relative '../lib/jekyll_plugin_support'
 require_relative '../lib/jekyll_plugin_support_spec_support'
 
-class MyTest
+class JekyllPluginHelperOptionsTest
   RSpec.describe JekyllPluginHelper do
     logger = PluginMetaLogger.instance.new_logger(self, PluginMetaLogger.instance.config)
 

data/spec/status_persistence.txt

@@ -1,6 +1,4 @@
-example_id                                                                                        | status | run_time        |
-------------------------------------------------------------------------------------------------- | ------ | --------------- |
-/mnt/_/work/jekyll/my_plugins/jekyll_plugin_support/spec/jekyll_block_plugin_support_spec.rb[1:1] | passed | 0.00335 seconds |
-/mnt/_/work/jekyll/my_plugins/jekyll_plugin_support/spec/jekyll_block_plugin_support_spec.rb[1:2] | passed | 0.00019 seconds |
-/mnt/_/work/jekyll/my_plugins/jekyll_plugin_support/spec/jekyll_block_plugin_support_spec.rb[1:3] | passed | 0.00337 seconds |
-/mnt/_/work/jekyll/my_plugins/jekyll_plugin_support/spec/jekyll_block_plugin_support_spec.rb[1:4] | passed | 0.00026 seconds |
+example_id                                                                                      | status | run_time        |
+----------------------------------------------------------------------------------------------- | ------ | --------------- |
+/mnt/_/work/jekyll/my_plugins/jekyll_plugin_support/spec/jekyll_plugin_helper_call_spec.rb[1:1] | passed | 0.00436 seconds |
+/mnt/_/work/jekyll/my_plugins/jekyll_plugin_support/spec/jekyll_plugin_helper_call_spec.rb[1:2] | passed | 0.00476 seconds |

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: jekyll_plugin_support
 version: !ruby/object:Gem::Version
-  version: 0.5.2
+  version: 0.6.0
 platform: ruby
 authors:
 - Mike Slinn
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-03-17 00:00:00.000000000 Z
+date: 2023-04-06 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: facets
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: jekyll
   requirement: !ruby/object:Gem::Requirement
@@ -60,26 +74,30 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".rubocop.yml"
+- ATTIBUTION_NOTES.md
 - CHANGELOG.md
 - LICENSE.txt
 - README.md
 - Rakefile
 - jekyll_plugin_support.gemspec
+- lib/call_chain.rb
+- lib/gem_support.rb
+- lib/jekyll_plugin_helper.rb
 - lib/jekyll_plugin_support.rb
 - lib/jekyll_plugin_support/version.rb
-- lib/jekyll_plugin_support_helper.rb
 - lib/jekyll_plugin_support_spec_support.rb
-- spec/jekyll_block_plugin_support_spec.rb
+- spec/jekyll_plugin_helper_call_spec.rb
+- spec/jekyll_plugin_helper_options_spec.rb
 - spec/spec_helper.rb
 - spec/status_persistence.txt
-homepage: https://www.mslinn.com/blog/2020/10/03/jekyll-plugins.html#quote
+homepage: https://www.mslinn.com/jekyll/10200-jekyll-plugin-support.html
 licenses:
 - MIT
 metadata:
   allowed_push_host: https://rubygems.org
   bug_tracker_uri: https://github.com/mslinn/jekyll_plugin_support/issues
   changelog_uri: https://github.com/mslinn/jekyll_plugin_support/CHANGELOG.md
-  homepage_uri: https://www.mslinn.com/blog/2020/10/03/jekyll-plugins.html#quote
+  homepage_uri: https://www.mslinn.com/jekyll/10200-jekyll-plugin-support.html
   source_code_uri: https://github.com/mslinn/jekyll_plugin_support
 post_install_message: |2+
 
@@ -104,7 +122,8 @@ signing_key:
 specification_version: 4
 summary: Provides support for writing Jekyll plugins.
 test_files:
-- spec/jekyll_block_plugin_support_spec.rb
+- spec/jekyll_plugin_helper_call_spec.rb
+- spec/jekyll_plugin_helper_options_spec.rb
 - spec/spec_helper.rb
 - spec/status_persistence.txt
 ...