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

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

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): # type: ignore
                failed_keys.add(f"exclude_regex '{pattern.pattern}'") # type: ignore
                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, list]	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

def check_fetch(data: ParsedData, settings: SettingsModel, speed_mode: bool = True) -> tuple[bool, list]:
    """
    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[str] = set()

    if speed_mode: # Fail as soon as possible
        if trash_handler(data, settings, failed_keys):
            return False, list(failed_keys)
        if adult_handler(data, settings, failed_keys):
            return False, list(failed_keys)
        if check_required(data, settings):
            return True, list(failed_keys)
        if check_exclude(data, settings, failed_keys):
            return False, list(failed_keys)
        if language_handler(data, settings, failed_keys):
            return False, list(failed_keys)
        if fetch_resolution(data, settings, failed_keys):
            return False, list(failed_keys)
        if fetch_quality(data, settings, failed_keys):
            return False, list(failed_keys)
        if fetch_audio(data, settings, failed_keys):
            return False, list(failed_keys)
        if fetch_hdr(data, settings, failed_keys):
            return False, list(failed_keys)
        if fetch_codec(data, settings, failed_keys):
            return False, list(failed_keys)
        if fetch_other(data, settings, failed_keys):
            return False, list(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, list(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

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

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

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

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

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

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

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.

Logic: 1. If no languages detected and remove_unknown_languages is True -> exclude 2. If no languages detected and required is set -> exclude 3. If required languages are set and torrent has NONE of them -> exclude 4. If allow_english_in_languages is True and torrent has English -> accept 5. If torrent has any allowed language -> accept (bypass exclusion check) 6. If torrent has any excluded language -> exclude 7. Otherwise -> accept

Returns:

Name	Type	Description
bool	bool	True if the languages should be excluded, otherwise False.

Source code in RTN/fetch.py

def language_handler(data: ParsedData, settings: SettingsModel, failed_keys: set) -> bool:
    """
    Check if the languages are excluded based on user settings.

    Logic:
    1. If no languages detected and remove_unknown_languages is True -> exclude
    2. If no languages detected and required is set -> exclude
    3. If required languages are set and torrent has NONE of them -> exclude
    4. If allow_english_in_languages is True and torrent has English -> accept
    5. If torrent has any allowed language -> accept (bypass exclusion check)
    6. If torrent has any excluded language -> exclude
    7. Otherwise -> accept

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

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

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

    if required_langs and not any(lang in required_langs for lang in data.languages):
        failed_keys.add("missing_required_language")
        return True

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

    if allowed_langs and any(lang in allowed_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

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", []))
    allowed_langs = set(settings.languages.get("allowed", []))

    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)
        if lang_group in allowed_langs:
            allowed_langs.update(lang_set)

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

trash_handler(data, settings, failed_keys)

Check if the title is trash based on user settings.

Source code in RTN/fetch.py

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