gnodet opened a new pull request, #22165:
URL: https://github.com/apache/camel/pull/22165
## Summary
- Organize the `Run` command's 60+ options into logical groups using
picocli's `@ArgGroup` annotation
- Options are now grouped under dedicated sections in the help output for
better discoverability
- All existing option names, defaults, and descriptions are preserved
exactly as-is
- Updated all field references in `Run.java`, `Debug.java`,
`ExportBaseCommand.java`, `Script.java`, and `TransformRoute.java`
### Option groups introduced
| Group | Heading | Options |
|-------|---------|---------|
| `LoggingOptions` | Logging Options | `--logging`, `--logging-level`,
`--logging-color`, `--logging-json`, `--logging-config-path`,
`--logging-category` |
| `DebugOptions` | Debug Options | `--jfr`, `--jfr-profile`, `--trace`,
`--backlog-trace` |
| `ExecutionLimitOptions` | Execution Limit Options | `--max-messages`,
`--max-seconds`, `--max-idle-seconds` |
| `ServerOptions` | Server Options | `--port`, `--management-port`,
`--console`, `--health`, `--metrics`, `--observe` |
### Help output structure (after)
```
Usage: camel run [-hV] [--background] [--background-wait] ...
Run as local Camel integration
<files> The Camel file(s) to run.
--runtime=<runtime> Runtime (camel-main, spring-boot, quarkus)
--source-dir=<sourceDir> Source directory for dynamically loading
Camel file(s)
--background Run in the background
... (general options)
Logging Options:
--logging Can be used to turn off logging
--logging-level=<loggingLevel> Logging level
--logging-color Use colored logging
--logging-json Use JSON logging (ECS Layout)
--logging-config-path=<loggingConfigPath> Path to file with custom
logging configuration
--logging-category=<loggingCategory> Used for individual logging
levels
Debug Options:
--jfr Enables Java Flight Recorder
--jfr-profile=<jfrProfile> Java Flight Recorder profile
--trace Enables trace logging of the routed messages
--backlog-trace Enables backlog tracing of the routed messages
Execution Limit Options:
--max-messages=<maxMessages> Max number of messages to process before
stopping
--max-seconds=<maxSeconds> Max seconds to run before stopping
--max-idle-seconds=<maxIdleSeconds> For how long time in seconds
Camel can be idle
Server Options:
--port=<port> Embeds a local HTTP server on this port
--management-port=<managementPort> Dedicated port for HTTP management
--console Developer console at /q/dev
--health Health check at /q/health (deprecated)
--metrics Metrics at /q/metrics (deprecated)
--observe Enable observability services
```
Previously all 60+ options were listed in a single flat list.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
