Issues
Trabaja con los ítems de tu space, o con las issues de un repositorio de GitHub, desde la terminal.
eqs issue es el gh issue de eQuantic Space, con los mismos subcomandos y flags. Sin flag, trabaja con los ítems de tu space. Con --gh, trabaja con las issues de un repositorio de GitHub a través de la conexión de GitHub de tu workspace, así que tu máquina no necesita ningún token de GitHub.
Dos modos
| Sin flag | Con --gh | |
|---|---|---|
| Trabaja con | Los ítems de un space | Las issues de un repositorio de GitHub |
| Se identifica por | Un identificador, TASK-42, en mayúsculas o minúsculas | Un número, 42 o #42, o la URL de la issue |
| Dónde | --space <slug>, o el space activo (eqs spaces use) | -R, --repo [github.com/]<owner>/<name>, o el remote de GitHub de este clon, primero origin |
| Permisos | item.* | issue.read, issue.write, issue.delete |
--gh: eqs issue view https://github.com/octo/app/issues/42 la lee de GitHub.Comandos
Lista los ítems abiertos de un space, primero los fijados, o las issues abiertas de un repositorio. También ls.
open (por defecto), closed o all@me, un correo, un id o un login de GitHub@me, a un miembro o a un logineqs issue ls -a @me -l api,ui
Muestra un ítem o una issue: su tipo, su etapa o estado, el bloqueo, la fijación, los responsables, las etiquetas y la descripción, y con qué se relaciona: su padre, sus subítems o sub-issues, lo que lo bloquea y lo que bloquea.
/w/<workspace>/items/<identifier>, en su lista, dondequiera que esté. Si el navegador está en otro workspace, la plataforma ofrece antes el cambioeqs issue view 650 --gh -c
Crea un ítem, del tipo tarea, en la única lista del space y en la primera etapa de esa lista salvo que se indique otra cosa, o una issue. También new.
- lee la entrada estándar)eqs issue new --gh -t "Flaky test" -l bug --parent 652
Edita uno o varios ítems a la vez, o varias issues de un repositorio.
none borra los dos últimos)eqs issue edit TASK-41 TASK-42 --add-label api
Cierra un ítem, en la etapa de terminado de su lista, o una issue, con un motivo. Lo que ya está cerrado se deja como está.
completed (por defecto), "not planned" o duplicateeqs issue close TASK-42 --duplicate-of TASK-41
Reabre un ítem, de vuelta a la primera etapa pendiente de su lista, o una issue. Lo que ya está abierto se deja como está.
eqs issue reopen 42 --gh
Elimina un ítem, con todo lo que tiene debajo, o una issue, después de que escribas su identificador o su número.
eqs issue delete TASK-42Comenta en un ítem o en una issue, o edita o elimina tu último comentario allí.
--create-if-none, comenta si no tienes ninguno--yes omite la confirmacióneqs issue comment TASK-42 --edit-last -b "On it, tomorrow"
Tus ítems abiertos, o tus issues abiertas en un repositorio: asignados a ti, que te mencionan, abiertos por ti.
eqs issue status --gh
Mueve un ítem, con sus subítems, a otra lista (<space>/<list>), o una issue a otro repositorio del mismo dueño (<owner>/<name>). Un ítem que pasa a otro space deja atrás sus etiquetas.
eqs issue transfer TASK-42 platform/BacklogBloquea la conversación: desde entonces solo comenta quien puede editarlo. eqs issue unlock <ref> la desbloquea.
off_topic, resolved, spam o too_heatedeqs issue lock TASK-42 -r resolved
Fija un ítem arriba de su space, primero en todas las vistas de su lista, o una issue en su repositorio. Tres como máximo de cada uno, como en GitHub. eqs issue unpin <ref> lo quita.
eqs issue pin TASK-42Crea una rama para un ítem, en un repositorio conectado, o para una issue, vinculada a ella en GitHub. Con --list, lista sus ramas.
eqs issue develop TASK-42 -c
--gh, -R, --repo y --json [fields], que imprime la respuesta en bruto, o solo los campos indicados, separados por comas. Un campo que la respuesta no tiene se rechaza antes de hacer nada, con la lista de los que tiene. Las opciones que admiten varios valores los aceptan repetidos o separados por comas.Permisos
Cada subcomando necesita la acción de abajo.
| Subcomando | Sin flag | Con --gh |
|---|---|---|
list, view, status | item.read | issue.read |
create | item.create (item.update para sus relaciones) | issue.write |
edit, close, reopen, lock, unlock, pin, unpin | item.update | issue.write |
transfer | item.update (y item.create en otro space) | issue.write |
comment | item.comment (item.update en un ítem bloqueado) | issue.write |
delete | item.delete | issue.delete |
develop | item.update y scm.write (item.read para --list) | issue.write (issue.read para --list) |
De los roles predefinidos, Reader lee y comenta: tiene item.read, item.comment e issue.read. Contributor además crea y modifica: todas las acciones item.*, más issue.read e issue.write. Solo Owner tiene issue.delete.
Un ítem puede apuntar a otro de otro space: el que duplica, lo que lo bloquea, lo que bloquea. Solo sabes de ese otro cuando puedes leer los ítems de su space. En caso contrario, view lo deja fuera, y close --duplicate-of responde que ese ítem no existe.
En GitHub
El trabajo lo hace la conexión de GitHub de tu workspace, así que GitHub muestra la App de la conexión como autora de lo que creas y comentas, y eQuantic Space registra quién lo pidió. @me es tu login de GitHub, que conoce cuando iniciaste sesión con GitHub. Si no, escribe tu login en su lugar. status --gh necesita ese inicio de sesión.
Cuando GitHub rechaza algo, el CLI dice por qué: el rechazo nombra el permiso que le falta a la App, y un límite de solicitudes dice cuándo se restablece.
Aceptar los nuevos permisos de la App
--gh necesita dos permisos que la GitHub App no pedía antes: Issues y Contents, ambos de lectura y escritura (Contents para crear una rama). Mientras una instalación no los acepte, GitHub mantiene allí los permisos antiguos de la App y rechaza esas escrituras, y el CLI nombra el permiso que falta.
eqs issue delete --gh no se puede deshacer: GitHub borra la issue para siempre. Por eso solo los owners tienen issue.delete, y el CLI te pide que escribas antes el número de la issue.