Metadata-Version: 2.4
Name: parsepesa
Version: 1.0.0
Summary: Official Python SDK for ParsePesa - The M-Pesa SMS Parsing API
Home-page: https://parsepesa.nexoracreatives.co.ke
Author: Nexora Creative Solutions
Author-email: info@nexoracreatives.co.ke
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.25.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license
Dynamic: license-file
Dynamic: requires-dist
Dynamic: summary

# ParsePesa Python SDK

Official Python client for the [ParsePesa](https://parsepesa.nexoracreatives.co.ke) API. Convert raw M-Pesa SMS notifications into structured JSON data instantly.

## Installation

```bash
pip install parsepesa
```

## Quick Start

```python
from parsepesa import ParsePesa

# Initialize the client
client = ParsePesa("your_api_key_here")

# Parse a single message
raw_sms = "Confirmed. Ksh500.00 sent to NEWTON MWANGI on 12/05/26 at 2:30 PM. Transaction ID: RKL8923ZXC."
result = client.parse(raw_sms)

if result['success']:
    data = result['data']
    print(f"Transaction ID: {data['transaction_id']}")
    print(f"Amount: {data['amount']} {data['currency']}")
    print(f"Type: {data['type']}")
```

## Features
- **Single Parsing**: Convert one SMS to JSON.
- **Batch Parsing**: Process up to 50 messages in a single request.
- **Robust Engine**: Handles standard M-Pesa, Till, Paybill, and Merchant formats.
- **AI Fallback**: Automatically uses Gemini-powered parsing for complex or non-standard messages.

## Documentation
For full API documentation, visit [parsepesa.nexoracreatives.co.ke/docs](https://parsepesa.nexoracreatives.co.ke/docs).

---
© 2026 Nexora Creative Solutions
