{"id":19321815,"url":"https://github.com/cristotodev/text-finder","last_synced_at":"2026-06-11T22:31:36.807Z","repository":{"id":244355300,"uuid":"814809991","full_name":"cristotodev/Text-Finder","owner":"cristotodev","description":"TextFinder es una herramienta de línea de comandos en Python que busca texto en archivos dentro de un directorio especificado. Permite omitir ciertos directorios y resalta los resultados en la consola con colores para una mejor legibilidad.","archived":false,"fork":false,"pushed_at":"2024-06-14T12:08:00.000Z","size":15,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-11-15T02:45:13.772Z","etag":null,"topics":["python","script"],"latest_commit_sha":null,"homepage":"https://cristoto.dev","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cristotodev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-06-13T18:48:28.000Z","updated_at":"2024-06-14T12:08:03.000Z","dependencies_parsed_at":"2025-01-06T05:40:36.927Z","dependency_job_id":"810c417e-20bc-4cf9-802f-e87a803311bf","html_url":"https://github.com/cristotodev/Text-Finder","commit_stats":null,"previous_names":["cristotodev/text-finder"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/cristotodev/Text-Finder","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cristotodev%2FText-Finder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cristotodev%2FText-Finder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cristotodev%2FText-Finder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cristotodev%2FText-Finder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cristotodev","download_url":"https://codeload.github.com/cristotodev/Text-Finder/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cristotodev%2FText-Finder/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34221150,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-11T02:00:06.485Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["python","script"],"created_at":"2024-11-10T01:39:12.223Z","updated_at":"2026-06-11T22:31:36.766Z","avatar_url":"https://github.com/cristotodev.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TextFinder\r\n\r\nTextFinder es una herramienta de línea de comandos en Python que busca texto en archivos dentro de un directorio especificado. Permite omitir ciertos directorios y resalta los resultados en la consola con colores para una mejor legibilidad.\r\n\r\n## Características\r\n\r\n- Busca múltiples textos en archivos de un directorio.\r\n- Permite omitir directorios específicos.\r\n- Permite incluir o excluir archivos por su extensión.\r\n- Resultados presentados en una tabla con colores para facilitar la lectura.\r\n- Soporte para expresiones regulares en las búsquedas.\r\n- Opción para realizar búsquedas sin diferenciar entre mayúsculas y minúsculas.\r\n- Exportación de resultados en formatos JSON y CSV\r\n\r\n## Requisitos\r\n\r\n- Python 3.6 o superior\r\n\r\n## Instalación\r\n\r\n1. Clona este repositorio:\r\n    ```sh\r\n    git clone https://github.com/tuusuario/Text-Finder.git\r\n    cd Text-Finder\r\n    ```\r\n\r\n2. Instala el proyecto y sus dependencias:\r\n    ```sh\r\n    pip install .\r\n    ```\r\n\r\n## Uso\r\n\r\n### Búsqueda de texto\r\n\r\nPara buscar texto en un directorio, utiliza la opción `-p` para especificar la ruta del directorio y `-t` para especificar el texto a buscar. Puedes especificar múltiples textos utilizando la opción `-t` varias veces.\r\n\r\n```sh\r\ntextfinder -p /ruta/del/directorio -t \"texto1\" -t \"texto2\"\r\n```\r\n\r\n### Omisión de directorios\r\n\r\nPara omitir ciertos directorios durante la búsqueda, utiliza la opción -o y especifícala varias veces.\r\n\r\n```sh\r\npython textfinder.py -p /ruta/del/directorio -t \"texto1\" -t \"texto2\" -o dir1 -o dir2\r\n```\r\n\r\n### Inclusión o exclusión de archivos por extensión\r\n\r\nPara incluir solo archivos con ciertas extensiones, utiliza la opción --include-ext y especifícala varias veces.\r\n\r\n```sh\r\ntextfinder -p /ruta/del/directorio -t \"texto1\" -t \"texto2\" --include-ext .txt --include-ext .log\r\n```\r\n\r\nPara excluir archivos con ciertas extensiones, utiliza la opción --exclude-ext y especifícala varias veces.\r\n\r\n```sh\r\ntextfinder -p /ruta/del/directorio -t \"texto1\" -t \"texto2\" --exclude-ext .txt --exclude-ext .log\r\n```\r\n\r\n### Búsqueda multihilo\r\n\r\nPara realizar la búsqueda utilizando múltiples hilos y así mejorar la velocidad de búsqueda, utiliza la opción -n para especificar el número de hilos.\r\n\r\n```sh\r\ntextfinder -p /ruta/del/directorio -t \"texto1\" -t \"texto2\" -n 4\r\n```\r\n\r\n### Uso de expresiones regulares\r\n\r\nPara realizar búsquedas utilizando expresiones regulares, utiliza la opción -r.\r\n\r\n```sh\r\ntextfinder -p /ruta/del/directorio -t \"regex1\" -t \"regex2\" -r\r\n```\r\n\r\n### Búsqueda sin diferenciar entre mayúsculas y minúsculas\r\n\r\nPara realizar búsquedas sin diferenciar entre mayúsculas y minúsculas, utiliza la opción -c.\r\n\r\n```sh\r\ntextfinder -p /ruta/del/directorio -t \"Texto1\" -t \"Texto2\" -c\r\n```\r\n\r\n### Exportación de resultados\r\n\r\nPara exportar los resultados en formato JSON o CSV, utiliza las opciones -f para el formato y -O para especificar el archivo de salida.\r\n\r\n```sh\r\ntextfinder -p /ruta/del/directorio -t \"texto1\" -t \"texto2\" -f json -O resultados.json\r\ntextfinder -p /ruta/del/directorio -t \"texto1\" -t \"texto2\" -f csv -O resultados.csv\r\n```\r\n\r\n## Ejemplo completo\r\n\r\n```sh\r\ntextfinder -p /ruta/del/directorio -t \"texto1\" -t \"texto2\" -o dir1 -o dir2 --include-ext .txt --exclude-ext .log -n 4 -r -c -f json -O resultados.json\r\n```\r\n\r\nEste comando buscará \"texto1\" y \"texto2\" en todos los archivos del directorio especificado, omitiendo los directorios dir1 y dir2, utilizando 4 hilos, con expresiones regulares, sin diferenciar entre mayúsculas y minúsculas, y exportando los resultados en formato JSON al archivo resultados.json.\r\n\r\n## Resultados\r\n\r\nLos resultados se presentan en una tabla con las siguientes columnas:\r\n\r\n- Ruta de la carpeta: La ruta del directorio donde se encontró el archivo.\r\n- Archivo: El nombre del archivo donde se encontró el texto.\r\n- Palabras Encontradas: Las palabras buscadas que se encontraron en el archivo.\r\n\r\nLos mensajes se muestran en colores para facilitar la lectura:\r\n\r\n- Verde: Número de coincidencias encontradas.\r\n- Amarillo: Indicador de que no se encontraron coincidencias.\r\n- Rojo: Mensajes de error durante la lectura de archivos.\r\n- Cian: Duración de la búsqueda y número de Threads lanzados\r\n\r\n## Contribuciones\r\n\r\nLas contribuciones son bienvenidas. Siéntete libre de abrir un issue o enviar un pull request.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcristotodev%2Ftext-finder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcristotodev%2Ftext-finder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcristotodev%2Ftext-finder/lists"}