mockjutsu 1.0.0__tar.gz

mockjutsu-1.0.0/LICENSE

@@ -0,0 +1,38 @@
+MIT License
+
+Copyright (c) 2026 Altan Sezer Ayan - A.S.A
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+DISCLAIMER — TESTING PURPOSES ONLY
+
+All data generated by this software is algorithmically synthesized and entirely
+fictitious. It is designed exclusively for software testing, QA automation, and
+load testing workflows.
+
+Generated values — including but not limited to identity numbers, IBANs, card
+numbers, passport numbers, and financial identifiers — must never be used for
+fraud, identity theft, financial crime, impersonation, or any other unlawful
+activity.
+
+The authors and copyright holders expressly disclaim any liability arising from
+misuse of this software. Use of this software constitutes acceptance of these
+terms.

mockjutsu-1.0.0/PKG-INFO

@@ -0,0 +1,386 @@
+Metadata-Version: 2.4
+Name: mockjutsu
+Version: 1.0.0
+Summary: Algorithmic mock data engine — 390+ types, 6 locales, real checksums. TCKN, IBAN, Luhn, VIN, NHS, SWIFT, crypto, MRZ, JMeter plugin and more.
+Author-email: Altan Sezer Ayan <altansezerayan@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/altansayan/mock-jutsu-api
+Project-URL: Repository, https://github.com/altansayan/mock-jutsu-api
+Project-URL: Bug Tracker, https://github.com/altansayan/mock-jutsu-api/issues
+Keywords: mock,fake,data,testing,fintech,faker,tckn,iban,luhn,vin,nhs,rfid,nfc,epc,ndef,apdu,ir,nec,pronto,rc5,locale
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Testing
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.0
+Requires-Dist: pyfiglet>=0.8
+Requires-Dist: rich>=13.0
+Provides-Extra: server
+Requires-Dist: fastapi>=0.100; extra == "server"
+Requires-Dist: granian>=1.0; extra == "server"
+Requires-Dist: httpx>=0.24; extra == "server"
+Provides-Extra: test
+Requires-Dist: pytest>=7.0; extra == "test"
+Requires-Dist: pytest-cov>=4.0; extra == "test"
+Requires-Dist: playwright>=1.30; extra == "test"
+Requires-Dist: pytest-playwright>=0.4; extra == "test"
+Provides-Extra: validation
+Requires-Dist: python-stdnum>=1.20; extra == "validation"
+Requires-Dist: schwifty>=2023.0; extra == "validation"
+Requires-Dist: bip-utils>=2.9; extra == "validation"
+Requires-Dist: mrz>=0.6; extra == "validation"
+Requires-Dist: lxml>=5.0; extra == "validation"
+Requires-Dist: PyJWT>=2.8; extra == "validation"
+Requires-Dist: cryptography>=42.0; extra == "validation"
+Requires-Dist: mt940>=0.8; extra == "validation"
+Requires-Dist: hl7>=0.4; extra == "validation"
+Requires-Dist: fhir.resources>=7.0; extra == "validation"
+Requires-Dist: simplefix>=1.0; extra == "validation"
+Requires-Dist: netaddr>=1.0; extra == "validation"
+Requires-Dist: icd10-cm>=0.0.5; extra == "validation"
+Requires-Dist: cbor2>=5.0; extra == "validation"
+Requires-Dist: fido2>=1.1; extra == "validation"
+Requires-Dist: phonenumbers>=8.13; extra == "validation"
+Dynamic: license-file
+
+<div align="center">
+
+<!-- A placeholder for a future logo or GIF -->
+<!-- <img src="https://raw.githubusercontent.com/altansayan/mock-jutsu-api/main/assets/mock-jutsu-banner.png" alt="mock-jutsu banner" width="100%"> -->
+
+# 🥷 Mock Jutsu
+
+**Stop mocking with random strings. Start generating cryptographically valid test data.**
+
+[![Tests](https://img.shields.io/badge/tests-5955%20passed-22c55e?style=for-the-badge&logo=pytest)](./tests)
+[![Python](https://img.shields.io/badge/python-3.9%2B-3b82f6?style=for-the-badge&logo=python&logoColor=white)](https://python.org)
+[![Data Types](https://img.shields.io/badge/Data%20Types-390-a855f7?style=for-the-badge)](https://altansayan.github.io/mock-jutsu-api/)
+[![Locales](https://img.shields.io/badge/Locales-6-ec4899?style=for-the-badge)](#-6-locales-100-real-algorithms)
+[![Zero Dependencies](https://img.shields.io/badge/Dependencies-0-ff69b4?style=for-the-badge)](#-features-that-will-blow-your-mind)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)](./LICENSE)
+[![Docker Hub](https://img.shields.io/badge/Docker%20Hub-altansezerayan%2Fmock--jutsu-2496ED?style=for-the-badge&logo=docker&logoColor=white)](https://hub.docker.com/r/altansezerayan/mock-jutsu)
+[![JMeter Plugin](https://img.shields.io/badge/JMeter%20Plugin-v1.0.0-D22128?style=for-the-badge&logo=apachejmeter&logoColor=white)](https://github.com/altansayan/mock-jutsu-jmeter/releases/tag/v1.0.0)
+[![Postman](https://img.shields.io/badge/Postman-390%20Requests-FF6C37?style=for-the-badge&logo=postman&logoColor=white)](https://github.com/altansayan/mock-jutsu-api/tree/main/.postman/collections)
+
+> **DISCLAIMER — FOR TESTING PURPOSES ONLY**
+> All data generated by this library is **algorithmically synthesized and entirely fictitious**.
+> Designed exclusively for software testing, QA automation, and load testing.
+> Generated values (identity numbers, IBANs, card numbers, passport numbers, etc.) must **never** be used for fraud, identity theft, financial crime, or any other illegal activity.
+> The authors accept no liability for misuse. By using this software you agree to these terms.
+
+*Traditional Mockers give you a random 16-digit string and call it a credit card number.<br>**Mock Jutsu runs Luhn. Every. Single. Time.***
+
+[**Installation**](#%EF%B8%8F-installation) • [**Why Mock Jutsu?**](#-why-not-faker) • [**Usage Guide**](#-usage) • [**390 Types**](#236-supported-data-types)
+
+</div>
+
+---
+
+## 🚀 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 |
+
+---
+
+## ⚙️ Installation
+
+### Python Package
+
+Requires **Python 3.9+**.
+
+```bash
+# Standard Installation
+pip 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.
+
+[![Docker Hub](https://img.shields.io/badge/Docker%20Hub-altansezerayan%2Fmock--jutsu-2496ED?style=flat&logo=docker&logoColor=white)](https://hub.docker.com/r/altansezerayan/mock-jutsu)
+
+```bash
+# 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.
+
+```bash
+$ mockjutsu start-api --port 8000
+```
+```http
+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.
+
+[![JMeter Plugin](https://img.shields.io/badge/JMeter%20Plugin-v1.0.0-red?style=flat&logo=apachejmeter&logoColor=white)](https://github.com/altansayan/mock-jutsu-jmeter/releases/tag/v1.0.0)
+
+```
+${__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](https://github.com/altansayan/mock-jutsu-jmeter)** · [Download JAR v1.0.0](https://github.com/altansayan/mock-jutsu-jmeter/releases/tag/v1.0.0)
+
+### 📬 Postman Collection
+
+390 ready-to-run requests organized by category. Import and hit Send.
+
+[![Postman](https://img.shields.io/badge/Postman-Collection-FF6C37?style=flat&logo=postman&logoColor=white)](https://github.com/altansayan/mock-jutsu-api/tree/main/.postman/collections)
+
+```bash
+# Collection is bundled in this repo — import directly in Postman:
+# .postman/collections/mock-jutsu.postman_collection.json
+```
+
+→ **[View Collection](https://github.com/altansayan/mock-jutsu-api/tree/main/.postman/collections)**
+
+---
+
+## 💻 Usage
+
+Whether you are writing automated tests, working in the terminal, or spinning up a mock API, `Mock Jutsu` is ready.
+
+### 🐍 1. Python SDK
+
+```python
+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.
+
+```bash
+# 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.
+
+```bash
+$ mockjutsu template uuid fullname crypto_address --count 2 --locale US
+```
+```json
+[
+  {
+    "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.
+
+<details>
+<summary><b>👤 Identity & Demographic (42 types)</b></summary>
+<br>
+<code>tckn</code> <code>ssn</code> <code>ein</code> <code>nin</code> <code>siren</code> <code>siret</code> <code>tva</code> <code>inn</code> <code>snils</code> <code>ogrn</code> <code>passport</code> <code>license</code> +20 more
+</details>
+
+<details>
+<summary><b>💳 Financial & Banking (53 types)</b></summary>
+<br>
+<code>cardnum</code> <code>cardnetwork</code> <code>iban</code> <code>sepa_qr</code> <code>emv_qr_p2p</code> <code>emv_qr_atm</code> <code>emv_qr_pos</code> <code>bic</code> <code>sort_code</code> +18 more
+</details>
+
+<details>
+<summary><b>📡 Telecom & IoT (19 types)</b></summary>
+<br>
+<code>imei</code> <code>iccid</code> <code>imsi</code> <code>msisdn</code> <code>rfid_uid</code> <code>epc</code> <code>nfc_uid</code> <code>ndef_uri</code> <code>apdu</code> <code>ir_nec</code> +10 more
+</details>
+
+<details>
+<summary><b>💹 Securities & Crypto (38 types)</b></summary>
+<br>
+<code>isin</code> <code>cusip</code> <code>sedol</code> <code>lei</code> <code>btc_address</code> <code>eth_address</code> <code>tx_hash</code> <code>block_hash</code>
+</details>
+
+<details>
+<summary><b>📦 E-Commerce & Barcodes (20 types)</b></summary>
+<br>
+<code>ean13</code> <code>upca</code> <code>isbn13</code> <code>gs1_128</code> <code>tracking_number</code> <code>sku</code> <code>order_id</code> +5 more
+</details>
+
+*(See our interactive guides for the full list of 390 types:
+[🇹🇷 TR](https://altansayan.github.io/mock-jutsu-api/HOW-TO/TR/HOW-TO-MockJutsu-TR.html) | [🇺🇸 EN](https://altansayan.github.io/mock-jutsu-api/HOW-TO/EN/HOW-TO-MockJutsu-EN.html) | [🇬🇧 UK](https://altansayan.github.io/mock-jutsu-api/HOW-TO/UK/HOW-TO-MockJutsu-UK.html) | [🇩🇪 DE](https://altansayan.github.io/mock-jutsu-api/HOW-TO/DE/HOW-TO-MockJutsu-DE.html) | [🇫🇷 FR](https://altansayan.github.io/mock-jutsu-api/HOW-TO/FR/HOW-TO-MockJutsu-FR.html) | [🇷🇺 RU](https://altansayan.github.io/mock-jutsu-api/HOW-TO/RU/HOW-TO-MockJutsu-RU.html))*
+
+---
+
+## 🤝 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](./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**.
+
+<br>
+
+---
+
+## 💖 Support Mock Jutsu
+
+Mock Jutsu is **free and open-source**. If it saved you hours of debugging, consider buying me a coffee ☕
+
+> _"Every cup of coffee = one more data type."_ 🥷
+
+| Network | Address |
+|---------|---------|
+| Ξ **Ethereum (ETH)** | `0x8D2fF0a795E3a19D41758Cb9b4451C39D528BbAF` |
+
+_This section will be updated with our sponsors._
+
+---
+
+<div align="center">
+  <h3>If mock-jutsu saved you from debugging a "valid-looking but broken" test ID, please leave a ⭐!</h3>
+  <p>Released under the <a href="./LICENSE">MIT License</a> • Copyright © 2026 <a href="https://github.com/altansayan">Altan Sezer Ayan — A.S.A</a></p>
+</div>