Metadata-Version: 2.1
Name: kunapipy
Version: 0.0.72
Summary: simple wrapper for kundelik.kz API, based on pydnevnikruapi
Home-page: https://github.com/Bs0Dd/KunAPIPy
Author: kesha1225 & Bs()Dd
License: UNKNOWN
Description: <p align="center">
          <img alt="Version" src="https://img.shields.io/badge/version-beta-blue" />
          <img alt="Python 3.7+" src="https://img.shields.io/badge/Python-3.7+-%23FFD242" />
          <img alt="The Unlicense" src="https://img.shields.io/badge/license-The%20Unlicense-blue" />
        </p>
        
        <h1 align="center">  KunAPIPy<br>api.kundelik.kz wrapper </h1>
        <p align="center">Упрощение работы с API Казахстанского электронного дневника как с токеном, так и без него.</p>
        <p align="center">Основан на Враппере DnevnikRuAPI.</p>
        
        ## Установка
        
        ```sh
        pip install kunapipy
        ```
        или
        ```sh
        pip install https://github.com/Bs0Dd/KunAPIPy/archive/master.zip --upgrade
        ```
        
        ## Документация
        
        Документация доступна здесь - https://github.com/Bs0Dd/KunAPIPy/blob/master/docs
        
        ## Пример синхронного использования
        
        #### Получение домашнего задания на указанный период без токена.
        
        ```python3
        from kunapipy.kundelik import kundelik
        from datetime import datetime
        
        login = "login"
        password = "password"
        # Получаем доступ через логин и пароль
        
        dn = kundelik.KunAPI(login=login, password=password)
        
        print(dn.get_school_homework(1000002283077, datetime(2019, 9, 5), datetime(2019, 9, 15)))
        #  Получение домашнего задания текущего пользователя для школы с id 1000002283077 в период с 05-09-2019 по 15-09-2019
        
        print(dn.get_edu_groups())
        #  Получение групп обучения текущего пользователя
        ```
        
        ## Пример асинхронного использования
        
        #### Получение домашнего задания на указанный период без токена.
        
        ```python3
        from kunapipy.asynkundelik import kundelik
        import asyncio
        from datetime import datetime
        from kunapipy.asynkundelik.utils import TaskManager
        
        
        async def get_dn_info():
            homework = await dn.get_school_homework(
                1000002283077, str(datetime(2019, 9, 5)), str(datetime(2019, 9, 15))
            )
            #  Получение домашнего задания текущего пользователя для школы с id 1000002283077 в период с 05-09-2019 по 15-09-2019
            print(homework)
        
            edu_groups = await dn.get_edu_groups()
            #  Получение групп обучения текущего пользователя
            print(edu_groups)
        
        
        async def close_session():
            await dn.close_session()
            #  В конце использования закрываем сессию
        
        
        if __name__ == "__main__":
            login = "login"
            password = "password"
            dn = kundelik.AsyncKunAPI(login=login, password=password)
            # Получаем доступ через логин и пароль
        
            loop = asyncio.get_event_loop()
            # Добавляем все наши функции в event loop через Task Manager
        
            task_manager = TaskManager(loop)
            task_manager.add_task(get_dn_info)
            task_manager.run(on_shutdown=close_session)
            # Закрываем сессию по завершению работы
        
        ```
        Чтобы пропустить шаг завершения сессии в последнем примере воспользуйтесь [примером](https://github.com/Bs0Dd/KunAPIPy/blob/master/examples/another_async_example.py)
        
        ## Соотнесение API методов и методов kunapipy (pydnevnikruapi)
        
        
        /v2.0/users/me/organizations -  **get_organizations()** - Список идентификаторов организаций текущего пользователя
        
        /v2.0/users/me/organizations/{organizationId} -  **get_organization_info(organization_id: int)** - Данные указанной организации пользователя
        
        /v2.0/authorizations -  **get_token(login, password)** - Обменять код доступа на токен
        
        /v2.0/persons/{person}/reporting-periods/{period}/avg-mark - **get_person_average_marks(person: int, period: int)** - Оценки персоны за отчетный период
        
        /v2.0/persons/{person}/groups/{group}/schedules - **get_person_schedule(person_id: int, group_id: int, start_time: datetime.datetime, end_time: datetime.datetime)** - Расписание ученика
        
        /v2.0/edu-groups/{group}/reporting-periods/{period}/avg-marks/{date} - **get_group_average_marks_by_date(group_id: int, period: int, date: datetime.datetime)** - Оценки учебной группы по предмету за отчетный период до определенной даты
        
        /v2.0/edu-groups/{group}/avg-marks/{from}/{to} - **get_group_average_marks_by_time(group_id: int, start_time: datetime.datetime, end_time: datetime.datetime)** - Оценки учебной группы за период
        
        /v2.0/user/{userID}/children - **get_user_children(user_id: int)** - Получение списка детей по идентификатору родительского пользователя
        
        /v2.0/person/{personID}/children - **get_person_children(person_id: int)** - Получение списка детей по идентификатору родительской персоны
        
        /v2.0/users/me/classmates - **get_classmates()** - Список id пользователей одноклассников текущего пользователя, если он является учеником, либо список активных участников образовательных групп пользователя во всех остальных случаях
        
        /v2.0/users/me/context - **get_context()** - Получение контекстной информации по пользователю
        
        /v2.0/users/{userId}/context - **get_user_context(user_id: int)** - Получение контекстной информации по пользователю
        
        /v2.0/edu-group/{group}/subject/{subject}/period/{period}/criteria-marks-sections - **func** - Метод получения списка секций СОр + СОч для класса по предмету в выбранном периоде c соответствующей информацией
        
        /v2.0/edu-group/{group}/person/{person}/subject/{subject}/period/{period}/criteria-marks - **func** - Метод получения суммативных оценок (СОр, СОч) ученика класса по предмету за период, с привязкой к конкретной теме/суммативной оценки четверти
        
        /v2.0/edu-group/{group}/period/{period}/criteria-marks - **func** - Метод получения списка оценок (СОр, СОч) класса сгруппированные по ученикам и предметам за период (т.е. оценки каждого ученика класса, разбитые по предметам)
        
        /v2.0/edu-group/{group}/subject/{subject}/period/{period}/criteria-marks - **func** - Метод получения всех оценок (СОр и СОч) класса (группировка по ученикам) за период по выбранному предмету
        
        /v2.0/edu-group/{group}/criteria-marks-totals - **get_final_group_marks(group_id: int)** - Метод, позволяющий получить итоговые оценки всего класса (каждого ученика) по всем предметам
        
        /v2.0/edu-group/{group}/subject/{subject}/criteria-marks-totals - **get_final_group_marks_by_subject(group_id: int, subject_id: int)** - Метод, позволяющий получить итоговые оценки всего класса по указанному предмету
        
        /v2.0/edu-group/{group}/criteriajournalsection/{section}/criteria-marks - **func** - Метод полученипя списка суммативных оценок класса за конкретную тему (СОр или СОч по section_id параметру, который является связывающим звеном для оценок одной темы)
        
        /v2.0/edu-group/{group}/criteriajournalsection/{section}/criteria-marks-totals - **func** - Метод полученипя списка итоговых суммативных оценок класса за конкретную тему (СОр или СОч по section_id параметру, который является связывающим звеном для сумативной оценки за четверть)
        
        /v2.0/users/{user}/school-memberships - **get_user_memberships(user_id: int)** - Список участий в школах для произвольного пользователя
        
        /v2.0/users/{user}/education - **get_user_education(user_id: int)** - Список участий в школах для произвольного пользователя
        
        /v2.0/persons/{person}/school-memberships - **get_person_memberships(person_id: int)** - Список участий в школах для произвольной персоны
        
        /v2.0/users/me/schools - **get_schools()** - Список идентификаторов школ текущего пользователя
        
        /v2.0/users/{user}/schools - **get_user_schools(user_id: int)** - Список идентификаторов школ произвольного пользователя
        
        /v2.0/users/me/edu-groups - **get_edu_groups()** - Список идентификаторов классов текущего пользователя
        
        /v2.0/users/{user}/edu-groups - **get_user_edu_groups(user_id: int)** - Список идентификаторов классов текущего пользователя
        
        /v2.0/users/me/school-memberships - **get_memberships()** - Список участий в школах для текущего пользователя
        
        /v2.0/edu-groups/{eduGroup} - **get_group_info(edu_group_id: int)** - Класс или учебная группа
        
        /v2.0/edu-groups - **get_groups_info(edu_groups_list: list)** - Список учебных групп
        
        /v2.0/schools/{school}/edu-groups - **get_school_groups(school_id: int)** - Список классов в школе
        
        /v2.0/persons/{person}/edu-groups - **get_person_groups(person_id: int)** - Учебные группы персоны
        
        /v2.0/persons/{person}/edu-groups/all - **get_person_groups_all(person_id: int)** - 123
        
        /v2.0/persons/{person}/schools/{school}/edu-groups - **get_person_school_groups(person_id: int, school_id: int)** - Учебные группы персоны в школе
        
        /v2.0/edu-groups/{group}/persons - **get_groups_pupils(edu_group_id: int)** - Список учеников учебной группы
        
        /v2.0/edu-groups/students - **get_students_groups_list()** - Список групп с учениками
        
        /v2.0/edu-groups/{groupId}/parallel - **get_groups_parallel(group_id: int)** - Список параллельных групп(включая группу указанную в параметрах)
        
        /authorizations/esia/v2.0/users/linked - **func** - 123
        
        /authorizations/esia/v2.0 - **func** - 123
        
        /v2.0/files/async/upload - **func** - Метод загрузки файла. Файл будет загружен в первую папку привязанной к приложению сети. При загрузке файла обязательно надо передать заголовки Content-Type: multipart/form-data с соотвествующим boundary и верный Content-Length. 
        
        /v2.0/folder/{folderId}/files/async/upload - **func** - Метод для загрузки файла в папку. При загрузке файла обязательно надо передать заголовки Content-Type: multipart/form-data с соотвествующим boundary и верный Content-Length.
        
        /v2.0/files/async/upload/base64 - **func** - Метод загрузки файла в формате строки base64. При загрузке файла обязательно надо передать заголовки Content-Type: application/json, а бинарные данные файла передать в теле запроса. Файл будет загружен в первую папку привязанной к приложению сети. 
        
        /v2.0/files/async/upload/{taskId} - **func** - Метод получения загруженного файла.
        
        /v2.0/files/{fileId}/repost - **func** - Репост файла
        
        /v2.0/folder/{folderId}/files - **func** - Получение файлов в папке
        
        /v2.0/apps/current/files - **func** - Получение файлов приложения
        
        /v2.0/files/{fileId}/like - **func** - Увеличения количества лайков/голосов на единицу
        
        /v2.0/edu-groups/{group}/final-marks - **get_group_marks(group_id: int)** - Оценки в учебной группе
        
        /v2.0/persons/{person}/edu-groups/{group}/final-marks - **get_person_group_marks(person_id: int, group_id: int)** - Оценки персоны в учебной группе
        
        /v2.0/persons/{person}/edu-groups/{group}/allfinalmarks - **get_person_group_marks_final(person_id: int, group_id: int)** - Итоговые оценки персоны в учебной группе
        
        /v2.0/edu-groups/{group}/subjects/{subject}/final-marks - **get_group_subject_final_marks(group_id: int, subject_id: int)** - Оценки по предмету в учебной группе
        
        /v2.0/users/me/friends - **get_friends()** - Список id пользователей друзей текущего пользователя
        
        /v2.0/users/{user}/friends - **get_user_friends(user_id: int)** - Список id пользователей друзей конкретного пользователя по его id
        
        /v2.0/users/me/school/{school}/homeworks - **def get_school_homework(school_id: int, start_time: datetime.datetime, end_time: datetime.datetime):** - Получить домашние задания пользователя за период времени
        
        /v2.0/users/me/school/homeworks - **get_homework_by_id(homework_id: int)** - Получить домашние задания по идентификаторам
        
        /v2.0/persons/{person}/school/{school}/homeworks - **get_person_homework(school_id: int,person_id: int, start_time: datetime.datetime, end_time: datetime.datetime):** - Получить домашние задания обучающегося за период времени
        
        /v2.0/works/{workId}/test - **func** - Прикрепить тест к дз
        
        /v2.0/lessons/{lesson}/log-entries - **delete_lesson_log(lesson_id: int, person_id: int)** - Список отметок о посещаемости на уроке
        
        /v2.0/lesson-log-entries - **get_lesson_logs(lessons_ids: list)** - Список отметок о посещаемости на нескольких уроках
        
        /v2.0/lesson-log-entries/lesson/{lesson}/person/{person} - **get_person_lesson_log(person_id: int, lesson_id: int)** - Отметка о посещаемости ученика на уроке
        
        /v2.0/lesson-log-entries/group/{eduGroup} - **get_group_lesson_log(group_id: int, subject_id: int, start_time: datetime.datetime, end_time: datetime.datetime)** - Список отметок о посещаемости на уроках по заданному предмету в классе за интервал времени
        
        /v2.0/lesson-log-entries/person/{personID}/subject/{subjectID} - **func** - Список отметок о посещаемости обучающегося по предмету за интервал времени
        
        /v2.0/lesson-log-entries/person={personID}&subject={subjectID}&from={from}&to={to} - **get_person_subject_lesson_log(person_id: int,subject_id: int,start_time: datetime.datetime,end_time: datetime.datetime)** - Список отметок о посещаемости обучающегося по предмету за интервал времени
        
        /v2.0/persons/{person}/lesson-log-entries - **get_person_lesson_logs(person_id: int, start_time: datetime.datetime, end_time: datetime.datetime)** - Список отметок о посещаемости обучающегося за интервал времени
        
        /v2.0/lesson-log-entries/statuses - **get_lesson_log_statuses()** - Получить список возможных отметок о посещаемости. Пример ответа - ["Attend","Absent","Ill","Late","Pass"].
        
        /v2.0/lessons/{lesson} - **get_lesson_info(lesson_id: int)** - Получить урок с заданным id
        
        /v2.0/lessons/many - **get_many_lessons_info(lessons_list: list)** - Получение списка уроков по списку id
        
        /v2.0/edu-groups/{group}/lessons/{from}/{to} - **get_group_lessons_info(group_id: int, start_time: datetime.datetime, end_time: datetime.datetime)** - Уроки группы за период
        
        /v2.0/edu-groups/{group}/subjects/{subject}/lessons/{from}/{to} - **get_group_lessons_info(group_id: int, start_time: datetime.datetime, end_time: datetime.datetime)** - Уроки группы по предмету за период
        
        /v2.0/works/{workID}/marks/histogram - **get_marks_histogram(work_id: int)** - Получение деперсонализированной гистограмы оценок всего класса по идентификатору работы
        
        /v2.0/periods/{periodID}/subjects/{subjectID}/groups/{groupID}/marks/histogram - **get_subject_marks_histogram(group_id: int, period_id: int, subject_id: int)** - Получение деперсонализированной гистограмы оценок всего класса за отчетный период
        
        /v2.0/marks/{mark} - **get_mark_by_id(mark_id: int)** - Оценка
        
        /v2.0/works/{work}/marks - **get_marks_by_work(work_id: int)** - Список оценок за работу на уроке
        
        /v2.0/lessons/{lesson}/marks - **get_marks_by_lesson(lesson_id: int)** - Оценки на уроке
        
        /v2.0/lessons/marks - **get_marks_by_lessons(lessons_ids: list)** - Список оценок за несколько уроков
        
        /v2.0/lessons/many/marks - **func** - Список оценок за несколько уроков
        
        /v2.0/edu-groups/{group}/marks/{from}/{to} - **get_group_marks_period(group_id: int,start_time: datetime.datetime, end_time: datetime.datetime)** - Оценки учебной группы за период
        
        /v2.0/edu-groups/{group}/subjects/{subject}/marks/{from}/{to} - **get_group_subject_marks(group_id: int, subject_id: int, start_time: datetime.datetime, end_time: datetime.datetime)** - Оценки учебной группы по предмету за период
        
        /v2.0/persons/{person}/schools/{school}/marks/{from}/{to} - **get_person_marks(person_id: int, school_id: int, start_time: datetime.datetime, end_time: datetime.datetime)** - Оценки персоны в школе за период
        
        /v2.0/persons/{person}/edu-groups/{group}/marks/{from}/{to} - **func** - Оценки персоны в учебной группе за период
        
        /v2.0/persons/{person}/lessons/{lesson}/marks - **get_person_lessons_marks(person_id: int, lesson_id: int)** - Оценки персоны за урок
        
        /v2.0/persons/{person}/works/{work}/marks - **get_person_work_marks(person_id: int, work_id: int)** - Оценки персоны за работу
        
        /v2.0/persons/{person}/subjects/{subject}/marks/{from}/{to} - **get_person_subject_marks(person_id: int, subject_id: int, start_time: datetime.datetime, end_time: datetime.datetime)** - Оценки персоны по предмету за период
        
        /v2.0/persons/{person}/subject-groups/{subjectgroup}/marks/{from}/{to} - **func** - Оценки персоны по предмету за период
        
        /v2.0/lessons/{date}/persons/{person}/marks - **func** - Оценки персоны по дате урока
        
        /v2.0/persons/{person}/marks/{date} - **get_marks_by_date(person_id: int, date: datetime.datetime)** - Оценки персоны по дате выставления оценки
        
        /v2.0/persons/{personId}/works/{workId}/mark - **get_person_work_marks(person_id: int, work_id: int)** - Выставить оценку ученику по работе
        
        /v2.0/marks/values - **get_marks_values()** - Метод возвращает все поддерживаемые системы (типы) оценок и все возможные оценки в каждой из систем.
                    
        /v2.0/marks/values/type/{type} - **get_marks_values_by_type(marks_type: str)** - Метод возвращает все возможные оценки в запрашиваемой системе (типе) оценок. Чтобы узнать, какие типы поддерживаются нужно предварительно делать запрос marks/values без параметров.
        
        
        TODO: доделать методы  
        /v2.0/persons - **func** - Список учеников в классе или учебной группе
        
        /v2.0/edu-groups/{eduGroup}/students - **func** - Список учеников в классе или учебной группе
        
        /v2.0/persons/search - **func** - 123
        
        /v2.0/persons/{person} - **func** - Профиль персоны
        
        /v2.0/persons/{person}/group/{group}/recentmarks - **func** - Последние оценки/отметки посещаемости персоны по предмету, указанному в параметре subject, начиная с даты определенном в параметре fromDate и с ограничением на выводимое количество указанном в параметре limit
        
        /authorizations/esia/v2.0/regions - **func** - 123
        
        /v2.0/edu-groups/{eduGroup}/reporting-periods - **func** - Список отчётных периодов для класса или учебной группы
        
        /v2.0/edu-groups/{eduGroup}/reporting-period-group - **func** - Группа отчетных периодов для класса или учебной группы
        
        /v2.0/school-rating/from/{from}/to/{to} - **func** - ѕолучение списка школ с наивысшим рейтингом за выбранный период
        
        /v2.0/school-rating/from/{from}/to/{to}/new - **func** - ѕолучение списка новых школ с наивысшим рейтингом за выбранный период
        
        /v2.0/schools/{school} - **func** - Профиль школы
        
        /v2.0/schools - **func** - Список профилей нескольких школ (или список образовательных организаций пользователя, если не передано ни одного идентификатора школы)
        
        /v2.0/schools/person-schools - **func** - Список образовательных организаций пользователя
        
        /v2.0/schools/cities - **func** - Список населенных пунктов, образовательные организации которых включены в Систему
        
        /v2.0/schools/search/by-oktmo - **func** - 123
        
        /v2.0/schools/{school}/parameters - **func** - Параметры общеобразовательных организаций
        
        /v2.0/events/{id}/invite - **func** - Пригласить в событие
        
        /v2.0/groups/{id}/invite - **func** - Пригласить в группу
        
        /v2.0/networks/{id}/invite - **func** - Пригласить в сеть
        
        /v2.0/edu-groups/{eduGroup}/subjects - **func** - Список предметов, преподаваемых в классе в текущем отчётном периоде
        
        /v2.0/schools/{school}/subjects - **func** - Список предметов, преподаваемых в образовательной организации в текущем учебном году
        
        /v2.0/tasks/{task} - **func** - Домашнее задание
        
        /v2.0/tasks - **func** - Домашние задания за несколько уроков
        
        /v2.0/lessons/{lesson}/tasks - **func** - Список домашних заданий за урок
        
        /v2.0/works/{work}/tasks - **func** - Список домашних заданий
        
        /v2.0/persons/{person}/tasks - **func** - Список домашних заданий ученика по предмету
        
        /v2.0/tasks/{personId}/undone - **func** - Список невыполненных домашних заданий обучающегося с истёкшим сроком выполнения
        
        /v2.0/teacher/{teacher}/students - **func** - Список учеников для учителя который ведет уроки у этих учеников(они должны быть в расписании) от недели назад и на 30 дней вперед
        
        /v2.0/schools/{school}/teachers - **func** - Список преподавателей в выбранной образовательной организации
        
        /v2.0/edu-groups/{group}/teachers - **func** - Список учителей, которые ведут уроки в данной группе, учитываются уроки от недели назад и на 30 дней вперед
        
        /v2.0/thematic-marks/{mark} - **func** - Получить оценку с заданным id
        
        /v2.0/thematic-marks - **func** - Сохранить оценку
        
        /v2.0/persons/{person}/edu-groups/{group}/subjects/{subject}/thematic-marks/{from}/{to} - **func** - Оценки персоны по предмету в учебной группе за период
        
        /v2.0/persons/{person}/edu-groups/{group}/thematic-marks/{from}/{to} - **func** - Оценки персоны в учебной группе за период
        
        /v2.0/persons/{person}/schools/{school}/thematic-marks/{from}/{to} - **func** - Оценки персоны в школе за период
        
        /v2.0/edu-groups/{group}/subjects/{subject}/thematic-marks - **func** - Оценки в учебной группе по предмету
        
        /v2.0/schools/{school}/timetables - **func** - Получение расписания школы
        
        /v2.0/edu-groups/{eduGroup}/timetables - **func** - Получение расписания учебной группы
        
        /v2.0/users/me/feed - **func** - Лента пользователя
        
        /v2.0/users/{user}/groups - **func** - Список идентификаторов групп пользователя
        
        /v2.0/users/me/children - **func** - Список id пользователей детей текущего пользователя
        
        /v2.0/users/{user}/relatives - **func** - Получение всех родственных связей произвольного пользователя.
        
        /v2.0/users/me/relatives - **func** - Получение всех родственных связей текущего пользователя.
        
        /v2.0/users/me/childrenrelatives - **func** - Список id всех родственных связей детей произвольного пользователя
        
        /v2.0/users/{user} - **func** - Профиль произвольного пользователя. Профиль текущего пользователя можно получить по users/me
        
        /v2.0/users/me - **func** - Профиль текущего пользователя.
        
        /v2.0/users/me/roles - **func** - Роли текущего пользователя.
        
        /v2.0/users/many - **func** - Профили нескольких пользователей
        
        /v2.0/users - **func** - Профили нескольких пользователей
        
        /v2.0/users/{user}/roles - **func** - Роли пользователя
        
        /v2.0/users/{user}/wallrecord - **func** - Отправить сообщение с изображением на стену пользователя
        
        /v2.0/edu-groups/{group}/wa-marks/{from}/{to} - **func** - Средние взвешенные оценки учебной группы за период
        
        /v2.0/works - **func** - Список работ на уроке
        
        /v2.0/lessons/{lesson}/works - **func** - Список работ на уроке
        
        /v2.0/works/{work} - **func** - Работа на уроке
        
        /v2.0/works/many - **func** - Получение списка работ по списку id
        
        /v2.0/works/{work}/persons/{person}/status - **func** - Изменить статус выполнения домашней работы учащимся.
        
        /v2.0/work-types/{school} - **func** - Получение списка всех типов работ школы
        
Platform: UNKNOWN
Description-Content-Type: text/markdown
