francwa
0fb59a4581
The four resolve_*_destination use cases now route through a private
_resolve_parsed helper that picks the right entry point:
- source path provided AND it exists -> inspect_release(name, path)
runs the full pipeline (parse + media-type refinement + probe
+ enrich), so missing tech tokens (quality, codec, ...) get
filled by ffprobe and the refreshed tech_string lands in the
destination folder / file names.
- source path missing or absent -> parse_release(name) only,
same behavior as before. Back-compat: tests using fake /dl/*.mkv
paths still pass unchanged.
resolve_episode_destination / resolve_movie_destination reuse their
existing source_file parameter as the inspection target. The two
folder-move use cases (season / series) gain a new OPTIONAL
source_path parameter — threaded through the agent tool wrappers
and documented in the YAML specs.
The lazy import inside _resolve_parsed avoids a circular import:
inspect_release imports detect_media_type / enrich_from_probe from
the same application.filesystem package whose __init__ re-exports
resolve_destination.
Three new tests in TestProbeEnrichmentWiring with a stub MediaProber
prove the wiring: movie picks up probe quality, season picks it up
via source_path, and a missing path correctly skips probe (back-compat
guard).
88 lines
3.0 KiB
YAML
88 lines
3.0 KiB
YAML
name: resolve_series_destination
|
|
|
|
summary: >
|
|
Compute the destination path for a complete multi-season series pack (folder move).
|
|
|
|
description: |
|
|
Resolves the target series folder for a pack that contains multiple seasons
|
|
(e.g. S01-S05 in a single release). Returns only the series folder — the
|
|
whole source folder is moved as-is into the library, no per-season
|
|
restructuring. If a folder with a different name already exists for this
|
|
show, returns needs_clarification.
|
|
|
|
when_to_use: |
|
|
Use after analyze_release has identified the release as a complete-series
|
|
pack (media_type=tv_complete, or multi-season indicators). TMDB must
|
|
already be queried for canonical title/year.
|
|
|
|
when_not_to_use: |
|
|
- Single-season packs: use resolve_season_destination.
|
|
- Single episodes: use resolve_episode_destination.
|
|
- Movies: use resolve_movie_destination.
|
|
|
|
next_steps: |
|
|
- On status=ok: call move_to_destination with source=<download folder> and
|
|
destination=series_folder.
|
|
- On status=needs_clarification: ask the user, re-call with
|
|
confirmed_folder set.
|
|
- On status=error: surface the message; do not move.
|
|
|
|
parameters:
|
|
release_name:
|
|
description: Raw release folder name as it appears on disk.
|
|
why_needed: |
|
|
Drives extraction of quality/source/codec/group tokens for the target
|
|
folder name, even though the multi-season structure inside is kept
|
|
as-is.
|
|
example: The.Wire.S01-S05.1080p.BluRay.x265-GROUP
|
|
|
|
tmdb_title:
|
|
description: Canonical show title from TMDB.
|
|
why_needed: |
|
|
Title prefix of the series folder; comes from TMDB to avoid raw
|
|
release-name spellings.
|
|
example: The Wire
|
|
|
|
tmdb_year:
|
|
description: Show start year from TMDB.
|
|
why_needed: |
|
|
Disambiguates shows that share a title across eras and locks the
|
|
folder identity.
|
|
example: "2002"
|
|
|
|
confirmed_folder:
|
|
description: Folder name chosen by the user after needs_clarification.
|
|
why_needed: |
|
|
Forces the use case to use this exact folder name and skip detection.
|
|
example: The.Wire.2002.1080p.BluRay.x265-GROUP
|
|
|
|
source_path:
|
|
description: |
|
|
Absolute path to the release folder on disk. Optional.
|
|
why_needed: |
|
|
When provided, the tool runs ffprobe on the main video inside the
|
|
folder and uses probe data to fill quality/codec tokens that may
|
|
be missing from the release name, producing a more accurate
|
|
destination folder name.
|
|
example: /downloads/The.Wire.S01-S05.1080p.BluRay.x265-GROUP
|
|
|
|
returns:
|
|
ok:
|
|
description: Path resolved; ready to move the pack.
|
|
fields:
|
|
series_folder: Absolute path to the destination series folder.
|
|
series_folder_name: Folder name for display.
|
|
is_new_series_folder: True if the folder doesn't exist yet.
|
|
|
|
needs_clarification:
|
|
description: A folder exists with a different name; ask the user.
|
|
fields:
|
|
question: Human-readable question.
|
|
options: List of folder names to pick from.
|
|
|
|
error:
|
|
description: Resolution failed.
|
|
fields:
|
|
error: Short error code.
|
|
message: Human-readable explanation.
|