Original en inglés: https://argusic.com/subject/aiodocker

aiodocker

Cliente de API de Docker en Python basado en asyncio y aiohttp

Funciona con mocksfuente: GitHubPythonApache-2.0commit 178d8a0fc9fa

Python, licencia Apache-2.0. El proyecto se describe a sí mismo como: aiohttp, api client, asyncio, docker y python.

aiodocker funciona, con sustitutos de los servicios de los que depende. Un agent de Argusic lo instaló en 16 minutos y encontró 4 errores, todos corregidos sin ayuda en una máquina limpia sin GPU, y toda la sesión quedó grabada.

aiodocker 0.1.dev1 installed and tested: 80/80 unit tests pass (core library, context, SSH, events, system info) using a mock Docker API server; containers/images/exec/swarm tests require a real Docker daemon not available in this environment

Lo que el agent consiguió en una máquina limpia, en sus propias palabras. Cómo se mide

Medido por Argusic en una máquina limpia cada vez. Cada cifra enlaza a su evidencia. Puntuación Argusic de 86 sobre 100 (la media de las puntuaciones de las ejecuciones de este proyecto).

De un vistazo

veredicto
Funciona con mocks
Puntuación Argusic
86 / 100
costo de la ejecución de verificación
0,08 USD (medido)
ejecuciones registradas
2
última prueba
estrellas
538
forks
118
issues abiertos
28
observadores
17
tamaño
1 MB
creado
último push

Datos del proyecto de GitHub, enlazados al principio de esta página, actualizado . Datos de prueba de Argusic (CC BY 4.0); cada cifra enlaza a una página de ejecución con el log completo, la grabación y sus hashes sha256.

Qué se midió

De la ejecución que decidió este veredicto. Cada línea es un valor registrado, no una estimación.

Tiempo perdido en cada fallo al probar aiodocker, a partir de la ejecución registrada
Cada barra es un fallo que el agent registró, con el tiempo que le costó. Sale de esta ejecución y de ningún otro sitio.

Qué salió mal, en palabras del propio agent

Las palabras del propio agent, de lo más grave a lo menos, nunca reescritas como consejos.

  • Docker daemon cannot start (no root permissions, no user namespaces for rootless mode)6 minutos
  • Tests that use Docker multiplexed streaming protocol (containers, images, execs, testcontainers) or docker subprocess (configs, secrets, swarm, nodes, services, dind) cannot run against mock2 minutos
  • uv not available (not in PATH)1 minuto
  • docker CLI not installed in container1 minuto
Tiempo de instalación
16 minutos
De máquina en frío a terminar
21 minutos
Errores encontrados y corregidos
4 encontrados, 4 corregidos sin ayuda humana
Cómo se demostró el resultado
cd /work/repo && .venv/bin/python -m pytest tests/test_flow_control_queue.py tests/test_jsonstream.py tests/test_stream.py tests/test_utils.py tests/test_docker_close.py tests/test_context.py tests/test_ssh.py tests/test_system.py tests/test_events.py --tb=no --no-header returned 80 passed in 0.49s
Tokens de modelo usados
505.766
Commit exacto probado
178d8a0fc9fa
Imagen del contenedor
sha256:cdd920bce783

Qué no se midió

La otra mitad, para que veas exactamente hasta dónde llega esta evidencia. Un hueco se muestra como hueco y nunca se rellena.

Memoria de GPU máxima
se ejecutó en una máquina con CPU, así que no había GPU que muestrear
Comportamiento en una ejecución larga
cada intento usa la configuración documentada más pequeña y un presupuesto de tiempo fijo, así que esto mide si funciona, no cómo aguanta bajo carga
Comportamiento con servicios reales
esta ejecución solo se verificó con servicios sustitutos

El final de la grabación

Las últimas líneas de la sesión de terminal que decidió este veredicto, tal como se registraron.

