docopt/docopt
Docopt
Docopt ist ein Parser für Befehlszeilenargumente und ein deklaratives Schnittstellentool, das rohe Terminaleingaben in eine strukturierte Datenkarte umwandelt. Es leitet seine Parsing-Logik und Anforderungen direkt aus einer standardisierten POSIX-Hilfenachricht ab und verwendet die Dokumentation als formale Spezifikation für die Schnittstelle.
Das System implementiert einen POSIX-Usage-Pattern-Parser, um menschenlesbare Hilfe-Strings in Regeln für die Extraktion von Optionen und Positionsargumenten zu übersetzen. Es generiert automatisch Hilfebildschirme und Versionsinformationen basierend auf den internen Nutzungsmustern, die vom Benutzer definiert wurden.
Das Tool sorgt für eine vorhersehbare Benutzererfahrung durch strikte Argument- und Optionsreihenfolge und verhindert das Mischen von Eingaben, sobald Positionsargumente auftreten. Es bietet eine vollständige Implementierung für das Design von Befehlszeilenschnittstellen und gleicht Eingabe-Token mit vordefinierten Mustern ab, um Datenstrukturen zu befüllen.
Features
- Usage-Pattern-Based Parsing - Translates a formal help string into a set of rules for extracting options and positional arguments from input.
- CLI Token Consumption - Processes the input stream sequentially to identify flags and arguments while adhering to specified order constraints.
- CLI Token Matching - Matches raw command line tokens against defined usage patterns to populate a structured data map.
- Declarative Argument Definitions - Defines CLI interfaces using a human-readable help message as a declarative source of truth instead of imperative logic.
- Command Line Argument Parsers - Parses raw shell input strings into structured objects based on a predefined usage pattern.
- POSIX Usage Parsers - Derives command-line logic and requirements directly from a standardized POSIX-style help message.
- POSIX CLI Compliance - Creates command line tools that follow standard POSIX conventions for flags and arguments.
- CLI Specification Design - Defines how a program accepts user inputs by writing a clear usage message that the system automatically parses.
- Strict Argument Ordering - Ensures all options appear before positional arguments to prevent mixing inputs and ensure predictable command parsing.
- Command Help Displays - Displays formatted help screens and version information when specific command flags are provided.
- Help Generators - Automatically generates terminal-friendly documentation and version information from the internal usage specification.
- Help Text Generators - Automatically constructs and formats instructional help documentation based on the parsed usage patterns.
- Strict Option Sequencing - Stops accepting options once the first positional argument is encountered to maintain a strict sequence of command inputs.
- CLI Development - Creates command-line interfaces based on usage documentation strings.
- Python CLI Frameworks - Pythonic argument parser based on help messages.
