Issues
Trabalhe com os itens do seu space, ou com as issues de um repositório no GitHub, pelo terminal.
eqs issue é o gh issue do eQuantic Space, com os mesmos subcomandos e flags. Sem flag, ele trabalha com os itens do seu space. Com --gh, trabalha com as issues de um repositório no GitHub, pela conexão do GitHub do seu workspace, então a sua máquina não precisa de token do GitHub.
Dois modos
| Sem flag | Com --gh | |
|---|---|---|
| Trabalha com | Os itens de um space | As issues de um repositório no GitHub |
| Endereçado por | Um identificador, TASK-42, em maiúsculas ou minúsculas | Um número, 42 ou #42, ou a URL da issue |
| Onde | --space <slug>, ou o space ativo (eqs spaces use) | -R, --repo [github.com/]<owner>/<name>, ou o remote do GitHub deste clone, origin primeiro |
| Permissões | item.* | issue.read, issue.write, issue.delete |
--gh: eqs issue view https://github.com/octo/app/issues/42 lê a issue no GitHub.Comandos
Lista os itens abertos de um space, os fixados primeiro, ou as issues abertas de um repositório. Também ls.
open (padrão), closed ou all@me, um e-mail, um id ou um login do GitHub@me, um membro ou um logineqs issue ls -a @me -l api,ui
Mostra um item ou uma issue: o tipo, o estágio ou o estado, a trava, a fixação, os responsáveis, as labels e a descrição, e com o que se relaciona: o pai, os subitens ou sub-issues, o que o bloqueia e o que ele bloqueia.
/w/<workspace>/items/<identifier>, na lista onde estiver. Se o navegador estiver em outro workspace, a plataforma oferece a troca anteseqs issue view 650 --gh -c
Cria um item, do tipo tarefa, na única lista do space e no primeiro estágio dela se nada for dito, ou uma issue. Também new.
- lê a entrada padrão)eqs issue new --gh -t "Flaky test" -l bug --parent 652
Edita um ou mais itens de uma vez, ou várias issues de um repositório.
none limpa os dois últimos)eqs issue edit TASK-41 TASK-42 --add-label api
Fecha um item, no estágio de concluído da lista, ou uma issue, com um motivo. O que já está fechado fica como está.
completed (padrão), "not planned" ou duplicateeqs issue close TASK-42 --duplicate-of TASK-41
Reabre um item, de volta ao primeiro estágio a fazer da lista, ou uma issue. O que já está aberto fica como está.
eqs issue reopen 42 --gh
Exclui um item, com tudo o que está abaixo dele, ou uma issue, depois que você digita o identificador ou o número.
eqs issue delete TASK-42Comenta num item ou numa issue, ou edita ou exclui o seu último comentário ali.
--create-if-none, comenta quando você não tem nenhum--yes pula a confirmaçãoeqs issue comment TASK-42 --edit-last -b "On it, tomorrow"
Os seus itens abertos, ou as suas issues abertas num repositório: atribuídos a você, que mencionam você, abertos por você.
eqs issue status --gh
Move um item, com os subitens, para outra lista (<space>/<list>), ou uma issue para outro repositório do mesmo dono (<owner>/<name>). Um item que vai para outro space deixa as labels para trás.
eqs issue transfer TASK-42 platform/BacklogTrava a conversa: daí em diante só quem pode editar comenta. eqs issue unlock <ref> destrava.
off_topic, resolved, spam ou too_heatedeqs issue lock TASK-42 -r resolved
Fixa um item no topo do space, primeiro em todas as visões da lista, ou uma issue no repositório. No máximo três de cada, como no GitHub. eqs issue unpin <ref> desafixa.
eqs issue pin TASK-42Cria uma branch para um item, num repositório conectado, ou para uma issue, ligada a ela no GitHub. Com --list, lista as branches.
eqs issue develop TASK-42 -c
--gh, -R, --repo e --json [fields], que imprime a resposta crua, ou só os campos citados, separados por vírgula. Um campo que a resposta não tem é recusado antes de qualquer ação, com a lista dos que ela tem. Opções que levam vários valores aceitam os valores repetidos ou separados por vírgula.Permissões
Cada subcomando precisa da ação abaixo.
| Subcomando | Sem flag | Com --gh |
|---|---|---|
list, view, status | item.read | issue.read |
create | item.create (item.update para as relações) | issue.write |
edit, close, reopen, lock, unlock, pin, unpin | item.update | issue.write |
transfer | item.update (e item.create em outro space) | issue.write |
comment | item.comment (item.update num item travado) | issue.write |
delete | item.delete | issue.delete |
develop | item.update e scm.write (item.read para --list) | issue.write (issue.read para --list) |
Entre os papéis embutidos, Reader lê e comenta: tem item.read, item.comment e issue.read. Contributor também cria e altera: toda ação item.*, mais issue.read e issue.write. Só Owner tem issue.delete.
Um item pode apontar para outro de outro space: o que ele duplica, o que o bloqueia, o que ele bloqueia. Você só fica sabendo desse outro quando pode ler os itens do space dele. Caso contrário, view o deixa de fora, e close --duplicate-of responde que esse item não existe.
No GitHub
Quem faz o trabalho é a conexão do GitHub do seu workspace, então o GitHub mostra o App da conexão como autor do que você cria e comenta, e o eQuantic Space registra quem pediu. @me é o seu login do GitHub, que ele conhece quando você entrou com o GitHub. Senão, escreva o seu login no lugar. status --gh precisa dessa entrada.
Quando o GitHub recusa, o CLI diz por quê: a recusa cita a permissão que falta ao App, e um limite de taxa diz quando ele zera.
Aceitar as novas permissões do App
--gh precisa de duas permissões que o GitHub App não pedia antes: Issues e Contents, ambas de leitura e escrita (Contents para criar uma branch). Enquanto uma instalação não as aceita, o GitHub mantém ali as permissões antigas do App e recusa essas escritas, e o CLI cita a permissão que falta.
eqs issue delete --gh não tem volta: o GitHub apaga a issue de vez. Por isso só owners têm issue.delete, e o CLI pede que você digite o número da issue antes.