Saltearse al contenido

D · Bibliografía y fuentes

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.

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 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.

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

Una afirmación en este manual tiene que poder rastrearse a una de estas fuentes:

  1. Un libro leído, citado por capítulo o receta.
  2. El código de CPython, con el archivo.
  3. Una medición propia, con el script.
  4. 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.

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.