@@ -8,12 +8,56 @@ This project follows semantic versioning. While still in major version `0`,
88source-stability is only guaranteed within minor versions (e.g. between
99` 0.0.3 ` and ` 0.0.4 ` ). If you want to guard against potentially source-breaking
1010package 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.
1212
1313## [ Unreleased]
1414
1515* No changes yet.*
1616
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+
1761## [ 0.1.0] - 2020-06-03
1862
1963### Additions
@@ -220,7 +264,8 @@ This changelog's format is based on [Keep a Changelog](https://keepachangelog.co
220264
221265<!-- Link references for releases -->
222266
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
224269[ 0.1.0 ] : https://github.com/apple/swift-argument-parser/compare/0.0.6...0.1.0
225270[ 0.0.6 ] : https://github.com/apple/swift-argument-parser/compare/0.0.5...0.0.6
226271[ 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
237282
238283[ aleksey-mashanov ] : https://github.com/apple/swift-argument-parser/commits?author=aleksey-mashanov
239284[ AliSoftware ] : https://github.com/apple/swift-argument-parser/commits?author=AliSoftware
285+ [ artemnovichkov ] : https://github.com/apple/swift-argument-parser/commits?author=artemnovichkov
240286[ BradLarson ] : https://github.com/apple/swift-argument-parser/commits?author=BradLarson
241287[ buttaface ] : https://github.com/apple/swift-argument-parser/commits?author=buttaface
242288[ 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
254300[ klaaspieter ] : https://github.com/apple/swift-argument-parser/commits?author=klaaspieter
255301[ Lantua ] : https://github.com/apple/swift-argument-parser/commits?author=Lantua
256302[ 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
257304[ natecook1000 ] : https://github.com/apple/swift-argument-parser/commits?author=natecook1000
258305[ owenv ] : https://github.com/apple/swift-argument-parser/commits?author=owenv
259306[ rjstelling ] : https://github.com/apple/swift-argument-parser/commits?author=rjstelling
0 commit comments