| import os | |
| def listar_arquivos(pasta_alvo: str) -> list[str]: | |
| """ | |
| Lista todos os arquivos presentes dentro de uma pasta alvo específica. | |
| Args: | |
| pasta_alvo (str): O caminho completo ou relativo para a pasta que | |
| terá seus arquivos listados. | |
| Returns: | |
| list[str]: Uma lista de strings contendo os nomes dos arquivos | |
| encontrados na pasta. Retorna uma lista vazia se a pasta | |
| não existir, não for um diretório, estiver vazia ou | |
| ocorrer um erro. | |
| """ | |
| if not os.path.exists(pasta_alvo): | |
| print(f"Aviso (listar_arquivos): A pasta '{pasta_alvo}' não existe.") | |
| return [] | |
| if not os.path.isdir(pasta_alvo): | |
| print(f"Aviso (listar_arquivos): O caminho '{pasta_alvo}' não é um diretório válido.") | |
| return [] | |
| try: | |
| arquivos_na_pasta = [] | |
| # os.listdir retorna nomes de arquivos e diretórios. | |
| # Precisamos filtrar para incluir apenas arquivos. | |
| for item in os.listdir(pasta_alvo): | |
| caminho_completo_item = os.path.join(pasta_alvo, item) | |
| if os.path.isfile(caminho_completo_item): | |
| arquivos_na_pasta.append(item) | |
| return arquivos_na_pasta | |
| except Exception as e: | |
| print(f"Erro (listar_arquivos): Não foi possível listar arquivos em '{pasta_alvo}'. Erro: {e}") | |
| return [] |