🚀 The Ultimate Algorithmic Mock Data Engine

QA engineers, Data Scientists, and Fintech developers are tired of test data failing at the validation layer. Mock Jutsu is built differently. It treats every identifier as a strict technical specification. If an algorithm defines a checksum, Mock Jutsu computes it. No shortcuts.

🔥 Features That Will Blow Your Mind

• Zero External Dependencies: The core data engine uses pure Python standard library for maximum speed, security, and zero bloat.
• 5998 Automated Tests: We don't guess. We verify. Every single format and locale is rigorously tested against real-world algorithmic specifications.
• Multi-Interface: Use it as a rich Python SDK, a blazing-fast CLI, or a FastAPI REST endpoint.
• Export Anywhere: Directly export structured records as JSON, CSV, or SQL INSERT statements with thousands of rows in milliseconds.
• Context-Aware Profiles: Generate a person, and their email, phone, national ID, and IBAN will inherently match their locale and name.

🤔 Why Mock Jutsu?

Mock Jutsu — checksum-valid test data for Fintech Developers, QA Testers, and Everyone Else.

Traditional mockers produce values that merely look correct; Mock Jutsu generates national IDs, IBANs, and card numbers that pass real validation — every checksum computed to spec, and independently verified against third-party libraries rather than our own test suite. Use it for Unit Tests, Integration Tests, or UAT.

🎬 See It In Action

⚙️ Installation

Python Package

Requires Python 3.9+.

# Standard Installation
pip install mockjutsu

# Isolated CLI Installation (recommended for macOS/Linux)
pipx install mockjutsu

# For Developers (Editable Mode)
git clone https://github.com/altansayan/mock-jutsu-api.git
cd mock-jutsu-api
pip install -e .

REST API — Docker (Recommended)

Run the full REST API locally with a single command. No Python required.

# Pull and run (port 8000)
docker run -p 8000:8000 altansezerayan/mock-jutsu:latest

# With custom worker count
docker run -p 8000:8000 -e GRANIAN_WORKERS=8 altansezerayan/mock-jutsu:latest

# Run in background
docker run -d -p 8000:8000 --name mock-jutsu altansezerayan/mock-jutsu:latest

Once running:

• Swagger UI: http://localhost:8000/docs
• API: http://localhost:8000/generate/{type}

🌐 REST API — Built-in CLI (Local, Optional)

If you have the Python package installed, you can also spin up the API directly via CLI — no Docker needed.

$ mockjutsu start-api --port 8000

GET http://localhost:8000/generate/cardnum?network=visa
GET http://localhost:8000/profile?locale=DE&count=3

# Interactive Swagger UI automatically available at http://localhost:8000/docs

🔧 JMeter Plugin

Use Mock Jutsu types directly inside JMeter test plans as native custom functions — no scripting, no CSV, no subprocess required.

${__mockjutsu_identity(tckn|TR)}                  → 46396909916
${__mockjutsu_financial(iban|DE)}                 → DE89370400440532013000
${__mockjutsu_financial(cardnum:visa|TR|mask)}    → 4155 56** **** 3399
${__mockjutsu_contact(email|US)}                  → john.doe@example.com

→ mock-jutsu-jmeter on GitHub · Download JAR v1.0.0

📬 Postman Collection

390 ready-to-run requests organized by category. Import and hit Send.

# Collection is bundled in this repo — import directly in Postman:
# .postman/collections/mock-jutsu.postman_collection.json

→ View Collection

💻 Usage

Whether you are writing automated tests, working in the terminal, or spinning up a mock API, Mock Jutsu is ready.

🐍 1. Python SDK

from mockjutsu.core import jutsu

# 1. Complete, internally-consistent profiles
person = jutsu.profile(locale='DE')
print(person['nationalid']) # -> "86094599602" (Steuer-ID: ISO 7064 MOD 11,10 ✅)
print(person['iban'])       # -> "DE89370400440532013000" (ISO 13616 MOD-97 ✅)

# 2. Individual precise data types
card = jutsu.generate('cardnum', network='amex') # -> "376956063521007" (Luhn ✅)
btc = jutsu.generate('btc_address')              # -> "1BvBMSEYstWet..." (Base58Check SHA256d ✅)

# 3. 🎯 Fully Customizable Templates
# Define your own schema and generate a list of dictionaries instantly
users = jutsu.template(
    {'user_id': 'uuid', 'name': 'fullname', 'wallet': 'crypto_address'},
    count=100, locale='UK'
)

# 4. Generate thousands of records & export directly to SQL
sql = jutsu.export(
    {'id': 'uuid', 'name': 'fullname', 'card': 'cardnum', 'bank_account': 'iban'},
    count=5000, format='sql', table='users', locale='TR'
)

⚡ 2. Beautiful CLI

Generate valid test data straight from your terminal.

# Get single values instantly
$ mockjutsu generate tckn
$ mockjutsu generate iban --locale FR
$ mockjutsu generate cardnum --network troy

# Need an array of valid US phone numbers?
$ mockjutsu bulk phone --count 500 --locale US

# Generate CSV datasets and save to a file
$ mockjutsu template uuid fullname crypto_address --count 100 --format csv > users.csv

# Generate SQL seed files and save to a text file
$ mockjutsu template uuid fullname crypto_address --count 500 --format sql --table USERS > data.txt

🧱 4. Template Generation via CLI

Combine multiple data types into a structured JSON record directly from your terminal.

$ mockjutsu template uuid fullname crypto_address --count 2 --locale US

[
  {
    "uuid": "5ae780dd-1e26-4317-bc87-495eb53563aa",
    "fullname": "Holly Brandt",
    "crypto_address": "13gSozPBVaQMfFvVrRB7AQ3Fe6ZLDXErUh"
  },
  {
    "uuid": "76706c3e-3eaa-4afd-a749-e4002764d275",
    "fullname": "Brooke Lyons",
    "crypto_address": "1GPuQvEVjYfy7C4fdxtY2Y1q76Awngsk9n"
  }
]

🌍 6 Locales. 100% Real Algorithms.

We don't just localize names; we localize mathematics.

📦 390 Supported Data Types

We cover everything from standard identities to complex financial market identifiers.

(See our interactive guides for the full list of 390 types: 🇹🇷 TR | 🇺🇸 EN | 🇬🇧 UK | 🇩🇪 DE | 🇫🇷 FR | 🇷🇺 RU)

🤝 Contributing

Mock Jutsu thrives on community contributions. Found a checksum we're not validating? A locale we're missing? We'd love your help!

🚨 Strict TDD & Performance Mandate To maintain our enterprise-grade quality, this repository mechanically enforces Test-Driven Development (TDD).

• Every new generator must be fully tested mathematically.
• Every new generator must pass the < 1.5ms performance baseline.
• GitHub Actions will automatically block any Pull Request that lacks passing tests.

Please read our full CONTRIBUTING.md guide before starting your work.

Quick Start for Contributors

1. Fork the Project & clone it locally.
2. Install the pre-push safety hook: python scripts/setup-hooks.py
3. Write your test first, then implement your algorithm.
4. Commit your changes and open a Pull Request!

⚖️ Legal Disclaimer

Generated data is entirely synthetic and for development/testing environments only.

• Do not submit to real financial, government, or telecom production systems.
• Generated IBANs, card numbers, and national IDs are mathematically valid but do not belong to real entities.