Skip to content

Cómo Hacer: Sesiones de Terminal y Comandos Operativos

Comandos concretos para ejecutar y validar flujos reales.

1. Validación de Build de Docs

.venv/bin/mkdocs build --strict

Ejemplo de salida:

INFO    -  Cleaning site directory
INFO    -  Building documentation to directory: .../site
INFO    -  Documentation built in 0.67 seconds

2. Test Focalizado (Sin Gate de Cobertura)

Para checks rápidos:

PYTHONPATH=src .venv/bin/python -m pytest -q tests/test_config.py --no-cov

Ejemplo de salida:

collected 3 items

tests/test_config.py ...                                                 [100%]

============================== 3 passed in 0.02s ===============================

3. Por Qué Puede Fallar Cobertura en Subset

Si ejecutas subset con cobertura activa:

PYTHONPATH=src .venv/bin/python -m pytest -q tests/test_config.py

Puede fallar fail-under global porque se ejecutó solo una porción del código.

Para cobertura de release, correr suite completa.

4. Chequeos Runtime de Certificado y Proxy

Archivos CA locales:

ls -la ~/.mitmproxy

Listener monitor:

lsof -iTCP:8080 -sTCP:LISTEN

Estado proxy (macOS):

scutil --proxy

5. Secuencia Tipo Release

  1. Tests completos:
PYTHONPATH=src .venv/bin/python -m pytest -q
  1. Docs strict:
.venv/bin/mkdocs build --strict
  1. Build desktop:
python build.py --name SafeModeSecurity --clean --zip
  1. Build DMG (macOS):
python build.py --name SafeModeSecurity --clean --zip --dmg

6. Interpretación Rápida de Resultados

Comando Resultado sano Si falla
mkdocs build --strict exit 0, sin errores corregir links/nav/referencias
pytest -q tests verdes revisar módulos afectados
lsof -iTCP:8080 listener cuando monitor ON monitor no levantó
scutil --proxy claves proxy cuando ON proxy de SO no aplicado

Relacionado