Repolode
Enviar
ryboe

ryboe/q

Um auxiliar de depuração em Go: use q.Q(vars) para obter uma saída formatada em um arquivo de log em $TMPDIR, em vez de no stdout.

Ver no GitHub
Estrelas
1,542
Forks
69
Issues abertas
2
Último commit
há 12 dias

O que é?

q é um pequeno pacote Go para depuração com instruções de impressão. Você chama q.Q com variáveis ou expressões, e ele as imprime em um formato legível e bem formatado, que facilita inspecionar structs aninhadas em comparação com a saída de fmt.Printf.

Em vez de escrever no stdout, q acrescenta a saída a um arquivo em $TMPDIR/q. O projeto sugere deixar um terminal dedicado exibindo esse arquivo com tail enquanto você trabalha e fornece funções de shell (qq e rmqq) para começar a acompanhar o arquivo ou limpar o log. As chamadas a q.Q são seguras para uso concorrente.

O pacote inclui snippets de editor para VS Code, Zed, Sublime Text, GoLand, Emacs e Vim/NeoVim, que inserem chamadas a q.Q rapidamente. É uma versão em Go do módulo Python q, de zestyping.

Recursos principais

  • 01Formata variáveis e expressões passadas a q.Q.
  • 02Escreve a saída em $TMPDIR/q em vez de no stdout.
  • 03Os auxiliares de shell qq e rmqq acompanham ou limpam o arquivo de log.
  • 04Seguro para uso concorrente.
  • 05Snippets de editor para VS Code, Zed, Sublime Text, GoLand, Emacs e Vim.

Casos de uso

  • Inspecionar rapidamente valores de variáveis e structs aninhadas durante a depuração em Go.
  • Rastrear o estado do programa sem poluir a saída do terminal de um programa em execução.

Início rápido

  1. 1

    Clone o repositório para o seu GOPATH

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

    Importe o pacote e chame q.Q com suas variáveis no código

Antes de usar

  • A saída é gravada em um arquivo de log, então você precisa acompanhar $TMPDIR/q em outro terminal para vê-la.

Em coleções

Plataformas de OpenTelemetry e observabilidade

Tópicos

#golang#debugging#logging#developer-tools#print-debugging#debugger#go

Perguntas frequentes

O que é q?
Um auxiliar de depuração em Go: use q.Q(vars) para obter uma saída formatada em um arquivo de log em $TMPDIR, em vez de no stdout. q é um pequeno pacote Go para depuração com instruções de impressão. Você chama q.Q com variáveis ou expressões, e ele as imprime em um formato legível e bem formatado, que facilita inspecionar structs aninhadas em comparação com a saída de fmt.Printf.
q é gratuito? Qual é a licença?
q é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
q ainda é mantido?
Manutenção ativa. O último commit de q foi em 25 de out. de 2026.
Para que posso usar q?
Inspecionar rapidamente valores de variáveis e structs aninhadas durante a depuração em Go. Rastrear o estado do programa sem poluir a saída do terminal de um programa em execução.
Como instalar q?
Clone o repositório para o seu GOPATH: git clone https://github.com/ryboe/q "$(go env GOPATH)"/src/q Importe o pacote e chame q.Q com suas variáveis no código
Onde consigo q?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/ryboe/q

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados