nushell / nushell/nushell.github.io

Add a chapter about errors

Offen
#772 5 Kommentare 2 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

Vorherrschende Sprache
TypeScript
Sterne
258
Forks
561
Ø Merge
3 Std. 20 Min.
Gemergte PRs (30 T.)
15

Beschreibung

One concept that I still find quite hard to grasp are Nushell's errors.
As far as I can tell, they behave like raised exceptions in a language like Python.
They bubble up, but can be caught with try or do -i.
However, I haven't seen that spelled out yet.

I see that nushell errors are also created if external commands exit with a non-zero exit code.
But also that isn't mentioned in the book.

I would be happy to add a chapter about errors in Nushell if someone could me guide through the things I am unsure about.

Topics to cover:

  • behavior of errors
  • try
  • do
  • error make
  • complete

Beitragsleitfaden

Beitragsleitfaden öffnen

Erste Schritte

  1. Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
  3. Forke das Repository und arbeite in einem Branch.
  4. Öffne einen Pull Request, der die Issue-Nummer nennt.

Rechercherichtung

In der Issue werden keine Dateien, Tests oder Einstiegspunkte genannt. Beginne mit der Durchsicht der Nushell-Dokumentation zu Fehlern, try, do -i, error make und complete, und bestätige anschließend, wie sich externe Exit-Codes ungleich null verhalten; abgeschlossen ist die Aufgabe, wenn ein Kapitel hinzugefügt wurde, das jedes aufgeführte Thema klar erklärt.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
shell
Bereich
documentation
Issue-Typ
Dokumentation
Schwierigkeit
3/5
Geschätzter Aufwand
1-2 Tage
Aktivitätsstatus
Veraltet
Klarheit
Größtenteils klar
Anfängerfreundlichkeit
35/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.