Description
Un agente de IA te va a entregar Python que corre, importa limpio y está mal en silencio: le pone a una función un argumento por defecto mutable que se acumula entre llamadas, muta una lista a la que apuntan dos nombres, captura en un closure una variable de loop que ya cambió, escribe un type hint que nada verifica en runtime, hace una llamada sincrónica a la base de datos dentro de un handler async que congela todos los demás requests, se traga el error real con un except pelado, escribe un test que no verifica nada y reporta verde. El intérprete deja pasar casi todo, porque Python es dinámico y permisivo: que corra prueba que el código es sintácticamente válido, no que el flujo de datos, la concurrencia o el manejo de fallas estén bien. Los tutoriales de sintaxis no te sirven acá, no sos vos quien tipea la sintaxis. Lo que te falta es el modelo mental del revisor: qué está haciendo Python en realidad por debajo del código, para poder mirar un diff y saber si va a producción o vuelve para atrás.
Este libro te entrena para ser el revisor de Python vibe-codeado, no para memorizar el lenguaje. Arranca desde una premisa distinta a la de cualquier otro libro de Python: el agente escribe el código, y tu palanca es entender qué hace ese código en realidad para poder revisarlo con el criterio que el intérprete no tiene. Vas a aprender a qué se liga en realidad un nombre y por qué el aliasing y la mutabilidad causan los bugs que causan, qué verifica y qué no verifica un type hint, qué está haciendo en realidad el event loop detrás de async y await, por qué el global interpreter lock hace que tus threads no sean el paralelismo que creés, qué hacen realmente un ORM y un pool de conexiones, y cómo las piezas se integran en un servicio que corre, y vas a aprender todo eso como lo necesita un revisor: leyendo código real que el agente generaría y decidiendo qué está bien, qué es plausible pero peligroso y qué hay que devolver. La progresión va de revisar un solo objeto y un solo nombre, a revisar un componente como la capa de datos o el pipeline de requests, a revisar cómo encaja todo el sistema y dónde se va a romper bajo carga real. Acá casi no hay ejercicios de sintaxis y sí mucho sobre el modelo de objetos, concurrencia, fallas y las formas específicas en que el Python de un agente sale mal. Para ingenieros que van a vibe-codear en Python de todas formas y quieren ser los que cazan lo que se le escapó al modelo.
Escrito para vos si
Este libro es para: ingenieros que ya decidieron dejar que un agente de IA escriba su Python (vibe coding) y ahora se quedan con la parte que el agente no puede hacer, que es juzgar si el código que produjo es correcto, seguro y está bien diseñado, y que no piensan pasarse meses moliendo tutoriales de sintaxis para llegar ahí.
El método detrás
Los 6 pasos para volverte el revisor de Python que la IA no puede reemplazar. El modelo mental que te vuelve el ingeniero capaz de mirar cualquier Python que escribió un agente de IA y saber si es seguro mandarlo a producción. Que corra prueba que el código es válido, no que esté bien, y en esa grieta vive ahora tu valor. Subís desde leer un solo nombre hasta leer el sistema entero por donde se va a romper, y te volvés el que el modelo no puede reemplazar: el que caza lo que se le escapó.
- Leé a qué se liga en realidad un nombre
- Revisá el contrato que el código no obliga
- Rastreá qué corre antes y por debajo del handler
- Juzgá la concurrencia y la llamada que bloquea
- Medí el alcance de una sola llamada externa
- Confirmá que las docs y los tests coinciden con lo que salió
Todo lo que hay adentro
- Capítulo 1: Cómo me di cuenta de que mi verdadero trabajo era revisar Python, no escribirlo
- Capítulo 2: ¿A qué apunta en realidad un nombre en Python?
- Capítulo 3: El bug de objetos compartidos que sobrevive a todos los tests
- Capítulo 4: Los type hints que Python descarta en tiempo de ejecución
- Capítulo 5: El contrato de la API que no vas a poder cambiar una vez que un cliente depende de él
- Capítulo 6: Lo que se ejecuta antes de que tu handler vea el request
- Capítulo 7: Una línea de Python que en secreto es un viaje a la base de datos
- Capítulo 8: La única línea lenta que congela todos los demás requests
- Capítulo 9: Cuando el agente te dice que paralelizó tu tarea lenta
- Capítulo 10: La llamada externa que puede tirar abajo todo tu servicio
- Capítulo 11: Leer Quill como lo leería un atacante
- Capítulo 12: Qué mirar cuando Quill se rompe a las 3 de la mañana
- Capítulo 13: ¿Tu documentación sigue describiendo la API que desplegaste?
- Capítulo 14: Un test que pasa y no prueba nada
- Capítulo 15: Cómo llegué a ser el que decide si algo es seguro para desplegar
