Metadata-Version: 2.4
Name: ledgerbill-sdk
Version: 0.1.4
Summary: Official Python client for LedgerBill API
Project-URL: Homepage, https://ledgerbill.app
Project-URL: Repository, https://github.com/no1rstack/ledgerbill-sdk.git
Project-URL: Issues, https://noirstack.com/support
Project-URL: NPM, https://www.npmjs.com/package/@noirstack/ledgerbill-sdk
Project-URL: VS Code Marketplace, https://marketplace.visualstudio.com/items?itemName=LedgerBill.ledgerbill
Author: Noir Stack LLC
Maintainer: Noir Stack LLC
License-Expression: MIT
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: requests>=2.32.0
Description-Content-Type: text/markdown

# ledgerbill-sdk

Official Python SDK scaffold for LedgerBill.

The SDK aligns to the canonical OpenAPI source (`src/openapi.ts`) served at `/api/openapi.json`.

## Package listings

- npm: https://www.npmjs.com/package/@noirstack/ledgerbill-sdk
- PyPI: https://pypi.org/project/ledgerbill-sdk/
- VS Code Marketplace: https://marketplace.visualstudio.com/items?itemName=LedgerBill.ledgerbill
- Website: https://ledgerbill.app

## Install (local)

```bash
pip install -e sdk/python
```

## Usage

```python
from ledgerbill_sdk import LedgerBillClient

client = LedgerBillClient(
    base_url="http://localhost:3107",
    tenant_id="tenant_123",
    api_key="lb_your_api_key"
)

plans = client.get_pricing_plans()
preview = client.preview_usage(
    customer_id="cus_123",
    feature_key="events_processed",
    amount=1000,
)
```

## Contract governance

The public API taxonomy expected in `/api/openapi.json` is:

- `Tenant Administration`
- `Billing Operations`
- `Developer APIs`
- `Stripe Integration`
- `Policy Administration`
- `Audit & Governance`
- `Replay Operations`

## Support

- Issues and support: https://noirstack.com/support
