Expose ownership for library playlists

[seppegadeyne]

Summary

• expose owned for playlists parsed from library/grid cards
• derive ownership from the language-independent playlistEditorEndpoint
• document the new return field and correct the library return description
• add parser tests for owned and saved playlists

Why

get_library_playlists() currently drops the edit endpoint contained in the raw playlist card. Downstream clients therefore cannot distinguish an owned playlist from a saved playlist without issuing an extra detail request per item.

The new boolean is independent of playlist privacy: public, unlisted, and private playlists can all be editable when owned by the authenticated account.

Closes #971

Downstream

This unblocks the owned-playlist editability fix in music-assistant/server#5187, which is waiting for this change to be merged and released.

Tests

pytest -o addopts='' tests/parsers -q
36 passed

pre-commit run --files ytmusicapi/parsers/browsing.py ytmusicapi/mixins/library.py tests/parsers/test_browsing.py
ruff: passed
ruff format: passed
mypy: passed

[Copilot]

Pull request overview

This PR adds an ownership signal to playlist objects returned from library/grid playlist cards so downstream clients can distinguish owned (editable) playlists from saved playlists without additional requests.

Changes:

• Add an owned: bool field to parse_playlist() derived from the presence of a matching playlistEditorEndpoint.playlistId.
• Update get_library_playlists() docstring to describe library playlists (not only owned) and document the new owned field.
• Add parser tests for owned vs not-owned playlists.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

File	Description
ytmusicapi/parsers/browsing.py	Derives and exposes owned for playlists parsed from browsing/grid cards via playlistEditorEndpoint.
ytmusicapi/mixins/library.py	Updates get_library_playlists() documentation to include owned and correct the return description/example.
tests/parsers/test_browsing.py	Adds unit tests asserting parse_playlist() sets owned appropriately.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated no new comments.

Suppressed comments (1)

ytmusicapi/mixins/library.py:34

• Docstring example shows count as an int (5), but parse_playlist() sets count to nav(...).split(' ')[0], which returns a string (e.g. '5'). This can mislead API consumers about the return type.

                'count': 5,

[Copilot]

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated no new comments.

[Copilot]

Copilot was unable to review this pull request because the user who requested the review is ineligible. To be eligible to request a review, you need a paid Copilot license, or your organization must enable Copilot code review.

[Copilot]

Copilot was unable to review this pull request because the user who requested the review is ineligible. To be eligible to request a review, you need a paid Copilot license, or your organization must enable Copilot code review.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 95.78%. Comparing base (488d39b) to head (b452698).
⚠️ Report is 1 commits behind head on main.
✅ All tests successful. No failed tests found.

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #972   +/-   ##
=======================================
  Coverage   95.77%   95.78%           
=======================================
  Files          47       47           
  Lines        2725     2727    +2     
=======================================
+ Hits         2610     2612    +2     
  Misses        115      115           

Flag	Coverage Δ
unittests	95.78% <100.00%> (+<0.01%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

[Copilot]

Copilot was unable to review this pull request because the user who requested the review is ineligible. To be eligible to request a review, you need a paid Copilot license, or your organization must enable Copilot code review.