Metadata-Version: 2.3
Name: yango-tech-grocery-client
Version: 0.1.3
Summary: A Python client library for interacting with the Yango Tech Grocery API
License: MIT
Keywords: yango,grocery,api,client,delivery,ecommerce
Requires-Python: >=3.9,<4.0
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: aiohttp (>=3.12.0,<4.0.0)
Requires-Dist: dacite (>=1.9.0,<2.0.0)
Requires-Dist: yarl (>=1.8.0,<2.0.0)
Project-URL: Bug Tracker, https://github.com/yango-tech/yango-tech-grocery-client/issues
Project-URL: Documentation, https://github.com/yango-tech/yango-tech-grocery-client#readme
Project-URL: Homepage, https://github.com/yango-tech/yango-tech-grocery-client
Project-URL: Repository, https://github.com/yango-tech/yango-tech-grocery-client
Description-Content-Type: text/markdown

# Yango Tech Grocery API Client

A Python client library for interacting with the Yango Tech Grocery API. This library provides a comprehensive interface for managing orders, products, prices, stocks, and other grocery-related operations.

## Features

- **Order Management**: Create, update, cancel, and track orders
- **Product Management**: Create and update products, manage product media and VAT
- **Price Management**: Handle price lists, prices, and discounts
- **Stock Management**: Update and retrieve stock information
- **Store Management**: Get store information
- **Receipt Management**: Upload and retrieve receipts
- **Event Handling**: Process order events and state changes
- **Async Support**: Full async/await support for all operations
- **Error Handling**: Comprehensive error handling with retry logic

## Installation

```bash
pip install yango-grocery-client
```

## Quick Start

### Basic Setup

```python
import asyncio
from yango_grocery_client import YangoClient

async def main():
    # Initialize the client
    client = YangoClient(
        domain="https://api.retailtech.yango.com",
        auth_token="your_auth_token_here"
    )
    
    # Your API calls here
    stores = await client.get_stores()
    print(f"Found {len(stores)} stores")

# Run the async function
asyncio.run(main())
```

For comprehensive examples, see [EXAMPLES.md](EXAMPLES.md).

## Configuration

### Client Initialization Options

```python
client = YangoClient(
    domain="https://api.retailtech.yango.com",  # API domain
    auth_token="your_auth_token",           # Authentication token
    error_handler=custom_error_handler,     # Optional custom error handler
    proxy="http://proxy.example.com:8080"   # Optional proxy configuration
)
```

### Environment Variables

You can also configure the client using environment variables:

```bash
export YANGO_DOMAIN="https://api.retailtech.yango.com"
export YANGO_AUTH_TOKEN="your_auth_token"
```

## Documentation

- **[EXAMPLES.md](EXAMPLES.md)** - Comprehensive usage examples
- **[DEVELOPMENT.md](DEVELOPMENT.md)** - Development and contribution guide
