sutty-liquid 0.8.1 → 0.10.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9eecb00f3cfa8234ca077bddd1201be34e5490f8ebd915fd7b8988b0bc0e8347
-  data.tar.gz: 133733b0369fa579d0fcfd1b64ab89a8ab46b2ebbb70e1341f916c02cb66cbf7
+  metadata.gz: f89b4f4a0b3dc57f4720491bd1245b63e48a018eb059f1e1c065178e8d0ab185
+  data.tar.gz: 797a226386270f608022b0c9ff89402a17b0806fba9e409e0fb99eff2bdad475
 SHA512:
-  metadata.gz: 4e5c7ba1221f73a4ae42b59d4ad0f3d021a630617649d8412deab39ec06d3929286c85758a53ebc8edc44daa8d1b04def206b126ec848c9524b51907836bcd92
-  data.tar.gz: b371f3d5db4c81ac5b208fbd2491c15a25fc86315faa4ef6525e9dfcb522244350a0d649fbd0522cdf42ae424624d40b85edcb85a57b307ecda69a013d96bfe9
+  metadata.gz: 924ba6d9c6d01f1f3b313782911de7ce751e7dab63fbfd99cb18ccbec9f34ee2fe30ff9a65a5cc7e5b203ac3a90a2b094d89606a0247905322d9d611dd175eda
+  data.tar.gz: d2b3c2c91a51311313cff91b82ca752d680eb54b12145187bbeaa0771e0473fe561e3995c583bcbdb78e5297a67b42fae58bdeb427ef30dfaa8e5dc8c8aa6c5b

data/lib/jekyll/filters/arrays.rb

@@ -0,0 +1,149 @@
+# frozen_string_literal: true
+
+module Jekyll
+  module Filters
+    module Arrays
+      # Returns one or several random items from an Array.
+      #
+      # @example
+      #   {{ site.posts | sample }}
+      #   {{ site.posts | sample: 3 }}
+      # @param input [Array]
+      # @param amount [Integer]
+      # @return [Any]
+      def sample(input, amount = 1)
+        input = [] unless array? input
+
+        input.sample(amount)
+      end
+
+      # Join arrays or append item to array
+      #
+      # @example
+      #   {% assign things = site.posts | where: "layout", "thing" %}
+      #   {% assign being = site.posts | find: "layout", "being" %}
+      #   {% assign dread = things | concat: being %}
+      #
+      # @param input [Array]
+      # @param concatenable [Array,any]
+      def join(input, concatenable)
+        input = [] unless array? input
+
+        if concatenable.is_a? Array
+          input + concatenable
+        else
+          input.dup << concatenable
+        end
+      end
+
+      # Finds the next posts in a collection, starting from current
+      # post and restarts from the beginning to always return posts.
+      #
+      # @example
+      #   {{ page | infinite_next: site.posts }}
+      # @param input [Jekyll::Document,Drop] The current post (page)
+      # @param posts [Array] An array of posts (ie. results from where filter)
+      # @param amount [Integer] Amount of posts next to current, max is posts size
+      # @return [Array<Jekyll::Document,Drop>] Array of posts
+      def infinite_next(input, posts, amount = 1)
+        posts = [] unless array? posts
+
+        liquid_input = input.to_liquid
+        liquid_posts = posts.map(&:to_liquid)
+        index = find_in_stack(liquid_input, liquid_posts)
+        liquid_posts.rotate(index).slice(1, amount) if index
+      end
+
+      # Finds the previous posts in a collection, starting from current
+      # post and restarts from the beginning to always return posts.
+      #
+      # @example
+      #   {{ page | infinite_next: site.posts }}
+      # @param input [Jekyll::Document,Drop] The current post (page)
+      # @param posts [Array<Jekyll::Document,Drop>] An array of posts (ie. results from where filter)
+      # @param amount [Integer] Amount of posts previous to current, max is posts size
+      # @return [Array<Jekyll::Document,Drop>] Array of posts
+      def infinite_prev(input, posts, amount = 1)
+        posts = [] unless array? posts
+
+        liquid_input = input.to_liquid
+        liquid_posts = posts.map(&:to_liquid)
+        index = find_in_stack(liquid_input, liquid_posts)
+        liquid_posts.rotate(index).reverse.slice(0, amount).reverse if index
+      end
+
+      # Return next post from an array or nothing if post is last.
+      #
+      # @example
+      #   {{ page | next: site.posts }}
+      # @param input [Jekyll::Document,Drop]
+      # @param posts [Array<Jekyll::Document,Drop>]
+      # @return [Drop,nil]
+      def next(input, posts)
+        posts = [] unless array? posts
+
+        liquid_input = input.to_liquid
+        liquid_posts = posts.map(&:to_liquid)
+        index = find_in_stack(liquid_input, liquid_posts)
+        liquid_posts[index + 1] if index
+      end
+
+      # Return previous post from an array, or nothing if post is the
+      # first item.
+      #
+      # @example
+      #   {{ page | prev: site.posts }}
+      #   {{ page | previous: site.posts }}
+      # @param input [Jekyll::Document,Drop]
+      # @param array [Array]
+      # @return [Drop,nil]
+      def prev(input, posts)
+        posts = [] unless array? posts
+
+        liquid_input = input.to_liquid
+        liquid_posts = posts.map(&:to_liquid)
+        index = find_in_stack(liquid_input, liquid_posts)
+        liquid_posts[index - 1] if index && index > 0
+      end
+
+      alias_method :previous, :prev
+
+      private
+
+      # Detects if param is an array or raise an error if strict filters
+      # is enabled
+      #
+      # @param posts [Array]
+      # @return [Boolean]
+      def array?(posts)
+        posts.is_a?(Array).tap do |a|
+          next if a
+          next unless @context.strict_filters
+
+          raise Liquid::ArgumentError.new('needs an array argument')
+        end
+      end
+
+      # Find post in posts, raise an error if strict_filters is enabled
+      #
+      # @param input [Drop]
+      # @param posts [Array] array of drops
+      # @return [Integer]
+      def find_in_stack(input, posts)
+        posts.index(input).tap do |n|
+          next if n
+          next unless @context.strict_filters
+
+          title = input['title'] || input['id'] || 'no title'
+          titles = posts.map do |p|
+            p['title'] || p['id'] || 'no title'
+          end
+
+          raise Liquid::ArgumentError.new("can't find #{title} in #{titles.join(', ')}")
+        end
+      end
+    end
+  end
+end
+
+Liquid::Template.register_filter(Jekyll::Filters::Arrays)

