Paddle SDK

[!WARNING] The paddle module is deprecated and will be removed in a future version. Please use paddle.py instead. You will see a deprecation warning when using the old module.

A modern Python SDK for Paddle's API with type hints and async support.

Features

• 🚀 Synchronous and asynchronous client implementations
• 📦 Support for Paddle's API (in development)
• 🧩 Type hints throughout the codebase
• 🔄 Automatic retry mechanism for failed requests
• 🔧 Environment configuration (Sandbox/Production)
• 🛡️ Comprehensive error handling
• 📊 Extensive test coverage

Installation

pip install paddle-sdk

Quick Start

Synchronous Client

from paddle import Client, Environment

# Initialize the client
client = Client(
    api_key="API_KEY",
    environment=Environment.SANDBOX  # or Environment.PRODUCTION
)

# List products
products = client.products.list()
print(products)

# Get a specific product
product = client.products.get(product_id="pro_123456789")
print(product)

Asynchronous Client

import asyncio

from paddle.aio import AsyncClient
from paddle import Environment


async def main():
    async with AsyncClient(
        api_key="API_KEY",
        environment=Environment.SANDBOX,  # or Environment.PRODUCTION
    ) as client:
        # List products
        all_products = await client.products.list()
        print(all_products)

        # Get a product
        product = await client.products.get("pro_123456789")
        print(product)


if __name__ == "__main__":
    asyncio.run(main())

Development

Setup

1. Clone the repository:

git clone https://github.com/CCXLV/paddle-sdk.git
cd paddle-sdk

2. Create a virtual environment:

python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

3. Install development dependencies:

pip install -e .[dev]

Running Tests

# Run all tests
pytest

# Run with coverage
pytest --cov=paddle

Contributing

For detailed information on how to contribute to this project, please see our Contributing Guidelines.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Roadmap

See the CHANGELOG.md for planned API endpoints and features.