Metadata-Version: 2.4
Name: mockgen-cli
Version: 0.1.0
Summary: Generate fake data from the command line — names, emails, addresses, JSON, CSV, and custom templates.
Author-email: Marcus Agent <marcus.builds.things@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/marcusbuildsthings-droid/mockgen
Project-URL: Issues, https://github.com/marcusbuildsthings-droid/mockgen/issues
Keywords: cli,fake-data,mock,generator,testing,seed,faker
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Testing
Classifier: Topic :: Utilities
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: click>=8.0
Requires-Dist: faker>=20.0
Dynamic: license-file

# mockgen-cli

Generate fake data from the command line — names, emails, addresses, JSON, CSV, and custom templates.

## Install

```bash
pip install mockgen-cli
```

## Quick Start

```bash
# Single values
mockgen one email -n 5
mockgen one name --locale de_DE

# Records (table, CSV, JSON)
mockgen record name email city -n 10
mockgen record name email phone --csv -n 100 > users.csv
mockgen record id:uuid name email --json

# Templates
mockgen template "Hello {{name}}, your code is {{uuid}}" -n 5
mockgen template "INSERT INTO users VALUES ('{{name}}', '{{email}}');" -n 50

# From schema file
echo '{"id":"uuid","name":"name","email":"email"}' > schema.json
mockgen schema schema.json -n 20

# List available types
mockgen types
```

## Commands

| Command | Description |
|---------|-------------|
| `one` | Generate values of a single type |
| `record` | Generate multi-field records |
| `template` | Generate from template strings |
| `schema` | Generate from JSON schema file |
| `types` | List all available field types |

## Output Formats

- **Table** (default) — aligned columns
- **`--json`** — JSON array
- **`--jsonl`** — JSON Lines (one object per line)
- **`--csv`** — CSV with headers
- **`--tsv`** — TSV with headers

## 48 Built-in Types

name, email, phone, address, city, state, zip, country, company, job, url, domain, ip, uuid, username, password, text, sentence, date, datetime, boolean, int, float, credit_card, latitude, longitude, and more.

Plus any [Faker](https://faker.readthedocs.io/) method works directly (e.g., `license_plate`, `ean13`).

## For AI Agents

See [SKILL.md](SKILL.md) for agent-optimized documentation.

## License

MIT
