Saltearse al contenido

Descargar el manual

El manual se lee en el navegador, pero también se descarga entero. El paquete no es un respaldo: es el mismo material, ordenado para trabajar sin conexión.

manual-python.zip — 3,5 MB, 567 archivos.

  • dist — 327 archivos. El sitio ya construido: 139 páginas, las fuentes, el buscador. Se abre con doble clic en dist/index.html.
  • ejercicios — 183 archivos. Los 91 ejercicios ejecutables en .py, con sus 90 salidas de referencia y el índice.
  • mediciones — 34 archivos. Los 33 scripts que producen cada número publicado, más salida-3.13.md.
  • ingenieria — 9 archivos. Los cuatro ejemplos de las disciplinas, con la hoja de ruta de cada una.
  • herramientas — 10 archivos. Los verificadores: ejecutan ejercicios, ejemplos y mediciones y avisan si una cifra no coincide.
  • En la raíz — 4 archivos. README.md, LICENSE.md, requirements.txt y VERSION.txt con la fecha del paquete.

Para leer, no hace falta nada:

Ventana de terminal
# descomprime y abre dist/index.html, o sirve la carpeta:
python -m http.server 4322 --directory dist

Para ejecutar los ejercicios, Python 3.11 o superior y nada más:

Ventana de terminal
python ejercicios/12-hidrologia/05-caso-completo.py

Solo la Parte V (NumPy y SciPy) y la estadística de hidrología necesitan dependencias:

Ventana de terminal
pip install -r requirements.txt

Para comprobar que todo da lo publicado, desde la carpeta descomprimida:

Ventana de terminal
python herramientas/verificar-ejercicios.py # cada ejercicio contra su salida de referencia
python herramientas/verificar-ingenieria.py # los cuatro ejemplos, cifra a cifra
python herramientas/verificar-mediciones.py # los 33 scripts de medición
  • Sin conexión: el sitio construido funciona en local, con su buscador y sus estilos.
  • Reproducible: cada cifra que publica un capítulo tiene aquí el script que la produce.
  • Verificable: los 90 ejercicios deterministas traen su salida de referencia; si un número no coincide, el verificador lo dice.
  • Sin dependencias para leer: no hay que compilar ni instalar Node.

El paquete se regenera desde el repositorio:

Ventana de terminal
npm run build
python herramientas/empaquetar.py # escribe public/descargas/manual-python.zip
npm run build # el ZIP entra en dist/

El script imprime el tamaño, el número de archivos y el SHA-256 del paquete, para que puedas comprobar que la descarga llegó entera.

El texto y los diagramas van con CC BY 4.0; el código, con MIT. El logo y el nombre Mammoth Systems no están cubiertos por ninguna de las dos. El detalle está en LICENSE.md, dentro del paquete.