22.11.3.1 Web interface

Uma interface web (na verdade duas interfaces web!) está disponível para navegar pelos problemas:

• https://issues.guix.gnu.org fornece uma interface agradável alimentada por mumi⁴⁸ para navegar por relatórios de bugs e patches, e para participar de discussões; mumi também tem uma interface de linha de comando como veremos abaixo;
• https://bugs.gnu.org/guix lista relatórios de bugs;
• https://bugs.gnu.org/guix-patches lista envios de patches.

Para visualizar discussões relacionadas ao problema número n, acesse ‘https://issues.guix.gnu.org/n’ ou ‘https://bugs.gnu.org/n’.

22.11.3.2 Command-Line Interface

O Mumi também vem com uma interface de linha de comando que pode ser usada para pesquisar problemas existentes, abrir novos problemas, compor respostas, aplicar e enviar patches. Você não precisa usar o Emacs para usar o cliente de linha de comando mumi. Você interage com ele apenas na linha de comando.

Para usar a interface de linha de comando mumi, navegue até um clone local do repositório git Guix e entre em um shell com mumi, git e git:send-email instalados.

$ cd guix
~/guix$ guix shell mumi git git:send-email

Para procurar problemas, diga todos os problemas abertos sobre "zig", execute

~/guix [env]$ mumi search zig is:open

#60889 Add zig-build-system
opened on 17 Jan 17:37 Z by Ekaitz Zarraga
#61036 [PATCH 0/3] Update zig to 0.10.1
opened on 24 Jan 09:42 Z by Efraim Flashner
#39136 [PATCH] gnu: services: Add endlessh.
opened on 14 Jan 2020 21:21 by Nicol? Balzarotti
#60424 [PATCH] gnu: Add python-online-judge-tools
opened on 30 Dec 2022 07:03 by gemmaro
#45601 [PATCH 0/6] vlang 0.2 update
opened on  1 Jan 2021 19:23 by Ryan Prior

Escolha uma questão e torne-a a questão "atual".

~/guix [env]$ mumi current 61036

#61036 [PATCH 0/3] Update zig to 0.10.1
opened on 24 Jan 09:42 Z by Efraim Flashner

Quando um problema é o problema atual, você pode abri-lo em um navegador da web, redigir respostas, aplicar patches, enviar patches, etc. com comandos curtos e sucintos.

Abra o problema no seu navegador da web usando

~/guix [env]$ mumi www

Redija uma resposta usando

~/guix [env]$ mumi compose

Redija uma resposta e feche o problema usando

~/guix [env]$ mumi compose --close

mumi compose abre seu cliente de e-mail passando URIs ‘mailto:’ para xdg-open. Então, você precisa ter xdg-open configurado para abrir seu cliente de e-mail corretamente.

Aplique o patchset mais recente do problema usando

~/guix [env]$ mumi am

Você também pode aplicar um patchset de uma versão específica (digamos, v3) usando

~/guix [env]$ mumi am v3

Ou você pode aplicar um patch de uma mensagem de e-mail específica. Por exemplo, para aplicar o patch da 4ª mensagem (o índice da mensagem começa em 0), execute

~/guix [env]$ mumi am @4

mumi am é um wrapper em torno de git am. Você pode passar argumentos git am para ele depois de um ‘--’. Por exemplo, para adicionar um trailer Signed-off-by, execute

~/guix [env]$ mumi am -- -s

Crie e envie patches para o problema usando

~/guix [env]$ git format-patch origin/master
~/guix [env]$ mumi send-email foo.patch bar.patch

Observe que você não precisa passar os argumentos ‘--to’ ou ‘--cc’ para git format-patch. mumi send-email os inserirá corretamente ao enviar os patches.

Para abrir um novo problema, execute

~/guix [env]$ mumi new

e enviar um e-mail (usando mumi compose) ou patches (usando mumi send-email).

mumi send-email é realmente um wrapper em torno de git send-email que automatiza todos os detalhes do envio de patches. Ele usa o estado atual do problema para descobrir automaticamente o endereço ‘To’ correto para enviar, outros participantes para ‘Cc’, cabeçalhos para adicionar, etc.

Observe também que, diferentemente de git send-email, mumi send-email funciona perfeitamente bem com patches únicos e múltiplos. Ele automatiza a dança dos debbugs de enviar o primeiro patch, esperar por uma resposta dos debbugs e enviar os patches restantes. Ele faz isso enviando o primeiro patch, sondando o servidor para uma resposta e, em seguida, enviando os patches restantes. Infelizmente, essa sondagem pode levar alguns minutos. Então, seja paciente.

22.11.3.3 Emacs Interface

Se você usa o Emacs, pode achar mais conveniente interagir com problemas usando debbugs.el, que pode ser instalado com:

guix install emacs-debbugs

Por exemplo, para listar todos os problemas abertos em guix-patches, clique em:

C-u M-x debbugs-gnu RET RET guix-patches RET n y

Para uma maneira mais conveniente (mais curta) de acessar os envios de bugs e patches, você pode configurar as variáveis debbugs-gnu-default-packages e debbugs-gnu-default-severities do Emacs (veja Visualizando Bugs no Emacs).

Para procurar bugs, ‘M-x debbugs-gnu-guix-search’ pode ser usado.

Veja Guia do usuário do Debbugs, para mais informações sobre esta ferramenta bacana!