README
E
FakeError
- ::newColumn::new
- ::booleanGenerator::boolean
- ::bothifyGenerator::bothify
- ::chooseGenerator::choose
- ::companyGenerator::company
- ::dateGenerator::date
- ::date_betweenGenerator::date_between
- ::decimalGenerator::decimal
- ::ean13Generator::ean13
- ::emailGenerator::email
- ::hex_colorGenerator::hex_color
- ::integerGenerator::integer
- ::ipv4Generator::ipv4
- ::ipv6Generator::ipv6
- ::isbn13Generator::isbn13
- ::jobGenerator::job
- ::localizedGenerator::localized
- ::mac_addressGenerator::mac_address
- ::nameGenerator::name
- ::newGenerator::new
- ::profileGenerator::profile
- ::restoreGenerator::restore
- ::sampleGenerator::sample
- ::sentenceGenerator::sentence
- ::snapshotGenerator::snapshot
- ::urlGenerator::url
- ::usernameGenerator::username
- ::uuid4Generator::uuid4
- ::valueGenerator::value
- ::weighted_indexGenerator::weighted_index
- ::wordGenerator::word
T
Profile
T
Provider
- ::bind_tableSession::bind_table
- ::checkpointSession::checkpoint
- ::newSession::new
- ::nextSession::next
- ::positionSession::position
- ::restoreSession::restore
T
Spec
V
csv
V
dataset
V
ean13_from_body
V
generate_request
V
locale_methods
V
locale_values
V
locales
V
open_session
V
parse_spec
V
records
V
render_records
V
session_request

faker

六地区与结构化测试数据生成

Download zip

Author

peng-jun21

Version

0.4.0

License

MIT

Repository

github.com/peng-jun21/moonbit-faker

Last updated

7 days ago

Downloads

#可执行 API 示例

增加可复现的中文假数据 CSV 导出，符合字段引号和 CRLF 转义规则。这些例子调用公开 API，并随 moon test 执行。

///|
test "CSV is deterministic has header and CRLF" {
  let text = @faker.csv(42U, 3)
  assert_eq(text, @faker.csv(42U, 3))
  assert_eq(text.split("\r\n").count(), 5)
  assert_true(text.has_prefix("name,email,address,birth_date,id\r\n\""))
  assert_true(text.contains("@example.test"))
}

0.3 新增可配置记录、25 类 provider 和 JSON/JSONL/CSV；词库与地区覆盖仍小，完整边界见 FEATURES.md。

FakeError

source

pub suberror FakeError {
  Invalid(String)
} derive(@moonbitlang/core/debug.Debug
Debug)

Column

source

pub(all) struct Column {
  name : String
  provider : Provider
  unique : Bool
  null_percent : Int
} derive(Eq, @moonbitlang/core/debug.Debug
Debug)

Column::new

source

fn Column::new(name : String, provider : Provider, unique? : Bool, null_percent? : Int) -> Column

Generator

source

pub struct Generator {
  state : UInt
} derive(@moonbitlang/core/debug.Debug
Debug)

Generator::boolean

source

fn Generator::boolean(self : Generator, percent? : Int) -> Bool raise FakeError

Generator::bothify

source

fn Generator::bothify(self : Generator, template : String) -> String raise FakeError

Generator::choose

source

fn[T] Generator::choose(self : Generator, items : Array[T]) -> T raise FakeError

Generator::company

source

fn Generator::company(self : Generator) -> String

Generator::date

source

fn Generator::date(self : Generator, first_year : Int, last_year : Int) -> String raise FakeError

Generator::date_between

source

fn Generator::date_between(self : Generator, first : String, last : String) -> String raise FakeError

Samples Gregorian calendar days in the inclusive range.

Generator::decimal

source

fn Generator::decimal(self : Generator, min_scaled : Int, max_scaled : Int, places : Int) -> String raise FakeError

Generator::ean13

source

fn Generator::ean13(self : Generator) -> String raise FakeError

Generator::email

source

fn Generator::email(self : Generator) -> String raise FakeError

Generator::hex_color

source

