sutty-liquid 0.2.0 → 0.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0e0505b26f76af0f596d0c5b2b6763776ca28e0e83ef16207393488534ecde42
-  data.tar.gz: fc1f956be9ae1a997989c4f67cb399bc1c4ad0fd26034913f74d65235658cac9
+  metadata.gz: 4c72d9f508299076408aafbf0aa0e75f128259b3f647b16951f4f0b3ec18233a
+  data.tar.gz: 6c3216caa9bf468ea6375badf89cc33eef090ce41e98c8f0f9b7c492a28626d3
 SHA512:
-  metadata.gz: 2b9b2e9d866d1766922f9f69263a7ff8d9c11f01cab5a000f6d8a605048d8acd81a3d7a7319a8aa161e5f86727bf26e26b084b7b73521acb705ad4da6a3912a8
-  data.tar.gz: 1bfaf334727887f40399d4680dab162001ec80faf513a595411fc7dc800d41591a90ec5b3987207b7a97d202373eab08a089a246c57ecfb2ad111dcb95e0070a
+  metadata.gz: 7215373c2ff717d19d0b6593f2e938c153c2f2c7825928b9f8a88d416e61a7624e09fbcfc55f83e62859481231ae3700f7aae7a03d184e880e037d5c0362d35a
+  data.tar.gz: 414606c886d9e4313d405e95664ad8e108a562bb9a60490abf1f5042edb0df32533f5e30f97b1559fbe31cc55c33aca6bbfaa92e4b2ba40a0f0366a1f41b1565

data/lib/jekyll/drops/url_drop_decorator.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+require 'jekyll/drops/url_drop'
+
+module Jekyll
+  module Drops
+    module UrlDropDecorator
+      # Permits to use layout as an URL placeholder
+      def layout
+        @obj.data['layout']
+      end
+    end
+  end
+end
+
+Jekyll::Drops::UrlDrop.include Jekyll::Drops::UrlDropDecorator

data/lib/jekyll/filters/assertion.rb

@@ -0,0 +1,147 @@
+# frozen_string_literal: true
+
+module Jekyll
+  module Filters
+    module Assertion
+      # Compares two values.
+      #
+      # Example usage:
+      #
+      # {{ item.url | equals: page.url }}
+      #
+      # @param [Any]
+      # @param [Any]
+      # @return [TrueClass|FalseClass]
+      def equals(input, comparison)
+        input == comparison
+      end
+
+      # The two values must be different
+      def not(input, comparison)
+        input != comparison
+      end
+
+      # Greater than
+      #
+      # @param [Integer|Float]
+      # @param [Integer|Float]
+      # @return [TrueClass|FalseClass]
+      def gt(input, comparison)
+        input > comparison
+      end
+
+      # Less than
+      #
+      # @param [Integer|Float]
+      # @param [Integer|Float]
+      # @return [TrueClass|FalseClass]
+      def lt(input, comparison)
+        input < comparison
+      end
+
+      # Greater than or equal
+      #
+      # @param [Integer|Float]
+      # @param [Integer|Float]
+      # @return [TrueClass|FalseClass]
+      def gte(input, comparison)
+        input >= comparison
+      end
+
+      # Less than or equal
+      #
+      # @param [Integer|Float]
+      # @param [Integer|Float]
+      # @return [TrueClass|FalseClass]
+      def lte(input, comparison)
+        input <= comparison
+      end
+
+      # Ternary operator.  If the input value is truthy, return first
+      # argument, otherwise returns the last.
+      #
+      # Example usage:
+      #
+      # {% assign active = item.url | equals: page.url %}
+      # {{ active | ternary: 'active', '' }}
+      #
+      # @param [Any]
+      # @param [Any]
+      # @param [Any]
+      # @return [Any]
+      def ternary(input, value, alternative)
+        if present(input) && input
+          value
+        else
+          alternative
+        end
+      end
+
+      # Returns the value when the input is not empty or falsey
+      #
+      # If tags have something:
+      #
+      # {{ post.tags | value_if: "some tags" }} => "some tags"
+      def value_if(input, value)
+        value if present(input) && input
+      end
+
+      # Returns the value when the input is empty or falsey
+      #
+      # If tags are empty:
+      #
+      # {{ post.tags | value_unless: "no tags" }} => nil
+      def value_unless(input, value)
+        value unless present(input) && input
+      end
+
+      # Returns the input when value is not empty and truthy
+      #
+      # {{ post.url | input_if: true }} => 'url/to/post/'
+      def input_if(input, value)
+        input if present(value) && value
+      end
+
+      # {{ post.url | input_unless: false }} => nil
+      def input_unless(input, value)
+        input unless present(value) && value
+      end
+
+      # Checks if input value is empty.
+      #
+      # {{ post.title | blank }} => false
+      def blank(input)
+        case input
+        when TrueClass then false
+        when FalseClass then true
+        when NilClass then true
+        when Integer then false
+        when Float then false
+        when Time then false
+        when String then
+          require 'fast_blank'
+          input.blank?
+        when Array then input.compact.empty?
+        when Hash then input.compact.empty?
+        else input.respond_to?(:empty?) ? input.empty? : !!input
+        end
+      end
+
+      # The opposite of blank
+      #
+      # {{ post.title | present }} => true
+      def present(input)
+        !blank(input)
+      end
+
+      # Return the input if it's not blank
+      #
+      # {{ post.title | presence }} => 'the post title'
+      def presence(input)
+        input if present input
+      end
+    end
+  end
+end
+
+Liquid::Template.register_filter(Jekyll::Filters::Assertion)

