Module text 

Utilitários para manipulação de Strings em nomes de jogos, séries e tags.

Functions

contains_word_boundary

Verifica se needle aparece em haystack com fronteira de palavra nos dois lados (sem letra/dígito colado antes ou depois). Evita falsos positivos como “demo” dentro de “demon’s” ou “trial” dentro de “trials”.

is_likely_non_base_game

Heurística por palavra-chave para identificar nomes que provavelmente não são o jogo-base (DLC, edição especial, trilha sonora, demo, pré-venda). Não é definitivo — é um filtro barato para descartar candidatos óbvios antes de aplicar critérios mais confiáveis (match exato, dados estruturados).

normalize_for_matching

Normaliza para comparação/matching: minúsculo, sem símbolos, sem pontuação de separador. Uso: cache keys, dedup, series matching, comparação com resultado de busca externa.

strip_edition_suffix

Remove sufixo de edição conhecido do final do nome, se houver. Usado como segunda tentativa de match quando o nome completo (com edição) não bate.

strip_trademark_symbols

Remove símbolos de marca registrada, preservando capitalização e conteúdo. Uso: limpar nome antes de persistir (import), exibição.