Thicken table with sort/unique/chunk/zip/flatten and add lib/cli flag parsing, with golds and public demos. Co-authored-by: Cursor <cursoragent@cursor.com>
248 lines
3.6 KiB
Markdown
248 lines
3.6 KiB
Markdown
---
|
|
title: lib/table
|
|
description: >-
|
|
List and map helpers. Prefer put (1-based path, same as footnotes); at/set_at/slice
|
|
are 0-based. json is for parse/stringify.
|
|
---
|
|
|
|
## put
|
|
+ `in`
|
|
+ `at`
|
|
+ `value`
|
|
|
|
Directly update one element. `at=` is a text key, a **1-based** list index, or a list path of keys/indices (same nesting as footnotes).
|
|
|
|
**> host_collection_put in=`in` at=`at` value=`value`**
|
|
|
|
## len
|
|
+ `xs`
|
|
|
|
**> len `xs`**
|
|
|
|
## rows
|
|
+ `xs`
|
|
|
|
**> len `xs`**
|
|
|
|
## at
|
|
+ `xs`
|
|
+ `i`
|
|
|
|
Index is zero-based (same as builtin `at`). Out of range → `None`.
|
|
|
|
**> at value=`xs` index=`i`**
|
|
|
|
## row_at
|
|
+ `xs`
|
|
+ `i`
|
|
|
|
**> at value=`xs` index=`i`**
|
|
|
|
## append
|
|
+ `list`
|
|
+ `item`
|
|
|
|
**> host_list_append list=`list` item=`item`**
|
|
|
|
## prepend
|
|
+ `list`
|
|
+ `item`
|
|
|
|
**> host_list_prepend list=`list` item=`item`**
|
|
|
|
## concat
|
|
+ `a`
|
|
+ `b`
|
|
|
|
**> host_list_concat a=`a` b=`b`**
|
|
|
|
## insert
|
|
+ `list`
|
|
+ `index`
|
|
+ `item`
|
|
|
|
Index is zero-based (may insert at `len` to append).
|
|
|
|
**> host_list_insert list=`list` index=`index` item=`item`**
|
|
|
|
## set_at
|
|
+ `list`
|
|
+ `index`
|
|
+ `item`
|
|
|
|
Zero-based replace. Prefer `put` with 1-based index for author-facing edits.
|
|
|
|
**> host_list_set_at list=`list` index=`index` item=`item`**
|
|
|
|
## remove_at
|
|
+ `list`
|
|
+ `index`
|
|
|
|
**> host_list_remove_at list=`list` index=`index`**
|
|
|
|
## pop
|
|
+ `list`
|
|
|
|
Drop the last item (errors if empty). Use `last` first when you need the removed value.
|
|
|
|
*`n` = > len `list`*
|
|
1. `n` > 0
|
|
**> host_list_remove_at list=`list` index=`n` - 1**
|
|
2. *
|
|
**> host_list_remove_at list=`list` index=0**
|
|
|
|
## first
|
|
+ `list`
|
|
|
|
**> host_list_first list=`list`**
|
|
|
|
## last
|
|
+ `list`
|
|
|
|
**> host_list_last list=`list`**
|
|
|
|
## slice
|
|
+ `list`
|
|
+ `start`
|
|
+ `end`=None
|
|
|
|
Zero-based half-open range from `start` to `end`.
|
|
|
|
**> host_list_slice list=`list` start=`start` end=`end`**
|
|
|
|
## contains
|
|
+ `list`
|
|
+ `item`
|
|
|
|
**> host_list_contains list=`list` item=`item`**
|
|
|
|
## index_of
|
|
+ `list`
|
|
+ `item`
|
|
|
|
Zero-based index or `None`.
|
|
|
|
**> host_list_index_of list=`list` item=`item`**
|
|
|
|
## reverse
|
|
+ `list`
|
|
|
|
**> host_list_reverse list=`list`**
|
|
|
|
## sort
|
|
+ `list`
|
|
|
|
Ascending sort (int/num/text preferred).
|
|
|
|
**> host_list_sort list=`list`**
|
|
|
|
## sort_by
|
|
+ `list`
|
|
+ `key`
|
|
|
|
Sort a list of maps by `key`.
|
|
|
|
**> host_list_sort_by list=`list` key=`key`**
|
|
|
|
## unique
|
|
+ `list`
|
|
|
|
Stable unique (first wins).
|
|
|
|
**> host_list_unique list=`list`**
|
|
|
|
## chunk
|
|
+ `list`
|
|
+ `size`
|
|
|
|
**> host_list_chunk list=`list` size=`size`**
|
|
|
|
## zip
|
|
+ `a`
|
|
+ `b`
|
|
|
|
Pairs until the shorter list ends.
|
|
|
|
**> host_list_zip a=`a` b=`b`**
|
|
|
|
## flatten
|
|
+ `list`
|
|
|
|
One-level flatten.
|
|
|
|
**> host_list_flatten list=`list`**
|
|
|
|
## clear
|
|
+ `value`
|
|
|
|
Empty list or empty map (by type).
|
|
|
|
**> host_collection_clear value=`value`**
|
|
|
|
## get
|
|
+ `map`
|
|
+ `key`
|
|
|
|
Missing key → `None`.
|
|
|
|
**> host_map_get map=`map` key=`key`**
|
|
|
|
## set
|
|
+ `map`
|
|
+ `key`
|
|
+ `value`
|
|
|
|
Shallow map update. Prefer `put` for nested paths.
|
|
|
|
**> host_map_set map=`map` key=`key` value=`value`**
|
|
|
|
## delete
|
|
+ `map`
|
|
+ `key`
|
|
|
|
**> host_map_delete map=`map` key=`key`**
|
|
|
|
## has
|
|
+ `map`
|
|
+ `key`
|
|
|
|
**> host_map_has map=`map` key=`key`**
|
|
|
|
## keys
|
|
+ `map`
|
|
|
|
**> host_map_keys map=`map`**
|
|
|
|
## values
|
|
+ `map`
|
|
|
|
**> host_map_values map=`map`**
|
|
|
|
## items
|
|
+ `map`
|
|
|
|
Rows shaped as key/value maps.
|
|
|
|
**> host_map_items map=`map`**
|
|
|
|
## merge
|
|
+ `a`
|
|
+ `b`
|
|
|
|
Right-hand keys win.
|
|
|
|
**> host_map_merge a=`a` b=`b`**
|
|
|
|
## size
|
|
+ `map`
|
|
|
|
**> host_map_size map=`map`**
|
|
|
|
## empty_list
|
|
|
|
**> host_list_concat a=None b=None**
|
|
|
|
## empty_map
|
|
|
|
**> host_map_merge a=None b=None**
|