@@ -8,12 +8,56 @@ This project follows semantic versioning. While still in major version `0`,
8
8
source-stability is only guaranteed within minor versions (e.g. between
9
9
` 0.0.3 ` and ` 0.0.4 ` ). If you want to guard against potentially source-breaking
10
10
package updates, you can specify your package dependency using
11
- ` .upToNextMinor(from: "0.1 .0") ` as the requirement.
11
+ ` .upToNextMinor(from: "0.2 .0") ` as the requirement.
12
12
13
13
## [ Unreleased]
14
14
15
15
* No changes yet.*
16
16
17
+ ## [ 0.2.0] - 2020-06-23
18
+
19
+ ### Additions
20
+
21
+ - You can now specify default values for array properties of parsable types.
22
+ The default values are overridden if the user provides at least one value
23
+ as part of the command-line arguments.
24
+
25
+ ### Changes
26
+
27
+ - This release of ` swift-argument-parser ` requires Swift 5.2.
28
+ - Default values for all properties are now written using default initialization
29
+ syntax, including some values that were previously implicit, such as empty
30
+ arrays and ` false ` for Boolean flags.
31
+
32
+ * Migration:* Specify default values using typical Swift default value syntax
33
+ to remove the deprecation warnings:
34
+
35
+ ``` swift
36
+ // old
37
+ @Flag () var verbose: Bool
38
+ // new
39
+ @Flag () var verbose = false
40
+ ```
41
+
42
+ ** _ Important:_ ** There is a semantic change for flags with inversions that do
43
+ not have a default value. In previous releases, these flags had a default
44
+ value of ` false ` ; starting in 0.2.0, these flags will have no default, and
45
+ will therefore be required by the user. Specify a default value of ` false ` to
46
+ retain the old behavior.
47
+
48
+ ### Fixes
49
+
50
+ - Options with multiple names now consistently show the first-declared name
51
+ in usage and help screens.
52
+ - Default subcommands are indicated in the help screen.
53
+ - User errors with options are now shown before positional argument errors,
54
+ eliminating some false negative reports.
55
+ - CMake compatibility fixes.
56
+
57
+ The 0.2.0 release includes contributions from [ artemnovichkov] , [ compnerd] ,
58
+ [ ibrahimoktay] , [ john-mueller] , [ MPLew-is] , [ natecook1000] , and [ owenv] .
59
+ Thank you!
60
+
17
61
## [ 0.1.0] - 2020-06-03
18
62
19
63
### Additions
@@ -220,7 +264,8 @@ This changelog's format is based on [Keep a Changelog](https://keepachangelog.co
220
264
221
265
<!-- Link references for releases -->
222
266
223
- [ Unreleased ] : https://github.com/apple/swift-argument-parser/compare/0.1.0...HEAD
267
+ [ Unreleased ] : https://github.com/apple/swift-argument-parser/compare/0.2.0...HEAD
268
+ [ 0.2.0 ] : https://github.com/apple/swift-argument-parser/compare/0.1.0...0.2.0
224
269
[ 0.1.0 ] : https://github.com/apple/swift-argument-parser/compare/0.0.6...0.1.0
225
270
[ 0.0.6 ] : https://github.com/apple/swift-argument-parser/compare/0.0.5...0.0.6
226
271
[ 0.0.5 ] : https://github.com/apple/swift-argument-parser/compare/0.0.4...0.0.5
@@ -237,6 +282,7 @@ This changelog's format is based on [Keep a Changelog](https://keepachangelog.co
237
282
238
283
[ aleksey-mashanov ] : https://github.com/apple/swift-argument-parser/commits?author=aleksey-mashanov
239
284
[ AliSoftware ] : https://github.com/apple/swift-argument-parser/commits?author=AliSoftware
285
+ [ artemnovichkov ] : https://github.com/apple/swift-argument-parser/commits?author=artemnovichkov
240
286
[ BradLarson ] : https://github.com/apple/swift-argument-parser/commits?author=BradLarson
241
287
[ buttaface ] : https://github.com/apple/swift-argument-parser/commits?author=buttaface
242
288
[ compnerd ] : https://github.com/apple/swift-argument-parser/commits?author=compnerd
@@ -254,6 +300,7 @@ This changelog's format is based on [Keep a Changelog](https://keepachangelog.co
254
300
[ klaaspieter ] : https://github.com/apple/swift-argument-parser/commits?author=klaaspieter
255
301
[ Lantua ] : https://github.com/apple/swift-argument-parser/commits?author=Lantua
256
302
[ miguelangel-dev ] : https://github.com/apple/swift-argument-parser/commits?author=miguelangel-dev
303
+ [ MPLew-is ] : https://github.com/apple/swift-argument-parser/commits?author=MPLew-is
257
304
[ natecook1000 ] : https://github.com/apple/swift-argument-parser/commits?author=natecook1000
258
305
[ owenv ] : https://github.com/apple/swift-argument-parser/commits?author=owenv
259
306
[ rjstelling ] : https://github.com/apple/swift-argument-parser/commits?author=rjstelling
0 commit comments