jekyll_plugin_support 0.6.1 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5fa04aaa91759fb0cea5d52005f80d854c0e88bdc6c7300d167fd85737cdc584
-  data.tar.gz: '0183049f3234a4d97e071dc00055fd79d844da86ef8c6d836c1c8be3b1430d1b'
+  metadata.gz: 4d4b97854b427b9113f6db8e175608ac5e2b3fc5866c0062449c9b7e5c530798
+  data.tar.gz: 39c0b2b1ee1b457df3e339edb166d295fdf14b83faeb44a6261be39993fc82f4
 SHA512:
-  metadata.gz: 48bcfac7c6a918b7ad182bdcb5890c5707a5955d119df6ad03304c0a4712e07b7b5d523668fa6fc391a41e403706810d8939ac8c5c6ff1d7616db35ee804f017
-  data.tar.gz: 6adc3d6a4b5cebbf081b8b53abe3cc6abdac822046abbfe1d350f85f18d4c45f4861c0bed91cad29117d88605e49f22afb79d4b65adc6b35413924df6556d579
+  metadata.gz: db5aa2fe02695556bb5bc7c95e53c5eb98990688fd1920bcab97503262979ef4266ac95210da7fc5d60a67f635b2fe11e7b18ebd3d35ab6e4bdbeedc1d116442
+  data.tar.gz: accae0af9a79e92f812980db24e23e33b7555362f24e28f9dd099f6faa57e7484a7043ddeccb16aa10f1d6a7d187cf6ee9f023bbd030d8cb49bf9984dc8049eb

data/CHANGELOG.md

