ymdantic 0.2.0__tar.gz → 0.2.2__tar.gz

ymdantic-0.2.2/.github/workflows/tests.yml

@@ -0,0 +1,104 @@
+name: Testing YMdantic
+
+on:
+  push:
+  pull_request:
+  pull_request_target:
+    types: [opened, synchronize, reopened]
+
+jobs:
+  lint:
+    if: github.event_name != 'pull_request_target'
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.12", "3.13", "3.14"]
+        check:
+          - name: Ruff format
+            cmd: ruff format --diff
+          - name: Ruff check
+            cmd: ruff check ymdantic tests
+          - name: Mypy
+            cmd: mypy ymdantic tests
+
+    name: "${{ matrix.check.name }} (py${{ matrix.python-version }})"
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          version: "0.9.17"
+          python-version: ${{ matrix.python-version }}
+          enable-cache: true
+
+      - name: Install deps
+        run: uv sync --locked --all-groups
+
+      - name: Run check
+        run: uv run ${{ matrix.check.cmd }}
+
+  test_push:
+    if: github.event_name == 'push'
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.12", "3.13", "3.14"]
+
+    name: "Pytest push (py${{ matrix.python-version }})"
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          version: "0.9.17"
+          python-version: ${{ matrix.python-version }}
+          enable-cache: true
+
+      - name: Install deps
+        run: uv sync --locked --all-groups
+
+      - name: Run Pytest
+        env:
+          YM_TOKEN: ${{ secrets.YM_TOKEN }}
+        run: uv run pytest -vv tests
+
+  test_pr_approved:
+    if: github.event_name == 'pull_request_target'
+    runs-on: ubuntu-latest
+    environment: pull_requests
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.12", "3.13", "3.14"]
+
+    name: "Pytest PR approved (py${{ matrix.python-version }})"
+
+    permissions:
+      contents: read
+      pull-requests: read
+
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: ${{ github.event.pull_request.head.sha }}
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          version: "0.9.17"
+          python-version: ${{ matrix.python-version }}
+          enable-cache: true
+
+      - name: Install deps
+        run: uv sync --locked --all-groups
+
+      - name: Run Pytest
+        env:
+          YM_TOKEN: ${{ secrets.YM_TOKEN }}
+        run: uv run pytest -vv tests

{ymdantic-0.2.0 → ymdantic-0.2.2}/.pre-commit-config.yaml

@@ -1,4 +1,9 @@
 repos:
+  - repo: https://github.com/astral-sh/uv-pre-commit
+    rev: 0.9.7
+    hooks:
+      - id: uv-lock
+
   - repo: https://github.com/pre-commit/pre-commit-hooks
     rev: v6.0.0
     hooks:

{ymdantic-0.2.0 → ymdantic-0.2.2}/PKG-INFO

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: ymdantic
-Version: 0.2.0
+Version: 0.2.2
 Summary: Фреймворк предоставляющий доступ к API Яндекс Музыки (с Pydantic валидацией)
 Author-email: KatantDev <vlad26@mail.ru>
 License-File: LICENSE
-Requires-Python: <3.14,>=3.10
+Requires-Python: <3.15,>=3.12
 Requires-Dist: aiohttp<4,>=3.9.0
 Requires-Dist: certifi<2026,>=2025
 Requires-Dist: dataclass-rest>=0.5.0
@@ -18,7 +18,7 @@ Description-Content-Type: text/markdown
 **YMDantic** - это клиентская библиотека на Python для работы с API Yandex Music.
 Она позволяет получать информацию о треках, альбомах, плейлистах и других объектах сервиса.
 
