Skip to content

feat(py_common): Update py_common types to match Stash schema#2628

Merged
feederbox826 merged 3 commits intostashapp:masterfrom
xantror:xantror/update-py_common_types
Feb 21, 2026
Merged

feat(py_common): Update py_common types to match Stash schema#2628
feederbox826 merged 3 commits intostashapp:masterfrom
xantror:xantror/update-py_common_types

Conversation

@xantror
Copy link
Copy Markdown
Contributor

@xantror xantror commented Dec 27, 2025

Align py_common TypedDicts with Stash schema: add stored IDs, replace deprecated single url with urls, rename ScrapedMovie → ScrapedGroup, and remove deprecated fields.

  • ScrapedTag/Performer/Studio/Group/Gallery/Scene/Image: added stored_id, codes, photographers, directors, durations, and urls where appropriate.
  • ScrapedMovie renamed to ScrapedGroup; ScrapedMovie kept as alias.
  • Removed deprecated single url fields and other deprecated fields; added deprecation docstrings where applicable.

Signed-off-by: xantror <69341873+xantror@users.noreply.github.com>
@xantror xantror force-pushed the xantror/update-py_common_types branch from aa8c77b to a74b6bc Compare December 27, 2025 23:17
@xantror xantror changed the title chore(py_common): Update py_common types to match Stash schema feat(py_common): Update py_common types to match Stash schema Dec 27, 2025
@feederbox826
Copy link
Copy Markdown
Member

don't add back url

Signed-off-by: xantror <69341873+xantror@users.noreply.github.com>
Copy link
Copy Markdown
Collaborator

@Maista6969 Maista6969 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good to me but I'm not sure if the stored_id fields should be included from the scraper side

Comment on lines +43 to +44
stored_id: str
"Set if performer matched"
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What does this mean? Are there cases where scrapers do their own matching against Stash's database? I think this is an internal field that scrapers do not need to be concerned with

Copy link
Copy Markdown
Contributor Author

@xantror xantror Dec 28, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The field is supported by Stash as far as I could see e.g. if somebody were to do some gql query to match within their scraper they could chose to return this field for a more exact match than what Stash might provide internally.

I don't think that any of the current scrapers use this functionality but who knows what people might need in the future.

Comment thread scrapers/py_common/types.py Outdated
…base64 options

Signed-off-by: xantror <69341873+xantror@users.noreply.github.com>
Copy link
Copy Markdown
Member

@feederbox826 feederbox826 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Long overdue but LGTM. I'll try to resolve some other PRs to avoid merge nightmares or just YOLO if I don't get to it in time

@feederbox826 feederbox826 merged commit 7ebacfa into stashapp:master Feb 21, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants