remkop/picocli v0.9.0

picocli 0.9.0

on GitHub

Initial release for public review. API may change.

Issues Closed

0.9.0 (was 0.4.0) Milestone - User Manual and API Changes

• #89 Improve error message for missing required options and parameters (enhancement)
• #88 Code cleanup (enhancement)
• #87 Add CommandLine.usage methods with a ColorScheme parameter (enhancement)
• #86 Work around issue on Windows (Jansi?) where style OFF has no effect (bug)
• #85 Javadoc for Ansi classes (doc)
• #84 System property to let end users set color scheme (enhancement)
• #81 Improve README (doc enhancement)
• #80 Support customizable Ansi color scheme (enhancement)
• #79 Approximate istty() by checking System.console() != null (enhancement)
• #78 Add method CommandLine.setUsageWidth(int) (enhancement wontfix)
• #77 Replace PicoCLI in javadoc with picocli (doc enhancement)
• #76 @parameters javadoc is out of date (bug doc)
• #75 The default value for the showDefaultValues attribute should be false (bug)
• #74 rename attribute valueLabel to paramLabel (enhancement)
• #73 Remove @parameters synopsis attribute enhancement)
• #72 numeric parameter conversion should parse as decimal (bug enhancement)
• #71 Allow multiple values for an option -pA,B,C or -q="A B C" (enhancement)
• #66 Support ansi coloring (doc enhancement)
• #65 Consider removing the required Option attribute (enhancement question wontfix)
• #64 Test that boolean options with arity=1 throw MissingParameterException when no value exists (not ParameterException) (bug QA)
• #35 Allow users to express arity as a range: 0..* or 1..3 (remove "varargs" attribute) (enhancement)
• #30 Test & update manual for exceptions thrown from custom type converters (doc QA)
• #26 Ergonomic API - convenience method to parse & run an app (duplicate enhancement)
• #12 Create comparison feature table with prior art (doc)
• #11 Write user manual (doc in-progress)
• #6 Array field values should be preserved (like Collections) and new values appended (enhancement)
• #4 Should @option and @parameters have listConverter attribute instead of elementType? (enhancement question wontfix)

0.3.0 Milestone - Customizable Usage Help

• #69 Improve TextTable API (enhancement question)
• #63 Unify @option and @parameters annotations (enhancement wontfix)
• #59 Support declarative API for customizing usage help message (enhancement wontfix)
• #58 Add unit tests for ShortestFirst comparator (QA)
• #57 Consider using @Usage separator for parsing as well as for usage help (enhancement)
• #56 Add unit tests for customizable option parameter name and positional parameter name (QA)
• #55 Add unit tests for detailed Usage line (QA)
• #54 Add unit tests for DefaultLayout (QA)
• #53 Add unit tests for DefaultParameterRenderer (QA)
• #52 Add unit tests for DefaultOptionRenderer (QA)
• #51 Add unit tests for MinimalOptionRenderer (QA)
• #50 Add unit tests for Arity (QA)
• #49 Detailed usage header should cluster boolean options (enhancement)
• #48 Show positional parameters details in TextTable similar to option details (enhancement)
• #47 Reduce API surface for usage Help (enhancement)
• #44 Support detailed Usage line instead of generic Usage <main> [option] [parameters] (enhancement)
• #43 Generated help message should show parameter default value (except for boolean fields) (enhancement)
• #42 Show option parameter in generated help (use field name or field type?) (enhancement)
• #41 Required options should be visually distinct from optional options in usage help details (enhancement)
• #40 Test SortByShortestOptionName (QA)
• #39 Test that first declared option is selected by ShortestFirst comparator if both equally short (QA)
• #38 Test DefaultRenderer chooses shortest option name in left-most field (QA)
• #37 Consider returning a list of Points from TextTable::putValue (enhancement wontfix)
• #36 javadoc ILayout, IRenderer, DefaultLayout, DefaultRenderer (doc)
• #34 Usage should not show options if no options exist (enhancement)
• #32 Support customizable user help format. (enhancement)
• #31 Add test for recognizing clustered short option when parsing varargs array (bug QA)
• #27 Support git-like commands (enhancement)
• #8 Add positional @parameter annotation (enhancement)
• #7 Implement online usage help (enhancement)
• #5 Rename description attribute to helpText or usage (enhancement wontfix)

0.2.0 Milestone - Vararg Support

• #25 Use Integer.decode(String) rather than Integer.parseInt (enhancement)
• #23 @option should not greedily consume args if varargs=false (bug)

0.1.0 Milestone - Basic Option and Parameter Parsing

• #20 add test where option name is "-p", give it input "-pa-p" (QA)
• #19 Improve error message for type conversion: include field name (and option name?) (enhancement)
• #18 test superclass bean and child class bean where child class field shadows super class and have different annotation Option name (QA)
• #17 Test superclass bean and child class bean where child class field shadows super class and have same annotation Option name (invalid QA)
• #16 Test arity > 1 for single-value fields (int, File, ...) (QA)
• #13 Test for enum type conversation (QA)
• #3 Interpreter should set helpRequested=false before parse() (bug)
• #2 Test that separators other than '=' can be configured (QA)
• #1 Test with other option prefixes than '-' (QA)