Repolode
ryboe

ryboe/q

Un auxiliar de depuración para Go: escribe q.Q(vars) para obtener una salida con formato legible en un archivo de registro de $TMPDIR, en lugar de stdout.

Estrellas
1,542
Forks
69
Issues abiertos
2
Último commit
hace 12 días

¿Qué es?

q es un pequeño paquete de Go para depurar con instrucciones de impresión. Se llama a q.Q con variables o expresiones, y las muestra con un formato legible que facilita inspeccionar structs anidados en comparación con la salida de fmt.Printf.

En lugar de escribir en stdout, q agrega la salida a un archivo en $TMPDIR/q. El proyecto sugiere dedicar una terminal a seguir ese archivo mientras trabajas, y ofrece funciones de shell (qq y rmqq) para empezar a seguir el registro o vaciarlo. Las llamadas a q.Q se pueden usar de forma concurrente sin problemas.

Se incluyen snippets de editor para VS Code, Zed, Sublime Text, GoLand, Emacs y Vim/NeoVim que permiten insertar llamadas a q.Q rápidamente. El paquete es una adaptación a Go del módulo q de Python, creado por zestyping.

Funciones clave

  • 01Muestra con formato legible las variables y expresiones que se pasan a q.Q.
  • 02Escribe la salida en $TMPDIR/q en lugar de stdout.
  • 03Las funciones de shell qq y rmqq permiten seguir o vaciar el archivo de registro.
  • 04Se puede usar de forma concurrente sin problemas.
  • 05Incluye snippets de editor para VS Code, Zed, Sublime Text, GoLand, Emacs y Vim.

Casos de uso

  • Inspeccionar rápidamente los valores de variables y los structs anidados durante la depuración en Go.
  • Seguir el estado del programa sin saturar la salida de la terminal donde se ejecuta.

Inicio rápido

  1. 1

    Clona el repositorio en tu GOPATH

    git clone https://github.com/ryboe/q "$(go env GOPATH)"/src/q
  2. 2

    Importa el paquete y llama a q.Q con tus variables en el código

Antes de usarlo

  • La salida se escribe en un archivo de registro, así que debes supervisar $TMPDIR/q en otra terminal para verla.

En colecciones

Temas

Preguntas frecuentes

¿Qué es q?
Un auxiliar de depuración para Go: escribe q.Q(vars) para obtener una salida con formato legible en un archivo de registro de $TMPDIR, en lugar de stdout. q es un pequeño paquete de Go para depurar con instrucciones de impresión. Se llama a q.Q con variables o expresiones, y las muestra con un formato legible que facilita inspeccionar structs anidados en comparación con la salida de fmt.Printf.
¿q es gratuito? ¿Qué licencia tiene?
q es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿q sigue mantenido?
Mantenimiento activo. El último commit de q fue el 25 oct 2026.
¿Para qué puedo usar q?
Inspeccionar rápidamente los valores de variables y los structs anidados durante la depuración en Go. Seguir el estado del programa sin saturar la salida de la terminal donde se ejecuta.
¿Cómo se instala q?
Clona el repositorio en tu GOPATH: git clone https://github.com/ryboe/q "$(go env GOPATH)"/src/q Importa el paquete y llama a q.Q con tus variables en el código
¿Dónde consigo q?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/ryboe/q

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados