Proc Macro Warning

Emit warnings from inside proc macros.

Rust does not have native functions to produce warnings from inside proc macros. This crate provides "deprecated" warnings for your proc macro use-cases.

Example

Building a warning is easy with the builder pattern.

```rust use procmacrowarning::Warning;

let warning = Warning::newdeprecated("mymacro") .old("mymacro()") .new("mymacro::new()") .helplink("https:://example.com") .span(procmacro2::Span::call_site()) .build();

// Use the warning in a proc macro let tokens = quote::quote!(#warning); ```

This works in derive-macros, but you must set a span; otherwise it will not show up in the compile output.

The difference to a #[deprecated] attribute is that it emits the warning either way. For example when creating a custom Deprecated derive macro, it will warn without the struct being constructed.

```rust

[derive(derive::Deprecated)]

struct Test {}

fn main() { // Warning triggers although we never used Test.
// Otherwise use a normal #[deprecated]. } ```

Un-opinionated Formatting

The normal aforementioned way of creating a warning will impose specific unified grammar and formatting rules.
You can opt out of this and use your own instead by using FormattedWarning::new_deprecated:

```rust use procmacrowarning::FormattedWarning;

let warning = FormattedWarning::newdeprecated( "mymacro", "looooooooooooooooooooooooooooooong line that will not be brokeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeen ;)", procmacro2::Span::callsite(), );

// Use the warning in a proc macro let tokens = quote::quote!(#warning); ```

The output of a similar example is in derive_raw.stderr.

Used In

Substrate uses it to emit warnings for its eDSL (FRAME) on deprecated behaviour. The integration was done in #13798 and shows how to use these warnings in macro expansion.

The warnings are uniformly formatted and have consistent grammar: ``pre warning: use of deprecated constantpallet::warnings::ImplicitCallIndex0::w: It is deprecated to use implicit call indices. Please instead ensure that all calls have thepallet::call_indexattribute or that thedev-mode` of the pallet is enabled.

             For more info see:
                 <https://github.com/paritytech/substrate/pull/12891>
                 <https://github.com/paritytech/substrate/pull/11381>
--> frame/nomination-pools/src/lib.rs:2621:10
 |

2621 | pub fn claimcommission(origin: OriginFor, poolid: PoolId) -> DispatchResult { | ^^^^^^^^^^^^^^^^ | ```

A different one: ``pre warning: use of deprecated constantpallet::warnings::ConstantWeight0::w: It is deprecated to use hard-coded constant as call weight. Please instead benchmark all calls or put the pallet intodev` mode.

             For more info see:
                 <https://github.com/paritytech/substrate/pull/13798>
--> frame/nomination-pools/src/lib.rs:2620:20
 |

2620 | #[pallet::weight(0)] |
```

License

Licensed under either of at your own choice:

• GNU GENERAL PUBLIC LICENSE, Version 3 (LICENSE-GPL3 or gnu.org)
• Apache License, Version 2.0 (LICENSE-APACHE2 or apache.org).

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.