1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115
//! ##### An attribute macro to make trait methods callable without the trait in scope. //! //! # Example //! //! ```rust //! mod types { //! use inherent::inherent; //! //! trait Trait { //! fn f(self); //! } //! //! pub struct Struct; //! //! #[inherent(pub)] //! impl Trait for Struct { //! fn f(self) {} //! } //! } //! //! fn main() { //! // types::Trait is not in scope, but method can be called. //! types::Struct.f(); //! } //! ``` //! //! Without the `inherent` macro on the trait impl, this would have failed with the //! following error: //! //! ```console //! error[E0599]: no method named `f` found for type `types::Struct` in the current scope //! --> src/main.rs:18:19 //! | //! 8 | pub struct Struct; //! | ------------------ method `f` not found for this //! ... //! 18 | types::Struct.f(); //! | ^ //! | //! = help: items from traits can only be used if the trait is implemented and in scope //! = note: the following trait defines an item `f`, perhaps you need to implement it: //! candidate #1: `types::Trait` //! ``` //! //! The `inherent` macro expands to inherent methods on the `Self` type of the trait //! impl that forward to the trait methods. In the case above, the generated code //! would be: //! //! ```rust //! # trait Trait { //! # fn f(self); //! # } //! # //! # pub struct Struct; //! # //! # impl Trait for Struct { //! # fn f(self) {} //! # } //! # //! impl Struct { //! pub fn f(self) { //! <Self as Trait>::f(self) //! } //! } //! ``` //! //! # Visibility //! //! Ordinary trait methods have the same visibility as the trait or the `Self` type, //! whichever's is smaller. Neither of these visibilities is knowable to the //! `inherent` macro, so we simply emit all inherent methods as private by default. //! A different visibility may be specified explicitly in the `inherent` macro //! invocation. //! //! ```rust //! # use inherent::inherent; //! # //! # trait Trait {} //! # //! # struct A; //! #[inherent] // private inherent methods are the default //! # impl Trait for A {} //! //! # struct B; //! #[inherent(pub)] // all methods pub //! # impl Trait for B {} //! //! # struct C; //! #[inherent(crate)] // all methods pub(crate) //! # impl Trait for C {} //! //! # struct D; //! #[inherent(in path::to)] // all methods pub(in path::to) //! # impl Trait for D {} //! ``` extern crate proc_macro; mod default_methods; mod expand; mod parse; mod visibility; use proc_macro::TokenStream; use syn::parse_macro_input; use crate::parse::TraitImpl; use crate::visibility::Visibility; #[proc_macro_attribute] pub fn inherent(args: TokenStream, input: TokenStream) -> TokenStream { let vis = parse_macro_input!(args as Visibility); let input = parse_macro_input!(input as TraitImpl); expand::inherent(vis, input).into() }