Nivel 6 · En la práctica

6.4Caja de herramientas

Objetivo: disponer de checklists operativas y de los comandos Python esenciales.

Tiempo estimado: 10 min · Si solo tienes 5 min: lee «Lo esencial en 30s» + el esquema.

Lo esencial en 30 segundos

Entrega : 7 sí — black + ruff, pytest, requirements fijado, hints + README, logs limpios, Docker slim, CI + rollback.
Diario : venv, pytest, ruff, freeze y modo dev estricto sin tanteos.
Regla : una checklist marcada cada vez vale más que un método sabido de memoria — en rush, se ejecuta.

Hilo Nabil — las fichas junto al seguimiento de gastos

Tras un año, las dos fichas siguientes siguen junto al proyecto hilo de Nabil : la de entrega mostrada junto a la pantalla, la de comandos diarios en su cuaderno. « Lo que me salvó, dice en sustancia, no es conocer los puntos, es marcarlos cada vez — sobre todo los lunes de informe. »

Adapta las formulaciones a tu contexto, guarda la estructura : es ella la que evita olvidos e incidentes.

Referencias listas para usar

Una buena checklist hace una entrega serena y sin olvidos ; los buenos comandos evitan el tanteo. A adaptar a tu contexto.

Entrega (7 sí)

black + ruff en verde, pytest en verde (nominal + límites).
requirements fijado, venv reconstruido como prueba.
Hints en las fronteras, README con install + uso.
Logs estructurados, errores limpios, sin except desnudo.
Dockerfile slim + USER + .dockerignore (si contenedor).
CI en verde, secretos fuera del código, versión etiquetada.
Rollback conocido y probado.

Comandos diarios

python -m venv .venv / activate / pip install -r requirements.txt.
pytest -q / ruff check . / black .
pip freeze > requirements.txt.
python -m pip list --outdated.
python -X dev script.py (modo desarrollo estricto).

Error frecuente de interpretación: « coleccionar las checklists ». No. Una checklist solo es útil marcada y usada : toma la de tu próxima entrega, las otras esperarán.

Versión en texto del esquema (SEO / lectores de pantalla / traducción): Dos momentos, dos fichas : 1) Entrega — 7 sí (lint + pruebas, venv reconstruido, hints + README, logs, Docker slim, CI + versión, rollback). 2) Diario — crear/activar el venv, instalar, probar, fijar, vigilar en modo dev estricto. Lección : ya no se piensa bajo presión, se ejecuta la ficha junto al proyecto hilo.

Guion listo para decir — validar una entrega (30 s)

« ¿black + ruff en verde, pytest en verde ? ¿venv reconstruido desde el requirements fijado ? ¿README al día, logs limpios, Dockerfile slim ? ¿CI en verde, secretos fuera del código, versión etiquetada, rollback probado ? Si un no, no se entrega. »

Modelo copiar-pegar — seguimiento entrega (1 línea por punto)

suivi = {
    "lint (black + ruff)": "OK / a reprendre",
    "tests (pytest nominal + limites)": "OK / a reprendre",
    "venv reconstruit (requirements fige)": "OK / a reprendre",
    "hints + README": "OK / a reprendre",
    "logs + pas de except nu": "OK / a reprendre",
    "docker slim + CI verte": "OK / a reprendre",
    "version + rollback": "OK / a reprendre",
}

TPE / presupuesto pequeño

Fichas en una página mostrada en la pared : lo esencial (venv, pruebas, freeze) basta.

Pyme Argel

Prever las realidades locales en la ficha : responsables conocidos, picos del lunes, copias de seguridad verificadas.

Remoto / híbrido

Añadir una línea de confirmación escrita al seguimiento : a distancia, una entrega fechada y validada evita malentendidos.

Intercultural

Explicitar los títulos por escrito : lo que parece evidente (quién valida, qué venv) no lo es para todos.

Prudencia: Recordatorio genérico : secretos, versiones y rollbacks comprometen tu organización — secretos fuera del código, accesos limitados y validación por el responsable designado ; esta guía no da asesoramiento jurídico.

Desafío 48h — aplica mañana

Toma 1 proyecto real, pasa la checklist « Entrega (7 sí) » y marca dónde está. Prueba el rebuild del venv.

Lista de salida de la sección

Marqué una checklist en un proyecto real.
Sé sacar la entrega y los comandos diarios en el buen momento.
Hice el desafío 48h o planifiqué su fecha.

Autoevaluación 1-5 : ¿herramientas de mis proyectos ?¿uso fechado de las checklists ?

← Anterior : Buenas prácticas y trampas (V3)Siguiente : Voces del terreno (V3) →

Comprueba tu comprensión

Nabil se dispone a entregar su informe automatizado. ¿Qué debe marcar en prioridad ?