Metadata-Version: 2.4
Name: pathao
Version: 0.1.3
Summary: Python SDK for Pathao Courier Merchant API
Home-page: https://github.com/mojnomiya/pathao-python
Author: Md Mojno Miya
Author-email: Md Mojno Miya <your.email@example.com>
License: MIT
Project-URL: Homepage, https://github.com/mojnomiya/pathao-python
Project-URL: Documentation, https://mojnomiya.github.io/pathao-python/
Project-URL: Repository, https://github.com/mojnomiya/pathao-python.git
Project-URL: Bug Tracker, https://github.com/mojnomiya/pathao-python/issues
Keywords: pathao,courier,shipping,logistics,api
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
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: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.28.0
Requires-Dist: python-dotenv>=0.21.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0; extra == "dev"
Requires-Dist: pytest-mock>=3.10; extra == "dev"
Requires-Dist: black>=22.0; extra == "dev"
Requires-Dist: flake8>=4.0; extra == "dev"
Requires-Dist: mypy>=0.990; extra == "dev"
Requires-Dist: sphinx>=5.0; extra == "dev"
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# Pathao Python SDK

[![Tests](https://github.com/mojnomiya/pathao-python/workflows/Tests/badge.svg)](https://github.com/mojnomiya/pathao-python/actions)
[![Code Quality](https://github.com/mojnomiya/pathao-python/workflows/Code%20Quality/badge.svg)](https://github.com/mojnomiya/pathao-python/actions)
[![PyPI version](https://badge.fury.io/py/pathao.svg)](https://badge.fury.io/py/pathao)
[![Python versions](https://img.shields.io/pypi/pyversions/pathao.svg)](https://pypi.org/project/pathao/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Documentation](https://img.shields.io/badge/docs-GitHub%20Pages-blue)](https://mojnomiya.github.io/pathao-python/)

A comprehensive Python SDK for the Pathao Courier Merchant API. This package provides a clean, Pythonic interface to integrate Pathao's courier services into your Python applications.

## Features

-  OAuth 2.0 authentication with automatic token refresh
-  Type hints throughout the codebase
-  Comprehensive input validation
-  Detailed error messages
-  Support for both Sandbox and Production environments
-  Batch operations support
-  Extensive documentation and examples

## Installation

```bash
pip install pathao
```

## Quick Start

```python
from pathao import PathaoClient

# Initialize the client
client = PathaoClient(
    client_id="your_client_id",
    client_secret="your_client_secret",
    username="your_email",
    password="your_password",
    environment="sandbox"  # Use "production" for live
)

# Create an order
order = client.orders.create(
    store_id=1,
    recipient_name="John Doe",
    recipient_phone="01712345678",
    recipient_address="House 123, Road 4, Dhaka",
    delivery_type=48,  # Normal delivery
    item_type=2,  # Parcel
    item_quantity=1,
    item_weight=0.5,
    amount_to_collect=0
)

print(f"Order created: {order.consignment_id}")
```

## Documentation

- [📚 **Complete Documentation**](https://mojnomiya.github.io/pathao-python/)
- [Installation Guide](https://mojnomiya.github.io/pathao-python/installation/)
- [Authentication](https://mojnomiya.github.io/pathao-python/authentication/)
- [Store Management](https://mojnomiya.github.io/pathao-python/store_management/)
- [Order Management](https://mojnomiya.github.io/pathao-python/order_management/)
- [Location Services](https://mojnomiya.github.io/pathao-python/location_services/)
- [Price Calculation](https://mojnomiya.github.io/pathao-python/price_calculation/)
- [Error Handling](https://mojnomiya.github.io/pathao-python/error_handling/)
- [API Reference](https://mojnomiya.github.io/pathao-python/api_reference/)

## Requirements

- Python 3.8 or higher
- `requests>=2.28.0`
- `python-dotenv>=0.21.0`

## Development

```bash
# Clone the repository
git clone https://github.com/mojnomiya/pathao-python.git
cd pathao-python

# Install development dependencies
pip install -r requirements-dev.txt

# Run tests
pytest

# Format code
black pathao tests

# Type checking
mypy pathao
```

## Contributing

We welcome contributions! Please see our [Contributing Guidelines](CONTRIBUTING.md) for details.

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## Support

- [GitHub Issues](https://github.com/mojnomiya/pathao-python/issues)
- [Documentation](https://mojnomiya.github.io/pathao-python/)

## Changelog

See [CHANGELOG.md](CHANGELOG.md) for a list of changes and releases.
