Horizontal42/Sort_YM
1
0
Fork 0
mirror of https://github.com/Horizontal42/Sort_YM.git synced 2026-11-10 15:42:02 +03:00
Code Issues Projects Releases Packages Wiki Activity Actions
Sorts Yandex Music liked tracks into sub-genre playlists (Genre — RU / Genre — INT) via CLI — auth, fetch, report, digest, apply.
2 commits 1 branch 0 tags 188 KiB
Find a file
Andrew Pimenov 942c2d19e4 retry network errors and raise request timeout 
Медленная/нестабильная сеть до api.music.yandex.net роняла весь процесс
при первом же таймауте (5с по умолчанию у библиотеки). Добавлен
with_retries с экспоненциальной паузой на всех сетевых точках входа
(fetch, language, genres, apply, client.init), таймаут запроса поднят
до 20с (настраивается в config.toml). Заодно поправлен скрытый баг:
language.py раньше кэшировал таймаут как "текста нет" навсегда -
теперь только настоящий NotFoundError трактуется так.
2026-07-06 10:05:22 +03:00
sort_ym retry network errors and raise request timeout 2026-07-06 10:05:22 +03:00
tests init: сортировка лайков Яндекс.Музыки по жанру и языку 2026-07-06 09:49:36 +03:00
.gitignore init: сортировка лайков Яндекс.Музыки по жанру и языку 2026-07-06 09:49:36 +03:00
ARCHITECTURE.md init: сортировка лайков Яндекс.Музыки по жанру и языку 2026-07-06 09:49:36 +03:00
config.toml retry network errors and raise request timeout 2026-07-06 10:05:22 +03:00
README.md init: сортировка лайков Яндекс.Музыки по жанру и языку 2026-07-06 09:49:36 +03:00
requirements-dev.txt init: сортировка лайков Яндекс.Музыки по жанру и языку 2026-07-06 09:49:36 +03:00
requirements.txt init: сортировка лайков Яндекс.Музыки по жанру и языку 2026-07-06 09:49:36 +03:00

README.md

Sort YM

Раскладывает лайкнутые треки Яндекс.Музыки по плейлистам вида Жанр — RU / Жанр — INT.

$ python -m sort_ym report

Распределение по плейлистам:
  Рок — INT: 143
  Рок — RU: 287
  Рэп — RU: 512
  ...

Отчёт сохранён: out/report.csv

Установка

Требования: Python 3.11+ (используется tomllib из стандартной библиотеки), Windows/Linux/macOS, доступ в интернет.

python -m venv .venv
.venv\Scripts\pip install -r requirements.txt

Для разработки (тесты):

.venv\Scripts\pip install -r requirements-dev.txt

Что делает

  1. auth — вход в аккаунт Яндекса через OAuth device-flow: покажет код, вы подтверждаете вход на странице Яндекса, токен сохраняется в .token (локально, в .gitignore).
  2. fetch — скачивает список лайкнутых треков и их метаданные (жанр альбома, доступность текста) в cache/tracks.json. Повторный запуск докачивает только новые треки.
  3. report — определяет жанр (крупная группа) и язык (RU/иностранный) каждого трека, считает распределение по будущим плейлистам и сохраняет out/report.csv для проверки. Ничего не меняет в аккаунте.
  4. apply --yes — создаёт недостающие плейлисты и добавляет в них треки. Уже добавленные треки не дублируются при повторном запуске. Лайки не трогает, ничего не удаляет.

Как определяется жанр и язык

  • Жанр: у трека берётся жанр альбома, затем он сопоставляется с одной из ~11 крупных групп (Поп, Рок, Метал, Рэп, Электроника, Джаз и блюз, Классика, Фолк и world, Инди и альтернатива, Саундтреки, Разное) через реальное дерево жанров Яндекса (sort_ym/genres.py, таблица ROOT_BUCKET — легко дополняется).
  • Язык — гибрид:
    1. Если у трека есть текст песни — реальный язык из API (ru → RU, иначе → INT).
    2. Иначе — подсказка по жанру (rusrap, shanson, bard, ...).
    3. Иначе — по алфавиту названия/исполнителя (кириллица/латиница).
    4. Если ничего не сработало — трек попадает в ... — Не определено.

После report в консоли также печатается список нераспознанных жанров (попавших в «Разное»), чтобы можно было дополнить таблицу в sort_ym/genres.py.

Handy things

  • Первый прогон apply делайте с --limit 20 --yes и проверьте результат в приложении, прежде чем запускать на все ~2000 треков.
  • Все промежуточные данные лежат в cache/ — их можно удалить, чтобы пересчитать с нуля.
  • Настройки задержек между запросами — в config.toml ([throttle]).

Риски (неофициальный API)

Официального API для личной библиотеки Яндекс.Музыки нет — инструмент использует неофициальную библиотеку yandex-music. OAuth-токен в .token даёт полный доступ к аккаунту Яндекса — храните его локально и не публикуйте. Инструмент выполняет только безопасные действия (чтение лайков, создание плейлистов, добавление треков) и ничего не удаляет.

For developers

Python 3.11+, yandex-music==3.0.0, стандартная библиотека (tomllib, csv, unicodedata).

.venv\Scripts\python -m pytest tests/ -v
.venv\Scripts\python -m sort_ym auth
.venv\Scripts\python -m sort_ym fetch
.venv\Scripts\python -m sort_ym report
.venv\Scripts\python -m sort_ym apply --limit 20 --yes

Структура кода и поток данных — в ARCHITECTURE.md.