luoma 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: acb537ba303e1ce24a308b621d0ea4f878531d04d321d0ead9e2a261c2b76832
-  data.tar.gz: cc19b11460124b48b80766259d508408570323e596b6dbea5ee120edb874d298
+  metadata.gz: f24da19a06edd7781345b3b0e4d9aa73c616404472c24e50e068d9acb0a8e463
+  data.tar.gz: 97b49239b9ac0de992568860034dd7f8a5735739b3ee42f345508377a3c38eea
 SHA512:
-  metadata.gz: 05e51ff2461365ee5b41c0bd50545dc5c7444e44ee18da6fe4b15aa058cf9cc4d6d1e43420a41c61d9e37fa9fcdce096842212dd54f52f4ecd0cd34434799b04
-  data.tar.gz: 76bc4f2e919b162257b4eaf55331e7b436614442433d40056bb759ead9392a7099e195185cb8bed78219dbcd14380c93e2a89117c3d2ddfbe63e3396cdaab2e3
+  metadata.gz: '09c958eadecea8638b9fe6ce31907e83640f44342b78978696564bf3128e625f7604d09db53d2f62a1831ca238811eee9baf98e505d5be968cd7a3467479f5bf'
+  data.tar.gz: 19ce9bc9c86d34a65a1044803ec1627a916d92ad37bb9246166a2b4841f28dcfb53ebaf11e60eee9eff812dfda3854894a941e57ac0341c377f8bb3cf605c8ba

data/CHANGELOG.md

@@ -1,5 +1,7 @@
-## [Unreleased]
+## [0.2.0] - 2026-07-29
 
-## [0.1.0] - 2026-06-05
+- Added the `take` filter. `a | take: 5` is equivalent to `a | slice: stop=6`.
+
+## [0.1.0] - 2026-07-29
 
 - Initial release

data/README.md

@@ -1,6 +1,6 @@
 <h1 align="center">Luoma - Ruby</h1>
 
-<p align="center">A modern template engine for Ruby.</p>
+<p align="center">A modern template engine with a well-defined, composable, implementation agnostic expression language.</p>
 
 <p align="center">
   <a href="https://github.com/jg-rp/luoma-ruby/blob/main/LICENSE.txt">
@@ -14,7 +14,7 @@
     <img alt="Gem Version" src="https://img.shields.io/gem/v/luoma?style=flat-square">
   </a>
   <a href="https://github.com/jg-rp/luoma-ruby">
-    <img alt="Static Badge" src="https://img.shields.io/badge/Ruby-3.1%20%7C%203.2%20%7C%203.3%20%7C%203.4-CC342D?style=flat-square">
+    <img alt="Static Badge" src="https://img.shields.io/badge/Ruby-3.3%20%7C%203.4%20%7C%204.0-CC342D?style=flat-square">
   </a>
 </p>
 
@@ -57,7 +57,7 @@ puts template.render("you" => "Luoma")  # Hello, Luoma!
 
 ## Links
 
-- Documentation: https://jg-rp.github.io/luoma/
+- Documentation: https://jg-rp.github.io/luoma-ruby/
 - Change log: https://github.com/jg-rp/luoma-ruby/blob/main/CHANGELOG.md
 - RubyGems: https://rubygems.org/gems/luoma
 - Source code: https://github.com/jg-rp/luoma-ruby

data/docs/filter_reference.md

@@ -37,6 +37,156 @@ Given a value that can't be cast to an integer or float, the special value `Noth
 0
 ```
 
+## all
+
+```
+<array> | all
+<array> | all: <string> [, <value>]
+<array> | all: <lambda>
+```
+
+Return `true` if all items in the input array are truthy, or `false` otherwise.
+
+```liquid2
+{{ [true, true, true] | all }}
+{{ [true, false, true] | all }}
+```
+
+```title="Output"
+true
+false
+```
+
+If a string argument is given, array items should be objects and the string is used as a property name to test for truthiness.
+
+```liquid2
+{% assign
+  items = [
+    {"title": "foo", "active": true},
+    {"title": "bar", "active": false},
+    {"title": "baz", "active": true},
+  ]
+%}
+
+{{ items | all: "active" }}
+```
+
+```title="Output"
+false
+```
+
+If the optional second argument is given, the value at the given property will be compared to the argument value instead of testing for truthiness.
+
+```liquid2
+{% assign
+  items = [
+    {"title": "foo", "state": 2},
+    {"title": "bar", "state": 2},
+    {"title": "baz", "state": 2},
+  ]
+%}
+
+{{ items | all: "state", 2 }}
+```
+
+```title="Output"
+true
+```
+
+Given a lambda expression as the first argument, the expression will be evaluated for each item in the input array and the result tested for truthiness.
+
+```liquid2
+{% assign
+  items = [
+    {"title": "foo", "state": 2},
+    {"title": "bar", "state": 3},
+    {"title": "baz", "state": 1},
+  ]
+%}
+
+{{ items | all: (x) -> x.state < 5 }}
+```
+
+```title="Output"
+true
+```
+
+## any
+
+```
+<array> | any
+<array> | any: <string> [, <value>]
+<array> | any: <lambda>
+```
+
+Return `true` if any of the items in the input array are truthy, or `false` if they are all falsy.
+
+```liquid2
+{{ [true, true, true] | any }}
+{{ [true, false, true] | any }}
+{{ [false, false, false] | any }}
+```
+
+```title="Output"
+true
+true
+false
+```
+
+If a string argument is given, array items should be objects and the string is used as a property name to test for truthiness.
+
+```liquid2
+{% assign
+  items = [
+    {"title": "foo", "active": true},
+    {"title": "bar", "active": false},
+    {"title": "baz", "active": true},
+  ]
+%}
+
+{{ items | any: "active" }}
+```
+
+```title="Output"
+true
+```
+
+If the optional second argument is given, the value at the given property will be compared to the argument value instead of testing for truthiness.
+
+```liquid2
+{% assign
+  items = [
+    {"title": "foo", "state": 2},
+    {"title": "bar", "state": 2},
+    {"title": "baz", "state": 2},
+  ]
+%}
+
+{{ items | any: "state", 2 }}
+```
+
+```title="Output"
+true
+```
+
+Given a lambda expression as the first argument, the expression will be evaluated for each item in the input array and the result tested for truthiness.
+
+```liquid2
+{% assign
+  items = [
+    {"title": "foo", "state": 2},
+    {"title": "bar", "state": 3},
+    {"title": "baz", "state": 1},
+  ]
+%}
+
+{{ items | any: (x) -> x.state < 2 }}
+```
+
+```title="Output"
+true
+```
+
 ## append
 
 ```
