diff --git a/CHANGELOG.md b/CHANGELOG.md index 5c5b4e4c9..e73191a79 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -8,6 +8,27 @@ Add new items at the end of the relevant section under **Unreleased**. --- +## [1.8.0] - 2026-05-25 + +### Additions + +- `NameSpecification` and its elements now conform to `ExpressibleByStringLiteral`, allowing simplified option and flag name declarations. For example, `[.customLong("hex-output"), .customShort("x")]` can now be written as `"--hex-output -x"`. ([#745]) +- New `@Option` initializers accept a `defaultAsFlag:` parameter, creating options that work both as a bare flag (`--format`) and as an option with a value (`--format json`). ([#830]) +- Custom completion closures for `AsyncParsableCommand` types now support `async`/`await`. ([#855]) + +### Changes + +- The minimum Swift version for `swift-argument-parser` has been updated to Swift 6. Users of older Swift versions can continue using version 1.7.1 of the library. ([#882]) + +### Fixes + +- Command aliases now appear in generated man-pages for both single-page and multi-page output. ([#891]) +- Declaring `@Flag var x: Bool?` without an `inversion:` parameter now produces a useful diagnostic message. ([#892]) + +The 1.8.0 release includes contributions from [bkhouri], [natecook1000], [nkimon00], [rauhul], and [rgoldberg]. Thank you! + +--- + ## [1.7.1] - 2026-03-20 ### Changes @@ -1011,7 +1032,8 @@ This changelog's format is based on [Keep a Changelog](https://keepachangelog.co -[Unreleased]: https://github.com/apple/swift-argument-parser/compare/1.7.1...HEAD +[Unreleased]: https://github.com/apple/swift-argument-parser/compare/1.8.0...HEAD +[1.8.0]: https://github.com/apple/swift-argument-parser/compare/1.7.1...1.8.0 [1.7.1]: https://github.com/apple/swift-argument-parser/compare/1.7.0...1.7.1 [1.7.0]: https://github.com/apple/swift-argument-parser/compare/1.6.2...1.7.0 [1.6.2]: https://github.com/apple/swift-argument-parser/compare/1.6.1...1.6.2 @@ -1192,6 +1214,7 @@ This changelog's format is based on [Keep a Changelog](https://keepachangelog.co [#741]: https://github.com/apple/swift-argument-parser/pull/741 [#743]: https://github.com/apple/swift-argument-parser/pull/743 [#744]: https://github.com/apple/swift-argument-parser/pull/744 +[#745]: https://github.com/apple/swift-argument-parser/pull/745 [#746]: https://github.com/apple/swift-argument-parser/pull/746 [#747]: https://github.com/apple/swift-argument-parser/pull/747 [#754]: https://github.com/apple/swift-argument-parser/pull/754 @@ -1219,12 +1242,14 @@ This changelog's format is based on [Keep a Changelog](https://keepachangelog.co [#813]: https://github.com/apple/swift-argument-parser/pull/813 [#821]: https://github.com/apple/swift-argument-parser/pull/821 [#825]: https://github.com/apple/swift-argument-parser/pull/825 +[#830]: https://github.com/apple/swift-argument-parser/pull/830 [#838]: https://github.com/apple/swift-argument-parser/pull/838 [#839]: https://github.com/apple/swift-argument-parser/pull/839 [#841]: https://github.com/apple/swift-argument-parser/pull/841 [#843]: https://github.com/apple/swift-argument-parser/pull/843 [#844]: https://github.com/apple/swift-argument-parser/pull/844 [#853]: https://github.com/apple/swift-argument-parser/pull/853 +[#855]: https://github.com/apple/swift-argument-parser/pull/855 [#856]: https://github.com/apple/swift-argument-parser/pull/856 [#857]: https://github.com/apple/swift-argument-parser/pull/857 [#859]: https://github.com/apple/swift-argument-parser/pull/859 @@ -1236,6 +1261,10 @@ This changelog's format is based on [Keep a Changelog](https://keepachangelog.co [#876]: https://github.com/apple/swift-argument-parser/pull/876 [#877]: https://github.com/apple/swift-argument-parser/pull/877 [#879]: https://github.com/apple/swift-argument-parser/pull/879 +[#882]: https://github.com/apple/swift-argument-parser/pull/882 +[#883]: https://github.com/apple/swift-argument-parser/pull/883 +[#891]: https://github.com/apple/swift-argument-parser/pull/891 +[#892]: https://github.com/apple/swift-argument-parser/pull/892 @@ -1320,6 +1349,7 @@ This changelog's format is based on [Keep a Changelog](https://keepachangelog.co [mtj0928]: https://github.com/apple/swift-argument-parser/commits?author=mtj0928 [natecook1000]: https://github.com/apple/swift-argument-parser/commits?author=natecook1000 [NicFontana]: https://github.com/apple/swift-argument-parser/commits?author=NicFontana +[nkimon00]: https://github.com/apple/swift-argument-parser/commits?author=nkimon00 [owenv]: https://github.com/apple/swift-argument-parser/commits?author=owenv [pegasuze]: https://github.com/apple/swift-argument-parser/commits?author=pegasuze [randomeizer]: https://github.com/apple/swift-argument-parser/commits?author=randomeizer