普贤教程 › 包参考

faker 包

假数据生成（演示/测试夹具）

项	值
包名	`faker`
版本	`0.2.0`
可用版本	`0.1.0 / 0.2.0`
入口	`faker.px`
分类	`文本与中文处理`
文件数 / 行数	`1 / 270`

安装与引入

bash

pxpkg init          # 首次
pxpkg add faker@0.2.0
pxpkg install

import faker

所属分类教程：文本与中文处理

公开接口

函数	参数
`fa_rand`	`seed`
`fa_range`	`seed, lo, hi`
`fa_digits`	`seed, n`
`fa_surname`	`seed`
`fa_given`	`seed`
`fa_name`	`seed`
`fa_phone`	`seed`
`fa_email`	`seed`
`fa_sentence`	`seed, n`
`fa_uuid`
`fa_uuid_from`	`hex16`

其余 18 个 def（内部与辅助，可直接调用但不属稳定接口）

函数	参数
`fa_province`	`seed`
`fa_city`	`seed`
`fa_address`	`seed`
`fa_year`	`seed, lo = 2000, hi = 2026`
`fa_month`	`seed`
`fa_day`	`seed`
`fa_date`	`seed, lo = 2000, hi = 2026`
`fa_time`	`seed`
`fa_company`	`seed`
`fa_job`	`seed`
`fa_color_hex`	`seed`
`fa_color_rgb`	`seed`
`fa_ipv4`	`seed`
`fa_user_agent`	`seed`
`fa_credit_card`	`seed`
`fa_paragraph`	`seed, sentences = 3`
`fa_bool`	`seed`
`fa_password`	`seed, length = 12`

包内说明（源码头注释）

text

============================================================
普贤生态库：registry/faker —— 假数据生成（演示/测试夹具）
------------------------------------------------------------
纯函数库（无 IO、无状态；fa_uuid 除外，依赖 os_random_hex），
编译（px build）与解释（px run）双模式一致。
确定性 API：每个函数吃入种子 int，返回 [新种子, 值]；
fa_rand(seed) / fa_range(seed, lo, hi) / fa_digits(seed, n)
fa_name(seed)    → [新种子, "姓 名"]
fa_surname(seed) / fa_given(seed)
fa_phone(seed)   → [新种子, "1xx-xxxx-xxxx"]（第二位 3-9）
fa_email(seed)   → [新种子, "name@example.com"]
fa_sentence(seed, n) → [新种子, n 个词组成的句子]
随机 API（不可复现，仅格式确定）：
fa_uuid()        → v4 UUID 串（os_random_hex）
fa_uuid_from(hex16) → v4 UUID 串（给定 16 字节 hex，测试用）
说明：
- PRNG 用 splitmix64 风格（64 位乘加 + 2^64 回绕，两模式一致）
- 词表较小（写库规范 <500 行）；性别不区分；域名固定 example.com
============================================================
---- PRNG（splitmix64 风格；i64 乘法/加法按 2^64 回绕） ----