#chensuiyi/fndash

#Install

moon add chensuiyi/fndash

#Features

• Strings: trim_spaces (CRLF-tolerant), pad_start / pad_end (multi-char pad), to_lower / to_upper (Latin), remove_prefix / remove_suffix (None when absent), is_blank
• Parsing: parse_int is strict digits-only — non-numeric is None, never a partial value; quoted_value pulls the first double-quoted segment
• JSON: json_escape / jstr / jobj / jarr — optional fields absent from the input never become nulls on the wire
• Encoding: url_encode (RFC 3986 unreserved over UTF-8), hex_encode / hex_decode (uppercase, None on bad input)
• Arrays: chunk[T], uniq[T : Eq] (order-preserving), range(start, end, step?), clamp_int

#Scenarios

• Line-based config / manifest parsing (key = "value" shapes)
• Streaming JSON assembly for API payloads
• Query-string and form-body encoding, hex serialization of bytes
• Padding numbers and slicing data into batches

#API

// JSON assembly: omitted optional fields never become nulls
@fndash.jobj([
  ("msg", @fndash.jstr("hello")),
  ("count", "3"),
])

// Manifest line parsing
@fndash.quoted_value("name = \"chensuiyi/bm2\"")   // "chensuiyi/bm2"
@fndash.parse_int("42")                            // Some(42)
@fndash.parse_int("4x")                            // None

// String helpers
@fndash.pad_start("42", 5)                         // "00042"
@fndash.remove_prefix("v1.2.3", "v")               // Some("1.2.3")
@fndash.split("a,b,c", ",")                        // ["a", "b", "c"]

// Encoding
@fndash.url_encode("a b&c=1")                      // "a%20b%26c%3D1"
@fndash.hex_decode("4142")                         // Some(b"AB")

// Arrays
@fndash.chunk([1, 2, 3, 4, 5], 2)                  // [[1, 2], [3, 4], [5]]
@fndash.uniq(["a", "b", "a"])                      // ["a", "b"]
@fndash.range(0, 5, step=2)                        // [0, 2, 4]
@fndash.clamp_int(99, 1, 10)                       // 10

#Author

#License

#chensuiyi/fndash

#安装

moon add chensuiyi/fndash

#功能

• 字符串:trim_spaces(容忍 CRLF)、pad_start / pad_end(多字符 pad)、to_lower / to_upper(Latin)、remove_prefix / remove_suffix(不存在返回 None)、is_blank
• 解析:parse_int 严格纯数字——非数字一律 None,绝不返回残缺值;quoted_value 取首个双引号段
• JSON:json_escape / jstr / jobj / jarr——输入里省略的可选字段,绝不会以 null 出现在线上
• 编码:url_encode(RFC 3986 unreserved,按 UTF-8)、hex_encode / hex_decode(大写,非法输入 None)
• 数组:chunk[T]、uniq[T : Eq](保序)、range(start, end, step?)、clamp_int

#场景

• 行级配置 / 清单解析(key = "value" 形态)
• API 载荷的流式 JSON 拼装
• 查询串与表单体编码、字节的 hex 序列化
• 数字补零、数据分批

#API

#用法示例

// JSON 拼装:省略的可选字段不会以 null 出现在线上
@fndash.jobj([
  ("msg", @fndash.jstr("hello")),
  ("count", "3"),
])

// 清单行解析
@fndash.quoted_value("name = \"chensuiyi/bm2\"")   // "chensuiyi/bm2"
@fndash.parse_int("42")                            // Some(42)
@fndash.parse_int("4x")                            // None

// 字符串工具
@fndash.pad_start("42", 5)                         // "00042"
@fndash.remove_prefix("v1.2.3", "v")               // Some("1.2.3")
@fndash.split("a,b,c", ",")                        // ["a", "b", "c"]

// 编码
@fndash.url_encode("a b&c=1")                      // "a%20b%26c%3D1"
@fndash.hex_decode("4142")                         // Some(b"AB")

// 数组
@fndash.chunk([1, 2, 3, 4, 5], 2)                  // [[1, 2], [3, 4], [5]]
@fndash.uniq(["a", "b", "a"])                      // ["a", "b"]
@fndash.range(0, 5, step=2)                        // [0, 2, 4]
@fndash.clamp_int(99, 1, 10)                       // 10

#作者

#协议