data/lib/jekyll/filters/assertion.rb

@@ -123,7 +123,7 @@ module Jekyll
           input.blank?
         when Array then input.compact.empty?
         when Hash then input.compact.empty?
-        else input.respond_to?(:empty?) ? input.empty? : !!input
+        else input.respond_to?(:empty?) ? input.empty? : !!!input
         end
       end
 

data/lib/jekyll/filters/content.rb

@@ -0,0 +1,129 @@
+# frozen_string_literal: true
+
+module Jekyll
+  module Filters
+    module Content
+      HEADINGS = 'h1,h2,h3,h4,h5,h6'
+
+      # Add id attribute to all headings with an optional prefix.  It
+      # also creates a table of contents with unique IDs.
+      #
+      # It doesn't change pre-existing IDs.
+      #
+      # @example Render content with unique IDs
+      #   {{ content | canonicalize_headings }}
+      # @param input [String] HTML string
+      # @param prefix [nil,String] Prefix IDs with this
+      # @return [String]
+      def canonicalize_headings(input, prefix = nil)
+        @@canonicalize_headings ||= {}
+        @@canonicalize_headings[input.hash] ||=
+          begin
+            require 'nokogiri'
+
+            toc = toc(input)
+
+            html_fragment(input).tap do |html|
+              html.css(HEADINGS).each do |h|
+                id = h['id']
+
+                unless id
+                  slug = ::Jekyll::Utils.slugify(h.text, mode: 'pretty')
+                  id   = unique_id(slug, prefix, toc)
+                  h['id'] = id
+                end
+
+                toc[id] = {
+                  'level' => h.name[1].to_i,
+                  'title' => h.text,
+                  'id'    => id
+                }
+              end
+            end.to_s
+          end
+      end
+
+      # Extracts a table of contents from HTML up to a certain headings
+      # level.
+      #
+      # It returns an array of hashes with title, level and id.
+      #
+      # @example Create a table of contents
+      #   {% assign toc = content | table_of_contents: 2 %}
+      #  
+      #   {% unless toc == empty %}
+      #     {% for item in toc %}
+      #       {% assign heading = "h" | append: item.level %}
+      #       <{{ heading }}>
+      #         <a href="#{{ item.id }}">
+      #           {{ item.title }}
+      #         </a>
+      #       </{{ heading }}>
+      #     {% endfor %}
+      #   {% endunless %}
+      # @param input [String]
+      # @param max_level [Integer] All headings up to this level
+      # @param prefix [String,nil] Prefix
+      # @return [Hash]
+      def table_of_contents(input, max_level = 2, prefix = nil)
+        canonicalize_headings(input, prefix)
+
+        toc(input).select do |id, item|
+          item['level'] <= max_level
+        end.values
+      end
+
+      private
+
+      # Parses and caches an HTML5 fragment
+      #
+      # @param input [String]
+      # @return [Nokogiri::HTML5::Fragment]
+      def html_fragment(input)
+        @@html_fragment ||= {}
+        @@html_fragment[input.hash] ||= Nokogiri::HTML5.fragment(input.to_s)
+      end
+
+      # @param input [String]
+      # @return [Hash]
+      def toc(input)
+        @@toc ||= {}
+        @@toc[input.hash] ||= {}
+      end
+
+      # Apply a prefix to an ID unless it's already applied
+      #
+      # @param id [String]
+      # @param prefix [nil,String]
+      # @return [String]
+      def prefix_id(id, prefix)
+        return id if prefix.nil?
+        return id if id.start_with? "#{prefix}-"
+
+        "#{prefix}-#{id}"
+      end
+
+      # Obtains a unique ID for TOC
+      #
+      # @param id [String]
+      # @param prefix [String,nil]
+      # @param toc [Hash]
+      # @return [String]
+      def unique_id(id, prefix, toc)
+        prefixed_id = prefix_id id, prefix
+
+        return prefixed_id unless toc.key? prefixed_id
+
+        require 'securerandom'
+
+        loop do
+          unique = "#{prefixed_id}-#{SecureRandom.hex(3)}"
+
+          break unique unless toc.key? unique
+        end
+      end
+    end
+  end
+end
+
+Liquid::Template.register_filter(Jekyll::Filters::Content)