@@ -1,3 +1,9 @@
+## 0.7.0 / 2023-05-22
+  * Added `error_short_trace` and `warn_short_trace` methods for displaying non-fatal errors on the console.
+
+## 0.6.2 / 2023-05-15
+  * Removed annoying blank line output when attribute was invoked.
+
 ## 0.6.1 / 2023-04-12
   * Added `CallChain.excerpt_caller` to detect if an excerpt is being generated.
 

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/jekyll/10200-jekyll-plugin-support.html'
+  spec.homepage = 'https://www.mslinn.com/jekyll_plugins/jekyll_plugin_support.html'
   spec.license = 'MIT'
   spec.metadata = {
     'allowed_push_host' => 'https://rubygems.org',

data/lib/jekyll_plugin_helper.rb

@@ -142,7 +142,6 @@ class JekyllPluginHelper # rubocop:disable Metrics/ClassLength
              else
                @attribution
              end
-    puts { "Interpolationg #{string}" }
     String.interpolate { string }
   end
 

data/lib/jekyll_plugin_support/version.rb

@@ -1,3 +1,3 @@
 module JekyllPluginSupportVersion
-  VERSION = '0.6.1'.freeze
+  VERSION = '0.7.0'.freeze
 end

data/lib/jekyll_plugin_support.rb

@@ -12,6 +12,26 @@ module NoArgParsing
 end
 
 module JekyllSupport
+  DISPLAYED_CALLS = 8
+
+  def self.error_short_trace(logger, error)
+    remaining = e.backtrace.length - DISPLAYED_CALLS
+    logger.error do
+      error.message + "\n" + # rubocop:disable Style/StringConcatenation
+        error.backtrace.take(DISPLAYED_CALLS).join("\n") +
+        "\n...Remaining #{remaining} call sites elided.\n"
+    end
+  end
+
+  def self.warn_short_trace(logger, error)
+    remaining = e.backtrace.length - DISPLAYED_CALLS
+    logger.warn do
+      error.message + "\n" + # rubocop:disable Style/StringConcatenation
+        error.backtrace.take(DISPLAYED_CALLS).join("\n") +
+        "\n...Remaining #{remaining} call sites elided.\n"
+    end
+  end
+
   # Base class for Jekyll block tags
   class JekyllBlock < Liquid::Block
     attr_reader :argument_string, :helper, :line_number, :logger, :page, :site, :text
@@ -34,16 +54,27 @@ module JekyllSupport
       @helper = JekyllPluginHelper.new tag_name, argument_string, @logger, respond_to?(:no_arg_parsing)
     end
 
+    # @return line number where tag or block was found, relative to the start of the page
+    def jekyll_line_number
+      @page['front_matter'].count("\n") + @line_number
+    end
+
     # Method prescribed by the Jekyll plugin lifecycle.
+    # Defines @config, @envs, @mode, @page and @site
     # @return [String]
     def render(liquid_context)
       text = super
       @helper.liquid_context = liquid_context
 
-      @page = liquid_context.registers[:page] # Type Jekyll::Drops::DocumentDrop
+      @page = liquid_context.registers[:page] # hash
       @site = liquid_context.registers[:site]
       @config = @site.config
       @envs = liquid_context.environments.first
+
+      @layout    = @envs[:layout]
+      @paginator = @envs[:paginator]
+      @theme     = @envs[:theme]
+
       @mode = @config['env']['JEKYLL_ENV'] || 'development'
 
       render_impl text
@@ -54,12 +85,18 @@ module JekyllSupport
       raise e
     end
 
-    # Jekyll plugins should override this method, not render, so their plugin can be tested more easily
-    # @page and @site are available
-    # @return [String]
+    # Jekyll plugins should override this method, not render,
+    # so they can be tested more easily.
+    # The following variables are predefined:
+    #   @argument_string, @config, @envs, @helper, @layout, @logger, @mode, @page, @paginator, @site, @tag_name and @theme
+    # @return [String] The result to be rendered to the invoking page
     def render_impl(text)
       text
     end
+
+    def warn_short_trace(error)
+      JekyllSupport.warn_short_trace(@logger, error)
+    end
   end
 
   class JekyllBlockNoArgParsing < JekyllBlock
@@ -74,6 +111,10 @@ module JekyllSupport
       @logger.error { "#{self.class} died with a #{e.full_message}" }
       exit 2
     end
+
+    def warn_short_trace(error)
+      JekyllSupport.warn_short_trace(@logger, error)
+    end
   end
 
   # Base class for Jekyll tags
@@ -98,6 +139,11 @@ module JekyllSupport
       @helper = JekyllPluginHelper.new(tag_name, argument_string, @logger, respond_to?(:no_arg_parsing))
     end
 
+    # @return line number where tag or block was found, relative to the start of the page
+    def jekyll_line_number
+      @page['front_matter'].count("\n") + @line_number
+    end
+
     # Method prescribed by the Jekyll plugin lifecycle.
     def render(liquid_context)
       return if @helper.excerpt_caller
@@ -123,10 +169,15 @@ module JekyllSupport
     end
 
     # Jekyll plugins must override this method, not render, so their plugin can be tested more easily
-    # @page and @site are available
+    # The following variables are predefined:
+    #   @argument_string, @config, @envs, @helper, @layout, @logger, @mode, @page, @paginator, @site, @tag_name and @theme
     def render_impl
       abort "#{self.class}.render_impl for tag #{@tag_name} must be overridden, but it was not."
     end
+
+    def warn_short_trace(error)
+      JekyllSupport.warn_short_trace(@logger, error)
+    end
   end
 
   class JekyllTagNoArgParsing < JekyllTag

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jekyll_plugin_support
 version: !ruby/object:Gem::Version
-  version: 0.6.1
+  version: 0.7.0
 platform: ruby
 authors:
 - Mike Slinn
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-04-13 00:00:00.000000000 Z
+date: 2023-07-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: facets
@@ -86,18 +86,16 @@ files:
 - lib/jekyll_plugin_support.rb
 - lib/jekyll_plugin_support/version.rb
 - lib/jekyll_plugin_support_spec_support.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/jekyll/10200-jekyll-plugin-support.html
+homepage: https://www.mslinn.com/jekyll_plugins/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/jekyll/10200-jekyll-plugin-support.html
+  homepage_uri: https://www.mslinn.com/jekyll_plugins/jekyll_plugin_support.html
   source_code_uri: https://github.com/mslinn/jekyll_plugin_support
 post_install_message: |2+
 
@@ -122,8 +120,6 @@ signing_key:
 specification_version: 4
 summary: Provides support for writing Jekyll plugins.
 test_files:
-- spec/jekyll_plugin_helper_call_spec.rb
 - spec/jekyll_plugin_helper_options_spec.rb
 - spec/spec_helper.rb
-- spec/status_persistence.txt
 ...

data/spec/jekyll_plugin_helper_call_spec.rb

@@ -1,21 +0,0 @@
-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/status_persistence.txt

@@ -1,4 +0,0 @@
-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 |