#moonbit-community/dummy

#Design Notes

• Generators use snake_case functions such as @dummy.name(locale=@dummy.en) with labeled options.
• Every generator returns @core.Gen[T] instead of producing a value immediately. This keeps the random source explicit and makes tests reproducible.
• Locale-backed tables and templates are centralized in the data package. Category packages such as name, address, and internet contain only generation logic.
• The root package is the stable facade. Subpackages remain public for users who want category-level imports, but most application code should depend on @dummy.
• The API returns plain MoonBit values. Identifier, encoding, semver, HTTP status, and date/time generators expose strings or integers that are easy to pass through application code and tests.

#Seeded Generation

///|
test "seeded generation is reproducible" {
  let rng1 = @dummy.seed(b"readme-seed")
  let rng2 = @dummy.seed(b"readme-seed")
  let a = @dummy.name(locale=@dummy.zh_cn).dummy(rng1)
  let b = @dummy.name(locale=@dummy.zh_cn).dummy(rng2)
  @test.assert_eq(a, b)
}

#Basic Usage

///|
test "basic facade usage" {
  let rng = @dummy.default_seeded()
  let name : String = @dummy.name().dummy(rng)
  let email : String = @dummy.safe_email().dummy(rng)
  let words : Array[String] = @dummy.words(count=@dummy.count_range(3, 5)).dummy(
    rng,
  )
  let ids : Array[Int32] = @dummy.int(range=@dummy.int_range(1000, 9999)).sample(
    count=4,
    rng,
  )
  assert_true(!name.is_empty())
  assert_true(email.contains("@"))
  assert_true(words.length() >= 3 && words.length() <= 5)
  @test.assert_eq(ids.length(), 4)
}

#Locale and Fallback

///|
test "locale-specific generators" {
  let rng = @dummy.default_seeded()
  let zh_name = @dummy.name(locale=@dummy.zh_tw).dummy(rng)
  let fr_company = @dummy.company_name(locale=@dummy.fr_fr).dummy(rng)
  let ja_sentence = @dummy.sentence(
    locale=@dummy.ja_jp,
    count=@dummy.count_range(4, 8),
  ).dummy(rng)
  assert_true(!zh_name.is_empty())
  assert_true(!fr_company.is_empty())
  assert_true(!ja_sentence.is_empty())
}

#Generator Categories

#API Reference

#Names

#Lorem

#Address

#Internet and Contact

#Business, Money, and IDs

#Formats and Utilities

#Date, Time, Markdown, and Images

#Deterministic Samples

///|
test "sample is deterministic for a fixed seed" {
  let left = @dummy.free_email(locale=@dummy.en).sample(
    count=3,
    @dummy.seed(b"email-sample"),
  )
  let right = @dummy.free_email(locale=@dummy.en).sample(
    count=3,
    @dummy.seed(b"email-sample"),
  )
  @test.assert_eq(left, right)
  @test.assert_eq(left.length(), 3)
  for email in left {
    assert_true(email.contains("@"))
  }
}

///|
test "one rng can drive a reproducible record" {
  let rng = @dummy.seed(b"profile-record")
  let username = @dummy.username().dummy(rng)
  let password = @dummy.password(len_range=@dummy.count_range(12, 16)).dummy(
    rng,
  )
  let city = @dummy.city_name(locale=@dummy.de_de).dummy(rng)
  assert_true(!username.is_empty())
  assert_true(password.length() >= 12 && password.length() <= 16)
  assert_true(!city.is_empty())
}

#Composition

///|
test "compose generators" {
  let rng = @dummy.seed(b"composition")
  let label = @dummy.company_name()
    .map(company => "customer: " + company)
    .dummy(rng)
  let contact = @dummy.one_of([@dummy.phone_number(), @dummy.cell_number()]).dummy(
    rng,
  )
  let weighted_bool = @dummy.weighted([
    (90, @dummy.boolean(ratio=100)),
    (10, @dummy.boolean(ratio=0)),
  ]).dummy(rng)
  assert_true(label.has_prefix("customer: "))
  assert_true(!contact.is_empty())
  assert_true(weighted_bool || !weighted_bool)
}

#Picsum Image URLs

///|
test "picsum custom image url" {
  let url = @dummy.picsum_image_custom(
    @dummy.image_options(
      width=800,
      height=600,
      grayscale=true,
      blur=5,
      seed="myseed",
    ),
  ).dummy(@dummy.seed(b"picsum-custom"))
  @test.assert_eq(
    url, "https://picsum.photos/seed/myseed/800/600?grayscale&blur=5",
  )
}

///|
test "picsum predefined variants" {
  let rng = @dummy.seed(b"picsum-variants")
  let image = @dummy.picsum_image().dummy(rng)
  let gray = @dummy.picsum_image_grayscale().dummy(rng)
  let blur = @dummy.picsum_image_blur().dummy(rng)
  assert_true(image.has_prefix("https://picsum.photos/"))
  assert_true(gray.has_suffix("?grayscale"))
  assert_true(blur.contains("?blur="))
}

#Identifier And Encoding Strings

///|
test "identifier and encoding strings" {
  let rng = @dummy.seed(b"identifier-encoding")
  let uuid = @dummy.uuid_v4().dummy(rng)
  let ulid = @dummy.ulid().dummy(rng)
  let object_id = @dummy.bson_object_id().dummy(rng)
  let encoded = @dummy.url_safe_base64_no_pad().dummy(rng)
  @test.assert_eq(uuid.length(), 36)
  @test.assert_eq(ulid.length(), 26)
  @test.assert_eq(object_id.length(), 24)
  assert_true(!encoded.contains("="))
}

#Locale-Specific Reference Data

///|
test "locale-specific administrative and automotive data" {
  let rng = @dummy.seed(b"locale-specific")
  let health_code = @dummy.health_insurance_code(locale=@dummy.fr_fr).dummy(rng)
  let plate = @dummy.licence_plate(locale=@dummy.nl_nl).dummy(rng)
  assert_true(!health_code.is_empty())
  assert_true(!plate.is_empty())
}

#Custom DummyDefault

///|
struct DemoUser {
  name : String
  active : Bool
} derive(Eq, Debug)

///|
impl @core.DummyDefault for DemoUser with fn dummy_default(rng) {
  { name: @dummy.name().dummy(rng), active: @dummy.boolean().dummy(rng), }
}

///|
test "custom dummy default" {
  let user : DemoUser = @core.DummyDefault::dummy_default(
    @dummy.default_seeded(),
  )
  assert_true(!user.name.is_empty())
}