augint-billing-lib 1.0.0

Billing service library for API usage tracking and Stripe integration.

Augint Billing Library

Billing service library for API usage tracking, tiered pricing calculations, and Stripe integration.

Overview

This library provides the core business logic for:

• Tracking API usage per customer
• Calculating charges with tiered pricing models
• Managing Stripe customers and payments
• Processing webhooks from Stripe
• Generating usage and billing reports

📊 Live Dashboards

📖 Documentation	🧪 Unit Tests	🔬 Integration Tests	📊 Coverage	⚡ Benchmarks	🔒 Security	⚖️ Compliance

🔑 Key Development Characteristics

Characteristic	Details
Merge Strategy	Configurable (see .env)
Deployment Model	Tag-based to PyPI
Environments	Local → PyPI
Preview Environments	N/A (library)
Pipeline Features	Semantic release, Auto-publish to PyPI
Special Considerations	90% coverage requirement, Mutation testing

---

Project Structure

augint-billing-lib-library/
├── src/
│   └── augint_billing_lib/      # Core library code (to be implemented)
├── tests/                   # Test suite (to be implemented)
├── examples/                # Original template code for reference
├── pyproject.toml          # Project dependencies and configuration
├── Makefile                # Development commands
└── README.md               # This file

Development Setup

# Install dependencies
make install

# Run tests
make test

# Check code quality
make lint
make type-check

# Generate documentation
make docs

Implementation Status

This is a minimal template ready for implementation. The following components need to be built:

Library Exports (from planning spec)

• BillingService - Main service class
• UsageCollector - Track API usage
• PricingCalculator - Apply tiered pricing
• StripeManager - Stripe operations
• WebhookProcessor - Process Stripe webhooks
• ReportGenerator - Generate reports
• Data models (Customer, UsageRecord, BillingPeriod, etc.)

Key Features Removed (Minimal Version)

• ✅ Feature flags removed
• ✅ Telemetry/Sentry removed
• ✅ Mutation testing removed
• ✅ Complex CLI structures removed

Dependencies

Core dependencies:

• click - CLI framework
• boto3 - AWS SDK (to be added)
• stripe - Stripe SDK (to be added)
• pydantic - Data validation (to be added)

Testing

The project uses pytest with pragmatic coverage targets:

• Library code: 70% coverage target
• Focus on core business logic
• Integration tests for AWS/Stripe interactions

License

AGPL v3 - See LICENSE file for details