ps-schedule

Python Version

⚠️ Це неофіційний, студентський проєкт, який витягує (парсить) розклад з пакету програм "ПС-Деканат", який використовується більшістю ВНЗ України.

Бібліотека буде працювати з більшостями доменів "ПС-Деканат". При розробці бібліотеки, функціонал тестувався на домені ІФНТУНГ, однак інші домени повинні також працювати.

Швидкий старт:

Встановлюємо бібліотеку з PyPI:

pip install ps-schedule

Отримуємо домен розкладу:

Для цього просто копіюємо ось цю частину посилання на розклад вашого ВНЗ:

Базовий код

Імпортуємо базові класи:

from ps_schedule import Schedule, ScheduleParameters

Вставляємо домен у поле domain класу Schedule та задаємо параметри для отримання розкладу групи:

schedule = Schedule(domain="https://dekanat.nung.edu.ua/", params=ScheduleParameters(group="ІП-24-1К")).get()

Обробляємо дані:

# Отримуємо розклад на сьогодні (перший у списку)
table = schedule[0]

# Виводимо дату таблиці розкладу на сьогодні в консоль
print(f"===| {table.date} |===")

# Проходимось по парам на сьогодні
for lesson in table.lessons:
    
    # Перевіряємо чи є пара
    if lesson.description:
        
        # Виписуємо в консоль час початку пари, час кінця пари і її опис.
        print(f"[{lesson.start_time} - {lesson.end_time}]: {lesson.description}")

Важливі нюанси:

Ця бібліотека використовує BeautifulSoup щоб парсити HTML з сторінки яку ви бачите коли заходите на розклад у браузері (тому що немає публічного API). Якщо якимось чудом структура HTML поміняється або навіть відрізняється конкретно у вашого ВНЗ, то можливо парсер не буде парсити (це мало вірогідно, зазвичай ПС-Розклад однаковий для всіх).

Дуже бажано не робити 1000 запитів на секунду, і робити тривалі паузи між ними, бо є два варіанти:

Ви покладете картоплину на якій ця чудо система працює.
Сервер вас пошле 403-м кодом.

Документація

Приємного користування 😊

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ps_schedule-1.3.tar.gz (7.6 kB view details)

Uploaded Sep 2, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

ps_schedule-1.3-py3-none-any.whl (8.5 kB view details)

Uploaded Sep 2, 2026 Python 3

File details

Details for the file ps_schedule-1.3.tar.gz.

File metadata

Download URL: ps_schedule-1.3.tar.gz
Upload date: Sep 2, 2026
Size: 7.6 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for ps_schedule-1.3.tar.gz
Algorithm	Hash digest
SHA256	`b08d88d4a4e0fac0bdd310f02107013fddd872838a502c9121be26ddb11bb498`
MD5	`ec2e4f25fe25ea77aaa85d684b11f66f`
BLAKE2b-256	`8453ff873b30d52006318465dd45238b50a8ea26880efa7fe7beed24027de922`

See more details on using hashes here.

Provenance

The following attestation bundles were made for ps_schedule-1.3.tar.gz:

Publisher: workflow.yml on olekstsu/ps-schedule

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: ps_schedule-1.3.tar.gz
- Subject digest: b08d88d4a4e0fac0bdd310f02107013fddd872838a502c9121be26ddb11bb498
- Sigstore transparency entry: 2686399109
- Sigstore integration time: Sep 2, 2026
Source repository:
- Permalink: olekstsu/ps-schedule@ed0493cd583c9e2b18e02c23429b7def88a530aa
- Branch / Tag: refs/tags/v1.3
- Owner: https://github.com/olekstsu
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: workflow.yml@ed0493cd583c9e2b18e02c23429b7def88a530aa
- Trigger Event: release