Metadata-Version: 2.4
Name: larzfaker
Version: 0.1.0
Summary: Deterministic, seedable fake data (names, emails, money, dates, records) for tests, demos, and seeds. Pure Python, zero dependencies.
Author: larz-scripter
License: MIT
Project-URL: Homepage, https://github.com/larz-scripter/larzfaker
Project-URL: Repository, https://github.com/larz-scripter/larzfaker
Project-URL: Issues, https://github.com/larz-scripter/larzfaker/issues
Keywords: faker,fake-data,test-data,mock-data,seed,deterministic,fixtures,lorem,money,zero-dependency
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# larzfaker

**Deterministic fake data for tests, demos, and seeds. Pure Python, zero deps.**

Names, emails, addresses, money, dates, lorem text, and whole records — generated
from a seed, so the **same seed always produces the same data**. Reproducible
fixtures, stable demo databases, and failing tests you can reproduce exactly.

```python
from larzfaker import Faker

f = Faker(seed=42)
f.name()        # 'Grace Hopper'
f.email()       # 'grace.hopper@example.com'
f.money()       # '$4,215.60'
f.records(5, {"name": f.name, "email": f.email, "balance": f.money})
```

## Why

- **Deterministic by design.** Seed it and the sequence is fixed — the whole point
  for test fixtures and demos, and unlike reaching for bare `random`.
- **Money- and date-aware.** `money()`/`money_decimal()` and ranged
  `date()`/`datetime()` — realistic seed data that pairs with
  [larztable](https://github.com/larz-scripter/larztable) and
  [larzledger](https://github.com/larz-scripter/larzledger).
- **Records in one call.** `records(n, {field: callable})` builds lists of dicts —
  drop straight into a database or a table.
- **Zero dependencies.** No `faker`, no locale data packs.

## Install

```bash
pip install larzfaker
```

## Providers

`name` `first_name` `last_name` `username` `email` `phone` `company` `job` ·
`address` `street` `city` `zipcode` · `word` `words` `sentence` `paragraph`
`text` `slug` · `integer` `decimal` `boolean` `choice` `pick` `color` `uuid4`
`url` · `money` `money_decimal` `date` `datetime` · `record` `records`.

## Tests

```bash
python -m unittest discover -s tests -v   # 26 tests incl. determinism
```

## The Larz stack

One of 30+ pure-Python, zero-dependency libraries at
[github.com/larz-scripter](https://github.com/larz-scripter).

## License

MIT © larz-scripter
