Metadata-Version: 2.4
Name: ztx-calendar
Version: 2.3.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.30,<4.0
Requires-Dist: aiogram-i18n>=1.5,<2.0
Requires-Dist: alembic>=1.18.4,<2.0
Requires-Dist: apscheduler>=3.11.2,<4.0
Requires-Dist: dateparser>=1.3.0,<2.0
Requires-Dist: fluent-runtime>=0.4.0,<1.0
Requires-Dist: geopy>=2.4.1,<3.0
Requires-Dist: grapheme>=0.6.0,<1.0
Requires-Dist: platformdirs>=4.9.4,<5.0
Requires-Dist: psycopg[binary]>=3.3.3,<4.0
Requires-Dist: pydantic-settings>=2.13.1,<3.0
Requires-Dist: python-dateutil>=2.9.0.post0,<3.0
Requires-Dist: reena-meval>=1.1.2,<2.0
Requires-Dist: rich>=14.3.3,<15.0
Requires-Dist: sqlalchemy>=2.0.48,<3.0
Requires-Dist: sqlalchemy-utc>=0.14.0,<1.0
Requires-Dist: telethon>=1.42.0,<2.0
Requires-Dist: timezonefinder>=8.2.1,<9.0
Requires-Dist: typer-slim>=0.23.1,<1.0
Requires-Dist: uvloop>=0.22.1,<1.0
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
```