D · Bibliografía y fuentes
Los tres libros
Sección titulada «Los tres libros»| Libro | Qué aporta | Dónde se usa |
|---|---|---|
| Fluent Python, 2ª ed. — Luciano Ramalho | El modelo de datos y el porqué del lenguaje. Escrito contra 3.10. | Partes I, II, III, IV y VI |
| Modern Python Cookbook, 3ª ed. — Steven F. Lott | Recetas por tarea: números, texto, archivos, tests, entornos, documentación. | Partes I, II, V y VII |
| Effective Python, 3ª ed. — Brett Slatkin | 125 ítems concretos con criterio práctico. | Puntual, en estructuras y clases |
Los tres están ingeridos en la wiki del proyecto (wiki/fuente-*.md), con las recetas mapeadas a páginas de concepto.
Los modelos de ingeniería
Sección titulada «Los modelos de ingeniería»Las cuatro partes de ingeniería no salen de un libro de Python: cada modelo cita su fuente propia, y el manual nombra el capítulo del libro, no el libro entero.
| Disciplina | Fuentes | Qué aporta | Parte |
|---|---|---|---|
| Estructural | Felippa, Matrix Structural Analysis; McGuire, Gallagher y Ziemian; notas del MIT 1.571 y Duke CE 131 | Método directo de rigidez, elemento marco de 6×6, rotación y ensamblaje | VIII |
| Geotecnia | Terzaghi (1943); Vesic (1973); Das, Principles of Foundation Engineering | Capacidad de carga, asentamientos, empuje de tierras, consolidación | IX |
| Hidráulica | Chow, Open-Channel Hydraulics (1959); Streeter, Wylie y Bedford, Fluid Mechanics | Manning, energía y resalto, vertederos, Colebrook, bombas | X |
| Hidrología | SCS, National Engineering Handbook sección 4; Maidment, Handbook of Hydrology (1993); Gumbel, Statistics of Extremes (1958); Bulletin 17C (2019); Eckhardt (2005); Lyne y Hollick (1979); Puls (1929) | Número de curva, hidrograma unitario, frecuencia de extremos, flujo base, tránsito en embalse | XI |
La regla de fidelidad se aplica igual: si el capítulo afirma un valor numérico, o viene de una de estas fuentes o viene de una medición propia. Los números de ingeniería se calcularon con los scripts de mediciones/ que cita cada parte —09-01 a 09-04, 10-01 a 10-06, 11-01, 12-01 a 12-03—, y los de la parte V con 05-08-scipy.py.
La fuente que no es un libro
Sección titulada «La fuente que no es un libro»La mitad de las afirmaciones del manual no vienen de un libro: vienen de CPython. Objects/listobject.c, Objects/dictobject.c, Python/ceval_gil.c y Include/cpython/object.h explican por qué un dict ocupa 36,9 bytes por entrada y por qué len() es una función.
Y la otra mitad no viene de nada escrito: viene de ejecutar el código. Los scripts están en mediciones/, uno por bloque de capítulos, y cualquiera puede reproducirlos.
Las PEPs citadas
Sección titulada «Las PEPs citadas»| PEP | Tema | Capítulo |
|---|---|---|
| 393 | Cadenas compactas en CPython | I-08 |
| — | Orden de inserción en dict (garantía del lenguaje desde 3.7) |
II-05 |
| 484 | Tipado gradual | III-11 |
| 544 | Protocol |
III-11, IV-04 |
| 649 | Anotaciones diferidas | III-11, Ap. C |
| 659 | Intérprete especializante | I-01 |
| 695 | Genéricos con [] |
Ap. C |
| 701 | f-strings sin restricciones | Ap. C |
| 703 | GIL opcional (build python3.13t) |
VI-01, Ap. C |
| 779 | Criterios de aceptación del free-threading | VI-01, Ap. C |
La regla de fidelidad
Sección titulada «La regla de fidelidad»Una afirmación en este manual tiene que poder rastrearse a una de estas fuentes:
- Un libro leído, citado por capítulo o receta.
- El código de CPython, con el archivo.
- Una medición propia, con el script.
- La documentación oficial, para API y comportamiento prometido.
Si no encaja en ninguna, la afirmación no se publica o se marca como pendiente. Es la razón de que el manual corrija consejos de los libros: la medición es una fuente de mayor jerarquía que la cita.
Dónde discrepa el manual de sus fuentes
Sección titulada «Dónde discrepa el manual de sus fuentes»| Afirmación del libro | Lo que dice la medición | Capítulo |
|---|---|---|
| Atar el método acelera el bucle | Sin diferencia medible en 3.13 | I-01 |
__slots__ acelera el acceso |
Sin diferencia; sólo memoria | IV-06 |
array es más eficiente que list |
En memoria sí; al sumar, 2× más lento | II-04, V-06 |
| EAFP es más rápido | 3,5× más lento cuando la ausencia es frecuente | VII-05 |
No son errores de los libros: son afirmaciones ciertas en la versión contra la que se escribieron, y falsas hoy. Ese es el motivo por el que el manual mide antes de repetir.