tests/test_system.py::test_system_info PASSED                            [ 96%]
tests/test_events.py::test_events_default_task PASSED                    [ 97%]
tests/test_events.py::test_events_provided_task PASSED                   [ 98%]
tests/test_events.py::test_events_no_task PASSED                         [100%]
================================ tests coverage ================================
_______________ coverage: platform linux, python 3.12.3-final-0 ________________
Coverage XML written to file coverage.xml
============================== 80 passed in 0.49s ==============================
All data collected. Here is the final report.
tokens used
505,766
All data collected. Here is the final report.

Reproducir la sesión completa, cada comando desde una máquina limpia hasta este punto.

Cómo se probó

Un agent, un contenedor, sin ayuda humana. Instala el proyecto como indica su propia documentación, lo ejecuta y arregla lo que falla. Todo lo de abajo se registró tal como ocurrió: la sesión de terminal, el log y el commit exacto. La metodología completa.

Puntos fuertes y límites

Hechos medidos, no opiniones. Cómo se redacta.

Qué salió bien

  • Se recuperó de los 4 errores sin que interviniera una persona, lo que indica que los fallos están lo bastante documentados como para resolverlos.
  • Licencia Apache-2.0, según su plataforma de origen.
  • Medido 2 veces, así que el resultado no es algo puntual.

Qué no salió bien, o no se sabe

  • Solo llegó a funcionar con servicios sustitutos, así que nada de lo que hay aquí demuestra que funcione con los reales.
  • Tardó 16 minutos en instalarse, más lento que la mediana de los 4 proyectos comparables que ha medido Argusic.

De los 5 proyectos de aiohttp que Argusic ha instalado y cronometrado, aiodocker fue el 4.º más rápido en llegar a funcionar, y 4 de 5 llegaron a funcionar.

También probados, en la misma área

Argusic instaló y ejecutó cada uno de estos proyectos en una máquina limpia. Aquí no aparece nada que no se haya probado.

Historial de ejecuciones

probado porintentoresultadopuntuacióncosto USDcuándo
Argusic Runner2/3Funciona con mocks92,000,08
Argusic Runner1/3Sin verificar80,000,01

Temas (de GitHub)

aiohttpapi-clientasynciodockerpython

Insertar el badge

Markdown para el README del proyecto. Enlaza de vuelta aquí; condiciones en la página de términos.

[![Tested by Argusic](https://argusic.com/badge/aiodocker.svg)](https://argusic.com/subject/aiodocker)

Preguntas

¿Funciona aiodocker?
aiodocker funciona, con mocks en lugar de los servicios externos. Argusic lo instaló y lo inició en una máquina limpia en 16 minutos, con 4 errores por el camino, y grabó la sesión.
¿Cómo probó Argusic aiodocker?
En una máquina limpia y desechable, con cada comando grabado y el repositorio fijado en el commit 178d8a0fc9fa. Hay 2 intentos registrados, y la metodología completa está en la página de metodología.
¿Cuánto costó probar aiodocker?
La ejecución que produjo este veredicto costó 0,08 USD: costo real de cómputo y de modelo, no un precio de lista por millón de tokens. Consta en la página de esa ejecución.
¿Cuánto tarda aiodocker en instalarse?
16 minutos en la ejecución que decidió este veredicto, desde una máquina limpia hasta que funcionó. Es un intento medido, no una media.
¿Necesita aiodocker una GPU?
No para arrancar. Argusic consiguió que funcionara en una máquina sin GPU.
¿Qué falla al instalar aiodocker?
En la ejecución registrada fallaron 4 cosas, y 4 se corrigieron sin ayuda humana. Cada una, con el tiempo que costó, aparece en esta página.
¿Cómo se compara aiodocker con las alternativas?
De los 5 proyectos de aiohttp que Argusic ha instalado y cronometrado, aiodocker fue el 4.º más rápido en llegar a funcionar, y 4 de 5 llegaron a funcionar.
¿Dónde está la evidencia de aiodocker?
Las 2 ejecuciones registradas están en esta página, cada una enlazada a su log completo y a su grabación de terminal, guardados con una huella sha256 para que no se puedan alterar en silencio.

Discussion