Metadata-Version: 2.4
Name: ztx-calendar
Version: 2.2.0
Summary: Calendar Telegram Bot
Keywords: telegram,telegram-bot,aiogram,calendar,docker,docker-compose
Author: zxcdiana, zeticsce
License-Expression: GPL-3.0-only
License-File: LICENSE
Classifier: Development Status :: 5 - Production/Stable
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3
Classifier: Typing :: Typed
Classifier: Environment :: Console
Classifier: Framework :: AsyncIO
Classifier: Topic :: Communications :: Chat
Requires-Dist: aiogram~=3.23
Requires-Dist: aiogram-i18n~=1.5
Requires-Dist: alembic~=1.18.4
Requires-Dist: apscheduler~=3.11.2
Requires-Dist: dateparser~=1.3.0
Requires-Dist: fluent-runtime~=0.4.0
Requires-Dist: geopy~=2.4.1
Requires-Dist: grapheme~=0.6.0
Requires-Dist: platformdirs~=4.9.4
Requires-Dist: psycopg[binary]~=3.3.3
Requires-Dist: pydantic-settings~=2.13.1
Requires-Dist: python-dateutil~=2.9.0.post0
Requires-Dist: reena-meval~=1.1.2
Requires-Dist: rich~=14.3.3
Requires-Dist: sqlalchemy~=2.0.48
Requires-Dist: sqlalchemy-utc~=0.14.0
Requires-Dist: telethon~=1.42.0
Requires-Dist: timezonefinder~=8.2.1
Requires-Dist: typer-slim~=0.23.1
Requires-Dist: uvloop~=0.22.1
Requires-Python: >=3.12
Project-URL: Homepage, https://codeberg.org/zxcdiana/ztx-calendar
Project-URL: Repository, https://codeberg.org/zxcdiana/ztx-calendar
Project-URL: Issues, https://codeberg.org/zxcdiana/ztx-calendar/issues
Project-URL: Telegram Bot, https://t.me/ztx_calendar_bot
Project-URL: Author, https://t.me/zxcdiana
Description-Content-Type: text/markdown

# Project info:
- Name: `ztx-calendar`
- Bot: https://t.me/ztx_calendar_bot
- Author: https://t.me/zxcdiana


---


# Command line interface
Get help:
```bash
ztx-calendar --help
```

---


# Configuration
Configuration based on environment variables or a `.env` file
You can use the `.env.template` file as a template


---


# Environment variables
- BOT_TOKEN: `str` — Telegram bot token
- OWNERS: `list[int]` — Telegram user IDs of bot owners
- POSTGRES_URL: `str` — PostgreSQL connection URL (format: `postgresql://<USER>:<PASSWORD>@<HOST>/<DATABASE>`)


---


# Installation
1. Create PostgreSQL database
2. Create a `.env` file and set the required variables (`BOT_TOKEN`, `OWNERS`, `POSTGRES_URL`)
3. Install to python environment:
```bash
pip install ztx-calendar
```
4. Run:
```bash
ztx-calendar bot
```


---


# Docker Compose
1. Create a .env file and set the required variables (BOT_TOKEN, OWNERS)
2. Run:
```bash
docker compose up
```