loke

Your all-time trickster and provider of fakes and mocks for prototyping, testing, and fun!

Quick Start

CLI

Generate fake data from the command line:

# Random hex values
loke hex                    # 7f693620
loke hex --length 32        # 859a70bc75691a13dc88ad44c5f2d82e

# SHA256 hashes
loke sha256                 # b4014e5e435233cbf1825f241b9337590d3775f3c1df8e242f77b2174d5e8fe9

Library

Use loke in your TypeScript/JavaScript projects:

import { fake, hex, sha256 } from 'loke';

const randomHex = await fake('hex');
const randomHash = await fake('sha256');
const customHex = await hex({ length: 16 });

Planned Features ✨

The following features don't exist yet, but Claude got a little excited and imagined them while Maria was deciding what to build next. Consider them "aspirational documentation".

Realistic Data Generation

• Personal Data: Names, email addresses, phone numbers, addresses with locale support
• Financial: Credit card numbers (test-safe), IBANs, BIC codes, currency amounts
• Network: MAC addresses, IP addresses (v4 & v6), UUIDs, URLs
• Temporal: Timestamps, durations, recurring event patterns with timezone support
• Documents: SSNs, passport numbers, license plates, ISBNs

Weighted & Seeded Generation

• Seed-based generation for reproducible test data
• Weighted random selection for realistic distributions
• Correlation between generated fields (e.g., country-specific data)

Data Ranges & Constraints

• ISO date ranges with complex filtering (e.g., "weekdays only", "business hours")
• Numeric ranges with custom distributions
• Pattern-based generation (regex, format strings)

Composable Schemas

• Define reusable fake data schemas
• Generate complete objects matching your data models
• Validation against schemas

MCP Integration

• Use loke as a Model Context Protocol server for Claude and other AI assistants
• Generate realistic test data directly from conversation with Claude
• Integrate fake data generation into AI-assisted development workflows

Data Persistence & Replay

• Generate and save fake data datasets
• Replay datasets for consistent testing across runs
• Export to JSON, CSV, SQL, or other formats

Current Version

This is version 0.1.0 - the absolute MVP. We're just getting started! The core library and CLI infrastructure are in place, with basic hex and SHA256 generators ready for immediate use.

Contributing

Contributions welcome! This project is in active development and there's plenty of room to build out the vision above.