Spis Zadań Domowych

Spis Zadań Domowych to bot na platformę Discord, służący do wygodnego zapisu szkolnych zadań domowych i ich wyświetlania.

Instalacja

Spis pisany jest pod Pythona 3.10, więc niekoniecznie będzie działał na poprzednich wersjach.

Bot jest przygotowany do hostowania na fly.io (patrz: branch) lub Heroku, aczkolwiek można go też zainstalować manualnie:

$ git clone https://github.com/Kacper0510/SpisZadanDomowych
$ cd SpisZadanDomowych
$ python -m pip install -r requirements.txt

Należy następnie ustawić zmienne środowiskowe:

Spis_Token = string z Discordowym tokenem
Spis_Dev = opcjonalne; ID serwera, na którym rejestrowane są komendy developerskie
Spis_Autosave = opcjonalne; prawda|fałsz (domyślnie: prawda)
Spis_LogLevel = opcjonalne; DEBUG|INFO|WARNING|ERROR|CRITICAL (domyślnie: INFO)

Można także edytować następujące pliki do zmiany innych ustawień:

• bot.py - klasa StanBota, pole edytor
• styl.py - zmiana domyślnego stylu wyświetlania
• przedmiot.py - lista przedmiotów szkolnych

Wszystko gotowe! Uruchom bota za pomocą:

$ python -m spis

Komendy

Globalne

/spis

/info

Dla edytorów

/dodaj zadanie

/dodaj ogloszenie

/edytuj zadanie

/edytuj ogloszenie

/usun

Dla developera

/dev zapisz

/dev wczytaj

Format daty

Data/godzina przekazywana do bota np. w komendzie /dodaj_zadanie zamieniana jest na obiekt typu datetime przez moduł dateutil.parser. Dzięki temu większość polskich formatów dat zostaje przyjęta i poprawnie zamieniona.

Użytkownik może podać datę, godzinę, dzień tygodnia lub kilka z tych rzeczy naraz. W przypadku niejednoznacznych dat (np. 01.02.03), domyślny format to DD.MM.RR.

Dozwolone jest także użycie słowa jutro.

Dozwolone oznaczenia miesięcy

Numer	Skrót	Odmieniona nazwa	Pełna nazwa	Cyfra rzymska
01	sty	stycznia	styczeń styczen	I
02	lut	lutego	luty	II
03	mar	marca	marzec	III
04	kwi	kwietnia	kwiecień kwiecien	IV
05	maj	maja	maj	V
06	cze	czerwca	czerwiec	VI
07	lip	lipca	lipiec	VII
08	sie	sierpnia	sierpień sierpien	VIII
09	wrz	września wrzesnia	wrzesień wrzesien	IX
10	paź paz	października pazdziernika	październik pazdziernik	X
11	lis	listopada	listopad	XI
12	gru	grudnia	grudzień grudzien	XII

Dozwolone oznaczenia dni tygodnia

Numer	2-literowy skrót	Pełna nazwa	3-literowy skrót
1	pn po	poniedziałek poniedzialek	pon
2	wt	wtorek	wto
3	śr sr	środa sroda	śro sro
4	cz	czwartek	czw
5	pt pi	piątek piatek	pią pia
6	sb so	sobota	sob
7	nd ni	niedziela	nie ndz