Metadata-Version: 2.5
Name: ghostecos-api
Version: 0.1.0a1
Summary: Python SDK for the GhostEcos API.
Author: GhostEcos
Keywords: api,ghostapi,ghostchat,ghostecos,sdk
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
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: Typing :: Typed
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# ghostecos-api

Python SDK for the GhostEcos API.

The project distribution name is `ghostecos-api`; the Python import name is
`ghostapi`:

```bash
pip install ghostecos-api
```

```python
import ghostapi

print(ghostapi.__version__)
```

## Status

This is the initial package stub (`0.1.0a1`). The first public namespace is
the GhostChat Bot API:

```python
from ghostapi import ghostbot

bot = ghostbot.Bot(token="YOUR_BOT_TOKEN")

@bot.command("/start")
def start(update):
    return "Привет!"

bot.run()
```

The first client supports `get_me()`, `get_updates()`, `send_message()`,
long-polling through `poll()`/`run()`, command handlers, and a fallback
`on_message()` handler. The default API URL is
`https://ghostecos.duckdns.org`; pass `base_url` to use another GhostChat
server.

The package will keep transport, authentication, typed models, and service
modules separate so adding a new GhostEcos API does not require rewriting the
bot layer.

## Local development

From this directory:

```bash
python -m pip install -e .
python -m pytest
```

## Name mapping

| Layer | Name |
| --- | --- |
| Product / brand | GhostAPI |
| Python distribution | `ghostecos-api` |
| Python import | `ghostapi` |
