blob: 05bb809c62931be75d69e68a4acb7cd1fb8421f6 [file] [log] [blame]
Cedric Beusta6e4abd2010-10-01 11:42:59 -07001Current
2
John Yani20a8ea02012-10-27 22:07:22 +030031.30
42012/10/27
5
John Yani5d2a3452012-10-27 15:12:52 +03006Added: JCommander#acceptUnknownOption and JCommander#getUnknownArgs
Cedric Beust2c092c02012-08-01 08:50:32 -07007Added: JCommander#allowAbbreviatedOptions (default: false)
Cedric Beusta8f4de22012-07-31 11:24:27 -07008Added: JCommander#setCaseSensitiveOptions (default: true)
Cedric Beust5fc805c2012-09-23 06:10:45 -07009Added: Support for enums (Scott M Stark)
Cedric Beustc6fb7f82012-09-17 23:08:45 -070010Fixed: Missing new lines in usage (styurin)
Cedric Beust5f260732012-07-30 22:23:27 -070011Fixed: The description of commands is now displayed on the next line and indented.
John Yani5d2a3452012-10-27 15:12:52 +030012
131.29
142012/07/28
John Yani20a8ea02012-10-27 22:07:22 +030015
Cedric Beuste79760c2012-07-25 14:53:22 -070016Fixed: Empty string defaults now displayed as "<empty string>" in the usage
Cedric Beustf65b1602012-07-17 22:44:09 -070017Fixed: Bugs with the PositiveInteger validator
Cedric Beust94e08e72012-07-17 22:25:26 -070018Fixed: Parameters with a single double quote were not working properly
Cedric Beusta8560682012-07-06 23:25:36 -070019
201.27
John Yani5d2a3452012-10-27 15:12:52 +0300212012/07/05
John Yani20a8ea02012-10-27 22:07:22 +030022
Cedric Beusta8560682012-07-06 23:25:36 -070023Added: IValueValidator to validate parameter values (typed) as opposed to IParameterValidator which validates strings
Cedric Beust11b27d32012-05-30 14:51:50 -070024Added: echoInput, used when password=true to echo the characters (Jason Wheeler)
Cedric Beustc675ef52012-07-04 13:23:31 -070025Added: @Parameter(help = true)
Cedric Beust074b8af2012-05-31 11:51:19 -070026Fixed: wasn't handling parameters that start with " but don't end with one correctly
Cedric Beust9e22cff2012-05-15 14:49:22 -070027Fixed: if using a different option prefix, unknown option are mistakenly reported as "no main parameter defined" (kurmasz)
Cedric Beust13a57cd2012-05-08 15:14:12 -070028Fixed: 113: getCommandDescription() returns the description of the main parameter instead of that of the command
Cedric Beustfb38f402012-05-02 11:52:39 -070029Fixed: bug with several multiple arity parameters (VariableArityTest)
Cedric Beustc84dbd32012-04-29 15:17:05 -070030Fixed: variable arities not working when same parameter appears multiple times.
31
Cedric Beust5f5b78b2012-04-28 17:50:24 -0700321.25
332012/04/26
John Yani20a8ea02012-10-27 22:07:22 +030034
Cedric Beustd38864b2012-03-15 08:09:11 -070035Added: Default passwords are no longer displayed in the usage (Paul Mendelson)
Cedric Beust8f046522012-04-26 14:00:22 -070036Added: Variable arities now work magically, no need for IVariableArity any more
37Fixed: Commands using @Parameters(resourceBundle) were not i18n'ed properly in the usage()
Cedric Beustca0789b2012-04-18 10:14:48 -070038Fixed: StringIndexOutOfBoundsException if passing an empty parameter (bomanz)
Cedric Beust3506d022012-03-12 14:51:40 -070039Fixed: GITHUB-105: If no description is given for an enum, use that enum's value (Adrian Muraru)
Cedric Beust8ebf58f2012-03-10 16:12:16 -080040Fixed: GITHUB-108: Dynamic parameters with "=" in them are not parsed correctly (szhem)
Cedric Beust8ad02da2012-01-12 13:23:58 -080041Fixed: Commands with same prefix as options were not working properly.
Cedric Beust39e431e2012-02-25 16:43:59 -080042Fixed: GITHUB-97: Required password always complains that it is not specified (timoteoponce)
Cedric Beust8ad02da2012-01-12 13:23:58 -080043
441.23
452012/01/12
46
Cedric Beusta559c602012-01-10 16:49:06 -080047Added: @DynamicParameter
Julien HENRYe45913e2011-11-29 09:40:08 +010048Fixed: Use JDK 6 Console() when available to improve support of non ascii chars (Julien Henry)
49
Cedric Beustaf876df2011-11-25 11:30:06 -0800501.20
512011/11/24
52
Cedric Beust4ba2a3c2011-11-25 09:34:05 -080053Added: Support for delegating parameter definitions to child classes (rodionmoiseev)
Cedric Beust66e78952011-11-23 13:15:16 -080054Added: @Parameter(commandNames) so that command names can be specified with annotations
Cédric Beustf2af8142011-10-23 12:02:09 -070055Added: Support for enums (Adrian Muraru)
Cedric Beust4ba2a3c2011-11-25 09:34:05 -080056Fixed: Throw if an unknown option is found
Cedric Beustc3507eb2011-11-25 10:47:01 -080057Fixed: Main parameters are now validated as well (Connor Mullen)
Cédric Beustf2af8142011-10-23 12:02:09 -070058
591.19
602011/10/10
Cedric Beustaf876df2011-11-25 11:30:06 -080061
Cedric Beust8a3f5622011-07-15 10:55:52 -070062Added: commandDescriptionKey to @Parameters, to allow internationalized command descriptions
Cédric Beustcbdb7072011-10-05 23:14:20 -070063Added: JCommander#setParameterDescriptionComparator for better control over usage()
Cedric Beust876c9772011-08-17 11:09:57 -070064Fixed: Fields of type Set (HashSet and SortedSet) are now supported
Cedric Beustdce5bdf2011-08-03 11:04:58 -070065Fixed: defaults for commands were not properly applied (Stevo Slavic)
Cedric Beust2ee07bc2011-07-27 10:32:36 -070066Fixed: "-args=a=b,b=c" was not being parsed correctly (Michael Lancaster)
Cedric Beust4f4ea1f2011-07-14 11:17:16 -070067Fixed: GITHUB-73: descriptionKey was being ignored on main parameters
68
691.18
702011/07/20
71
Cedric Beustdb01fd22011-04-12 13:03:29 -070072Added: Default converter factories can be overridden (Scott Clasen)
Cedric Beust8877f662011-03-10 11:04:38 -080073Added: IParameterValidator
Cedric Beustc199c872011-07-07 13:34:54 -070074Added: Don't display "Options:" if none were defined
75Added: Enforce that the type of the main parameter is a List
76Added: usage() now displays the options for each command as well
Cedric Beustfe8a6962011-06-13 13:35:31 -070077Fixed: Default values with a validator were being validate at parse() time instead of creation time.
Cedric Beust8877f662011-03-10 11:04:38 -080078Fixed: Exception when using an @ file with empty lines between options
Cedric Beustc199c872011-07-07 13:34:54 -070079Fixed: OOM when parsing certain descriptions with long URL's in them
Cedric Beust279af562011-01-24 14:57:44 -080080
811.15
Cedric Beuste2d8da72011-01-24 14:01:29 -0800822011/01/24
83
Cedric Beustfce970e2010-12-23 12:25:49 -080084Added: Added a constructor that takes a Bundle only, https://github.com/cbeust/jcommander/pull/47 (Russell Egan)
Cedric Beuste2d8da72011-01-24 14:01:29 -080085Fixed: NPE with calling getCommandDescription() of an unknown command
Cedric Beust1f4e89c2010-12-23 12:33:45 -080086
871.13
882010/12/15
89
90Added: Boolean parameters with arity 0 (e.g. "foo -debug")
Cedric Beusta6e4abd2010-10-01 11:42:59 -070091Fixed: JCommander would sometimes just print a stack trace and continue, now rethrowing.
92
Cedric Beuste97a6422010-08-31 22:03:35 -0700931.7
Cedric Beust3a32b552010-09-06 07:26:09 -0700942010/09/06
Cedric Beuste97a6422010-08-31 22:03:35 -070095
Cedric Beust4c020da2010-08-31 22:23:52 -070096Added: Command usages are now shown in the order they were added to the JCommander object
Cedric Beust22b8a2f2010-09-06 07:17:37 -070097Fixed: JCommander now compatible with Java 5
Cedric Beuste97a6422010-08-31 22:03:35 -070098Fixed: Minor bug in the command display (Marc Ende)
99
Cedric Beust72cacba2010-08-15 17:23:00 -07001001.6
Cedric Beuste97a6422010-08-31 22:03:35 -07001012010/08/28
Cedric Beust6f6f4362010-07-29 17:18:24 -0700102
Cedric Beustdda16512010-08-25 18:54:58 -0700103Added: @Parameters(commandDescription = "command description")
Cedric Beust72cacba2010-08-15 17:23:00 -0700104Added: now throwing an exception if required main parameters are not supplied
Cedric Beusta76d5b92010-08-16 21:48:14 -0700105Fixed: usage() was changing default values after two runs (jstrachan)
Cedric Beust72cacba2010-08-15 17:23:00 -0700106
1071.5
1082010/08/15
109
110Added: overloaded versions of usage() with StringBuilders
111Added: inheritance support (Guillaume Sauthier)
112Added: support for commands (e.g. "main add --author=cbeust Foo.java")
113Added: support for converters for main parameters (e.g. List<HostPort>).
Cedric Beust6f6f4362010-07-29 17:18:24 -0700114
Cedric Beustc63fd222010-07-27 11:05:19 -07001151.4
Cedric Beust72cacba2010-08-15 17:23:00 -07001162010/07/28
Cedric Beustc63fd222010-07-27 11:05:19 -0700117
Cedric Beustabcd2cb2010-08-15 17:23:30 -0700118Added: string converter factories
119Added: IDefaultProvider
120Added: PropertyFileDefaultProvider
121Added: Usage is now showing required parameters and default value
122Added: Support for values that look like parameters ("-integer -3", "/file /tmp/a")
123Added: @Parameters(optionPrefixes) to allow for different prefixes than "-"
Cedric Beustc63fd222010-07-27 11:05:19 -0700124
Cedric Beust2a7a6d42010-07-20 22:37:47 -07001251.2
Cedric Beust72cacba2010-08-15 17:23:00 -07001262010/07/25
Cedric Beust2a7a6d42010-07-20 22:37:47 -0700127
Cedric Beustb1056412010-07-20 23:11:25 -0700128Usage is now aligned and alphabetically sorted
129Added the hidden attribute
Cedric Beustfe9b1e52010-07-23 15:18:22 -0700130Added support for different separators than " " (e.g. "=").
131Deprecated @ResourceBundle, replaced with @Parameters
Cedric Beust2a7a6d42010-07-20 22:37:47 -0700132
1331.1
Cedric Beustfe9b1e52010-07-23 15:18:22 -07001342010/08/15
Cedric Beust2a7a6d42010-07-20 22:37:47 -0700135
136Better internationalization
137Password support
138Type converters
139