Неофициальный API АСУ РСО и NetSchool

Сделан мной потому что я хотел посмотреть что у меня выйдет по информатике если я забью на все контрольные по питону.

С новым годом кста

Таблица контента

• Неофициальный API АСУ РСО и NetSchool
  • Установка
  • Использование
  • Функции
    • Что умеет эта библиотека
    • TODO:
  • Документация
  • Примеры
  • Contributing
  • Лицензия
  • Донатик мне пжпж

Установка

npm i asurso

Использование

Все ID вы можете найти в файле LOGINIDS.md, а мои заметки о том, как я реверс-инженерил апи в HOWITWORKS.md

import ASURSO from "asurso"

const api = new ASURSO({
  countryID: 2,
  regionID: 1,
  regionAreaID: -1,
  cityID: 2,
  schoolTypeID: 2,
  schoolID: 257,
  login: "ЩелочковВ",
  password: "..."
})

await api.login()

// Вызов других методов, описанных ниже

Функции

Что умеет эта библиотека

Фича	Статус
Вход в аккаунт	✅
Создание сессии после входа	✅
Получение дневника: дз, оценки	✅
Получение файлов в дневнике	✅
Получение профиля пользователей	✅
Получение пользователей онлайн	✅
Получение почты	✅
Отправка почты	✅
Получение новостей	✅
Получение файлов из новостей	✅
Получение портфолио (портрет, достижения, коллектор, рабочие материалы)	✅
Получение файлов из портфолио	✅
Получение тем на форуме	✅
Создание тем на форуме	⏳
Чтение сообщений в темах на форуме	✅
Отправка сообщений в темы на форуме	⏳
Загрузка и удаление файлов	⏳
Генерация, скачивание и парсинг отчетов	✅

С версии 0.2.3 добавлены тесты Jest, покрытие кода: 2.59%

TODO:

• Сделать работающий как часы вход
• Переместить документацию в отдельный файл, чтобы оптимизировать размер пакета
• Вместо скачивания файла, полученного из generateReport сделать интерфейс ReportFile с методами download и parse
• Добавить метод подсчета средней оценки из массива по методике системы АСУ РСО
• Нормально организовать сет тестов (unit-тесты, e2e, примеры)
• Написать примеры
• Найти кого-нибудь, кто напишет на этой библиотеке свой проект
• Написать статью об этой ситуации и опубликовать куда-нибудь

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

Перейти к документации

Примеры

Добавлю позже

Contributing

Если вы видите это через 5 лет то просто лучше сделайте форк и развивайте его.

Лицензия

MIT aka не знаю других лицензий

Донатик мне пжпж

Если вы домотали до конца, вам должно быть интересна данная библиотека так вот я делал ее днем и ночью, беспощадно теряя свое свободное время на такую ерунду, и никто из команды АСУ РСО мне не заплатил. Поэтому если вам не сложно скиньте мне денюжку на аренду сервера 🥺  hloth.dev/donate