superfluid 0.2.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d0c3710ceb5f8e3d5869d8ddc3a3d9fde8291132cf94ebe7eb72cf71326d6a57
-  data.tar.gz: 90fa8ae9ece1ad2021cd0e8e58d3ab2f341d4c32f428bf21c02baa7c6dbea758
+  metadata.gz: 55e3fbd59c2ab1e4e156c0777f74eec2e15e6a12224c133fc606592218057a03
+  data.tar.gz: 16bd7bee4a6913a4f334cc0f3118cd3b0bb3c363e4b68d8275a6ce654d4c632a
 SHA512:
-  metadata.gz: b18219cf36cb6c2b55be26c2b5d587cec0c04ed44337a7615ba5c094f99a20e6453497211c7012755ad699494feb368f4d7e34a4e22ef7b367599dd57257795f
-  data.tar.gz: 7581feaf8567ec6fffee1aa3096a2d490fd864847445f0af9ab4cc82db1cb64622c192dd19395f07f0eaf57ce661046cf857693165bbb07b2dff774f668e12ef
+  metadata.gz: ad32e7c1058088116af46a180051dd751a378c9d9f82e99afa938a863c52be60650368fc5d3e31e8784390f481fb474629fc62cf2c2429ce1b423cd940ecc820
+  data.tar.gz: 4d2d1e4735b8c28fc32c9a6bcce2e6cdd7bb41801fd851ca316a1b2e2bd46203fc9b63fc64f8cb434a6cc126ff23da6242bc617bb48669c9c473ee3f73371495

data/README.adoc

@@ -6,7 +6,7 @@
 :containable_link: link:https://alchemists.io/projects/containable[Containable]
 :core_link: link:https://alchemists.io/projects/core[Core]
 :functionable_link: link:https://alchemists.io/projects/functionable[Functionable]
-:liquid_link: link:https://shopify.github.io/liquid/[Liquid]
+:liquid_link: link:https://shopify.github.io/liquid[Liquid]
 :struct_link: link:https://alchemists.io/articles/ruby_structs[Struct]
 
 = Superfluid
@@ -220,6 +220,32 @@ environment.filter_registry.names
 
 The above will produce a list of all registered filters. These including all filters provided by {liquid_link} and those unique to this gem which are:
 
+===== `append`
+
+Renders a suffix appended to a `String` or `Array`. This also overrides and enhances the default {liquid_link} filter of the same name. Example:
+
+*Array*
+
+[source,ruby]
+----
+renderer.call(%({{ data | append: "three" }}), {"data" => %w[one two]})
+# "onetwothree"
+
+renderer.call(%({{ data | append: suffix }}), {"data" => %w[one two], "suffix" => "three"})
+# "onetwothree"
+----
+
+*String*
+
+[source,ruby]
+----
+renderer.call %({{ "demo" | append: " suffix" }})
+# "demo suffix"
+
+renderer.call(%({{ "demo" | append: suffix }}), {"suffix" => " suffix"})
+# "demo suffix"
+----
+
 ===== `jsonify`
 
 Renders objects as JSON. Example:
@@ -263,6 +289,32 @@ renderer.call(%({{ text | pluralize: 3, "i", "us" }}), {"text" => "octopus"})
 # "3 octopi"
 ----
 
+===== `prepend`
+
+Renders a prefix prepended to a `String` or `Array`. This also overrides and enhances the default {liquid_link} filter of the same name. Example:
+
+*Array*
+
+[source,ruby]
+----
+renderer.call(%({{ data | prepend: "one" }}), {"data" => %w[two three]})
+# "onetwothree"
+
+renderer.call(%({{ data | prepend: prefix }}), {"data" => %w[two three], "prefix" => "one"})
+# "onetwothree"
+----
+
+*String*
+
+[source,ruby]
+----
+renderer.call %({{ "demo" | prepend: "prefix " }})
+# "prefix demo"
+
+renderer.call(%({{ "demo" | prepend: prefix }}), {"prefix" => "prefix "})
+# "demo prefix"
+----
+
 ===== `singularize`
 
 Renders a singular string. Example:

data/lib/superfluid/filters/common.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Superfluid
+  # Custom filters.
+  module Filters
+    require "functionable"
+
+    # Shared primitive behavior.
+    module Common
+      extend Functionable
+
+      def append target, suffix
+        case target
+          when Array then target.dup.append suffix
+          when String then "#{target}#{suffix}"
+          else fail Liquid::ArgumentError, "Unsupported type: #{target.class}."
+        end
+      end
+
+      def prepend target, prefix
+        case target
+          when Array then target.dup.prepend prefix
+          when String then "#{prefix}#{target}"
+          else fail Liquid::ArgumentError, "Unsupported type: #{target.class}."
+        end
+      end
+    end
+  end
+end

data/lib/superfluid/filters/container.rb

@@ -9,7 +9,7 @@ module Superfluid
   module Filters
     # A container of filter dependencies.
     module Container
-      extend Containable
+      extend Containable[register: Register]
 
       using Refinements::String
 

data/lib/superfluid/register.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "containable"
+
+module Superfluid
+  # A custom register which allows key overrides.
+  class Register < Containable::Register
+    def call key, value = nil, as: :cache, &block
+      dependencies[namespacify(key)] = [block || value, as]
+    end
+  end
+end

data/lib/superfluid/registries/filter.rb

@@ -10,12 +10,12 @@ module Superfluid
       attr_reader :mode
 
       def initialize container = Filters::Container,
-                     defaults: Liquid::StandardFilters,
+                     defaults: [Liquid::StandardFilters, Filters::Common],
                      mode: :strict
         @container = container
         @mode = mode
 
-        add defaults
+        add(*defaults)
       end
 
       def add(*, **)
@@ -80,8 +80,6 @@ module Superfluid
       def add_commands(**collection) = collection.each { |name, command| add_command name, command }
 
       def add_command name, callable
-        return if container.key? name
-
         case callable
           in Proc | Method | Core::Composable then container.register(name) { callable }
           else fail Liquid::ArgumentError, "Filter must be callable."

data/lib/superfluid/tags/container.rb

@@ -6,7 +6,7 @@ module Superfluid
   module Tags
     # A container of tag dependencies.
     module Container
-      extend Containable
+      extend Containable[register: Register]
 
       register :template, Template
     end

data/superfluid.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |spec|
   spec.name = "superfluid"
-  spec.version = "0.2.1"
+  spec.version = "0.3.0"
   spec.authors = ["Brooke Kuhlmann"]
   spec.email = ["brooke@alchemists.io"]
   spec.homepage = "https://alchemists.io/projects/superfluid"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: superfluid
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.3.0
 platform: ruby
 authors:
 - Brooke Kuhlmann
@@ -146,7 +146,9 @@ files:
 - lib/superfluid.rb
 - lib/superfluid/configuration.rb
 - lib/superfluid/environment.rb
+- lib/superfluid/filters/common.rb
 - lib/superfluid/filters/container.rb
+- lib/superfluid/register.rb
 - lib/superfluid/registries/filter.rb
 - lib/superfluid/registries/tag.rb
 - lib/superfluid/renderer.rb
@@ -179,7 +181,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.23
+rubygems_version: 4.0.24
 specification_version: 4
 summary: Enhances Liquid with object composition and functional design.
 test_files: []