remkop/picocli
Picocli
picocli 是一个用于 JVM 应用的命令行接口（CLI）开发框架和参数解析器。它使用声明式的注解模型，将命令行选项和位置参数映射到强类型的 Java 方法和字段。
该框架为原生镜像（Native Image）编译提供了特定支持，生成构建具有更低启动开销的独立二进制文件所需的反射和资源配置文件。它还以专门的 shell 自动补全脚本生成系统和用于为输出应用颜色与样式的 ANSI 终端美化器而著称。
该项目涵盖了广泛的终端应用功能，包括用于嵌套子命令的层级命令分发、自动生成使用帮助和 man 手册页，以及带有用户提示的交互式 shell 实现。它还包括通过自定义工厂进行依赖注入、基于插件的类型转换以及处理外部参数文件的基础设施。
Features
- Command Line Argument Parsers - Implements a powerful parser that converts raw shell input into structured Java objects based on defined requirements.
- Command Line Argument Parsing - Converts raw terminal input into strongly typed Java objects using named options and positional parameters.
- Command-Line Interface Development - Provides a framework for building terminal applications that map arguments and options to strongly typed Java data.
- Nested Command Structures - Creates hierarchical command structures that allow users to navigate complex toolsets through sub-levels.
- Command Hierarchies - Executes nested command hierarchies based on user input using aliases and lazy instantiation.
- AOT Metadata Generation - Produces the reflection and resource configuration files necessary to build standalone binaries with reduced startup overhead.
- Annotation-Based Model Mapping - Implements a declarative model that maps command line options and parameters to strongly typed Java fields using annotations.
- Hierarchical Command Dispatch - Supports hierarchical command dispatch for complex toolsets with nested subcommands.
- CLI Command Mapping - Maps command line arguments and options directly to specific methods and fields for automated execution.
- Reflection-Based Population - Uses reflection to populate typed fields in command objects from raw string arguments during the parsing phase.
- Argument Grouping - Groups related options to enforce mutual exclusivity or require that certain parameters appear together.
- CLI Type Converters - Transforms command line strings into complex data types using built-in converters or custom implementation classes.
- Type Conversion Registries - Implements a registry of interchangeable converter classes to transform command line strings into complex Java types.
- Native Binary Optimizations - Offers specific support for GraalVM native image compilation to create fast-starting standalone binaries.
- CLI Documentation Generation - Automatically produces formatted usage help, man pages, and technical documentation from command definitions.
- Recursive Argument File Parsing - Supports reading options from external files to bypass operating system command line length limits.
- External Argument File Processing - Reads input from external files to bypass operating system limits on command line length.
- Help Generators - Produces formatted help messages with synopses and option lists that adapt to terminal width.
- Interactive CLI Prompts - Provides interactive CLI prompts for collecting user input, including secure fields for passwords.
- Interactive Shells - Implements persistent interactive shell sessions combining command parsing with real-time tokenization.
- Man Page Generation - Automatically generates Unix man pages and other documentation formats from CLI definitions.
- Native AOT Compilation - Enables compilation into standalone binaries to eliminate runtime startup overhead and increase speed.
- Shell Autocompletion Scripts - Generates shell autocompletion scripts to provide interactive suggestions for options and subcommands.
- Shell Completion Generators - Generates context-sensitive shell autocompletion scripts for options and subcommands across various terminal shells.
- Native Compilation Metadata - Produces reflection and resource configuration files necessary for ahead-of-time native binary compilation.
- Native Image Compatibility Tools - Builds the command model at compile time to ensure full compatibility with native image compilers.
- Executable Interface Frameworks - Enables the creation of command line tools that operate either within or independently of a runtime environment.
- CLI - Restricts options by defining mutual exclusivity or specifying exact counts and ranges for parameters.
- Terminal Color Formatting - Provides a dedicated ANSI terminal stylizer for applying colors and styles to text output.
- Terminal Styling - Applies ANSI colors and styles to terminal output using markup codes for visual emphasis.
- Java CLI Frameworks - Modern framework for building user-friendly CLI apps.
- Scripting Tools - Framework for building feature-rich command-line interfaces.
