Padrões básicos de regex

search acha um, findall acha todos

As duas funções que você mais vai usar são re.search e re.findall. A search percorre o texto e para na primeira parte que casa com o padrão, devolvendo um objeto Match; se nada casar, devolve None, que é falso em uma condição. Do Match você lê o trecho encontrado com .group(). Já a findall não para no primeiro: ela devolve uma lista com todos os trechos que casam, do começo ao fim. Use search quando quer saber se existe ou pegar o primeiro; use findall quando quer coletar tudo.

import re

texto = "Notas: 8, 10 e 7 no bimestre"

# search: primeira ocorrencia, como objeto Match
m = re.search(r"\d+", texto)
print(m.group())          # 8

# findall: todas as ocorrencias, como lista
print(re.findall(r"\d+", texto))   # ['8', '10', '7']

# search sem casar devolve None:
print(re.search(r"\d+", "sem numeros aqui"))  # None

search devolve o primeiro Match (ou None); findall devolve a lista de todos os trechos.

Classes e quantificadores

O coração das regex são as classes de caractere, que representam grupos. A classe \d casa com um dígito de 0 a 9. A classe \w casa com um caractere de palavra: letra, dígito ou sublinhado. A classe \s casa com um espaço em branco, o que inclui a tabulação e a quebra de linha. Cada uma dessas casa com apenas um caractere. Para casar com vários, você combina com um quantificador: o sinal de mais (+) exige uma ou mais repetições, e o asterisco (*) aceita zero ou mais. Assim, \d+ casa com um número inteiro inteiro, com quantos dígitos tiver.

import re

# \d+ pega numeros inteiros de qualquer tamanho
print(re.findall(r"\d+", "ano 2026, mes 7, dia 2"))
# ['2026', '7', '2']

# \w+ pega palavras (letras, digitos, sublinhado)
print(re.findall(r"\w+", "user_1 fez login"))
# ['user_1', 'fez', 'login']

# \d{4} exige exatamente 4 digitos (ex.: um ano)
print(re.findall(r"\d{4}", "de 2026 a 2027, codigo 12"))
# ['2026', '2027']  (o 12 tem so 2 digitos, nao casa)

Combinar classe e quantificador descreve formatos: números, palavras, anos de quatro dígitos.

Conjuntos com colchetes e âncoras

Quando as classes prontas não bastam, você monta seu próprio conjunto com colchetes. O padrão [aeiou] casa com uma vogal; [0-9] casa com um dígito, igual a \d; e [a-z] casa com uma letra minúscula. Dentro dos colchetes, o hífen indica um intervalo. As âncoras completam o quadro: o acento circunflexo (^) marca o começo do texto e o cifrão ($) marca o fim. Elas não casam com um caractere; casam com uma posição. Com ^ e $ você exige que o padrão descreva o texto inteiro, não só um pedaço no meio.

import re

# Conjunto: um caractere que seja vogal
print(re.findall(r"[aeiou]", "Python"))   # ['o']

# Intervalo dentro do conjunto: uma letra minuscula
print(re.findall(r"[a-z]+", "Ola Mundo 123"))  # ['la', 'undo']

# Ancoras: o texto INTEIRO e formado por digitos?
print(bool(re.search(r"^\d+$", "12345")))   # True
print(bool(re.search(r"^\d+$", "123a5")))   # False (tem letra)
print(bool(re.search(r"^\d+$", "12 45")))   # False (tem espaco)

Colchetes montam conjuntos; ^ e $ prendem o padrão ao início e ao fim do texto.

Junte as peças e você já descreve formatos úteis. Um e-mail bem simples, por exemplo, é uma sequência de caracteres de palavra, um arroba, mais caracteres, um ponto e o final: \w+@\w+\.\w+. Repare no \. com barra invertida: como o ponto sozinho é um símbolo especial de regex (casa com qualquer caractere), você escapa com barra para dizer que quer um ponto literal. Esse padrão não valida todos os e-mails do mundo, mas mostra como classes, o arroba literal e o ponto escapado se combinam para reconhecer uma forma real.

import re

# E-mail simples: palavra, arroba, palavra, ponto, palavra
padrao = r"\w+@\w+\.\w+"

texto = "Contatos: ana@exemplo.com e joao@teste.org"
print(re.findall(padrao, texto))
# ['ana@exemplo.com', 'joao@teste.org']

# O ponto precisa de barra (\.) para ser um ponto literal,
# senao ele casaria com QUALQUER caractere.

Um padrão de e-mail simples reúne classes, o arroba literal e o ponto escapado com \.