Objetivo: Criar funções que utilizem Expressões Regulares para extrair padrões específicos de texto (como números de telefone, datas, etc.) de strings mais longas.

1. Extração de Números de Telefone

Criar uma função que encontre e retorne todos os números de telefone em um texto, aceitando diferentes formatos comuns.

1. Abra o arquivo exercicios_regex.py.
2. Crie uma nova função chamada extrair_numeros_telefone que aceite um argumento: texto (string).
3. Dentro da função, defina uma expressão regular (padrão regex) que seja capaz de capturar números de telefone nos seguintes formatos (e suas variações):
   • (DD) XXXX-XXXX (ex: (11) 1234-5678)
   • (DD) XXXXX-XXXX (ex: (11) 91234-5678)
   • DD XXXX-XXXX (ex: 11 1234-5678) - sem parênteses, com espaço
   • DD XXXXX-XXXX (ex: 11 91234-5678) - sem parênteses, com espaço
   • DDXXXXXXXXX (ex: 11912345678) - sem espaços ou hífens (apenas dígitos)
   • Dicas:
     • Use \\d para dígitos.
     • Use {n} para quantidades exatas (ex: {2} para 2 dígitos).
     • Use {n,m} para quantidades mínimas e máximas (ex: {4,5} para 4 ou 5 dígitos).
     • Use ? para tornar um caractere ou grupo opcional (ex: (grupo)?).
     • Use \\s para espaços em branco e para zero ou mais ocorrências.
     • O | (pipe) é útil para combinar diferentes padrões (OU lógico).
     • Você provavelmente usará re.findall() para encontrar todas as ocorrências.
4. A função extrair_numeros_telefone deve retornar uma lista de strings, onde cada string é um número de telefone encontrado. Se nenhum for encontrado, deve retornar uma lista vazia.

2. Adicionar Testes Unitários para Extração de Telefones

1. Abra o arquivo test_exercicios_regex.py.
2. Importe a nova função extrair_numeros_telefone no início do arquivo de testes.
3. Dentro da sua classe TestValidarEmail (ou crie uma nova TestExtrairInformacoes se achar que faz mais sentido para organizar, mas por agora podemos manter na mesma), escreva pelo menos 3 métodos de teste (test_...) para extrair_numeros_telefone:
   • Um teste com um texto contendo vários números de telefone em diferentes formatos.
   • Um teste com um texto que não contém números de telefone.
   • Um teste com um texto que contém números, mas não no formato de telefone (ex: 12345 que não é um telefone completo).
   • Use self.assertEqual(lista_resultante, lista_esperada).

3. Adicionar Demonstração

1. No bloco if __name__ == "__main__": do arquivo exercicios_regex.py, adicione chamadas à função extrair_numeros_telefone com textos de exemplo e imprima os resultados.

Revisão Final e Boas Práticas:

• Docstrings: Volte e adicione docstrings completas para a função extrair_numeros_telefone e para cada método de teste, explicando seu propósito, argumentos, retorno e detalhes importantes.
• Formatação: Use black e isort para formatar seus arquivos (black . e isort . na pasta do exercício, com a venv ativada).
• Testes: Certifique-se de que todos os seus testes passam.