nushell / nushell/nushell.github.io

Documentation: A "Coming from Perl" section

Offen
#1,843 7 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

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

Beschreibung

Related problem

The "Coming from " sections of the Nushell book are a great idea, but there is an obvious "other language" missing- Perl.

As a solution that aims to bridge the gap between shells and programming languages the Pathologically Eclectic Rubbish Lister (PERL) seems to me the natural ancestor/competitor of Nushell. Perl may be long in the tooth but it is still a very widely used tool on Linux / Unix based systems, and has a lot of features designed specifically to make it work well as a "glue" language.

It's not obvious (at least to me as a user new to Nushell) how some of the things Perl can do can be accomplished in Nushell, some specific "getting started" help would be useful.

Describe the solution you'd like

A documentation section on "Coming from Perl" could help open up Nushell to areas where Perl has been the "swiss army knife" of system automation for years.

As an example, it would be particularly helpful to have idiomatic Nushell alternatives for the Perl "special variables" including-

$0    $PROGRAM_NAME        Pathname of the current script
$$    $PID                 The pid of the process running the current script
$^T   $BASETIME            Timestamp when the current process started
$<    $UID                 Real user ID (uid) of this process
$>    $EUID                Effective user ID of this process
$(    $GID                 Real group ID
$)    $EGID                Effective group ID
$!    $ERRNO / $OS_ERROR   Number or text of the error from the last system call
$?    $CHILD_ERROR         Status returned by the last child process
Describe alternatives you've considered

No response

Additional context and details

No response

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

Beginne damit, die vorhandenen Abschnitte „Coming from “ im Nushell-Buch zu finden und ihre Struktur und Beispiele zu lesen. Füge einen vergleichbaren Abschnitt „Coming from Perl“ mit idiomatischen Nushell-Alternativen für die aufgelisteten speziellen Perl-Variablen hinzu und überprüfe anschließend, ob er dem Dokumentationsstil und der Navigation des Buchs entspricht.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

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

Neue Issues direkt in Ihr Postfach

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