Metadata-Version: 2.5
Name: paac
Version: 0.1.0
Summary: Python for Accounts, Audit & Compliance: practical helpers for Indian CA workflows
Project-URL: Homepage, https://github.com/mbrinda2189/PAAC
Author: Mary Brinda John Wilson
License: MIT
License-File: LICENSE
Keywords: accounting,audit,gst,income-tax,india,reconciliation
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Office/Business :: Financial :: Accounting
Requires-Python: >=3.9
Provides-Extra: data
Requires-Dist: openpyxl; extra == 'data'
Requires-Dist: pandas>=1.5; extra == 'data'
Provides-Extra: dev
Requires-Dist: pytest; extra == 'dev'
Description-Content-Type: text/markdown

# PAAC — Python for Accounts, Audit & Compliance

Practical Python helpers for Indian accounting, audit and tax compliance work:
Indian number formatting, financial year logic, PAN and GSTIN checks, invoice
normalisation, and (coming soon) reconciliation and audit analytics.

Built alongside the LinkedIn series **"The CA's Python Notebook: 20 Real Problems from Practice."**

## Install

```bash
pip install paac
```

## Quick start

```python
from datetime import date
from paac import format_inr, fy_details, check_pan, is_valid_gstin, normalise_invoice

format_inr(1234567.5)              # '₹12,34,567.50'
fy_details(date(2026, 3, 31))      # ('2025-26', '2026-27', 'Q4')
check_pan("AAACX1234Z")            # 'Company'
is_valid_gstin("27AAPFU0939F1ZV")  # True
normalise_invoice("INV/001")       # 'INV1'
```

## Roadmap

| Week | Module | Status |
|---|---|---|
| 1 | Formatting, dates, PAN/GSTIN, invoice normalisation | ✅ v0.1 |
| 2 | Reconciliation: GSTR-2B, 26AS/AIS, bank, payment gateways | Planned |
| 3 | Audit analytics: JE testing, Benford, 43B(h) ageing, Schedule III ratios | Planned |
| 4 | Tally XML, PDF extraction, document generation | Planned |

## Important

- PAN and GSTIN checks confirm **format only**, not that an identifier exists or is active.
- Outputs are aids to professional review, not conclusions. Verify results against source records.
- PAAC processes data locally and sends nothing anywhere.
- Tax rules change; check the changelog and the law in force before relying on any rule-based function.

## Contributing

Issues and suggestions from fellow professionals are welcome. Please use synthetic data only;
never include client information in issues, tests or pull requests.

## License

MIT
