Metadata-Version: 2.4
Name: clovord.py
Version: 0.1.10.dev6
Summary: Official Python library for the Clovord platform.
Project-URL: Homepage, https://clovord.com
Project-URL: Documentation, https://clovord.com/developers/docs
Project-URL: Repository, https://github.com/Clovord/Library---py---clovord.py
Author: Clovord
License-Expression: MIT
License-File: LICENSE
Keywords: api,clovord,sdk
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries
Classifier: Typing :: Typed
Requires-Python: >=3.10
Requires-Dist: aiohttp>=3.9.0
Provides-Extra: dev
Requires-Dist: build>=1.2.2; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: ruff>=0.6.0; extra == 'dev'
Requires-Dist: twine>=5.1.0; extra == 'dev'
Description-Content-Type: text/markdown

# clovord

A Python SDK for interacting with the Clovord Gateway and REST API.

## Installation

```bash
pip install clovord
```

For local development:

```bash
pip install -e .[dev]
```

## Usage

```python
import clovord
from clovord import Bot
import json


intents = clovord.Intents.default()
intents.members = True
intents.messages = True
intents.presence = True

bot = Bot(intents=intents)

@bot.event
async def on_ready():
    print("READY EVENT FIRED")

@bot.event
async def on_ready_payload(data):
    print("READY PAYLOAD:")
    print(json.dumps(data, indent=2, ensure_ascii=False))

bot.run("YourBotToken") 
```

## Overview

- `Bot` is the main entrypoint.
- The Gateway connection is handled internally with heartbeat and reconnect support.
- The REST client is asynchronous and available through `bot.http`.

<!-- latest-release-notes:start -->
## Latest Release Notes
Version: `0.1.10dev2`
Last commit: `feat: Added presence_update event handling`

### Added
- Added presence_update event handling

### Fixed
- use constant for internal event name in message_create handler feat: add presence_update event

See full history in CHANGELOG.md.
<!-- latest-release-notes:end -->