-Особенностью библиотеки является использование [Pydantic](https://pydantic-docs.helpmanual.io/) для валидации и сериализации данных.
+Особенностью библиотеки является использование [Pydantic](https://docs.pydantic.dev/) для валидации и сериализации данных.
 
 ## Технологии
 Проект написан на Python и использует следующие библиотеки:
@@ -27,7 +27,7 @@ Description-Content-Type: text/markdown
 - Pydantic для валидации и сериализации данных
 
 ## Установка и использование
-Для установки библиотеки используйте pip/poetry:
+Для установки библиотеки используйте pip/poetry/uv:
 
 ```bash
 pip install ymdantic
@@ -36,23 +36,9 @@ pip install ymdantic
 ```bash
 poetry add ymdantic
 ```
-
-## Пример использования
-Получаем список чартов и выводим треки
-
-```python
-import asyncio
-from ymdantic import YMClient
-
-
-async def get_chart(client: YMClient) -> None:
-    chart_block = await client.get_chart()
-    print(chart_block.title, end="\n\n")
-    print("Треки в чарте:")
-    for playlist_track in chart_block.chart.tracks:
-        print(f"{playlist_track.track.artists_names} - {playlist_track.track.title}")
-
-
-if __name__ == "__main__":
-    asyncio.run(get_chart(client=YMClient(token="y0_123")))
+или
+```bash
+uv add ymdantic
 ```
+
+## [Примеры использования](https://github.com/KatantDev/YMdantic/tree/main/examples)

{ymdantic-0.2.0 → ymdantic-0.2.2}/README.md

@@ -4,7 +4,7 @@
 **YMDantic** - это клиентская библиотека на Python для работы с API Yandex Music.
 Она позволяет получать информацию о треках, альбомах, плейлистах и других объектах сервиса.
 
-Особенностью библиотеки является использование [Pydantic](https://pydantic-docs.helpmanual.io/) для валидации и сериализации данных.
+Особенностью библиотеки является использование [Pydantic](https://docs.pydantic.dev/) для валидации и сериализации данных.
 
 ## Технологии
 Проект написан на Python и использует следующие библиотеки:
@@ -13,7 +13,7 @@
 - Pydantic для валидации и сериализации данных
 
 ## Установка и использование
-Для установки библиотеки используйте pip/poetry:
+Для установки библиотеки используйте pip/poetry/uv:
 
 ```bash
 pip install ymdantic
@@ -22,23 +22,9 @@ pip install ymdantic
 ```bash
 poetry add ymdantic
 ```
-
-## Пример использования
-Получаем список чартов и выводим треки
-
-```python
-import asyncio
-from ymdantic import YMClient
-
-
-async def get_chart(client: YMClient) -> None:
-    chart_block = await client.get_chart()
-    print(chart_block.title, end="\n\n")
-    print("Треки в чарте:")
-    for playlist_track in chart_block.chart.tracks:
-        print(f"{playlist_track.track.artists_names} - {playlist_track.track.title}")
-
-
-if __name__ == "__main__":
-    asyncio.run(get_chart(client=YMClient(token="y0_123")))
+или
+```bash
+uv add ymdantic
 ```
+
+## [Примеры использования](https://github.com/KatantDev/YMdantic/tree/main/examples)

ymdantic-0.2.2/examples/chart.py

@@ -0,0 +1,32 @@
+import asyncio
+import os
+
+from ymdantic import YMClient
+
+TOKEN = os.environ["TOKEN"]
+
+
+async def get_chart() -> None:
+    """Получаем чарт и выводим треки в консоль."""
+    client = YMClient(token=TOKEN)
+
+    chart_block = await client.get_chart()
+    print(chart_block.title)
+    for index, playlist_track in enumerate(chart_block.chart.tracks, start=1):
+        track = playlist_track.track
+        if track.available:
+            download_info = await track.get_download_info_direct()
+            direct_url = download_info[-1].direct_url
+        else:
+            direct_url = "Недоступен для скачивания"
+        print(
+            f"{index}. "
+            f"{playlist_track.track.artists_names} - {playlist_track.track.title}\n"
+            f"({direct_url})\n",
+        )
+
+    await client.close()
+
+
+if __name__ == "__main__":
+    asyncio.run(get_chart())

{ymdantic-0.2.0 → ymdantic-0.2.2}/pyproject.toml

@@ -1,9 +1,9 @@
 [project]
 name = "ymdantic"
-version = "0.2.0"
+version = "0.2.2"
 description = "Фреймворк предоставляющий доступ к API Яндекс Музыки (с Pydantic валидацией)"
 authors = [{ name = "KatantDev", email = "vlad26@mail.ru" }]
-requires-python = ">=3.10,<3.14"
+requires-python = ">=3.12,<3.15"
 readme = "README.md"
 dependencies = [
     "aiohttp>=3.9.0,<4",

ymdantic-0.2.2/tests/account/test_settings.py

@@ -0,0 +1,25 @@
+import pytest
+from ymdantic import YMClient
+from ymdantic.models.account import SetAccountSettingsParams
+
+
+@pytest.mark.anyio
+async def test_set_account_settings_direct(client: YMClient) -> None:
+    old_settings = await client.get_account_settings()
+
+    settings = await client.set_account_settings_request(
+        SetAccountSettingsParams(
+            auto_play_radio=not old_settings.auto_play_radio,
+        ),
+    )
+    assert settings.result.auto_play_radio != old_settings.auto_play_radio
+
+
+@pytest.mark.anyio
+async def test_set_account_settings(client: YMClient) -> None:
+    old_settings = await client.get_account_settings()
+
+    settings = await client.set_account_settings(
+        auto_play_radio=not old_settings.auto_play_radio,
+    )
+    assert settings.auto_play_radio != old_settings.auto_play_radio

ymdantic-0.2.2/tests/search/test_search_instant_mixed.py

@@ -0,0 +1,141 @@
+import pytest
+from ymdantic import YMClient
+from ymdantic.models.search.results import (
+    AlbumSearchResult,
+    ArtistSearchResult,
+    TrackSearchResult,
+)
+
+XOLIDAYBOY_ARTIST_ID = 10878798
+
+
+@pytest.mark.anyio
+async def test_search_instant_mixed(client: YMClient) -> None:
+    response = await client.search_instant_mixed(text="xolidayboy")
+    assert response.text == "xolidayboy"
+    assert len(response.results) > 0
+    assert response.total > 0
+    assert response.per_page > 0
+    assert isinstance(response.search_request_id, str)
+    assert isinstance(response.misspell_corrected, bool)
+
+
+@pytest.mark.anyio
+async def test_search_has_artist_result(client: YMClient) -> None:
+    response = await client.search_instant_mixed(text="xolidayboy")
+    artist_results = [r for r in response.results if isinstance(r, ArtistSearchResult)]
+    assert len(artist_results) > 0, (
+        "Expected at least one artist result for 'xolidayboy'"
+    )
+    artist = artist_results[0].artist
+    assert artist.id == XOLIDAYBOY_ARTIST_ID
+    assert artist.name.lower() == "xolidayboy"
+
+
+@pytest.mark.anyio
+async def test_search_has_track_results(client: YMClient) -> None:
+    response = await client.search_instant_mixed(text="xolidayboy")
+    track_results = [r for r in response.results if isinstance(r, TrackSearchResult)]
+    assert len(track_results) > 0, "Expected at least one track result for 'xolidayboy'"
+    for track_result in track_results:
+        track = track_result.track
+        assert track.id > 0
+        assert track.title
+
+
+@pytest.mark.anyio
+async def test_search_result_types(client: YMClient) -> None:
+    response = await client.search_instant_mixed(text="xolidayboy")
+    for result in response.results:
+        expected_types = (
+            "track",
+            "artist",
+            "album",
+            "podcast_episode",
+            "playlist",
+        )
+        assert result.type in expected_types
+
+
+@pytest.mark.anyio
+async def test_search_with_filter_artist(client: YMClient) -> None:
+    response = await client.search_instant_mixed(
+        text="xolidayboy",
+        filter="artist",
+    )
+    assert len(response.results) > 0
+    for result in response.results:
+        assert isinstance(result, ArtistSearchResult)
+        assert result.type == "artist"
+
+
+@pytest.mark.anyio
+async def test_search_with_filter_track(client: YMClient) -> None:
+    response = await client.search_instant_mixed(
+        text="xolidayboy",
+        filter="track",
+    )
+    assert len(response.results) > 0
+    for result in response.results:
+        assert isinstance(result, TrackSearchResult)
+        assert result.type == "track"
+
+
+@pytest.mark.anyio
+async def test_search_with_filter_album(client: YMClient) -> None:
+    response = await client.search_instant_mixed(
+        text="xolidayboy",
+        filter="album",
+    )
+    assert len(response.results) > 0
+    for result in response.results:
+        assert isinstance(result, AlbumSearchResult)
+        assert result.type == "album"
+
+
+@pytest.mark.anyio
+async def test_search_filters_present(client: YMClient) -> None:
+    response = await client.search_instant_mixed(text="xolidayboy")
+    assert len(response.filters) > 0
+    for f in response.filters:
+        assert f.id
+        assert f.display_name
+
+
+@pytest.mark.anyio
+async def test_search_nocorrect(client: YMClient) -> None:
+    response = await client.search_instant_mixed(
+        text="xolidayboy",
+        nocorrect=True,
+    )
+    assert response.misspell_corrected is False
+    assert response.text == "xolidayboy"
+
+
+@pytest.mark.anyio
+async def test_search_with_page_size(client: YMClient) -> None:
+    page_size = 5
+    response = await client.search_instant_mixed(
+        text="xolidayboy",
+        page_size=page_size,
+    )
+    assert response.per_page == page_size
+    assert len(response.results) <= page_size
+
+
+@pytest.mark.anyio
+async def test_search_misspelled_query(client: YMClient) -> None:
+    response = await client.search_instant_mixed(text="холидейбой")
+    assert len(response.results) > 0
+    artist_results = [r for r in response.results if isinstance(r, ArtistSearchResult)]
+    if artist_results:
+        assert any(a.artist.id == XOLIDAYBOY_ARTIST_ID for a in artist_results)
+
+
+@pytest.mark.anyio
+async def test_search_gibberish_returns_no_results(client: YMClient) -> None:
+    response = await client.search_instant_mixed(
+        text="zzzqqq999xxx888jjj777",
+    )
+    assert response.total == 0
+    assert len(response.results) == 0

{ymdantic-0.2.0 → ymdantic-0.2.2}/tests/tracks/test_get_track.py

@@ -3,7 +3,7 @@ import secrets
 
 import pytest
 from ymdantic import YMClient
-from ymdantic.exceptions.custom_exceptions import YMTrackNotFoundError
+from ymdantic.exceptions import YMTrackNotFoundError
 from ymdantic.models import Podcast, Track, UnavailablePodcast, UnavailableTrack
 
 

ymdantic-0.2.2/tests/tracks/test_get_track_file_info.py

@@ -0,0 +1,21 @@
+import pytest
+from ymdantic import YMClient
+from ymdantic.models.tracks.file_info import FileInfo
+
+
+@pytest.mark.anyio
+async def test_get_available_track_file_info_nq(client: YMClient) -> None:
+    track_id = 83313323
+
+    result = await client.get_track_file_info(track_id=track_id)
+    assert isinstance(result, FileInfo)
+    assert result.quality == "nq"
+
+
+@pytest.mark.anyio
+async def test_get_available_track_file_info_lossless(client: YMClient) -> None:
+    track_id = 117708948
+
+    result = await client.get_track_file_info(track_id=track_id)
+    assert isinstance(result, FileInfo)
+    assert result.quality == "lossless"

{ymdantic-0.2.0 → ymdantic-0.2.2}/tests/tracks/test_get_tracks.py

@@ -1,6 +1,6 @@
 import asyncio
 import secrets
-from typing import TypedDict
+from typing import Type, TypedDict
 
 import pytest
 from ymdantic import YMClient
@@ -14,7 +14,7 @@ class TrackExpected(TypedDict):
 
     type: str
     available: bool
-    instance_type: type[BaseTrack]
+    instance_type: Type[BaseTrack]
 
 
 @pytest.mark.anyio