data/lib/jekyll/filters/compact.rb

@@ -5,6 +5,10 @@ module Jekyll
     module Compact
       # Removes nil values from an Array
       #
+      # Example usage:
+      #
+      # {{ 'tag,,tag2' | split: ',' | compact }}
+      #
       # @param [Array]
       # @return [Array]
       def compact(array)

data/lib/jekyll/filters/date_local.rb

@@ -3,7 +3,12 @@
 module Jekyll
   module Filters
     module DateLocal
-      # Translates month and day names.  This requires certain values on your _data/LANG.yml
+      # Translates month and day names.  This requires certain values on
+      # your _data/LANG.yml
+      #
+      # Example usage:
+      #
+      # {{ page.date | date_local: '%e de %B de %Y' }}
       #
       # @see {_data/es.yml}
       # @param [String|Date]

data/lib/jekyll/filters/file.rb

@@ -3,7 +3,11 @@
 module Jekyll
   module Filters
     module File
-      # File extension
+      # File extension.
+      #
+      # Example usage:
+      #
+      # {{ page.file.path | extname }}
       #
       # @param [String]
       # @return [Nil|String]

data/lib/jekyll/filters/json.rb

@@ -1,11 +1,12 @@
 # frozen_string_literal: true
 
-
 module Jekyll
   module Filters
     module Json
       # Converts an object to JSON
       #
+      # Note: Jekyll 4 has a jsonify filter now.
+      #
       # @param [Any]
       # @return [String]
       def json(object)

data/lib/jekyll/filters/menu.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+module Jekyll
+  module Filters
+    module Menu
+      # Verifies if the given URL is an active item on the menu.
+      #
+      # Example usage:
+      #
+      # {% assign active_url = page.url | menu_active %}
+      # {% for item in site.i18n.menu.items %}
+      #   <a
+      #     href="{{ item.href }}"
+      #     class="{{ page.url | menu_active | equals: item.href | ternary: 'active', '' }}">
+      #
+      #     {{ item.title }}
+      #   </a>
+      # {% endfor %}
+      #
+      # @param [String] The URL to be verified
+      # @return [String] The item URL
+      def menu_active_item(page_url)
+        site_menu&.find do |key, value|
+          key == page_url || page_url.start_with?(key)
+        end&.last
+      end
+
+      # The menu is defined in a data file that corresponds to the site
+      # language.  This method converts the menu items into a map of URL
+      # parts and actual URLs.
+      #
+      # @see _data/es.yml
+      # @see {https://0xacab.org/sutty/jekyll/jekyll-locales}
+      # @return [Hash]
+      def site_menu
+        site = @context.registers[:site]
+        @site_menu ||= site.data.dig(site.config['locale'], 'menu', 'items')&.reduce({}) do |menu, item|
+          # If the item has a layout, we pick the first post and update
+          # the href.  We can't do the same for all posts because we
+          # wouldn't be able to cache the menu.
+          if item['layout']
+            doc = site.documents.find do |doc|
+              doc.data['layout'] == item['layout']
+            end
+
+            item['href'] = doc&.url
+          end
+
+          # Ignore empty or anchor items
+          next menu if item['href'].nil? || item['href'].empty? || item['href']&.start_with?('#')
+
+          menu[item['href']] = item['href']
+
+          item['active']&.each do |a|
+            menu[a] = item['href']
+          end
+
+          menu
+        end
+      end
+    end
+  end
+end
+
+Liquid::Template.register_filter(Jekyll::Filters::Menu)

