rs-study-utils 1.0.0

Notebook-friendly theory, search, and complete practice solutions for a recommender-systems exam.

RS Study Utils

rs-study-utils — компактная учебная библиотека для экзамена по рекомендательным системам. Внутри находятся 33 подробных теоретических ответа и 23 полностью самостоятельных практических решения для MovieLens.

Библиотека хранит учебные материалы и сама не устанавливает тяжёлые рекомендательные фреймворки. В коде конкретных заданий уже есть необходимые команды установки Surprise, implicit или LightFM.

Установка

pip install rs-study-utils

В Google Colab:

!pip install -q rs-study-utils

Быстрый старт

from rs_study_utils import theory, practice, find

Показать все номера теоретических вопросов или практических заданий:

theory()
practice()

Получить материал по номеру:

theory(8)
practice(14)

Найти лучший ответ по словам или по целой формулировке:

theory("матричная факторизация")
practice("ALS top-10 для пользователя")

Одновременно поискать по теории и практике:

find("LightFM WARP")
find("cosine similarity", kind="theory")
find("RMSE KNN", kind="practice")

Каждая найденная строка подсказывает готовую команду вида theory(номер) или practice(номер).

Отдельные функции поиска

from rs_study_utils import search_theory, search_practice

search_theory("implicit feedback")
search_practice("TF-IDF названий")

Получить текст без автоматического вывода

answer = theory(5, display=False)
code = practice(3, display=False)
print(code)

Практическое решение возвращается целиком: условие, важные замечания, скачивание MovieLens и полный исполняемый код. Чтобы получить только код без заголовочных комментариев:

code_only = practice(3, display=False, include_task=False)

Все материалы сразу

from rs_study_utils import all_theory, all_practice

all_theory()
all_practice()

Копирование

pip install "rs-study-utils[clipboard]"

from rs_study_utils import copy_theory, copy_practice

copy_theory(1)
copy_practice(1)

Командная строка

rsstudy list-theory
rsstudy list-practice
rsstudy theory 8
rsstudy practice 14
rsstudy find "LightFM WARP"

То же самое без отдельной команды:

python -m rs_study_utils theory 8

Данные и воспроизводимость практики

• В 22 заданиях каждый самостоятельный блок напрямую скачивает официальный ml-latest-small.zip с сервера GroupLens и читает ratings.csv и movies.csv.
• В задании 6 по условию используется встроенный MovieLens ml-100k, который Surprise скачивает вызовом Dataset.load_builtin("ml-100k", prompt=False).
• Все решения предназначены для копирования в одну ячейку Google Colab или Jupyter Notebook.
• Все практические блоки синтаксически проверены; обычные задания, Surprise, implicit и LightFM также прошли исполняемые тесты.

Основные команды

from rs_study_utils import (
    theory, practice, find,
    list_theory, list_practice,
    search_theory, search_practice,
    all_theory, all_practice,
)