Agena

4.9.0 Trion, February 09, 2025 - It is now very easy to write-protect tables, sets, pairs, sequences, registers and userdata. `freeze` switches on write-protection and `unfreeze` removes the protection. Not only is the actual data in the structures protected, but also associated metatables and user-defined types. Thus you no longer have to define metamethods to do the job: > tbl := [1, 2, 3, a = 10, b = 20]; > freeze(tbl); > tbl[1] := null; Error in stdin at line 1: table is read-only. > setmetatable(tbl, []); Error in `setmetatable`: table is read-only. > unfreeze(tbl); > tbl[1] := null; > tbl: [2 ~ 2, 3 ~ 3, a ~ 10, b ~ 20] - You can also now write-protect numarrays and memfiles with `freeze`, and remove the protection with `unfreeze`. - New `tables.cleanse` is an alternative to `cleanse`, removes all values from a table but does not slim its size and also does not conduct a garbage collection. - `environ.attrib` returns the read-only setting for structures with the 'readonly' entry. - `environ.attrib` now also returns information on userdata: the (estimated) size in bytes, the user-defined type and the 'readonly' flag. - The new `fzy` package provides functions for fuzzy string matching. It is an adaption of the Lua package of the same name written by Seth Warn which itself binds to John Hawthorn's fzy C library. > fzy.score('app/models/user.rb', 'amuser'): 5.595 > fzy.score('app/models/customer.rb', 'xzyr'): 0 - New `math.noise` computes gradient Perlin noise which can be used, for example, in applying pseudo-random changes to a variable. - New `os.period` returns the computer's clock timing (period) in seconds. - New `os.timestamp` returns the current value of the computer's clock that increments monotonically in tick units. - New `os.ticker` returns the number of seconds elapsed since the start of an epoch, usually the time the computer has been switched on. Contrary to `os.uptime`, the function also returns fractional seconds. - Minor tweaks for `numarray.geti`, `numarray.seti` and `numarray.one`. - `cleanse` has been tuned a little bit with tables. - `environ.attrib` could crash with tables or return wrong information. This has both been fixed. - `environ.attrib` could theoretically crash with pairs. This has been fixed, as well. - In DOS, `io.pcall` did not work with the internally attached `2>nul` stderr redirection. The supplied fix should help. - This release has been named after the Town of Trion in Georgia and has been Valgrind-checked on x86 and AMD64 Linux to ensure there are no internal errors or memory leaks.