Skip to content

Fetch

This module contains functions to determine if a torrent should be fetched based on user settings.

Functions: - check_fetch: Evaluates user settings and unwanted quality to decide if a torrent should be fetched. - check_trash: Identifies if the title contains any unwanted patterns. - trash_handler: Checks if the title is trash based on user settings, return True if trash is detected. - language_handler: Checks if the languages are excluded based on user settings.

Parameters: - raw_title (str): The raw title string to evaluate. - data (ParsedData): The parsed data object containing information about the torrent title. - settings (SettingsModel): The user settings object containing custom ranking models.

For more information on each function, refer to the respective docstrings.

adult_handler(data, settings, failed_keys)

Check if the title is adult based on user settings.

Source code in RTN/fetch.py
112
113
114
115
116
117
def adult_handler(data: ParsedData, settings: SettingsModel, failed_keys: set) -> bool:
    """Check if the title is adult based on user settings."""
    if data.adult and settings.options.get("remove_adult_content", True):
        failed_keys.add("trash_adult")
        return True
    return False

check_exclude(data, settings, failed_keys)

Check if the title contains excluded patterns.

Source code in RTN/fetch.py
184
185
186
187
188
189
190
191
def check_exclude(data: ParsedData, settings: SettingsModel, failed_keys: set) -> bool:
    """Check if the title contains excluded patterns."""
    if settings.exclude:
        for pattern in settings.exclude:
            if pattern and pattern.search(data.raw_title):
                failed_keys.add(f"exclude_regex '{pattern.pattern}'")
                return True
    return False

check_fetch(data, settings, speed_mode=True)

Check user settings and unwanted quality to determine if torrent should be fetched.

Parameters:

Name Type Description Default
`data` ParsedData

The parsed data object containing information about the torrent title.

required
`settings` SettingsModel

The user settings object containing custom ranking models.

required

Returns:

Name Type Description
bool tuple[bool, set]

True if the torrent should be fetched, otherwise False.

Raises:

Type Description
TypeError

If the parsed data is not a ParsedData object.

TypeError

If the settings is not a SettingsModel object.

Source code in RTN/fetch.py
33
34
35
36
37
38
39
40
41
42
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
def check_fetch(data: ParsedData, settings: SettingsModel, speed_mode: bool = True) -> tuple[bool, set]:
    """
    Check user settings and unwanted quality to determine if torrent should be fetched.

    Parameters:
        `data` (ParsedData): The parsed data object containing information about the torrent title.
        `settings` (SettingsModel): The user settings object containing custom ranking models.

    Returns:
        bool: True if the torrent should be fetched, otherwise False.

    Raises:
        TypeError: If the parsed data is not a ParsedData object.
        TypeError: If the settings is not a SettingsModel object.
    """
    if not isinstance(data, ParsedData):
        raise TypeError("Parsed data must be an instance of ParsedData.")
    if not isinstance(settings, SettingsModel):
        raise TypeError("Settings must be an instance of SettingsModel.")

    failed_keys = set()

    if speed_mode: # Fail as soon as possible
        if trash_handler(data, settings, failed_keys):
            return False, failed_keys
        if adult_handler(data, settings, failed_keys):
            return False, failed_keys
        if check_required(data, settings):
            return True, failed_keys
        if check_exclude(data, settings, failed_keys):
            return False, failed_keys
        if language_handler(data, settings, failed_keys):
            return False, failed_keys
        if fetch_resolution(data, settings, failed_keys):
            return False, failed_keys
        if fetch_quality(data, settings, failed_keys):
            return False, failed_keys
        if fetch_audio(data, settings, failed_keys):
            return False, failed_keys
        if fetch_hdr(data, settings, failed_keys):
            return False, failed_keys
        if fetch_codec(data, settings, failed_keys):
            return False, failed_keys
        if fetch_other(data, settings, failed_keys):
            return False, failed_keys
    else: # Gather all failed keys for more information
        trash_handler(data, settings, failed_keys)
        adult_handler(data, settings, failed_keys)
        check_required(data, settings)
        check_exclude(data, settings, failed_keys)
        language_handler(data, settings, failed_keys)
        fetch_resolution(data, settings, failed_keys)
        fetch_quality(data, settings, failed_keys)
        fetch_audio(data, settings, failed_keys)
        fetch_hdr(data, settings, failed_keys)
        fetch_codec(data, settings, failed_keys)
        fetch_other(data, settings, failed_keys)

    if failed_keys:
        return False, failed_keys

    return True, list(failed_keys)

check_required(data, settings)

Check if the title meets the required patterns.

