Befehlszeilenoptionsparser für Java

Sie könnten sich FeSimpleArgs ansehen

Ich glaube, es erfüllt alle Ihre Anforderungen:

Konzept: Ein sehr leichter Kommandozeilen-Parser. Akzeptiert Argumente entweder in der Form String oder String[], gibt eine Klasseninstanz zurück, die die Argumente in einer Zuordnung und die Parameter in einer Liste enthält.

Anforderungen:

• Nimmt einen beliebigen String oder String[] (dh verwendet nicht die Argumente von der Kommandozeile) Ja
• Nimmt Argumente in einem ähnlichen Format wie getopt (die erweiterte GNU-Version); speziell:
• Mehrere Einzelbuchstaben-Optionen können verbunden werden (z. B. -a -b -c bis -abc) Ja
• Unterstützt lange Optionen (z. B. --message="Hello!") (obwohl es keine langen Optionen mit einem Bindestrich unterstützen muss) Ja
• Geht davon aus, dass alle nicht-optionsähnlichen Bits am Ende Parameter sind, die normal übergeben werden müssen (z. B. -abc --long="Hello!" param1 param2 sagt mir, dass die Parameter param1 und param2 sind) Ja
• -- kann verwendet werden, um Optionen von Argumenten zu trennen (z. B. -ab --custom="hello" -- -file_starting_with_hyphen -another gibt mir die Optionen/Flags a, b und custom mit den entsprechenden Werten und teilt mir mit, dass die Argumente sind -file_starting_with_hyphen und -another) Ja
• Leerzeichen können Teil von Argumenten sein, wenn sie in Anführungszeichen stehen. Ja

• Ein Optionsname gefolgt von einem Wert wird als die Option mit diesem Wert geparst (z. B. -h foo sagt, dass es eine Option h mit einem Wert foo gibt). Ja

• Vollständig plattformübergreifend Ja

• Ich muss nicht angeben, nach welchen Optionen ich suche (dh ich übergebe einen String oder String[] und er sagt mir, welche Flags/Optionen gesetzt wurden, anstatt nach den Optionen zu suchen, die ich setzen möchte, und davon auszugehen der Rest sind Argumente) Ja

zur nutzung:

• Kostenlos (wie in Bier) Ja - Apache 2.0
• Kann in jedem Projekt legal verwendet werden (dh nicht nicht kommerziell, nicht GPL) Ja - Apache 2.0
• Minimale Urheberrechtslizenz (Keine Copyleft – ich mag es, mir keine Gedanken über rechtliche Probleme zu machen, und ich hasse Leute, die mir sagen wollen, dass ich meine Arbeit nicht verwenden darf, aber ich bitte verdammt noch mal, bitte) Ja – Apache 2.0

Veröffentlicht unter der Apache 2.0-Lizenz.

Ideal, aber nicht notwendig:

• Klein – eine Datei Ja (eine Datei für den Parser, eine für die Komponententests, wird nicht zum Parsen benötigt)
• Verwendet die integrierten Schnittstellen (insbesondere java.util.Map), um Daten zurückzugeben. (So ​​kann ich später leichter meine eigene Funktion schreiben) **Art von ** (Gibt eine Klasse zurück, die eine java.util.Map von Argumenten und eine Liste von Parametern enthält)

VERWENDUNG Verwendung: 1) Erstellen Sie eine Instanz von FeSimpleArgs

FeSimpleArgs parser = new FeSimpleArgs();

2) Verwenden Sie es, um Ihre Argumente zu analysieren:

FeSimpleArgs.Result result = parser.parse ("-def=value1 --GHI=value2 -a -b -c=value3 -n=\"foo bar baz\" -- param1 -param2"); 

3) Untersuchen Sie Ihre Ergebnisse: Aus dem Obigen besteht das Ergebnis aus einer Map, die die folgenden Argumente und Flags enthält (beachten Sie, dass „Argument“ oder „Flag“ keine wirkliche Bedeutung haben, ich verwende diese Begriffe nur, um zu trennen, ob sie gelten Werte oder nicht - alle befinden sich in derselben Map).

• a
• b
• d
• e
• f mit Wert=Wert1
• WHI mit Wert=Wert2
• c mit Wert=Wert3
• n mit value=foo bar baz (Anführungszeichen werden entfernt)

Und eine Liste mit diesen Parametern (beachten Sie, dass der führende Bindestrich erhalten bleibt) - param1 - -param2

4) Gewinn?

Weitere Beispiele finden Sie in den enthaltenen Unit-Tests.

Haftungsausschluss: Ich bin der Autor von FeSimpleArgs

Ich habe args4j erfolgreich in einer Reihe von Projekten eingesetzt. Es wurde von Kohsuke Kawaguchi entwickelt, der auch Jenkins entwickelt hat, Hauptentwickler für JAXB und andere Projekte war, also hat er einen sehr guten Stammbaum.

Hinweis: Diese Antwort ist veraltet, da OP die Frage bearbeitet hat, um eine Anforderung hinzuzufügen, die diese nicht erfüllt (es ist jedoch immer noch verdammt gut zu wissen). Siehe die Kommentare unten. Das OP möchte NICHT , dass Sie diese Antwort ablehnen.

Der Klassiker dafür in Unix/Linux, noch aus C-Tagen, war GetOpt().

Gnome hat hier einen Java-Port .

Picocli könnte von Interesse sein. Es handelt sich um eine einzelne Quelldatei, um Entwickler von Befehlszeilen-Apps zu ermutigen, sie als einfachere Alternative zum Schattieren von Gläsern in einem Uberjar als Quelle einzuschließen. Es erfüllt auch alle anderen Anforderungen, die im OP - UPDATE angegeben sind: mit Ausnahme der Anforderung, dass Optionen nicht zur Kompilierzeit behoben werden können :-(.

UPDATE 2: picocli 3.x bietet zusätzlich zur Annotations-API eine programmatische API, erfüllt also jetzt alle Anforderungen. Beachten Sie, dass Groovy CliBuilder seit Groovy 2.5 auf Picocli basiert. Das ist genau das, wonach das OP fragt: Optionen und Positionsparameter dynamisch zu einem Befehl hinzufügen.

Es hat kürzlich eine Autovervollständigungsfunktion hinzugefügt.

Eine weitere Funktion, die Ihnen gefallen könnte, ist die farbige Nutzungshilfe.

Parser-Funktionen:

• Anmerkungs-API: Das Parsen ist eine Codezeile in Ihrer Anwendung
• Programmatische API: Alles, was mit Anmerkungen möglich ist, kann programmgesteuert ausgeführt werden
• Alles stark typisiert - Befehlszeilenoptionen sowie Positionsparameter
• POSIX-Cluster-Short-Optionen ( <command> -xvfInputFilesowie <command> -x -v -f InputFile) und GNU-Long-Optionen
• Ein Aritätsmodell, das eine minimale, maximale und variable Anzahl von Parametern zulässt, z "1..*"."3..5"
• Unterbefehle (können beliebig tief verschachtelt werden)
• Funktioniert mit Java 5 und höher

Die Hilfemeldung zur Verwendung kann einfach mit Anmerkungen angepasst werden (ohne Programmierung). Zum Beispiel:

( Quelle )

Ich konnte nicht widerstehen, einen weiteren Screenshot hinzuzufügen, um zu zeigen, welche Hilfemeldungen zur Verwendung möglich sind. Die Nutzungshilfe ist das Gesicht Ihrer Anwendung, also seien Sie kreativ und haben Sie Spaß!

Haftungsausschluss: Ich habe Picocli erstellt. Feedback oder Fragen sehr willkommen.