argbash

Argbash

• Schreiben Sie Bash -Skripte, die Argumente akzeptieren sollten?
• Aber seit Argumenten ist Unterstützung nicht eine entmutigende Aufgabe, weil ...
• getopt ist entmutigt, getopts unterstützt keine langen Optionen, es gibt kein weit verbreitetes Bash Modul, um die Aufgabe zu erledigen, und einige Lösungen funktionieren nicht auf allen Plattformen (Linux, OSX, MSW) ...

Probieren Sie Argbash aus, um nicht mehr von diesen lästigen Argumenten terrorisiert zu werden! Mit Argbash werden Sie:

• Eine schnelle, minimalistische Argumentationserklärung, die Ihr Skript erwartet (siehe unten für unterstützte Argumententypen).
• Skripte, die aus Definitionen generiert werden, sobald sie auf allen Plattformen mit bash verwendet werden können.
• Definitionen, die in wenige Zeilen des Skripts selbst eingebettet sind (damit Sie Argbash verwenden, um den Parsing -Teil Ihres Skripts leicht zu regenerieren).
• Fähigkeit zur Wiederverwendung Argbash -bewährten Skripten mit niedrigem Niveau, indem sie sie durch die bequeme Argbash -ANGEWIRKUNGEN auf höherer Ebene einwickeln, ohne Code zu duplizieren.
• Einfache Installation (optional). Holen Sie sich einfach eine Version, entpacken Sie es, gehen Sie in cd resources && make install (Sie möchten möglicherweise sudo make install PREFIX=/usr ).
• Dokumentation und Beispiele.

Machen Sie Ihr vorhandenes Skript in ein paar Minuten von Argbash . Erforschen Sie verschiedene Aromen von Argbash:

Geschmack	Zielgruppe
Argbash online	Verwenden Sie es, wenn Sie Argbash probieren möchten, ohne es zu installieren, und einen dauerhaften Zugriff auf das Internet haben.
Argbash Cli	Installieren Sie das Paket so, dass argbash ständig vor Ort bereit ist.
Argbash Docker	Ziemlich wie Argbash CLI, aber Sie müssen es nicht installieren, Sie laden das Bild einfach herunter.

Was es ist

Argbash ist keine Parsing-Bibliothek, sondern eher ein Codegenerator, der eine Bash-Bibliothek generiert, die für Ihr Skript zugeschnitten ist. Sie können Argumente beschreiben, die Ihr Skript einnehmen sollte, und dann können Sie den bash -Parsing -Code generieren. Es bleibt standardmäßig in Ihrem Skript, aber Sie können es in einer separaten Datei generiert und Argbash in Ihr Skript für Sie einbeziehen lassen. In jedem Fall müssen Sie Argbash nicht benötigen, um das Skript auszuführen.

Argbash ist sehr einfach zu bedienen und der generierte Code ist relativ schön zu lesen. Darüber hinaus bleiben Argument-Definitionen in das Skript eingebettet. Wenn Sie also die Parsen-Logik aktualisieren müssen, führen Sie das argbash -Skript auf dem bereits generierten Skript erneut aus.

Wenn Sie also nur wenige Kommentare zu Ihrem Skript schreiben und den bin/argbash von Argbash darüber ausgeführt haben, erhalten Sie ein bash -Skript mit Argument -Parsen. Die einfache Beispielquellvorlage und das einfache Beispielskript für das Ergebnis finden Sie in der einfachen Beispiel -Quellvorlage. Wenn Sie nicht lange lesen möchten, lassen Sie bin/argbash-init die Vorlage für Sie generieren.

Die folgenden Argumententypen werden unterstützt:

• Positionsargumente (unterstützte Ausfälle, Möglichkeiten einer festen, variablen oder unendlichen Anzahl von Argumenten).
• optionale Argumente, die einen Wert nehmen,
• boolesche optionale Argumente,
• wiederholte (dh nicht übertriebene) optionale Argumente,
• Inkrementierende (wie --verbose ) optionale Argumente und
• Aktion optionale Argumente (z. B. --version , --help ).

Die folgenden Ausgänge sind verfügbar:

• Bash-Skripte, maßgeschneiderte Bash-Parsing-Bibliotheken.
• POSIX-Skripte, die getopts verwenden, maßgeschneiderte.
• Fertigstellung.
• docopt-konforme Nutzungsnachricht.
• Manpage Output mit RST2MAN.

Das Dienstprogramm wurde von Pythons argparse und dem shflags -Projekt inspiriert.

Lesen Sie die DOCS (neueste stabile Version) für weitere Informationen

Anforderungen

• bash , der mit Arrays arbeiten kann (höchstwahrscheinlich bash >= 3.0 ) (die einzige Anforderung für Benutzer - dh Personen, die nur Skripte ausführen und sie nicht machen)
• autom4te -Dienstprogramm, das mit Sets funktionieren kann (Teil der autoconf >= 2.63 Suite)
• Grundlegende sed , grep , cat , test .