fn Generator::hex_color(self : Generator) -> String raise FakeError

Generator::integer

source

fn Generator::integer(self : Generator, min : Int, max : Int) -> Int raise FakeError

Generator::ipv4

source

fn Generator::ipv4(self : Generator) -> String raise FakeError

Generator::ipv6

source

fn Generator::ipv6(self : Generator) -> String raise FakeError

Generator::isbn13

source

fn Generator::isbn13(self : Generator) -> String raise FakeError

Checksum-correct 978-prefixed sample, without validating registry allocation.

Generator::job

source

fn Generator::job(self : Generator) -> String

Generator::localized

source

fn Generator::localized(self : Generator, locale : String, provider_name : String) -> String raise FakeError

Locale-aware attributed provider data; the PRNG is local, not Python MT19937.

Generator::mac_address

source

fn Generator::mac_address(self : Generator) -> String raise FakeError

Generator::name

source

fn Generator::name(self : Generator) -> String

Generator::new

source

fn Generator::new(seed : UInt) -> Generator

Generator::profile

source

fn Generator::profile(self : Generator, index : Int) -> Profile raise FakeError

Generator::restore

source

fn Generator::restore(self : Generator, state : UInt) -> Unit raise FakeError

Generator::sample

source

fn[T] Generator::sample(self : Generator, items : Array[T], count : Int) -> Array[T] raise FakeError

Sample distinct input positions without changing the source array.

Generator::sentence

source

fn Generator::sentence(self : Generator, words? : Int) -> String raise FakeError

Generator::snapshot

source

fn Generator::snapshot(self : Generator) -> UInt

PRNG-only checkpoint, not a cryptographic seed or a uniqueness-state snapshot.

Generator::url

source

fn Generator::url(self : Generator) -> String raise FakeError

Generator::username

source

fn Generator::username(self : Generator) -> String raise FakeError

Generator::uuid4

source

fn Generator::uuid4(self : Generator) -> String raise FakeError

RFC 9562 version/variant layout with deterministic, non-secret test bits.

Generator::value

source

fn Generator::value(self : Generator, provider : Provider, index? : Int) -> Json raise FakeError

Generate one provider value. Sequence index is explicit and does not consume RNG.

Generator::weighted_index

source

fn Generator::weighted_index(self : Generator, weights : Array[Int]) -> Int raise FakeError

Generator::word

source

fn Generator::word(self : Generator) -> String

Profile

source

pub(all) struct Profile {
  name : String
  email : String
  address : String
  birth_date : String
  id : String
} derive(Eq, @moonbitlang/core/debug.Debug
Debug)

Provider

source

pub(all) enum Provider {
  Name
  Address
  Email
  Username
  Url
  Uuid4
  Ipv4
  Ipv6
  MacAddress
  HexColor
  Company
  Job
  Word
  Sentence(Int)
  Boolean(Int)
  Integer(Int, Int)
  Decimal(Int, Int, Int)
  DateBetween(String, String)
  Ean13
  Isbn13
  Template(String)
  Choice(Array[String])
  WeightedChoice(Array[String], Array[Int])
  Constant(Json)
  Sequence(Int, Int)
  Localized(String, String)
} derive(Eq, ToJson, @moonbitlang/core/debug.Debug
Debug)

Session

source

pub struct Session {
  generator : Generator
  spec : Spec
  unique_paths : Map[String, Bool]
  seen : Map[String, Map[String, Bool]]
  tables : Map[String, Array[Json]]
  index : Int
  unique_count : Int
  unique_text : Int
}

Session::bind_table

source

fn Session::bind_table(self : Session, name : String, rows : Array[Json]) -> Unit raise FakeError

Session::checkpoint

source

fn Session::checkpoint(self : Session) -> Json

Includes row index, RNG, unique sets, table data and the schema contract.

Session::new

source

fn Session::new(seed : UInt, spec : Spec) -> Session raise FakeError

Session::next

source

fn Session::next(self : Session) -> Json raise FakeError

Each row commits atomically. On failure, RNG, position and uniqueness remain unchanged.

Session::position

source

fn Session::position(self : Session) -> Int

Session::restore

source

fn Session::restore(self : Session, checkpoint : Json) -> Unit raise FakeError

Restore is atomic and requires the same schema. Checkpoints are not credentials.

Spec

source

pub(all) enum Spec {
  Value(Provider)
  Object(Array[(String, Spec)])
  List(Spec, Int, Int)
  Nullable(Spec, Int)
  Unique(Spec)
  Reference(String)
  Foreign(String, String)
  Join(Array[Spec], String)
} derive(Eq, ToJson, @moonbitlang/core/debug.Debug
Debug)

csv

source

fn csv(seed : UInt, count : Int) -> String raise FakeError

RFC 4180 quoted CSV using the original synthetic dataset provider.

dataset

source

fn dataset(seed : UInt, count : Int) -> Array[Profile] raise FakeError

ean13_from_body

source

fn ean13_from_body(body : String) -> String raise FakeError

Append the GS1 alternating 1/3 modulo-10 check digit to twelve digits.

generate_request

source

fn generate_request(request : String) -> String raise FakeError

JSON request with seed/count/columns/format; output is json, jsonl, or CSV.

locale_methods

source

fn locale_methods(locale : String) -> Array[String] raise FakeError

locale_values

source

fn locale_values(locale : String, provider_name : String) -> Array[String] raise FakeError

A copy of the attributed source values/templates, useful for data inspection.

locales

source

fn locales() -> Array[String]

open_session

source

fn open_session(request : String) -> Session raise FakeError

Parse a schema/columns session definition, optionally with bound tables and checkpoint.

parse_spec

source

fn parse_spec(value : Json) -> Spec raise FakeError

records

source

fn records(seed : UInt, columns : Array[Column], count : Int) -> Array[Json] raise FakeError

Flat scalar records. Per-column uniqueness includes null and has bounded retries.

render_records

source

fn render_records(columns : Array[Column], rows : Array[Json], format : String) -> String raise FakeError

session_request

source

fn session_request(input : String) -> String

Thin stateful JSON bridge for JS hosts. Explicit close releases the session.

Source Files

Site source Report issue Packages Build queue Skills Statistics

faker

#可执行 API 示例

#FakeError

#Column

#Column::new

#Generator

#Generator::boolean

#Generator::bothify

#Generator::choose

#Generator::company

#Generator::date

#Generator::date_between

#Generator::decimal

#Generator::ean13

#Generator::email

#Generator::hex_color

#Generator::integer

#Generator::ipv4

#Generator::ipv6

#Generator::isbn13

#Generator::job

#Generator::localized

#Generator::mac_address

#Generator::name

#Generator::new

#Generator::profile

#Generator::restore

#Generator::sample

#Generator::sentence

#Generator::snapshot

#Generator::url

#Generator::username

#Generator::uuid4

#Generator::value

#Generator::weighted_index

#Generator::word

#Profile

#Provider

#Session

#Session::bind_table

#Session::checkpoint

#Session::new

#Session::next

#Session::position

#Session::restore

#Spec

#csv

#dataset

#ean13_from_body

#generate_request

#locale_methods

#locale_values

#locales

#open_session

#parse_spec

#records

#render_records

#session_request

Source Files

FakeError

Column

Column::new

Generator

Generator::boolean

Generator::bothify

Generator::choose

Generator::company

Generator::date

Generator::date_between

Generator::decimal

Generator::ean13

Generator::email

Generator::hex_color

Generator::integer

Generator::ipv4

Generator::ipv6

Generator::isbn13

Generator::job

Generator::localized

Generator::mac_address

Generator::name

Generator::new

Generator::profile

Generator::restore

Generator::sample

Generator::sentence

Generator::snapshot

Generator::url

Generator::username

Generator::uuid4

Generator::value

Generator::weighted_index

Generator::word

Profile

Provider

Session

Session::bind_table

Session::checkpoint

Session::new

Session::next

Session::position

Session::restore

Spec

csv

dataset

ean13_from_body

generate_request

locale_methods

locale_values

locales

open_session

parse_spec

records

render_records

session_request