Metadata-Version: 2.4
Name: syeedalireza-billcycle
Version: 1.0.1
Summary: Subscription & Usage-based Billing Engine
Author-email: Alireza Aminzadeh <syeedalireza@yahoo.com>
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: fastapi==0.110.0
Requires-Dist: uvicorn[standard]==0.27.1
Requires-Dist: pydantic==2.6.3
Requires-Dist: pydantic-settings==2.2.1
Requires-Dist: sqlalchemy==2.0.29
Requires-Dist: asyncpg==0.29.0
Requires-Dist: pytest==8.1.1
Requires-Dist: pytest-asyncio==0.23.5
Requires-Dist: httpx==0.27.0

# BillCycle: Subscription & Usage-based Billing Engine

**BillCycle** handles complex recurring billing, plan upgrades/downgrades, and usage metering for SaaS and subscription box e-commerce.

Developed by **Alireza Aminzadeh** ([@syeedalireza](https://github.com/syeedalireza)).

## Architecture
- **API:** FastAPI
- **Database:** PostgreSQL (SQLAlchemy)
- **Background Jobs:** Celery Beat
- **Pattern:** State Machine Pattern, Event Sourcing

*(Technical implementation pending in next iteration)*
