https://github.com/vadvergasov/hometaskbot

Telegram bot, which parses home task from schools.by
https://github.com/vadvergasov/hometaskbot

bot diary hometask html lxml python3 requests schools telegram telegram-bot webscraping

Last synced: 2 months ago
JSON representation

Telegram bot, which parses home task from schools.by

• Host: GitHub
• URL: https://github.com/vadvergasov/hometaskbot
• Owner: VadVergasov
• License: gpl-3.0
• Created: 2020-12-15T15:44:36.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2024-02-26T02:29:42.000Z (over 1 year ago)
• Last Synced: 2025-04-12T08:59:55.703Z (2 months ago)
• Topics: bot, diary, hometask, html, lxml, python3, requests, schools, telegram, telegram-bot, webscraping
• Language: Python
• Homepage:
• Size: 506 KB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
HometaskBot

[![License](https://img.shields.io/github/license/VadVergasov/HometaskBot)](https://github.com/VadVergasov/HometaskBot/blob/master/LICENSE)

[![Stars](https://img.shields.io/github/stars/VadVergasov/HometaskBot)](https://github.com/VadVergasov/HometaskBot/stargazers)

![Codestyle](https://img.shields.io/badge/code%20style-black-000000.svg)

===========

Simple to use Telegram bot, that can send hometask from schools.by, belorussian e-diary platform.

Setup

-----------

```bash

git clone https://github.com/VadVergasov/HometaskBot.git

cd HometaskBot

python3 -m venv bot-env

bot-env\Scripts\activate.bat # For Windows.

source bot-env/bin/activate # For Linux and MacOS

pip install -r requirements.txt

```

Copy config.py.template to config.py insert all required values (example can be found in examples folder), then run by

```bash

python3 main.py

```

Basic usage

-----------

How to login: type `/login`. Bot will reply to this command with a message. You should reply to bot's message with your credentials in format `username password`. This will save your token and let you use the bot.

To get hometask, you should type `/hometask`. That will return button list with days in week. First and last buttons used to switch previous/upcoming weeks accordingly.

`/set` command is useful for using bot in group chat. Typing this command will link the group's diary to the diary of the person who sent the command. *Note. Person, who sent the command should have token, registered in bot (in simple words, logged into the bot)*

`/marks` command will give you all marks in current quarter.

`/select` is command for parents for selecting pupil.

License

-----------

Licensed under GPLv3. See LICENSE file.