Skip to content

prerelease_handler

Prerelease track detection and handling.

Determines how to handle albums containing prerelease tracks based on the configured handling mode (skip_all, mark_only, process_editable).

PrereleaseHandler 

PrereleaseHandler(
    *,
    console_logger,
    config,
    pending_verification,
    prerelease_recheck_days
)

Handles prerelease track detection and filtering.

Responsibilities: - Detect prerelease tracks in an album - Apply configured handling mode (skip_all, mark_only, process_editable) - Mark albums for verification when appropriate

Source code in src/core/tracks/prerelease_handler.py 
30
31
32
33
34
35
36
37
38
39
40
41
def __init__(
    self,
    *,
    console_logger: logging.Logger,
    config: AppConfig,
    pending_verification: PendingVerificationServiceProtocol,
    prerelease_recheck_days: int,
) -> None:
    self.console_logger = console_logger
    self.config = config
    self.pending_verification = pending_verification
    self.prerelease_recheck_days = prerelease_recheck_days

handle_prerelease_tracks async 

handle_prerelease_tracks(artist, album, album_tracks)

Handle prerelease track detection and filtering.

Checks for prerelease tracks and applies the configured handling mode.

Parameters:

Name Type Description Default
artist str

Artist name

 required
album str

Album name

 required
album_tracks list[TrackDict]

List of all tracks in the album

 required

Returns:

Type Description
bool

Tuple of (should_continue, editable_tracks):
list[TrackDict]
  • should_continue: False if processing should stop
tuple[bool, list[TrackDict]]
  • editable_tracks: Filtered list of tracks that can be edited
Source code in src/core/tracks/prerelease_handler.py 
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
async def handle_prerelease_tracks(
    self,
    artist: str,
    album: str,
    album_tracks: list[TrackDict],
) -> tuple[bool, list[TrackDict]]:
    """Handle prerelease track detection and filtering.

    Checks for prerelease tracks and applies the configured handling mode.

    Args:
        artist: Artist name
        album: Album name
        album_tracks: List of all tracks in the album

    Returns:
        Tuple of (should_continue, editable_tracks):
        - should_continue: False if processing should stop
        - editable_tracks: Filtered list of tracks that can be edited

    """
    original_track_count = len(album_tracks)
    prerelease_tracks = [track for track in album_tracks if is_prerelease_status(track.track_status)]
    has_prerelease = len(prerelease_tracks) > 0
    editable_tracks = [track for track in album_tracks if can_edit_metadata(track.track_status)]

    if not has_prerelease:
        return True, editable_tracks

    prerelease_handling = self._get_prerelease_handling_mode(artist, album)

    if prerelease_handling == "skip_all":
        self.console_logger.info(
            "[SKIP] %s - %s: contains prerelease tracks (%d/%d) - skip_all mode",
            artist,
            album,
            len(prerelease_tracks),
            original_track_count,
        )
        return False, []

    if prerelease_handling == "mark_only":
        self.console_logger.info(
            "[MARK] %s - %s: %d prerelease + %d editable - mark_only mode",
            artist,
            album,
            len(prerelease_tracks),
            len(editable_tracks),
        )
        await self.pending_verification.mark_for_verification(
            artist,
            album,
            reason="prerelease",
            metadata={
                "track_count": str(original_track_count),
                "prerelease_count": str(len(prerelease_tracks)),
                "editable_count": str(len(editable_tracks)),
                "mode": "mark_only",
            },
            recheck_days=self.prerelease_recheck_days,
        )
        return False, []

    # process_editable mode: check if we have any editable tracks
    if not editable_tracks:
        self.console_logger.debug(
            "Skipping album '%s - %s': no editable tracks (%d/%d tracks are prerelease)",
            artist,
            album,
            len(prerelease_tracks),
            original_track_count,
        )
        await self.pending_verification.mark_for_verification(
            artist,
            album,
            reason="prerelease",
            metadata={
                "track_count": str(original_track_count),
                "prerelease_count": str(len(prerelease_tracks)),
                "all_prerelease": "true",
            },
            recheck_days=self.prerelease_recheck_days,
        )
        return False, []

    # Mixed album: mark for verification but continue processing editable tracks
    self.console_logger.info(
        "[MIXED] %s - %s: %d prerelease + %d editable - marking for verification, processing editable",
        artist,
        album,
        len(prerelease_tracks),
        len(editable_tracks),
    )
    await self.pending_verification.mark_for_verification(
        artist,
        album,
        reason="prerelease",
        metadata={
            "track_count": str(original_track_count),
            "prerelease_count": str(len(prerelease_tracks)),
            "editable_count": str(len(editable_tracks)),
            "mixed_album": "true",
        },
        recheck_days=self.prerelease_recheck_days,
    )
    return True, editable_tracks