Issues
Mit den Items Ihres Space oder den GitHub-Issues eines Repositorys im Terminal arbeiten.
eqs issue ist gh issue für eQuantic Space, mit denselben Unterbefehlen und Flags. Ohne Flag arbeitet es mit den Items Ihres Space. Mit --gh arbeitet es mit den Issues eines GitHub-Repositorys, über die GitHub-Verbindung Ihres Workspace, sodass Ihr Rechner kein GitHub-Token braucht.
Zwei Modi
| Ohne Flag | Mit --gh | |
|---|---|---|
| Arbeitet mit | Den Items eines Space | Den Issues eines GitHub-Repositorys |
| Angesprochen über | Einen Bezeichner, TASK-42, in beliebiger Schreibweise | Eine Nummer, 42 oder #42, oder die URL der Issue |
| Wo | --space <slug> oder der aktive Space (eqs spaces use) | -R, --repo [github.com/]<owner>/<name> oder das GitHub-Remote dieses Klons, origin zuerst |
| Berechtigungen | item.* | issue.read, issue.write, issue.delete |
--gh: eqs issue view https://github.com/octo/app/issues/42 liest sie von GitHub.Befehle
Listet die offenen Items eines Space, angeheftete zuerst, oder die offenen Issues eines Repositorys. Auch ls.
open (Standard), closed oder all@me, eine E-Mail-Adresse, eine ID oder einen GitHub-Login@me, ein Mitglied oder einen Login erwähneneqs issue ls -a @me -l api,ui
Zeigt ein Item oder eine Issue: Typ, Phase oder Status, Sperre, Anheftung, Zuständige, Labels und Beschreibung, und womit es zusammenhängt: das übergeordnete Item, Unter-Items oder Sub-Issues, wodurch es blockiert wird und was es blockiert.
/w/<workspace>/items/<identifier>, in seiner Liste, wo immer es liegt. Ist der Browser in einem anderen Workspace, bietet die Plattform zuerst den Wechsel aneqs issue view 650 --gh -c
Legt ein Item an, vom Typ Aufgabe, in der einzigen Liste des Space und in deren erster Phase, sofern nicht anders angegeben, oder eine Issue. Auch new.
- liest die Standardeingabe)eqs issue new --gh -t "Flaky test" -l bug --parent 652
Bearbeitet ein oder mehrere Items auf einmal, oder mehrere Issues eines Repositorys.
none leert die letzten beiden)eqs issue edit TASK-41 TASK-42 --add-label api
Schließt ein Item, in die Erledigt-Phase seiner Liste, oder eine Issue, mit einem Grund. Was bereits geschlossen ist, bleibt, wie es ist.
completed (Standard), "not planned" oder duplicateeqs issue close TASK-42 --duplicate-of TASK-41
Öffnet ein Item wieder, zurück in die erste offene Phase seiner Liste, oder eine Issue. Was bereits offen ist, bleibt, wie es ist.
eqs issue reopen 42 --gh
Löscht ein Item, mit allem darunter, oder eine Issue, nachdem Sie den Bezeichner oder die Nummer eingetippt haben.
eqs issue delete TASK-42Kommentiert ein Item oder eine Issue, oder bearbeitet oder löscht Ihren letzten Kommentar dort.
--create-if-none wird kommentiert, wenn es noch keinen gibt--yes überspringt die Bestätigungeqs issue comment TASK-42 --edit-last -b "On it, tomorrow"
Ihre offenen Items, oder Ihre offenen Issues in einem Repository: Ihnen zugewiesen, Sie erwähnend, von Ihnen geöffnet.
eqs issue status --gh
Verschiebt ein Item, mit seinen Unter-Items, in eine andere Liste (<space>/<list>), oder eine Issue in ein anderes Repository desselben Owners (<owner>/<name>). Ein Item, das in einen anderen Space wechselt, lässt seine Labels zurück.
eqs issue transfer TASK-42 platform/BacklogSperrt die Unterhaltung: Danach kommentiert nur noch, wer es bearbeiten darf. eqs issue unlock <ref> entsperrt sie.
off_topic, resolved, spam oder too_heatedeqs issue lock TASK-42 -r resolved
Heftet ein Item oben in seinem Space an, zuerst in jeder Ansicht seiner Liste, oder eine Issue an ihr Repository. Höchstens drei je, wie auf GitHub. eqs issue unpin <ref> löst es wieder.
eqs issue pin TASK-42Erstellt einen Branch für ein Item, in einem verbundenen Repository, oder für eine Issue, auf GitHub mit ihr verknüpft. Mit --list stattdessen seine Branches.
eqs issue develop TASK-42 -c
--gh, -R, --repo und --json [fields], das die rohe Antwort ausgibt, oder nur die genannten Felder, durch Kommas getrennt. Ein Feld, das die Antwort nicht hat, wird abgelehnt, bevor etwas geschieht, mit der Liste der vorhandenen. Optionen mit mehreren Werten nehmen sie wiederholt oder durch Kommas getrennt.Berechtigungen
Jeder Unterbefehl braucht die Aktion unten.
| Unterbefehl | Ohne Flag | Mit --gh |
|---|---|---|
list, view, status | item.read | issue.read |
create | item.create (item.update für seine Beziehungen) | issue.write |
edit, close, reopen, lock, unlock, pin, unpin | item.update | issue.write |
transfer | item.update (und item.create in einem anderen Space) | issue.write |
comment | item.comment (item.update bei einem gesperrten Item) | issue.write |
delete | item.delete | issue.delete |
develop | item.update und scm.write (item.read für --list) | issue.write (issue.read für --list) |
Von den eingebauten Rollen liest und kommentiert Reader: Sie hat item.read, item.comment und issue.read. Contributor legt außerdem an und ändert: alle item.*-Aktionen, dazu issue.read und issue.write. Nur Owner hat issue.delete.
Ein Item kann auf eines in einem anderen Space verweisen: das, das es dupliziert, was es blockiert, was es selbst blockiert. Sie erfahren davon nur, wenn Sie die Items in dessen Space lesen dürfen. Andernfalls lässt view es weg, und close --duplicate-of antwortet, dass es dieses Item nicht gibt.
Auf GitHub
Die Arbeit erledigt die GitHub-Verbindung Ihres Workspace, daher zeigt GitHub die App der Verbindung als Autor dessen, was Sie anlegen und kommentieren, und eQuantic Space protokolliert, wer es veranlasst hat. @me ist Ihr GitHub-Login, den es kennt, wenn Sie sich mit GitHub angemeldet haben. Andernfalls schreiben Sie stattdessen Ihren Login. status --gh braucht diese Anmeldung.
Wenn GitHub ablehnt, sagt das CLI warum: Die Ablehnung nennt die Berechtigung, die der App fehlt, und ein Rate-Limit sagt, wann es zurückgesetzt wird.
Die neuen Berechtigungen der App akzeptieren
--gh braucht zwei Berechtigungen, die die GitHub App bisher nicht angefordert hat: Issues und Contents, beide Lesen und Schreiben (Contents, um einen Branch zu erstellen). Solange eine Installation sie nicht akzeptiert, behält GitHub dort die alten Berechtigungen der App und lehnt diese Schreibzugriffe ab, und das CLI nennt die fehlende Berechtigung.
eqs issue delete --gh lässt sich nicht rückgängig machen: GitHub löscht die Issue endgültig. Deshalb hat nur der Owner issue.delete, und das CLI lässt Sie vorher die Nummer der Issue eintippen.