Ji.lua is a collection of Lua implementations of functional primitives that work on iterators, based on features from the Julia Base.Iterators library, and a few other data structures that make Lua a little less minimalistic.
Most of the functionality of Julia's Base.Iterators, adapted to Lua's iterator protocol.
Class- OOP boilerplate, used by all the other types
Deque- tables as stacks, queues or double-ended queues
Lens- bijective tables, where mapping a key to a value also maps the value to the key.
Object- tables that can be frozen or sealed like JavaScript objects
Set- tables with set-like operations
Examples of how to use each of the types can be found in their test files.
More string manipulation functions added to the string prototype.
chomp- Removes a trailing new line, if any.
endswith,startswith- Check for patterns at the start or end of a string.
gsplit,split- Split a string with a pattern, returning an iterator or a list of strings.
isascii- Checks if all characters of a string are in the lower ASCII range.
lpad,rpad- Pad the start or end of a string to a specified length.
lstrip,rstrip,strip- Strip characters from a string at the start, the end or both.
find- Finds the index of a value in a list.
findall- Iterate over all matching values in a list.
findsorted- Binary search for sorted lists.
issorted- Check if a list is sorted.
ji is scoped how you prefer it. Import the whole module as a table, or export to attach the module to a table, _G by default.
local ji = require("ji")
ji.sum(ipairs({ 1, 2, 3 })) --#= 6
-- or alternatively
require("ji"):export()
sum(ipairs({ 1, 2, 3 })) --#= 6Exporting to a specific table is useful for attaching functionality to another metatable.
local String = require("ji/string")
String.split("hello world", " ") --#= {"hello", "world"}
-- or alternatively
require("ji/string"):export(string)
("hello world"):split(" ") --#= {"hello", "world"}