Metadata-Version: 2.4
Name: WolfTg
Version: 0.1.1
Summary: Official Python SDK for the WolfTg API.
Project-URL: Homepage, https://github.com/eeeob/WolfTg
Project-URL: Repository, https://github.com/eeeob/WolfTg
Project-URL: Issues, https://github.com/eeeob/WolfTg/issues
Project-URL: API, https://wolf-tg.com/api/docs
Author-email: Abdullah <aldheeb01@gmail.com>
License: MIT
License-File: LICENSE
Keywords: api,asyncio,client,sdk,telegram,telegram-api,wolf-tg,wolftg
Classifier: Development Status :: 4 - Beta
Classifier: Framework :: AsyncIO
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Internet
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.12
Requires-Dist: aiohttp[speedups]<4.0,>=3.9
Requires-Dist: aldheeb-pytools[country,phone]>=0.2.15
Requires-Dist: pydantic<3.0,>=2.7
Requires-Dist: requests<3.0,>=2.32
Provides-Extra: dev
Requires-Dist: hatch<2.0,>=1.16; extra == 'dev'
Requires-Dist: twine<7.0,>=6.1; extra == 'dev'
Description-Content-Type: text/markdown

# WolfTg

Official Python SDK for the **WolfTg API**.

WolfTg provides a simple and modern interface for interacting with the WolfTg API from Python applications. The library includes both synchronous and asynchronous clients with fully typed request models powered by Pydantic.

## Features

* Official WolfTg API client
* Synchronous and asynchronous interfaces
* Type-safe request models
* Built-in request validation using Pydantic
* Configurable HTTP sessions
* Connection pooling
* Easy integration into existing Python projects

## Requirements

* Python 3.12 or newer

## Installation

```bash
pip install WolfTg
```

## Quick Start

### Synchronous Client

```python
from WolfTg import Client
from WolfTg.methods import GetBalance

with Client(api_key="YOUR_API_KEY") as client:
    result = client(GetBalance())
    print(result)

```

### Asynchronous Client

```python
import asyncio

from WolfTg import AsyncClient
from WolfTg.methods import GetBalance


async def main():
    client = AsyncClient(api_key="YOUR_API_KEY")

    await client.start()

    try:
        result = await client(GetBalance())
        print(result)
    finally:
        await client.stop()


asyncio.run(main())
```

## Configuration

The client can be configured with custom options such as:

* API key
* Request timeout
* HTTP session implementation
* Custom HTTP settings

Refer to the API documentation for all available options.

## Documentation

* API Documentation: https://wolf-tg.com/api/docs

## Support

If you encounter a bug or would like to request a feature, please open an issue on GitHub.

Repository:

https://github.com/eeeob/WolfTg

## License

This project is licensed under the MIT License (or the license included with this repository).