Source code in RTN/fetch.py
177
178
179
180
181
def check_required(data: ParsedData, settings: SettingsModel) -> bool:
    """Check if the title meets the required patterns."""
    if settings.require and any(pattern.search(data.raw_title) for pattern in settings.require if pattern):  # type: ignore
        return True
    return False

fetch_audio(data, settings, failed_keys)

Check if the audio is fetchable based on user settings.

Source code in RTN/fetch.py
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
def fetch_audio(data: ParsedData, settings: SettingsModel, failed_keys: set) -> bool:
    """Check if the audio is fetchable based on user settings."""
    if not data.audio:
        return False

    audio_map = {
        "AAC": "aac",
        # "OPUS": "opus",
        "Atmos": "atmos",
        "Dolby Digital": "dolby_digital",
        "Dolby Digital Plus": "dolby_digital_plus",
        "DTS Lossy": "dts_lossy",
        "DTS Lossless": "dts_lossless",
        # "PCM": "pcm",
        "FLAC": "flac",
        "MP3": "mp3",
        "TrueHD": "truehd",
        "HQ Clean Audio": "clean_audio"
    }

    for audio_format in data.audio:
        if audio_format not in audio_map:
            # PTN parses other audio formats that RTN doesn't support.
            continue

        category = "trash" if audio_format == "HQ Clean Audio" else "audio"
        key = audio_map[audio_format]
        if not settings.custom_ranks[category][key].fetch:
            failed_keys.add(f"{category}_{key}")
            return True
    return False

fetch_codec(data, settings, failed_keys)

Check if the codec is fetchable based on user settings.

Source code in RTN/fetch.py
258
259
260
261
262
263
264
265
266
267
def fetch_codec(data: ParsedData, settings: SettingsModel, failed_keys: set) -> bool:
    """Check if the codec is fetchable based on user settings."""
    if not data.codec:
        return False

    if data.codec.lower() in ["avc", "hevc", "av1", "xvid", "mpeg"]:
        if not settings.custom_ranks["quality"][data.codec.lower()].fetch:
            failed_keys.add(f"codec_{data.codec.lower()}")
            return True
    return False

fetch_hdr(data, settings, failed_keys)

Check if the HDR is fetchable based on user settings.

Source code in RTN/fetch.py
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
def fetch_hdr(data: ParsedData, settings: SettingsModel, failed_keys: set) -> bool:
    """Check if the HDR is fetchable based on user settings."""
    if not data.hdr:
        return False

    hdr_map = {
        "DV": "dolby_vision",
        "HDR": "hdr",
        "HDR10+": "hdr10plus",
        "SDR": "sdr"
    }

    for hdr_format in data.hdr:
        if not settings.custom_ranks["hdr"][hdr_map[hdr_format]].fetch:
            failed_keys.add(f"hdr_{hdr_map[hdr_format]}")
            return True
    return False

fetch_other(data, settings, failed_keys)

Check if the other data is fetchable based on user settings.

Source code in RTN/fetch.py
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
def fetch_other(data: ParsedData, settings: SettingsModel, failed_keys: set) -> bool:
    """Check if the other data is fetchable based on user settings."""
    fetch_map = {
        "_3d": ("extras", "three_d"),
        "converted": ("extras", "converted"),
        "documentary": ("extras", "documentary"),
        "dubbed": ("extras", "dubbed"),
        "edition": ("extras", "edition"),
        "hardcoded": ("extras", "hardcoded"),
        "network": ("extras", "network"),
        "proper": ("extras", "proper"),
        "repack": ("extras", "repack"),
        "retail": ("extras", "retail"),
        "subbed": ("extras", "subbed"),
        "upscaled": ("extras", "upscaled"),
        "site": ("extras", "site"),
        "size": ("trash", "size"),
        "bit_depth": ("hdr", "10bit"),
        "scene": ("extras", "scene"),
        "uncensored": ("extras", "uncensored")
    }

    for attr, (category, key) in fetch_map.items():
        if getattr(data, attr) and not settings.custom_ranks[category][key].fetch:
            failed_keys.add(f"{category}_{key}")
            return True
    return False

fetch_quality(data, settings, failed_keys)

Check if the quality is fetchable based on user settings.

