Skip to content

pentergust/pars-diary

 
 

Repository files navigation

Pars diary (Telegram bot)

Ruff License: AGPL v3 GitHub Repo stars

Проект для упрощения жизни школьников. Позволяет просматривать информацию из школьного дневника.

Основные функции:

  • Автоматические уведомления об изменениях.
  • Просмотр текущих и итоговых оценок.
  • Совместимость с Bars API.

Бот запущен и вы можете пользоваться им здесь: @pars_diary_bot

Установка / Installation

Для того чтобы запустить бота локально.

  1. Клонируем репозиторий.
git clone https://github.com/iamlostshe/PARS-DIARY
cd PARS-DIARY
  1. копируем .env.dist в .env и заполняем поля.

  2. Устанавливаем зависимости и запускаем бота:

Через uv (рекомендуется)

Устанавливаем uv (если еще не установлен):

Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Устанавливаем зависимости:

uv sync

Компилируем перевод:

uv run pybabel compile -d locales -D messages

Запускаем бота:

uv run python -m pars_diary
Через venv + `requirements.txt`

Создаём виртуальное окружение:

python -m venv .venv

Активируем виртуальное окружение:

. .venv/bin/activate

Последняя команда для Windows:

.venv\Scripts\activate

Устанавливаем зависимости:

pip install -r requirements.txt

Компилируем перевод:

pybabel compile -d locales -D messages

Запускаем бота:

pip install -r requirements.txt

Для последующего запуска повторите шаги активация виртуального окружения (только для venv) и запуск бота.

Перевод / Translate

Бот может работать на нескольких языках.

Здесь будут примеры команд для uv. В случае venv, просто убираем uv run из команды.

Для начала извлекаем все переводимые строки:

uv run pybabel extract --input-dirs=. -o locales/messages.pot

Теперь, добавляем перевод для нужного языка. Например Русского (ru):

uv run pybabel init -i locales/messages.pot -d locales -D messages -l ru

Открываем файл locales/ru/LC_MESSAGES/messages.po и начинаем переводить все строки.

Ну и наконец, компилируем полученный перевод:

Поддержка / Contribute

Если вам понравился проект, можете отметить репозиторий звёздочкой.

При возникновении проблем/вопросов можете обращаться в issue.

Также вы можете сделать форк проекта со своими улучшениями.

About

Бот для удобного использования дневника и повышения успеваемости учащихся.

Topics

Resources

License

Stars

Watchers

Forks

Contributors

Languages

  • Python 100.0%