1# Changelog 2 3## v0.20.8 (February 23, 2024) 4 5- Add `#[darling(with = ...)]` support to `attrs` magic field to allow using custom receiver types for `attrs` [#273](https://github.com/TedDriggs/darling/issues/273) 6 7## v0.20.7 (February 22, 2024) 8 9- Add `#[darling(flatten)]` to allow forwarding unknown fields to another struct [#146](https://github.com/TedDriggs/darling/issues/146) 10- Don't suggest names of skipped fields in derived impls [#268](https://github.com/TedDriggs/darling/issues/268) 11 12## v0.20.6 (February 14, 2024) 13 14- Fix some missing syn invisible group handling in `FromMeta` impls [#263](https://github.com/TedDriggs/darling/pull/263) 15- Fix misleading error message on `Error::unexpected_type` so it no longer implies the type was a literal [#264](https://github.com/TedDriggs/darling/pull/264) 16- Impl `FromMeta` `Vec` of literals, e.g. `LitStr` [#265](https://github.com/TedDriggs/pull/265) 17 18## v0.20.5 (January 30, 2024) 19 20- Add `Flag::span` inherent method, as `Flag` can no longer impl `syn::spanned::Spanned` [#242](https://github.com/TedDriggs/darling/issues/242) 21 22## v0.20.4 (January 29, 2024) 23 24- Accept bare paths in `#[darling(default = ...)]` [#258](https://github.com/TedDriggs/darling/pull/258) 25- Add `FromMeta` impl for `PathBuf` [#259](https://github.com/TedDriggs/darling/pull/259) 26- Improve `FromMeta` implementation for enums [#260](https://github.com/TedDriggs/darling/pull/260) 27 - Properly implement unit arms in `FromMeta::from_list` to provide a consistent API for heterogeneous enums that include a mix of unit, newtype and struct variants 28 - Add `#[darling(word)]` attribute for unit enum variants (See [#63](https://github.com/TedDriggs/darling/issues/63) for details) 29 30## v0.20.3 (July 12, 2023) 31 32- Add `FromMeta` impl for `u128` and `i128` [#243](https://github.com/TedDriggs/darling/pull/243) 33 34## v0.20.2 (May 25, 2023) 35 36- Allow darling users to omit quotation marks for paths and idents [#236](https://github.com/TedDriggs/darling/pull/236) 37- Add new util functions for controlling how quotation marks are handled when reading into `Expr` fields [#235](https://github.com/TedDriggs/darling/pull/235) 38 39## v0.20.1 (May 2, 2023) 40 41- Add `Clone` impl for `NestedMeta` [#230](https://github.com/TedDriggs/darling/pull/230) 42 43## v0.20.0 (April 27, 2023) 44 45- Bump syn to version 2, courtesy of @jonasbb [#227](https://github.com/TedDriggs/darling/issues/227) 46 47### Breaking Changes 48 49- Replace all occurrences of syn::NestedMeta with darling::ast::NestedMeta. 50 51- Replacement for the deprecated AttributeArgs: 52 53```rust 54// Before 55 56parse_macro_input!(args as AttributeArgs); 57 58// After 59 60match NestedMeta::parse_meta_list(args) { 61 Ok(v) => v, 62 Err(e) => { 63 return TokenStream::from(Error::from(e).write_errors()); 64 } 65}; 66``` 67 68- In GenericParamExt, `LifetimeDef` is now `LifetimeParam`. 69- In GenericParamExt, `as_lifetime_def` is renamed to `as_lifetime_param`. 70- Flag and SpannedValue no longer implement `syn::spanned::Spanned`. 71- The MSRV (minimum supported Rust version) is now 1.56, because of syn. 72 73### Deprecation Warnings 74 75In previous versions of `darling`, arbitrary expressions were passed in attributes by wrapping them in quotation marks. 76v0.20.0 preserves this behavior for `syn::Expr`, but as a result a field expecting a `syn::Expr` cannot accept a string literal - it will incorrectly attempt to parse the contents. If this is an issue for you, please add a comment to [#229](https://github.com/TedDriggs/darling/issues/229). 77 78## v0.14.4 (March 9, 2023) 79 80- Add support for child diagnostics when `diagnostics` feature enabled [#224](https://github.com/TedDriggs/darling/issues/224) 81 82## v0.14.3 (February 3, 2023) 83 84- Re-export `syn` from `darling` to avoid requiring that consuming crates have a `syn` dependency. 85- Change `<SpannedValue<T> as FromMeta>` impl to more precisely capture the _value_ span, as opposed to the span of the entire item. 86- Add `darling::util::{AsShape, Shape, ShapeSet}` to improve "shape" validation for structs and variants. [#222](https://github.com/TedDriggs/issues/222) 87 88## v0.14.2 (October 26, 2022) 89 90- Derived impls of `FromMeta` will now error on literals, rather than silently ignoring them. [#193](https://github.com/TedDriggs/darling/pull/193) 91- Don't include property paths in compile errors when spans are available. [#203](https://github.com/TedDriggs/darling/pull/203) 92 93## v0.14.1 (April 28, 2022) 94 95- Fix a bug where using a trait that accepts `#[darling(attributes(...))]` without specifying any attributes would emit code that did not compile. [#183](https://github.com/TedDriggs/darling/issues/183) 96- Impl `Clone` for `darling::Error` [#184](https://github.com/TedDriggs/darling/pull/184) 97- Impl `From<darling::Error> for syn::Error` [#184](https://github.com/TedDriggs/darling/pull/184) 98- Add `Error::span` and `Error::explicit_span` methods [#184](https://github.com/TedDriggs/darling/pull/184) 99 100## v0.14.0 (April 13, 2022) 101 102- **BREAKING CHANGE:** Remove many trait impls from `util::Flag`. 103 This type had a number of deref and operator impls that made it usable as sort-of-a-boolean. 104 Real-world usage showed this type is more useful if it's able to carry a span for good errors, 105 and that most of those impls were unnecessary. [#179](https://github.com/TedDriggs/darling/pull/179) 106- Remove need for `#[darling(default)]` on `Option<T>` and `Flag` fields [#161](https://github.com/TedDriggs/darling/issues/161) 107- Improve validation of enum shapes [#178](https://github.com/TedDriggs/darling/pull/178) 108- Bump `proc-macro2` dependency to 1.0.37 [#180](https://github.com/TedDriggs/darling/pull/180) 109- Bump `quote` dependency to 1.0.18 [#180](https://github.com/TedDriggs/darling/pull/180) 110- Bump `syn` dependency to 1.0.91 [#180](https://github.com/TedDriggs/darling/pull/180) 111 112## v0.13.4 (April 6, 2022) 113 114- Impl `FromMeta` for `syn::Visibility` [#173](https://github.com/TedDriggs/darling/pull/173) 115 116## v0.13.3 (April 5, 2022) 117 118- Add `error::Accumulator` for dealing with multiple errors [#164](https://github.com/TedDriggs/darling/pull/164) 119- Impl `FromMeta` for `syn::Type` and its variants [#172](https://github.com/TedDriggs/darling/pulls/172) 120 121## v0.13.2 (March 30, 2022) 122 123- Impl `FromMeta` for `syn::ExprPath` [#169](https://github.com/TedDriggs/darling/issues/169) 124 125## v0.13.1 (December 7, 2021) 126 127- Add `FromAttributes` trait and macro [#151](https://github.com/TedDriggs/darling/issues/151) 128 129## v0.13.0 (May 20, 2021) 130 131- Update darling to 2018 edition [#129](https://github.com/TedDriggs/darling/pull/129) 132- Error on duplicate fields in `#[darling(...)]` attributes [#130](https://github.com/TedDriggs/darling/pull/130) 133- Impl `Copy` for `SpannedValue<T: Copy>` 134- Add `SpannedValue::map_ref` 135 136## v0.13.0-beta (April 20, 2021) 137 138- Update darling to 2018 edition [#129](https://github.com/TedDriggs/darling/pull/129) 139- Error on duplicate fields in `#[darling(...)]` attributes [#130](https://github.com/TedDriggs/darling/pull/130) 140 141## v0.12.4 (April 20, 2021) 142 143- Add `and_then` to derive macros for `darling` 144 145## v0.12.3 (April 8, 2021) 146 147- Fix `FromMeta` impl for `char` not to panic [#126](https://github.com/TedDriggs/darling/pull/126) 148 149## v0.12.2 (February 23, 2021) 150 151- Impl `FromMeta` for `HashMap<Ident, V>` and `HashMap<Path, V>` 152 153## v0.12.1 (February 22, 2021) 154 155- Impl `FromMeta` for `syn::ExprArray` [#122](https://github.com/TedDriggs/darling/pull/122) 156- Remove use of `unreachable` from `darling::ast::Data` [#123](https://github.com/TedDriggs/darling/pull/123) 157- Add `darling::ast::Data::try_empty_from` to avoid panics when trying to read a union body [#123](https://github.com/TedDriggs/darling/pull/123) 158 159## v0.12.0 (January 5, 2021) 160 161- POSSIBLY BREAKING: Derived impls of `FromDeriveInput`, `FromField`, `FromVariant`, and `FromTypeParam` will now error when encountering an attribute `darling` has been asked to parse that isn't a supported shape. 162 Any crates using `darling` that relied on those attributes being silently ignored could see new errors reported in their dependent crates. [#113](https://github.com/TedDriggs/darling/pull/113) 163- Impl `syn::spanned::Spanned` for `darling::util::SpannedValue` [#113](https://github.com/TedDriggs/darling/pull/113) 164- Add `darling::util::parse_attribute_to_meta_list` to provide useful errors during attribute parsing [#113](https://github.com/TedDriggs/darling/pull/113) 165- Add `impl From<syn::Error> for Error` to losslessly propagate `syn` errors [#116](https://github.com/TedDriggs/darling/pull/116) 166 167## v0.11.0 (December 14, 2020) 168 169- Bump minor version due to unexpected breaking change [#107](https://github.com/TedDriggs/darling/issues/107) 170 171## v0.10.3 (December 10, 2020) 172 173- Add `discriminant` magic field when deriving `FromVariant` [#105](https://github.com/TedDriggs/darling/pull/105) 174 175## v0.10.2 (October 30, 2019) 176 177- Bump syn dependency to 1.0.1 [#83](https://github.com/TedDriggs/darling/pull/83) 178 179## v0.10.1 (September 25, 2019) 180 181- Fix test compilation errors [#81](https://github.com/TedDriggs/darling/pull/81) 182 183## v0.10.0 (August 15, 2019) 184 185- Bump syn and quote to 1.0 [#79](https://github.com/TedDriggs/darling/pull/79) 186- Increase rust version to 1.31 187 188## v0.9.0 (March 20, 2019) 189 190- Enable "did you mean" suggestions by default 191- Make `darling_core::{codegen, options}` private [#58](https://github.com/TedDriggs/darling/issues/58) 192- Fix `Override::as_mut`: [#66](https://github.com/TedDriggs/darling/issues/66) 193 194## v0.8.6 (March 18, 2019) 195 196- Added "did you mean" suggestions for unknown fields behind the `suggestions` flag [#60](https://github.com/TedDriggs/issues/60) 197- Added `Error::unknown_field_with_alts` to support the suggestion use-case. 198- Added `ast::Fields::len` and `ast::Fields::is_empty` methods. 199 200## v0.8.5 (February 4, 2019) 201 202- Accept unquoted positive numeric literals [#52](https://github.com/TedDriggs/issues/52) 203- Add `FromMeta` to the `syn::Lit` enum and its variants 204- Improve error message for unexpected literal formats to not say "other" 205 206## v0.8.4 (February 4, 2019) 207 208- Use `syn::Error` to provide precise errors before `proc_macro::Diagnostic` is available 209- Add `diagnostics` feature flag to toggle between stable and unstable error backends 210- Attach error information in more contexts 211- Add `allow_unknown_fields` to support parsing the same attribute multiple times for different macros [#51](https://github.com/darling/issues/51) 212- Proc-macro authors will now see better errors in `darling` attributes 213 214## v0.8.3 (January 21, 2019) 215 216- Attach spans to errors in generated trait impls [#37](https://github.com/darling/issues/37) 217- Attach spans to errors for types with provided bespoke implementations 218- Deprecate `set_span` from 0.8.2, as spans should never be broadened after being initially set 219 220## v0.8.2 (January 17, 2019) 221 222- Add spans to errors to make quality warnings and errors easy in darling. This is blocked on diagnostics stabilizing. 223- Add `darling::util::SpannedValue` so proc-macro authors can remember position information alongside parsed values. 224 225## v0.8.0 226 227- Update dependency on `syn` to 0.15 [#44](https://github.com/darling/pull/44). Thanks to @hcpl 228 229## v0.7.0 (July 24, 2018) 230 231- Update dependencies on `syn` and `proc-macro2` 232- Add `util::IdentString`, which acts as an Ident or its string equivalent 233 234## v0.6.3 (May 22, 2018) 235 236- Add support for `Uses*` traits in where predicates 237 238## v0.6.2 (May 22, 2018) 239 240- Add `usage` module for tracking type param and lifetime usage in generic declarations 241 - Add `UsesTypeParams` and `CollectsTypeParams` traits [#37](https://github.com/darling/issues/37) 242 - Add `UsesLifetimes` and `CollectLifetimes` traits [#41](https://github.com/darling/pull/41) 243- Don't add `FromMeta` bounds to type parameters only used by skipped fields [#40](https://github.com/darling/pull/40) 244 245## v0.6.1 (May 17, 2018) 246 247- Fix an issue where the `syn` update broke shape validation [#36](https://github.com/TedDriggs/darling/issues/36) 248 249## v0.6.0 (May 15, 2018) 250 251### Breaking Changes 252 253- Renamed `FromMetaItem` to `FromMeta`, and renamed `from_meta_item` method to `from_meta` 254- Added dedicated `derive(FromMetaItem)` which panics and redirects users to `FromMeta` 255 256## v0.5.0 (May 10, 2018) 257 258- Add `ast::Generics` and `ast::GenericParam` to work with generics in a manner similar to `ast::Data` 259- Add `ast::GenericParamExt` to support alternate representations of generic parameters 260- Add `util::WithOriginal` to get a parsed representation and syn's own struct for a syntax block 261- Add `FromGenerics` and `FromGenericParam` traits (without derive support) 262- Change generated code for `generics` magic field to invoke `FromGenerics` trait during parsing 263- Add `FromTypeParam` trait [#30](https://github.com/TedDriggs/darling/pull/30). Thanks to @upsuper 264 265## v0.4.0 (April 5, 2018) 266 267- Update dependencies on `proc-macro`, `quote`, and `syn` [#26](https://github.com/TedDriggs/darling/pull/26). Thanks to @hcpl 268 269## v0.3.3 (April 2, 2018) 270 271**YANKED** 272 273## v0.3.2 (March 13, 2018) 274 275- Derive `Default` on `darling::Ignored` (fixes [#25](https://github.com/TedDriggs/darling/issues/25)). 276 277## v0.3.1 (March 7, 2018) 278 279- Support proc-macro2/nightly [#24](https://github.com/TedDriggs/darling/pull/24). Thanks to @kdy1 280 281## v0.3.0 (January 26, 2018) 282 283### Breaking Changes 284 285- Update `syn` to 0.12 [#20](https://github.com/TedDriggs/darling/pull/20). Thanks to @Eijebong 286- Update `quote` to 0.4 [#20](https://github.com/TedDriggs/darling/pull/20). Thanks to @Eijebong 287- Rename magic field `body` in derived `FromDeriveInput` structs to `data` to stay in sync with `syn` 288- Rename magic field `data` in derived `FromVariant` structs to `fields` to stay in sync with `syn` 289 290## v0.2.2 (December 5, 2017) 291 292- Update `lazy_static` to 1.0 [#15](https://github.com/TedDriggs/darling/pull/16). Thanks to @Eijebong 293 294## v0.2.1 (November 28, 2017) 295 296- Add `impl FromMetaItem` for integer types [#15](https://github.com/TedDriggs/darling/pull/15) 297 298## v0.2.0 (June 18, 2017) 299 300- Added support for returning multiple errors from parsing [#5](https://github.com/TedDriggs/darling/pull/5) 301- Derived impls no longer return on first error [#5](https://github.com/TedDriggs/darling/pull/5) 302- Removed default types for `V` and `F` from `ast::Body` 303- Enum variants are automatically converted to snake_case [#12](https://github.com/TedDriggs/darling/pull/12) 304