Source code in RTN/fetch.py
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
def fetch_quality(data: ParsedData, settings: SettingsModel, failed_keys: set) -> bool:
    """Check if the quality is fetchable based on user settings."""
    if not data.quality:
        return False

    quality_map = {
        # parse result, (settings location, settings key)
        "WEB": ("quality", "web"),
        "WEB-DL": ("quality", "webdl"),
        "BluRay": ("quality", "bluray"),
        "HDTV": ("quality", "hdtv"),
        "VHS": ("quality", "vhs"),
        "WEBMux": ("quality", "webmux"),
        "BluRay REMUX": ("quality", "remux"),
        "REMUX": ("quality", "remux"),
        "WEBRip": ("rips", "webrip"),
        "WEB-DLRip": ("rips", "webdlrip"),
        "UHDRip": ("rips", "uhdrip"),
        "HDRip": ("rips", "hdrip"),
        "DVDRip": ("rips", "dvdrip"),
        "BDRip": ("rips", "bdrip"),
        "BRRip": ("rips", "brrip"),
        "VHSRip": ("rips", "vhsrip"),
        "PPVRip": ("rips", "ppvrip"),
        "SATRip": ("rips", "satrip"),
        "TeleCine": ("trash", "telecine"),
        "TeleSync": ("trash", "telesync"),
        "SCR": ("trash", "screener"),
        "R5": ("trash", "r5"),
        "CAM": ("trash", "cam"),
        "PDTV": ("trash", "pdtv")
    }

    category, key = quality_map.get(data.quality, (None, None))
    if category and key:
        if not settings.custom_ranks[category][key].fetch:
            failed_keys.add(f"{category}_{key}")
            return True
    return False

fetch_resolution(data, settings, failed_keys)

Check if the resolution is fetchable based on user settings.

Source code in RTN/fetch.py
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
def fetch_resolution(data: ParsedData, settings: SettingsModel, failed_keys: set) -> bool:
    """Check if the resolution is fetchable based on user settings."""
    if not data.resolution:
        if not settings.resolutions["unknown"]:
            failed_keys.add("resolution_unknown")
            return True
        return False

    res_map = {
        "2160p": "2160p", "4k": "2160p",
        "1080p": "1080p", "1440p": "1080p",
        "720p": "720p",
        "480p": "480p", "576p": "480p",
        "360p": "360p", "240p": "360p"
    }

    res_key = res_map.get(data.resolution.lower(), "unknown")
    if not settings.resolutions[res_key]:
        failed_keys.add(f"resolution")
        return True
    return False

language_handler(data, settings, failed_keys)

Check if the languages are excluded based on user settings. If the languages are not found, it will fail if remove_unknown_languages is True.

Returns:

Name Type Description
bool bool

True if the languages are excluded, otherwise False.

Source code in RTN/fetch.py
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
149
150
151
152
def language_handler(data: ParsedData, settings: SettingsModel, failed_keys: set) -> bool:
    """
    Check if the languages are excluded based on user settings.
    If the languages are not found, it will fail if remove_unknown_languages is True.

    Returns:
        bool: True if the languages are excluded, otherwise False.
    """
    populate_langs(settings)

    remove_unknown = settings.options.get("remove_unknown_languages", False)
    required_langs = settings.languages.get("required", [])
    exclude_langs = settings.languages.get("exclude", [])

    if not data.languages:
        if remove_unknown:
            failed_keys.add("unknown_language")
            return True
        return False

    if "en" in data.languages and settings.options.get("allow_english_in_languages", False):
        return False

    if required_langs and any(lang in required_langs for lang in data.languages):
        return False

    excluded = [lang for lang in data.languages if lang in exclude_langs]
    if excluded:
        for lang in excluded:
            failed_keys.add(f"lang_{lang}")
        return True

    return False

populate_langs(settings)

Populate the languages based on user settings.

Source code in RTN/fetch.py
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
def populate_langs(settings: SettingsModel) -> None:
    """Populate the languages based on user settings."""
    exclude_langs = set(settings.languages.get("exclude", []))
    required_langs = set(settings.languages.get("required", []))

    language_groups = {
        "anime": ANIME,
        "non_anime": NON_ANIME,
        "common": COMMON,
        "all": ALL
    }

    for lang_group, lang_set in language_groups.items():
        if lang_group in exclude_langs:
            exclude_langs.update(lang_set)
        if lang_group in required_langs:
            required_langs.update(lang_set)

    settings.languages.exclude = list(exclude_langs)
    settings.languages.required = list(required_langs)

trash_handler(data, settings, failed_keys)

Check if the title is trash based on user settings.

Source code in RTN/fetch.py
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
def trash_handler(data: ParsedData, settings: SettingsModel, failed_keys: set) -> bool:
    """Check if the title is trash based on user settings."""
    if settings.options["remove_all_trash"]:
        if data.quality in ["CAM", "PDTV", "R5", "SCR", "TeleCine", "TeleSync"]:
            failed_keys.add("trash_quality")
            return True
        if "HQ Clean Audio" in data.audio:
            failed_keys.add("trash_audio")
            return True
        if hasattr(data, "trash") and data.trash:
            failed_keys.add("trash_flag")
            return True
    return False