data/lib/jekyll/filters/number.rb

@@ -5,6 +5,10 @@ module Jekyll
     # Extracts numbers from a String, useful for converting phone
     # numbers to tel: links.
     #
+    # Example usage:
+    #
+    # <a href="tel:{{ page.tel | numbers }}">{{ page.tel }}</a>
+    #
     # @param [String]
     # @return [String]
     module Numbers

data/lib/jekyll/filters/pry.rb

@@ -4,6 +4,10 @@ module Jekyll
   module Filters
     module Pry
       # Pry into the input and args
+      #
+      # Example usage:
+      #
+      # {{ site.posts | pry }}
       def pry(input, *args)
         require 'pry'
 

data/lib/jekyll/filters/sample.rb

@@ -3,7 +3,11 @@
 module Jekyll
   module Filters
     module Sample
-      # Returns a random item from an Array
+      # Returns a random item from an Array.
+      #
+      # Example usage:
+      #
+      # {{ site.posts | sample }}
       #
       # @input [Array]
       # @return [Any]

data/lib/jekyll/filters/social_network.rb

@@ -7,6 +7,15 @@ module Jekyll
       # want to generate social network buttons from an undetermined
       # list of URLs.
       #
+      # Example usage:
+      #
+      # {% assign mastodon = 'https://todon.nl/@sutty' | social_network %}
+      # <a href="{{ mastodon.url }}">
+      #   <i class="fa-{{ mastodon.name }}"></i>
+      #
+      #   {{ mastodon.name | capitalize }}
+      # </a>
+      #
       # @param [String]
       # @return [Hash]
       def social_network(url)

data/lib/jekyll/tags/pry.rb

@@ -4,6 +4,10 @@ module Jekyll
   module Tags
     class Pry < Liquid::Tag
       # Pry into the rendering context
+      #
+      # Example usage:
+      #
+      # {% pry %}
       def render(context)
         require 'pry'
 

data/lib/sutty-liquid.rb

@@ -1,11 +1,17 @@
 # frozen_string_literal: true
 
-require_relative 'jekyll/filters/compact.rb'
-require_relative 'jekyll/filters/infinite.rb'
-require_relative 'jekyll/filters/file.rb'
-require_relative 'jekyll/filters/json.rb'
-require_relative 'jekyll/filters/sample.rb'
-require_relative 'jekyll/filters/social_network.rb'
+require_relative 'jekyll/filters/assertion'
+require_relative 'jekyll/filters/compact'
+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/social_network'
 
-require_relative 'jekyll/filters/pry.rb'
-require_relative 'jekyll/tags/pry.rb'
+require_relative 'jekyll/filters/pry'
+require_relative 'jekyll/tags/pry'
+
+require_relative 'jekyll/drops/url_drop_decorator'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sutty-liquid
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.5.1
 platform: ruby
 authors:
 - f
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-09-27 00:00:00.000000000 Z
+date: 2020-11-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jekyll
@@ -24,6 +24,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '4'
+- !ruby/object:Gem::Dependency
+  name: fast_blank
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
 description: An assorment of Liquid filters and tags for Jekyll used in Sutty
 email:
 - f@sutty.nl
@@ -35,11 +49,14 @@ extra_rdoc_files:
 files:
 - LICENSE.txt
 - README.md
+- lib/jekyll/drops/url_drop_decorator.rb
+- lib/jekyll/filters/assertion.rb
 - lib/jekyll/filters/compact.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
@@ -77,7 +94,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.1.2
 signing_key:
 specification_version: 4
 summary: Liquid filters