# Visa Clearing File Parser
A Python library for parsing Visa BASE II Clearing Transaction Files (.ctf).
## 📥 Installation
### From PyPI
```bash
pip install visa-clearing-file-parser
```
### From Source
```bash
git clone https://github.com/makafanpeter/visa-clearing-file-parser.git
cd visa-clearing-file-parser
pip install -e .
```
### 🔧 Quick Start
```python
from visa_clearing import VisaBaseIIParser
# Initialize parser
parser = VisaBaseIIParser()
# Parse file and iterate through transactions
for transaction in parser.parse_file('transactions.ctf'):
print(f"Transaction: {transaction['Transaction Description']}")
print(f"Amount: {transaction.get('Source Amount', 'N/A')}")
print(f"Merchant: {transaction.get('Merchant Name', 'N/A')}")
print("-" * 40)
```
### 💻 CLI Usage
```bash
# Parse a file and display summary
visa-clearing-parser parse transactions.ctf --format summary
# Output as JSON
visa-clearing-parser parse transactions.ctf --format json --output results.json
# Show parser information
visa-clearing-parser info --verbose
```
### 📋 Supported Transaction Types
- Sales Draft
- Credit Voucher
- Cash Disbursement
- Chargeback, Sales Draft
- Chargeback, Credit Voucher
- Reversal, Sales Draft
### 🛠️ Development
```bash
# Clone the repository
git clone https://github.com/makafanpeter/visa-clearing-file-parser.git
cd visa-clearing-file-parser
# Install in development mode
pip install -e ".[dev]"
# Run tests
pytest tests/
# Run linting
black src/ tests/
flake8 src/ tests/
```
### 🤝 Contributing
1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request
Raw data
{
"_id": null,
"home_page": "https://github.com/makafanpeter/visa-clearing-file-parser",
"name": "visa-clearing-file-parser",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "visa, clearing, payment, transaction, finance, baseii",
"author": "Peter Dev",
"author_email": "Peter Dev <706435+makafanpeter@users.noreply.github.com>",
"download_url": "https://files.pythonhosted.org/packages/09/46/45fe16e9d4c70d8e4682ae1587033fb36b7e6a981f0e61e88d7044de1e57/visa_clearing_file_parser-0.0.1.tar.gz",
"platform": null,
"description": "# Visa Clearing File Parser\n\nA Python library for parsing Visa BASE II Clearing Transaction Files (.ctf).\n\n\n\n\n## \ud83d\udce5 Installation\n\n### From PyPI\n```bash\npip install visa-clearing-file-parser\n```\n\n### From Source\n```bash\ngit clone https://github.com/makafanpeter/visa-clearing-file-parser.git\ncd visa-clearing-file-parser\npip install -e .\n```\n\n### \ud83d\udd27 Quick Start\n```python\nfrom visa_clearing import VisaBaseIIParser\n\n# Initialize parser\nparser = VisaBaseIIParser()\n\n# Parse file and iterate through transactions\nfor transaction in parser.parse_file('transactions.ctf'):\n print(f\"Transaction: {transaction['Transaction Description']}\")\n print(f\"Amount: {transaction.get('Source Amount', 'N/A')}\")\n print(f\"Merchant: {transaction.get('Merchant Name', 'N/A')}\")\n print(\"-\" * 40)\n```\n\n### \ud83d\udcbb CLI Usage\n```bash\n# Parse a file and display summary\nvisa-clearing-parser parse transactions.ctf --format summary\n\n# Output as JSON\nvisa-clearing-parser parse transactions.ctf --format json --output results.json\n\n# Show parser information\nvisa-clearing-parser info --verbose\n```\n\n### \ud83d\udccb Supported Transaction Types\n- Sales Draft\n- Credit Voucher\n- Cash Disbursement\n- Chargeback, Sales Draft\n- Chargeback, Credit Voucher\n- Reversal, Sales Draft\n\n### \ud83d\udee0\ufe0f Development\n```bash\n# Clone the repository\ngit clone https://github.com/makafanpeter/visa-clearing-file-parser.git\ncd visa-clearing-file-parser\n\n# Install in development mode\npip install -e \".[dev]\"\n\n# Run tests\npytest tests/\n\n# Run linting\nblack src/ tests/\nflake8 src/ tests/\n```\n### \ud83e\udd1d Contributing\n1. Fork the repository\n2. Create a feature branch (git checkout -b feature/amazing-feature)\n3. Commit your changes (git commit -m 'Add amazing feature')\n4. Push to the branch (git push origin feature/amazing-feature)\n5. Open a Pull Request\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A Python library for parsing Visa BASE II Clearing Transaction Files",
"version": "0.0.1",
"project_urls": {
"Bug Tracker": "https://github.com/makafanpeter/visa-clearing-file-parser/issues",
"Homepage": "https://github.com/makafanpeter/visa-clearing-file-parser",
"Repository": "https://github.com/makafanpeter/visa-clearing-file-parser.git"
},
"split_keywords": [
"visa",
" clearing",
" payment",
" transaction",
" finance",
" baseii"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "6d3f0bf1efbc7e50af351854d945776208868747ce4a348ffb490a3db75a26e3",
"md5": "b9a24fb59480b934770b64b4243d1fdd",
"sha256": "eada08573cea9d18399717948516714276049e6bfafe5a0b66ff00ea6cea29cb"
},
"downloads": -1,
"filename": "visa_clearing_file_parser-0.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b9a24fb59480b934770b64b4243d1fdd",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 9924,
"upload_time": "2025-09-03T14:19:17",
"upload_time_iso_8601": "2025-09-03T14:19:17.291341Z",
"url": "https://files.pythonhosted.org/packages/6d/3f/0bf1efbc7e50af351854d945776208868747ce4a348ffb490a3db75a26e3/visa_clearing_file_parser-0.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "094645fe16e9d4c70d8e4682ae1587033fb36b7e6a981f0e61e88d7044de1e57",
"md5": "a0f9b1a9e6436b825d1ee4c131ebd4ee",
"sha256": "439bcf322dbffa25192f3f69e85a2827304eeb14da60567f94378f3ff21285c7"
},
"downloads": -1,
"filename": "visa_clearing_file_parser-0.0.1.tar.gz",
"has_sig": false,
"md5_digest": "a0f9b1a9e6436b825d1ee4c131ebd4ee",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 14909,
"upload_time": "2025-09-03T14:19:18",
"upload_time_iso_8601": "2025-09-03T14:19:18.293734Z",
"url": "https://files.pythonhosted.org/packages/09/46/45fe16e9d4c70d8e4682ae1587033fb36b7e6a981f0e61e88d7044de1e57/visa_clearing_file_parser-0.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-03 14:19:18",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "makafanpeter",
"github_project": "visa-clearing-file-parser",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "visa-clearing-file-parser"
}
JSON
