🚀 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.
• 5955 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?

| Capability | Mock Jutsu 🥷 | Traditional Mockers 🤡 | |:---|:---:|:---:| | Card Numbers (Luhn Valid) | ✅ 9 Networks Validated | ❌ Random digits | | IBANs (MOD-97 Valid) | ✅ Country-specific | ❌ Format-only | | National IDs | ✅ Real algorithms (6 countries) | ⚠️ Partial / Random | | Telecom (IMEI, ICCID, IMSI)| ✅ 3GPP / ITU-T Valid | ❌ None | | Securities (ISIN, LEI, SEDOL)| ✅ Checksum Validated | ❌ None | | Crypto (BTC, ETH addresses) | ✅ Base58Check / Keccak-256 | ❌ None | | Payment QRs (EMVCo/SEPA) | ✅ CRC-16 Checksum / BCD Format | ❌ None | | Barcodes (EAN, ISBN, GS1) | ✅ GS1 v24.0 Valid | ❌ None | | Tracking (USPS/UPS/FedEx) | ✅ Pub.97 Luhn / Mod-11 | ❌ None | | Banking Routing Codes | ✅ Valid ABA/Sort/BIC | ⚠️ Format-only | | RFID & NFC Data | ✅ EPC SGTIN-96, NDEF URI/Text | ❌ None | | Context-Aware Profiles | ✅ Linked Name ↔ Email ↔ Phone | ⚠️ Disconnected randoms | | SQL/CSV Direct Export | ✅ Native Support | ❌ Manual generation | | Schema/Template Generation| ✅ jutsu.template() for complex dictionaries | ❌ Manual object mapping | | Built-in CLI Tool | ✅ Out-of-the-box (mockjutsu generate) | ❌ Requires custom scripts | | Built-in REST API | ✅ 1 command (mockjutsu start-api) | ❌ Requires custom wrapper | | Reverse Regex Generation | ✅ Pattern → valid string (stdlib only) | ❌ None | | External Dependencies | ✅ Zero (Pure Python) | ❌ Relies on external files | | Regulation-Aware Masking | ✅ PCI DSS · GDPR · KVKK · HIPAA · GLBA · UK GDPR · LGPD · PDPA · PIPL · PSD2 · BSA · FATF | ❌ None |

🎬 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.

${_mockjutsuidentity(tckn|TR)}                  → 46396909916
${_mockjutsufinancial(iban|DE)}                 → DE89370400440532013000
${_mockjutsufinancial(cardnum:visa|TR|mask)}    → 4155 56 ** 3399
${_mockjutsucontact(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(
    {'userid': 'uuid', 'name': 'fullname', 'wallet': 'cryptoaddress'},
    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.

| Locale | Country | National ID | Internal Algorithm Executed | |:---:|:---|:---|:---| | 🇹🇷 | TR | TCKN | Dual MOD-10 checksum, 11 digits | | 🇺🇸 | US | SSN / EIN | ABA Routing MOD-10 | | 🇬🇧 | UK | NIN / UTR | HMRC prefix restrictions | | 🇩🇪 | DE | Steuer-ID | ISO 7064 MOD 11,10 | | 🇫🇷 | FR | SIREN / TVA | Luhn + MOD-97 | | 🇷🇺 | RU | INN / SNILS | Weighted checksum arrays, MOD-101 |

📦 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.

Quick Start for Contributors

• Fork the Project & clone it locally.
• Install the pre-push safety hook: python scripts/setup-hooks.py
• Write your test first, then implement your algorithm.
• 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.