data/lib/jekyll/filters/strings.rb

@@ -61,6 +61,20 @@ module Jekyll
           .gsub(star_delimiter, '*')
           .gsub(escaped_delimiter, '\*')
       end
+
+      def unescape(input)
+        CGI.unescapeHTML input.to_s
+      end
+
+      # Escapes a string by percent encoding all reserved characters
+      #
+      # @param :input [Any]
+      # @return [String]
+      def component_escape(input)
+        require 'addressable'
+
+        Addressable::URI.encode_component input.to_s, Addressable::URI::CharacterClasses::UNRESERVED
+      end
     end
   end
 end

data/lib/sutty-liquid.rb

@@ -1,14 +1,14 @@
 # frozen_string_literal: true
 
+require_relative 'jekyll/filters/arrays'
 require_relative 'jekyll/filters/assertion'
 require_relative 'jekyll/filters/compact'
+require_relative 'jekyll/filters/content'
 require_relative 'jekyll/filters/date_local'
-require_relative 'jekyll/filters/infinite'
 require_relative 'jekyll/filters/file'
 require_relative 'jekyll/filters/json'
 require_relative 'jekyll/filters/menu'
 require_relative 'jekyll/filters/number'
-require_relative 'jekyll/filters/sample'
 require_relative 'jekyll/filters/strings'
 require_relative 'jekyll/filters/social_network'
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sutty-liquid
 version: !ruby/object:Gem::Version
-  version: 0.8.1
+  version: 0.10.1
 platform: ruby
 authors:
 - f
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-03-08 00:00:00.000000000 Z
+date: 2022-08-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll
@@ -80,6 +80,34 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.13'
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: An assorment of Liquid filters and tags for Jekyll used in Sutty
 email:
 - f@sutty.nl
@@ -92,16 +120,16 @@ files:
 - LICENSE.txt
 - README.md
 - lib/jekyll/drops/url_drop_decorator.rb
+- lib/jekyll/filters/arrays.rb
 - lib/jekyll/filters/assertion.rb
 - lib/jekyll/filters/compact.rb
+- lib/jekyll/filters/content.rb
 - lib/jekyll/filters/date_local.rb
 - lib/jekyll/filters/file.rb
-- lib/jekyll/filters/infinite.rb
 - lib/jekyll/filters/json.rb
 - lib/jekyll/filters/menu.rb
 - lib/jekyll/filters/number.rb
 - lib/jekyll/filters/pry.rb
-- lib/jekyll/filters/sample.rb
 - lib/jekyll/filters/social_network.rb
 - lib/jekyll/filters/strings.rb
 - lib/jekyll/tags/pry.rb
@@ -137,7 +165,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.5
+rubygems_version: 3.3.15
 signing_key:
 specification_version: 4
 summary: Liquid filters

data/lib/jekyll/filters/infinite.rb

@@ -1,20 +0,0 @@
-# frozen_string_literal: true
-
-module Jekyll
-  module Filters
-    module Infinite
-      # 
-      def infinite_next(input, posts, amount)
-        liquid = posts.map(&:to_liquid)
-        liquid.rotate(liquid.index(input)).slice(1, amount)
-      end
-
-      def infinite_prev(input, posts, amount)
-        liquid = posts.map(&:to_liquid)
-        liquid.rotate(liquid.index(input)).reverse.slice(0, amount).reverse
-      end
-    end
-  end
-end
-
-Liquid::Template.register_filter(Jekyll::Filters::Infinite)

data/lib/jekyll/filters/sample.rb

@@ -1,24 +0,0 @@
-# frozen_string_literal: true
-
-module Jekyll
-  module Filters
-    module Sample
-      # Returns a random item from an Array.
-      #
-      # Example usage:
-      #
-      # {{ site.posts | sample }}
-      # {{ site.posts | sample: 3 }}
-      #
-      # @input [Array]
-      # @return [Any]
-      def sample(input, amount = 1)
-        return unless input.respond_to? :sample
-
-        input.sample(amount)
-      end
-    end
-  end
-end
-
-Liquid::Template.register_filter(Jekyll::Filters::Sample)