A Python CLI tool for generating fake data and exporting it to JSON files.
Forger helps you generate realistic test data using the Faker library. It's perfect for developers who need to quickly create test datasets for their applications.
- Generate fake user data with customizable fields
- Export to JSON format
- Support for multiple data types (names, addresses, emails)
- Command-line interface with Typer
- Configurable output format
- Batch processing
{
"id": "21f94bb0-3756-417b-9b02-60052c81c84c",
"name": "Michele",
"middle_name": "Pamela",
"last_name": "Martin",
"email": "michele.martin@example.com",
"password": "6y84DZsk$%V+",
"gender": "male",
"age": 49,
"is_active": true,
"created_at": "2025-05-20T11:59:05.956115",
"updated_at": "2025-05-20T11:59:05.956117"
}- Python 3.13+
- Poetry
- Git
- Clone and install:
git clone https://github.com/yourusername/forger.git
cd forger
poetry install- Verify installation:
forger --help# Basic usage
forger # Will generate 10 users and a output file users.json
# With parameters
$ forger -c 50 -o user50.json
$ forger -c 50 -o user50 #without file extension- Fork and clone the repository
- Create a feature branch:
git checkout -b feature/your-feature - Install dependencies:
poetry install - Run tests:
poetry run pytest
- Fork the repository
- Create your feature branch
- Commit your changes
- Push to the branch
- Open a Pull Request
Apache 2.0 License - see LICENSE for details.