@@ -677,6 +827,14 @@ Ground
 
 If the input sequence is undefined, empty or not a sequence, `nil` is returned.
 
+## flatten
+
+TODO
+
+## flat_map
+
+TODO
+
 ## floor
 
 ```
@@ -779,6 +937,10 @@ If an argument string is not given, it defaults to a single space.
 John Paul George Ringo
 ```
 
+## json
+
+TODO
+
 ## last
 
 ```
@@ -852,6 +1014,14 @@ For example, if `pages` is an array of objects with a `category` property:
 - technology
 ```
 
+## max
+
+TODO:
+
+## min
+
+TODO:
+
 ## minus
 
 ```
@@ -1366,6 +1536,10 @@ The optional argument is a sort key. If given, it should be the name of a proper
 <h4>A Shoe</h4>
 ```
 
+## sort_numeric
+
+TODO
+
 ## split
 
 ```
@@ -1487,6 +1661,10 @@ Return the sum of all numeric elements in an array.
 
 If the optional string argument is given, it is assumed that array items are hash/dict/mapping-like, and the argument should be the name of a property/key. The values at `array[property]` will be summed.
 
+## take
+
+TODO
+
 ## times
 
 ```
@@ -1700,3 +1878,7 @@ Available product:
 - Television
 - Garlic press
 ```
+
+## zip
+
+TODO:

data/docs/index.md

@@ -1,5 +1,9 @@
 # Luoma - Ruby
 
+!!! warning
+
+    This documentation is a work in progress.
+
 Luoma is a modern template engine with a well-defined, composable, implementation agnostic expression language.
 
 Luoma markup will be familiar to anyone who's used [Liquid](https://github.com/Shopify/liquid), [Jinja](https://jinja.palletsprojects.com/en/stable/) or [Django's template language](https://docs.djangoproject.com/en/6.0/topics/templates/#the-django-template-language), but with a strictly immutable data model, first-class blocks and expressions, and functional primitives for when data transformation is necessary.

data/lib/luoma/environment.rb

@@ -205,6 +205,7 @@ module Luoma
       register_filter("strip_newlines", Luoma::Filters.method(:strip_newlines))
       register_filter("strip", Luoma::Filters.method(:strip))
       register_filter("sum", Luoma::Filters.method(:sum))
+      register_filter("take", Luoma::Filters.method(:take))
       register_filter("times", Luoma::Filters.method(:times))
       register_filter("truncate", Luoma::Filters.method(:truncate))
       register_filter("truncatewords", Luoma::Filters.method(:truncatewords))

data/lib/luoma/filters/array.rb

@@ -368,5 +368,14 @@ module Luoma
         max_.call(left) { |item, _index| context.fetch(item, key, default: nil) }
       end
     end
+
+    # Return at most _count_ items from `_left` as a new array.
+    # Coerce _left_ to an array if it's not an array already.
+    # Coerce _count_ to an integer, or zero if it is not numeric.
+    def self.take(context, left, count)
+      count_ = context.to_i(count, default: 0)
+      count_ = 0 if count_.negative?
+      context.to_enumerable(left).take(count_)
+    end
   end
 end

data/lib/luoma/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Luoma
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

data/sig/luoma/filters/array.rbs

@@ -70,5 +70,9 @@ module Luoma
     # Return the maximum numeric value found in _left_.
     # Coerce _left_ to an array if it's not an array already.
     def self.max: (FilterContext context, untyped left, ?untyped key) -> untyped
+                
+    # Return at most _count_ items from `_left` as a new array.
+    # Coerce _left_ to an array if it's not an array already.
+    def self.take: (FilterContext context, untyped left, untyped count) -> Array[untyped]
   end
 end

data/zensical.toml

@@ -202,7 +202,7 @@ features = [
     # In order to provide a better user experience on slow connections when
     # using instant navigation, a progress indicator can be enabled.
     # https://zensical.org/docs/setup/navigation/#progress-indicator
-    #"navigation.instant.progress",
+    "navigation.instant.progress",
 
     # When navigation paths are activated, a breadcrumb navigation is rendered
     # above the title of each page

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: luoma
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - James Prior
@@ -204,11 +204,11 @@ files:
 - sig/luoma/template.rbs
 - sig/luoma/token.rbs
 - zensical.toml
-homepage: https://jg-rp.github.io/luoma/
+homepage: https://jg-rp.github.io/luoma-ruby/
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://jg-rp.github.io/luoma/
+  homepage_uri: https://jg-rp.github.io/luoma-ruby/
   source_code_uri: https://github.com/jg-rp/luoma-ruby
   changelog_uri: https://github.com/jg-rp/luoma-ruby/blob/main/CHANGELOG.md
   rubygems_mfa_required: 'true'