Segundo Cerebro

README

Se lee en 2 min

Prototipo del buscador de material

Volver a Buscador de material · Plan

Este es un prototipo mínimo y ejecutable de la automatización. Sirve para ver el flujo completo antes de escribir la versión final.

Qué hace

  1. Lee 03_Fundamentos/Material/temas.md o recibe un tema por parámetro.
  2. Busca documentación oficial curada para temas conocidos.
  3. Busca un resumen en Wikipedia.
  4. Busca repositorios en GitHub.
  5. Genera una carpeta por tema en 03_Fundamentos/Material/prototipo/.
  6. Crea README.md, notas.md y fuentes.json.
  7. Actualiza 03_Fundamentos/Material/prototipo/00 Prototipo.md.

Qué no hace

  • No usa YouTube, DuckDuckGo ni arXiv.
  • No descarga PDFs ni videos.
  • No reemplaza tu implementación final.
  • No está conectado al disparador systemd; el disparador ejecuta el run.sh de la raíz, que espera tu buscar_material.py.

Ejecutar

cd 08_Proyectos/buscador-material/prototipo
 
# Un tema concreto
python3 prototipo.py --tema "PSeInt: estructuras de control"
 
# Leer todos los temas de temas.md
python3 prototipo.py
 
# Ver el resultado sin escribir archivos
python3 prototipo.py --tema "Python: funciones y archivos" --dry-run
 
# Si GitHub limita las consultas
python3 prototipo.py --tema "Git: ramas" --sin-github

O con el lanzador:

./run.sh --tema "PSeInt: estructuras de control"

En Windows, desde PowerShell:

cd 08_Proyectos\buscador-material\prototipo
python prototipo.py --tema "PSeInt: estructuras de control"

Dependencias

Ninguna: solo la biblioteca estándar de Python 3.11 o superior.

Pruebas

cd 08_Proyectos/buscador-material/prototipo
python3 -m unittest discover -s tests -v

Salida

03_Fundamentos/Material/prototipo/
├── 00 Prototipo.md
└── pseint-estructuras-de-control/
    ├── README.md
    ├── notas.md
    └── fuentes.json

La carpeta prototipo/ es desechable. Cuando tengas tu implementación final, puedes borrarla sin afectar el material definitivo.

Diferencia con la versión final

Este prototipo demuestra el flujo, pero no está diseñado para crecer. La versión final debe separar proveedores, manejar mejor los errores, agregar pruebas y decidir qué fuentes usar. Eso está en Plan.

Vista Gráfica