@@ -10,12 +10,37 @@ Add new items at the end of the relevant section under **Unreleased**.
10
10
11
11
---
12
12
13
+ ## [ 1.4.0] - 2024-05-21
14
+
15
+ ### Additions
16
+
17
+ - Adds support for subcommand aliases via a new ` CommandConfiguration.aliases `
18
+ parameter. Aliases are shown in help text and used during command parsing. For
19
+ example, a subcommand like "average" from the example "math" tool can be
20
+ defined with the aliases ` ["avg"] ` . The resulting subcommand can now be
21
+ invoked with either of ` math stats average ` and ``math stats avg`. See the
22
+ updated documentation and example for additional details. ([ #627 ] )
23
+ - Adds a new API ` usageString ` to ` ParsableArguments ` and ` ParsableCommand ` for
24
+ retrieving their usage text, allowing for more flexible construction of error
25
+ screens. ([ #634 ] )
26
+ - Adds support for passing custom arguments to ` AsyncParsableCommand.main() `
27
+ with a new ` static func main(_ arguments: [String]?) async ` method. ([ #568 ] )
28
+
29
+ ### Fixes
30
+
31
+ - Removes default parameter values from deprecated CommandConfiguration
32
+ initializers to prevent them from being selected as overloads. Some niche
33
+ invalid deprecation warnings should no longer occur. ([ #636 ] )
34
+
35
+ The 1.4.0 release includes contributions from [ Austinpayne] , [ dcantah] ,
36
+ [ KS1019] , [ natecook1000] , [ rauhul] , and [ revolter] . Thank you!
37
+
13
38
## [ 1.3.1] - 2024-03-16
14
39
15
40
### Changes
16
41
17
42
- The ` CommandConfiguration ` type is now designated as ` Sendable ` . ([ #615 ] )
18
- - The library uses ` internal ` imports instead of `` @_ implementationOnly` annotations
43
+ - The library uses ` internal ` imports instead of ` @_implementationOnly ` annotations
19
44
in Swift versions where permitted. ([ #616 ] )
20
45
21
46
### Fixes
@@ -867,7 +892,8 @@ This changelog's format is based on [Keep a Changelog](https://keepachangelog.co
867
892
868
893
<!-- Link references for releases -->
869
894
870
- [ Unreleased ] : https://github.com/apple/swift-argument-parser/compare/1.3.1...HEAD
895
+ [ Unreleased ] : https://github.com/apple/swift-argument-parser/compare/1.4.0...HEAD
896
+ [ 1.4.0 ] : https://github.com/apple/swift-argument-parser/compare/1.3.1...1.4.0
871
897
[ 1.3.1 ] : https://github.com/apple/swift-argument-parser/compare/1.3.0...1.3.1
872
898
[ 1.3.0 ] : https://github.com/apple/swift-argument-parser/compare/1.2.3...1.3.0
873
899
[ 1.2.3 ] : https://github.com/apple/swift-argument-parser/compare/1.2.2...1.2.3
@@ -964,6 +990,7 @@ This changelog's format is based on [Keep a Changelog](https://keepachangelog.co
964
990
[ #552 ] : https://github.com/apple/swift-argument-parser/pull/552
965
991
[ #554 ] : https://github.com/apple/swift-argument-parser/pull/554
966
992
[ #565 ] : https://github.com/apple/swift-argument-parser/pull/565
993
+ [ #568 ] : https://github.com/apple/swift-argument-parser/pull/568
967
994
[ #572 ] : https://github.com/apple/swift-argument-parser/pull/572
968
995
[ #573 ] : https://github.com/apple/swift-argument-parser/pull/573
969
996
[ #574 ] : https://github.com/apple/swift-argument-parser/pull/574
@@ -986,6 +1013,9 @@ This changelog's format is based on [Keep a Changelog](https://keepachangelog.co
986
1013
[ #617 ] : https://github.com/apple/swift-argument-parser/pull/617
987
1014
[ #619 ] : https://github.com/apple/swift-argument-parser/pull/619
988
1015
[ #621 ] : https://github.com/apple/swift-argument-parser/pull/621
1016
+ [ #627 ] : https://github.com/apple/swift-argument-parser/pull/627
1017
+ [ #634 ] : https://github.com/apple/swift-argument-parser/pull/634
1018
+ [ #636 ] : https://github.com/apple/swift-argument-parser/pull/636
989
1019
990
1020
<!-- Link references for contributors -->
991
1021
@@ -997,6 +1027,7 @@ This changelog's format is based on [Keep a Changelog](https://keepachangelog.co
997
1027
[ allevato ] : https://github.com/apple/swift-argument-parser/commits?author=allevato
998
1028
[ artemnovichkov ] : https://github.com/apple/swift-argument-parser/commits?author=artemnovichkov
999
1029
[ atierian ] : https://github.com/apple/swift-argument-parser/commits?author=atierian
1030
+ [ Austinpayne ] : https://github.com/apple/swift-argument-parser/commits?author=Austinpayne
1000
1031
[ BradLarson ] : https://github.com/apple/swift-argument-parser/commits?author=BradLarson
1001
1032
[ buttaface ] : https://github.com/apple/swift-argument-parser/commits?author=buttaface
1002
1033
[ Chamepp ] : https://github.com/apple/swift-argument-parser/commits?author=Chamepp
@@ -1008,6 +1039,7 @@ This changelog's format is based on [Keep a Changelog](https://keepachangelog.co
1008
1039
[ CypherPoet ] : https://github.com/apple/swift-argument-parser/commits?author=CypherPoet
1009
1040
[ d-ronnqvist ] : https://github.com/apple/swift-argument-parser/commits?author=d-ronnqvist
1010
1041
[ damuellen ] : https://github.com/apple/swift-argument-parser/commits?author=damuellen
1042
+ [ dcantah ] : https://github.com/apple/swift-argument-parser/commits?author=dcantah
1011
1043
[ dduan ] : https://github.com/apple/swift-argument-parser/commits?author=dduan
1012
1044
[ dirtyhabits97 ] : https://github.com/apple/swift-argument-parser/commits?author=dirtyhabits97
1013
1045
[ drewmccormack ] : https://github.com/apple/swift-argument-parser/commits?author=drewmccormack
@@ -1055,6 +1087,7 @@ This changelog's format is based on [Keep a Changelog](https://keepachangelog.co
1055
1087
[ pegasuze ] : https://github.com/apple/swift-argument-parser/commits?author=pegasuze
1056
1088
[ randomeizer ] : https://github.com/apple/swift-argument-parser/commits?author=randomeizer
1057
1089
[ rauhul ] : https://github.com/apple/swift-argument-parser/commits?author=rauhul
1090
+ [ revolter ] : https://github.com/apple/swift-argument-parser/commits?author=revolter
1058
1091
[ rickrizzo ] : https://github.com/apple/swift-argument-parser/commits?author=rickrizzo
1059
1092
[ rjstelling ] : https://github.com/apple/swift-argument-parser/commits?author=rjstelling
1060
1093
[ robertmryan ] : https://github.com/apple/swift-argument-parser/commits?author=robertmryan
0 commit comments