[feat] add find files methods

[CuriousGu]

Descrição

[Descreva as mudanças que este PR introduz. Inclua o contexto necessário para entender as alterações.]

Tipo de Mudança

• feat: Nova funcionalidade
• fix: Correção de bug
• docs: Alterações na documentação
• refactor: Refatoração de código sem alteração de funcionalidade
• chore: Tarefas de manutenção

Checklist do Autor

• Segui as diretrizes da PEP 8
• Utilizei type hints para melhorar a legibilidade
• Mantive funções pequenas e focadas em uma única responsabilidade
• Realizei uma auto-revisão do meu próprio código
• Comentei meu código, especialmente em áreas difíceis de entender
• Fiz as alterações correspondentes na documentação
• Buildei o container e funcionou normalmente

Testes

[Descreva os testes que você realizou para verificar suas mudanças. Forneça instruções para reproduzir os testes.]

Processo de Review

Verificação Automática

• Linting (verificação de estilo de código)
• Testes unitários e de integração
• Cobertura de código

Review Manual

• Clareza do código e legibilidade
• Qualidade da documentação
• Performance e otimizações
• Segurança e tratamento de erros

Referências

[Adicione links para issues, documentação ou outros recursos relevantes]

Observações Adicionais

[Adicione qualquer informação adicional que possa ser relevante para os revisores]

Licença

Ao contribuir, você concorda que suas contribuições serão licenciadas sob a Licença MIT.