apple/swift-argument-parser
### [`v1.2.0`](https://togithub.com/apple/swift-argument-parser/blob/HEAD/CHANGELOG.md#120---2022-11-08)
[Compare Source](https://togithub.com/apple/swift-argument-parser/compare/1.1.4...1.2.0)
##### Additions
- You can now provide a title in an `@OptionGroup` declaration. Titled option
groups are listed separately in the help screen under that title as a
heading. (\[[#492](https://togithub.com/apple/swift-argument-parser/issues/492)])
- Two new parsing strategies have been added for `@Argument` array properties:
- `.allUnrecognized` captures all unrecognized inputs after parsing known
flags, options, and arguments.
- `.postTerminator` collects any inputs that follow the `--` terminator.
See the [`ArgumentArrayParsingStrategy` documentation][arrayparse-docs] for
more. (\[[#496](https://togithub.com/apple/swift-argument-parser/issues/496)])
- Default values are now supported for `@Argument` or `@Option` properties with
optional type, allowing you to initialize those properties with `nil`.
Providing a non-`nil` default value results in a warning, since optional
properties with non-`nil` defaults don't need to be declared as optionals.
(\[[#477](https://togithub.com/apple/swift-argument-parser/issues/477)], \[[#480](https://togithub.com/apple/swift-argument-parser/issues/480)])
##### Changes
- The `.unconditionalRemaining` array parsing strategy has been deprecated and
renamed to `.captureForPassthrough`, to better fit its semantic behavior and
intended usage. See the [`ArgumentArrayParsingStrategy`
documentation][arrayparse-docs] for more. (\[[#496](https://togithub.com/apple/swift-argument-parser/issues/496)])
##### Fixes
- Invalid `init(from:)` decoding initializers are now correctly diagnosed by
ArgumentParser's validators. (\[[#487](https://togithub.com/apple/swift-argument-parser/issues/487)])
- Default values are now correctly displayed as flags for `@Flag` properties
with inversions or `EnumerableFlag` types. (\[[#486](https://togithub.com/apple/swift-argument-parser/issues/486)])
- The help display for non-string-backed raw representable types has been
corrected to not show raw Swift values. Instead, the help display uses the
type's customized `defaultValueDescription` and `allValues` implementations.
(\[[#494](https://togithub.com/apple/swift-argument-parser/issues/494)])
- Properties at different levels of a command hierarchy with the same Swift name
but different argument names no longer collide. (\[[#495](https://togithub.com/apple/swift-argument-parser/issues/495)])
- The `generate-manual` plugin name is improved when used from within Xcode.
(\[[#505](https://togithub.com/apple/swift-argument-parser/issues/505)])
- Documentation fixes and improvements.
The 1.2.0 release includes contributions from \[allevato], \[clayellis],
\[compnerd], \[d-ronnqvist], \[natecook1000], \[randomeizer], and \[rauhul].
Thank you!
[arrayparse-docs]: https://apple.github.io/swift-argument-parser/documentation/argumentparser/argumentarrayparsingstrategy
***
Configuration
📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).
🚦 Automerge: Enabled.
♻ Rebasing: Whenever PR is behind base branch, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about this update again.
[ ] If you want to rebase/retry this PR, check this box
This PR has been generated by Mend Renovate. View repository job log here.
This PR contains the following updates:
from: "1.1.4"->from: "1.2.0"Release Notes
apple/swift-argument-parser
### [`v1.2.0`](https://togithub.com/apple/swift-argument-parser/blob/HEAD/CHANGELOG.md#120---2022-11-08) [Compare Source](https://togithub.com/apple/swift-argument-parser/compare/1.1.4...1.2.0) ##### Additions - You can now provide a title in an `@OptionGroup` declaration. Titled option groups are listed separately in the help screen under that title as a heading. (\[[#492](https://togithub.com/apple/swift-argument-parser/issues/492)]) - Two new parsing strategies have been added for `@Argument` array properties: - `.allUnrecognized` captures all unrecognized inputs after parsing known flags, options, and arguments. - `.postTerminator` collects any inputs that follow the `--` terminator. See the [`ArgumentArrayParsingStrategy` documentation][arrayparse-docs] for more. (\[[#496](https://togithub.com/apple/swift-argument-parser/issues/496)]) - Default values are now supported for `@Argument` or `@Option` properties with optional type, allowing you to initialize those properties with `nil`. Providing a non-`nil` default value results in a warning, since optional properties with non-`nil` defaults don't need to be declared as optionals. (\[[#477](https://togithub.com/apple/swift-argument-parser/issues/477)], \[[#480](https://togithub.com/apple/swift-argument-parser/issues/480)]) ##### Changes - The `.unconditionalRemaining` array parsing strategy has been deprecated and renamed to `.captureForPassthrough`, to better fit its semantic behavior and intended usage. See the [`ArgumentArrayParsingStrategy` documentation][arrayparse-docs] for more. (\[[#496](https://togithub.com/apple/swift-argument-parser/issues/496)]) ##### Fixes - Invalid `init(from:)` decoding initializers are now correctly diagnosed by ArgumentParser's validators. (\[[#487](https://togithub.com/apple/swift-argument-parser/issues/487)]) - Default values are now correctly displayed as flags for `@Flag` properties with inversions or `EnumerableFlag` types. (\[[#486](https://togithub.com/apple/swift-argument-parser/issues/486)]) - The help display for non-string-backed raw representable types has been corrected to not show raw Swift values. Instead, the help display uses the type's customized `defaultValueDescription` and `allValues` implementations. (\[[#494](https://togithub.com/apple/swift-argument-parser/issues/494)]) - Properties at different levels of a command hierarchy with the same Swift name but different argument names no longer collide. (\[[#495](https://togithub.com/apple/swift-argument-parser/issues/495)]) - The `generate-manual` plugin name is improved when used from within Xcode. (\[[#505](https://togithub.com/apple/swift-argument-parser/issues/505)]) - Documentation fixes and improvements. The 1.2.0 release includes contributions from \[allevato], \[clayellis], \[compnerd], \[d-ronnqvist], \[natecook1000], \[randomeizer], and \[rauhul]. Thank you! [arrayparse-docs]: https://apple.github.io/swift-argument-parser/documentation/argumentparser/argumentarrayparsingstrategy ***Configuration
📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).
🚦 Automerge: Enabled.
♻ Rebasing: Whenever PR is behind base branch, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about this update again.
This PR has been generated by Mend Renovate. View repository job log here.