@@ -10,6 +10,58 @@ Add new items at the end of the relevant section under **Unreleased**.
10
10
11
11
---
12
12
13
+ ## [ 1.2.0] - 2022-11-08
14
+
15
+ ### Additions
16
+
17
+ - You can now provide a title in an ` @OptionGroup ` declaration. Titled option
18
+ groups are listed separately in the help screen under that title as a
19
+ heading. ([ #492 ] )
20
+ - Two new parsing strategies have been added for ` @Argument ` array properties:
21
+
22
+ - ` .allUnrecognized ` captures all unrecognized inputs after parsing known
23
+ flags, options, and arguments.
24
+ - `.postTerminator` collects any inputs that follow the `--` terminator.
25
+
26
+ See the [ ` ArgumentArrayParsingStrategy ` documentation] [ arrayparse-docs ] for
27
+ more. ([ #496 ] )
28
+ - Default values are now supported for ` @Argument ` or ` @Option ` properties with
29
+ optional type, allowing you to initialize those properties with ` nil ` .
30
+ Providing a non-` nil ` default value results in a warning, since optional
31
+ properties with non-` nil ` defaults don't need to be declared as optionals.
32
+ ([ #477 ] , [ #480 ] )
33
+
34
+ ### Changes
35
+
36
+ - The ` .unconditionalRemaining ` array parsing strategy has been deprecated and
37
+ renamed to ` .captureForPassthrough ` , to better fit its semantic behavior and
38
+ intended usage. See the [ ` ArgumentArrayParsingStrategy `
39
+ documentation] [ arrayparse-docs ] for more. ([ #496 ] )
40
+
41
+ ### Fixes
42
+
43
+ - Invalid ` init(from:) ` decoding initializers are now correctly diagnosed by
44
+ ArgumentParser's validators. ([ #487 ] )
45
+ - Default values are now correctly displayed as flags for ` @Flag ` properties
46
+ with inversions or ` EnumerableFlag ` types. ([ #486 ] )
47
+ - The help display for non-string-backed raw representable types has been
48
+ corrected to not show raw Swift values. Instead, the help display uses the
49
+ type's customized ` defaultValueDescription ` and ` allValues ` implementations.
50
+ ([ #494 ] )
51
+ - Properties at different levels of a command hierarchy with the same Swift name
52
+ but different argument names no longer collide. ([ #495 ] )
53
+ - The ` generate-manual ` plugin name is improved when used from within Xcode.
54
+ ([ #505 ] )
55
+ - Documentation fixes and improvements.
56
+
57
+ The 1.2.0 release includes contributions from [ allevato] , [ clayellis] ,
58
+ [ compnerd] , [ d-ronnqvist] , [ natecook1000] , [ randomeizer] , and [ rauhul] .
59
+ Thank you!
60
+
61
+ [ arrayparse-docs ] : https://apple.github.io/swift-argument-parser/documentation/argumentparser/argumentarrayparsingstrategy
62
+
63
+ ---
64
+
13
65
## [ 1.1.4] - 2022-08-26
14
66
15
67
### Changes
@@ -691,7 +743,8 @@ This changelog's format is based on [Keep a Changelog](https://keepachangelog.co
691
743
692
744
<!-- Link references for releases -->
693
745
694
- [ Unreleased ] : https://github.com/apple/swift-argument-parser/compare/1.1.4...HEAD
746
+ [ Unreleased ] : https://github.com/apple/swift-argument-parser/compare/1.2.0...HEAD
747
+ [ 1.2.0 ] : https://github.com/apple/swift-argument-parser/compare/1.1.4...1.2.0
695
748
[ 1.1.4 ] : https://github.com/apple/swift-argument-parser/compare/1.1.3...1.1.4
696
749
[ 1.1.3 ] : https://github.com/apple/swift-argument-parser/compare/1.1.2...1.1.3
697
750
[ 1.1.2 ] : https://github.com/apple/swift-argument-parser/compare/1.1.1...1.1.2
@@ -763,21 +816,33 @@ This changelog's format is based on [Keep a Changelog](https://keepachangelog.co
763
816
[ #474 ] : https://github.com/apple/swift-argument-parser/pull/474
764
817
[ #475 ] : https://github.com/apple/swift-argument-parser/pull/475
765
818
[ #476 ] : https://github.com/apple/swift-argument-parser/pull/476
819
+ [ #477 ] : https://github.com/apple/swift-argument-parser/pull/477
820
+ [ #480 ] : https://github.com/apple/swift-argument-parser/pull/480
821
+ [ #486 ] : https://github.com/apple/swift-argument-parser/pull/486
822
+ [ #487 ] : https://github.com/apple/swift-argument-parser/pull/487
823
+ [ #492 ] : https://github.com/apple/swift-argument-parser/pull/492
824
+ [ #494 ] : https://github.com/apple/swift-argument-parser/pull/494
825
+ [ #495 ] : https://github.com/apple/swift-argument-parser/pull/495
826
+ [ #496 ] : https://github.com/apple/swift-argument-parser/pull/496
827
+ [ #505 ] : https://github.com/apple/swift-argument-parser/pull/505
766
828
767
829
<!-- Link references for contributors -->
768
830
769
831
[ 3405691582 ] : https://github.com/apple/swift-argument-parser/commits?author=3405691582
770
832
[ adellibovi ] : https://github.com/apple/swift-argument-parser/commits?author=adellibovi
771
833
[ aleksey-mashanov ] : https://github.com/apple/swift-argument-parser/commits?author=aleksey-mashanov
772
834
[ AliSoftware ] : https://github.com/apple/swift-argument-parser/commits?author=AliSoftware
835
+ [ allevato ] : https://github.com/apple/swift-argument-parser/commits?author=allevato
773
836
[ artemnovichkov ] : https://github.com/apple/swift-argument-parser/commits?author=artemnovichkov
774
837
[ atierian ] : https://github.com/apple/swift-argument-parser/commits?author=atierian
775
838
[ BradLarson ] : https://github.com/apple/swift-argument-parser/commits?author=BradLarson
776
839
[ buttaface ] : https://github.com/apple/swift-argument-parser/commits?author=buttaface
840
+ [ clayellis ] : https://github.com/apple/swift-argument-parser/commits?author=clayellis
777
841
[ CodaFi ] : https://github.com/apple/swift-argument-parser/commits?author=CodaFi
778
842
[ compnerd ] : https://github.com/apple/swift-argument-parser/commits?author=compnerd
779
843
[ CraigSiemens ] : https://github.com/apple/swift-argument-parser/commits?author=CraigSiemens
780
844
[ CypherPoet ] : https://github.com/apple/swift-argument-parser/commits?author=CypherPoet
845
+ [ d-ronnqvist ] : https://github.com/apple/swift-argument-parser/commits?author=d-ronnqvist
781
846
[ damuellen ] : https://github.com/apple/swift-argument-parser/commits?author=damuellen
782
847
[ dduan ] : https://github.com/apple/swift-argument-parser/commits?author=dduan
783
848
[ dirtyhabits97 ] : https://github.com/apple/swift-argument-parser/commits?author=dirtyhabits97
@@ -820,6 +885,7 @@ This changelog's format is based on [Keep a Changelog](https://keepachangelog.co
820
885
[ NicFontana ] : https://github.com/apple/swift-argument-parser/commits?author=NicFontana
821
886
[ owenv ] : https://github.com/apple/swift-argument-parser/commits?author=owenv
822
887
[ pegasuze ] : https://github.com/apple/swift-argument-parser/commits?author=pegasuze
888
+ [ randomeizer ] : https://github.com/apple/swift-argument-parser/commits?author=randomeizer
823
889
[ rauhul ] : https://github.com/apple/swift-argument-parser/commits?author=rauhul
824
890
[ rjstelling ] : https://github.com/apple/swift-argument-parser/commits?author=rjstelling
825
891
[ Sajjon ] : https://github.com/apple/swift-argument-parser/commits?author=Sajjon
0 commit comments