iso8583sim 1.1.0__tar.gz

iso8583sim-1.1.0/.github/workflows/ci.yml

@@ -0,0 +1,58 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ['3.10', '3.11', '3.12']
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[test]"
+
+      - name: Run tests
+        run: pytest --cov=iso8583sim --cov-report=xml -v
+
+      - name: Upload coverage
+        uses: codecov/codecov-action@v4
+        if: matrix.python-version == '3.12'
+        with:
+          files: coverage.xml
+          fail_ci_if_error: false
+
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install ruff mypy
+
+      - name: Run ruff
+        run: ruff check .
+
+      - name: Run ruff format check
+        run: ruff format --check .

iso8583sim-1.1.0/.github/workflows/docs.yml

@@ -0,0 +1,55 @@
+name: Deploy Documentation
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'docs/**'
+      - 'mkdocs.yml'
+      - 'iso8583sim/**'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[docs]"
+
+      - name: Build documentation
+        run: mkdocs build
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: site/
+
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

iso8583sim-1.1.0/.github/workflows/publish.yml

@@ -0,0 +1,50 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - name: Install build dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install build twine
+
+      - name: Build package
+        run: python -m build
+
+      - name: Check package
+        run: twine check dist/*
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - name: Download artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

iso8583sim-1.1.0/.gitignore

@@ -0,0 +1,59 @@
+# Python
+__pycache__/
+*.py[cod]
+*.class
+.Python
+build/
+
+# Cython
+*.so
+*.c
+iso8583sim/core/_bitmap.c
+iso8583sim/core/_parser_fast.c
+iso8583sim/core/_validator_fast.c
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual Environment
+venv/
+.venv/
+ENV/
+env/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Testing
+.coverage
+htmlcov/
+.pytest_cache/
+test-results.xml
+
+# Distribution
+dist/
+build/
+*.egg-info/
+
+# Documentation
+docs/_build/
+/_dev/
+
+# Jupyter
+.ipynb_checkpoints/
+notebooks/.ipynb_checkpoints/
+site/

iso8583sim-1.1.0/.pre-commit-config.yaml

@@ -0,0 +1,37 @@
+# Pre-commit configuration for iso8583sim
+# Install: pre-commit install
+# Run manually: pre-commit run --all-files
+
+repos:
+  # Ruff - Fast Python linter and formatter
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.8.4
+    hooks:
+      - id: ruff
+        args: [--fix, --exit-non-zero-on-fix]
+      - id: ruff-format
+
+  # Mypy - Static type checking
+  # TODO: Re-enable in v0.3.0 after fixing type annotations
+  # - repo: https://github.com/pre-commit/mirrors-mypy
+  #   rev: v1.14.1
+  #   hooks:
+  #     - id: mypy
+  #       additional_dependencies:
+  #         - pydantic>=2.0
+  #         - typer>=0.9.0
+  #       args: [--ignore-missing-imports]
+  #       exclude: ^(tests|benchmarks)/
+
+  # Pre-commit hooks
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-json
+      - id: check-added-large-files
+        args: [--maxkb=500]
+      - id: check-merge-conflict
+      - id: debug-statements

iso8583sim-1.1.0/PKG-INFO

@@ -0,0 +1,233 @@
+Metadata-Version: 2.4
+Name: iso8583sim
+Version: 1.1.0
+Summary: High-performance ISO 8583 message simulator with CLI, Python SDK, and LLM features
+Author-email: Subhadip Mitra <contact@subhadipmitra.com>
+License-File: LICENSE
+Keywords: banking,financial,iso8583,payment,simulator
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Financial and Insurance Industry
+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: Topic :: Office/Business :: Financial
+Classifier: Topic :: Software Development :: Testing
+Requires-Python: >=3.10
+Requires-Dist: click>=8.0.0
+Requires-Dist: fastapi>=0.68.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: rich>=10.0.0
+Requires-Dist: typer>=0.4.0
+Requires-Dist: uvicorn>=0.15.0
+Provides-Extra: anthropic
+Requires-Dist: anthropic>=0.40.0; extra == 'anthropic'
+Provides-Extra: dev
+Requires-Dist: black>=22.0.0; extra == 'dev'
+Requires-Dist: coverage>=7.4.0; extra == 'dev'
+Requires-Dist: cython>=3.0.0; extra == 'dev'
+Requires-Dist: isort>=5.0.0; extra == 'dev'
+Requires-Dist: mypy>=0.900; extra == 'dev'
+Requires-Dist: pre-commit>=3.5.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
+Requires-Dist: pytest-html>=4.1.1; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: pyyaml>=6.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.0.290; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: mkdocs-material>=9.5.0; extra == 'docs'
+Requires-Dist: mkdocs>=1.6.0; extra == 'docs'
+Requires-Dist: mkdocstrings[python]>=0.24.0; extra == 'docs'
+Provides-Extra: google
+Requires-Dist: google-generativeai>=0.8.0; extra == 'google'
+Provides-Extra: llm
+Requires-Dist: anthropic>=0.40.0; extra == 'llm'
+Requires-Dist: google-generativeai>=0.8.0; extra == 'llm'
+Requires-Dist: ollama>=0.4.0; extra == 'llm'
+Requires-Dist: openai>=1.50.0; extra == 'llm'
+Provides-Extra: ollama
+Requires-Dist: ollama>=0.4.0; extra == 'ollama'
+Provides-Extra: openai
+Requires-Dist: openai>=1.50.0; extra == 'openai'
+Provides-Extra: perf
+Requires-Dist: cython>=3.0.0; extra == 'perf'
+Provides-Extra: test
+Requires-Dist: coverage>=7.4.0; extra == 'test'
+Requires-Dist: pytest-cov>=4.1.0; extra == 'test'
+Requires-Dist: pytest-html>=4.1.1; extra == 'test'
+Requires-Dist: pytest>=7.0.0; extra == 'test'
+Requires-Dist: pyyaml>=6.0.0; extra == 'test'
+Description-Content-Type: text/markdown
+
+# ISO8583 Simulator
+
+[![PyPI version](https://img.shields.io/pypi/v/iso8583sim.svg)](https://pypi.org/project/iso8583sim/)
+[![Python versions](https://img.shields.io/pypi/pyversions/iso8583sim.svg)](https://pypi.org/project/iso8583sim/)
+[![License](https://img.shields.io/github/license/bassrehab/ISO8583-Simulator.svg)](https://github.com/bassrehab/ISO8583-Simulator/blob/main/LICENSE)
+[![CI](https://github.com/bassrehab/ISO8583-Simulator/actions/workflows/ci.yml/badge.svg)](https://github.com/bassrehab/ISO8583-Simulator/actions/workflows/ci.yml)
+[![Documentation](https://img.shields.io/badge/docs-iso8583.subhadipmitra.com-blue.svg)](https://iso8583.subhadipmitra.com)
+[![Code style: ruff](https://img.shields.io/badge/code%20style-ruff-000000.svg)](https://github.com/astral-sh/ruff)
+
+A modern, high-performance ISO 8583 message simulator with CLI, Python SDK, and interactive Jupyter notebooks.
+
+## Features
+
+- **Message Handling**:
+  - Parse ISO 8583 messages (180k+ TPS with Cython)
+  - Build ISO 8583 messages (150k+ TPS)
+  - Validate message structure and content
+  - Support for ISO versions (1987, 1993, 2003)
+
+- **Network Support**:
+  - VISA, Mastercard, AMEX, Discover, JCB, UnionPay
+  - Network-specific field validation
+  - EMV/chip card data handling (Field 55)
+
+- **Multiple Interfaces**:
+  - Command Line Interface (CLI)
+  - Python SDK for programmatic usage
+  - Interactive Jupyter notebooks
+
+- **Performance Optimized**:
+  - Optional Cython extensions for 2x speedup
+  - Object pooling for high-throughput scenarios
+  - See [Performance Guide](docs/performance.md)
+
+## Installation
+
+```bash
+pip install iso8583sim
+
+# For Cython performance extensions
+pip install iso8583sim[perf]
+python setup.py build_ext --inplace
+```
+
+## Quick Start
+
+### Python SDK
+
+```python
+from iso8583sim.core.parser import ISO8583Parser
+from iso8583sim.core.builder import ISO8583Builder
+from iso8583sim.core.validator import ISO8583Validator
+from iso8583sim.core.types import ISO8583Message
+
+# Build a message
+builder = ISO8583Builder()
+message = ISO8583Message(
+    mti="0100",
+    fields={
+        0: "0100",
+        2: "4111111111111111",
+        3: "000000",
+        4: "000000001000",
+        11: "123456",
+        41: "TERM0001",
+        42: "MERCHANT123456 ",
+    }
+)
+raw = builder.build(message)
+
+# Parse a message
+parser = ISO8583Parser()
+parsed = parser.parse(raw)
+
+# Validate a message
+validator = ISO8583Validator()
+errors = validator.validate_message(parsed)
+```
+
+### CLI Usage
+
+```bash
+# Parse a message
+iso8583sim parse "0100..." --version 1987
+
+# Build a message
+iso8583sim build --mti 0100 --fields fields.json
+
+# Validate a message
+iso8583sim validate "0100..."
+
+# Generate sample messages
+iso8583sim generate --type auth --pan 4111111111111111 --amount 1000
+```
+
+## Interactive Notebooks
+
+Learn ISO 8583 with our Jupyter notebooks:
+
+| Notebook | Description |
+|----------|-------------|
+| [01_getting_started.ipynb](notebooks/01_getting_started.ipynb) | Basic concepts and quick start |
+| [02_parsing_messages.ipynb](notebooks/02_parsing_messages.ipynb) | Deep dive into message parsing |
+| [03_building_messages.ipynb](notebooks/03_building_messages.ipynb) | Building various message types |
+| [04_network_specifics.ipynb](notebooks/04_network_specifics.ipynb) | VISA, Mastercard, and other networks |
+| [05_emv_data.ipynb](notebooks/05_emv_data.ipynb) | Working with EMV/chip card data |
+| [06_benchmarking.ipynb](notebooks/06_benchmarking.ipynb) | Performance testing and benchmarks |
+
+Run locally:
+```bash
+pip install jupyter
+jupyter notebook notebooks/
+```
+
+## Performance
+
+Benchmarks on Apple Silicon (M-series), Python 3.12:
+
+| Operation | Pure Python | With Cython |
+|-----------|-------------|-------------|
+| Parse | ~105k TPS | ~182k TPS |
+| Build | ~150k TPS | ~150k TPS |
+| Roundtrip | ~49k TPS | ~63k TPS |
+
+See [benchmarks/BASELINE.md](benchmarks/BASELINE.md) for detailed results.
+
+## Documentation
+
+Full documentation is available at **[iso8583.subhadipmitra.com](https://iso8583.subhadipmitra.com)**
+
+- [Getting Started](https://iso8583.subhadipmitra.com/getting-started/quickstart/) - Quick start guide
+- [Architecture](https://iso8583.subhadipmitra.com/architecture/overview/) - System design and decisions
+- [API Reference](https://iso8583.subhadipmitra.com/api/core/) - Complete API documentation
+- [Performance Guide](https://iso8583.subhadipmitra.com/performance/) - Optimization techniques
+
+## Development
+
+```bash
+# Clone and setup
+git clone https://github.com/bassrehab/ISO8583-Simulator.git
+cd iso8583sim
+python -m venv .venv
+source .venv/bin/activate
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Run benchmarks
+python benchmarks/bench_parser.py
+python benchmarks/bench_roundtrip.py
+```
+
+## Contributing
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/my-feature`)
+3. Commit your changes (`git commit -am 'Add new feature'`)
+4. Push to the branch (`git push origin feature/my-feature`)
+5. Create a Pull Request
+
+## Author
+
+**Subhadip Mitra** - [subhadipmitra.com](https://subhadipmitra.com)
+
+- GitHub: [@bassrehab](https://github.com/bassrehab)
+- LinkedIn: [subhadipmitra](https://linkedin.com/in/subhadipmitra)
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.

iso8583sim-1.1.0/README.md

@@ -0,0 +1,171 @@
+# ISO8583 Simulator
+
+[![PyPI version](https://img.shields.io/pypi/v/iso8583sim.svg)](https://pypi.org/project/iso8583sim/)
+[![Python versions](https://img.shields.io/pypi/pyversions/iso8583sim.svg)](https://pypi.org/project/iso8583sim/)
+[![License](https://img.shields.io/github/license/bassrehab/ISO8583-Simulator.svg)](https://github.com/bassrehab/ISO8583-Simulator/blob/main/LICENSE)
+[![CI](https://github.com/bassrehab/ISO8583-Simulator/actions/workflows/ci.yml/badge.svg)](https://github.com/bassrehab/ISO8583-Simulator/actions/workflows/ci.yml)
+[![Documentation](https://img.shields.io/badge/docs-iso8583.subhadipmitra.com-blue.svg)](https://iso8583.subhadipmitra.com)
+[![Code style: ruff](https://img.shields.io/badge/code%20style-ruff-000000.svg)](https://github.com/astral-sh/ruff)
+
+A modern, high-performance ISO 8583 message simulator with CLI, Python SDK, and interactive Jupyter notebooks.
+
+## Features
+
+- **Message Handling**:
+  - Parse ISO 8583 messages (180k+ TPS with Cython)
+  - Build ISO 8583 messages (150k+ TPS)
+  - Validate message structure and content
+  - Support for ISO versions (1987, 1993, 2003)
+
+- **Network Support**:
+  - VISA, Mastercard, AMEX, Discover, JCB, UnionPay
+  - Network-specific field validation
+  - EMV/chip card data handling (Field 55)
+
+- **Multiple Interfaces**:
+  - Command Line Interface (CLI)
+  - Python SDK for programmatic usage
+  - Interactive Jupyter notebooks
+
+- **Performance Optimized**:
+  - Optional Cython extensions for 2x speedup
+  - Object pooling for high-throughput scenarios
+  - See [Performance Guide](docs/performance.md)
+
+## Installation
+
+```bash
+pip install iso8583sim
+
+# For Cython performance extensions
+pip install iso8583sim[perf]
+python setup.py build_ext --inplace
+```
+
+## Quick Start
+
+### Python SDK
+
+```python
+from iso8583sim.core.parser import ISO8583Parser
+from iso8583sim.core.builder import ISO8583Builder
+from iso8583sim.core.validator import ISO8583Validator
+from iso8583sim.core.types import ISO8583Message
+
+# Build a message
+builder = ISO8583Builder()
+message = ISO8583Message(
+    mti="0100",
+    fields={
+        0: "0100",
+        2: "4111111111111111",
+        3: "000000",
+        4: "000000001000",
+        11: "123456",
+        41: "TERM0001",
+        42: "MERCHANT123456 ",
+    }
+)
+raw = builder.build(message)
+
+# Parse a message
+parser = ISO8583Parser()
+parsed = parser.parse(raw)
+
+# Validate a message
+validator = ISO8583Validator()
+errors = validator.validate_message(parsed)
+```
+
+### CLI Usage
+
+```bash
+# Parse a message
+iso8583sim parse "0100..." --version 1987
+
+# Build a message
+iso8583sim build --mti 0100 --fields fields.json
+
+# Validate a message
+iso8583sim validate "0100..."
+
+# Generate sample messages
+iso8583sim generate --type auth --pan 4111111111111111 --amount 1000
+```
+
+## Interactive Notebooks
+
+Learn ISO 8583 with our Jupyter notebooks:
+
+| Notebook | Description |
+|----------|-------------|
+| [01_getting_started.ipynb](notebooks/01_getting_started.ipynb) | Basic concepts and quick start |
+| [02_parsing_messages.ipynb](notebooks/02_parsing_messages.ipynb) | Deep dive into message parsing |
+| [03_building_messages.ipynb](notebooks/03_building_messages.ipynb) | Building various message types |
+| [04_network_specifics.ipynb](notebooks/04_network_specifics.ipynb) | VISA, Mastercard, and other networks |
+| [05_emv_data.ipynb](notebooks/05_emv_data.ipynb) | Working with EMV/chip card data |
+| [06_benchmarking.ipynb](notebooks/06_benchmarking.ipynb) | Performance testing and benchmarks |
+
+Run locally:
+```bash
+pip install jupyter
+jupyter notebook notebooks/
+```
+
+## Performance
+
+Benchmarks on Apple Silicon (M-series), Python 3.12:
+
+| Operation | Pure Python | With Cython |
+|-----------|-------------|-------------|
+| Parse | ~105k TPS | ~182k TPS |
+| Build | ~150k TPS | ~150k TPS |
+| Roundtrip | ~49k TPS | ~63k TPS |
+
+See [benchmarks/BASELINE.md](benchmarks/BASELINE.md) for detailed results.
+
+## Documentation
+
+Full documentation is available at **[iso8583.subhadipmitra.com](https://iso8583.subhadipmitra.com)**
+
+- [Getting Started](https://iso8583.subhadipmitra.com/getting-started/quickstart/) - Quick start guide
+- [Architecture](https://iso8583.subhadipmitra.com/architecture/overview/) - System design and decisions
+- [API Reference](https://iso8583.subhadipmitra.com/api/core/) - Complete API documentation
+- [Performance Guide](https://iso8583.subhadipmitra.com/performance/) - Optimization techniques
+
+## Development
+
+```bash
+# Clone and setup
+git clone https://github.com/bassrehab/ISO8583-Simulator.git
+cd iso8583sim
+python -m venv .venv
+source .venv/bin/activate
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Run benchmarks
+python benchmarks/bench_parser.py
+python benchmarks/bench_roundtrip.py
+```
+
+## Contributing
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/my-feature`)
+3. Commit your changes (`git commit -am 'Add new feature'`)
+4. Push to the branch (`git push origin feature/my-feature`)
+5. Create a Pull Request
+
+## Author
+
+**Subhadip Mitra** - [subhadipmitra.com](https://subhadipmitra.com)
+
+- GitHub: [@bassrehab](https://github.com/bassrehab)
+- LinkedIn: [subhadipmitra](https://linkedin.com/in/subhadipmitra)
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.