18 releases

0.0.18 Nov 8, 2024
0.0.17 Jun 14, 2024
0.0.16 Jan 16, 2024
0.0.15 Oct 17, 2023
0.0.3 Dec 14, 2021

#107 in Rust patterns

Download history 36527/week @ 2024-11-23 46378/week @ 2024-11-30 148484/week @ 2024-12-07 157182/week @ 2024-12-14 37714/week @ 2024-12-21 78218/week @ 2024-12-28 168193/week @ 2025-01-04 192410/week @ 2025-01-11 144422/week @ 2025-01-18 170984/week @ 2025-01-25 175064/week @ 2025-02-01 182435/week @ 2025-02-08 177333/week @ 2025-02-15 225091/week @ 2025-02-22 226015/week @ 2025-03-01 196439/week @ 2025-03-08

857,661 downloads per month
Used in 63 crates (10 directly)

MIT license

190KB
3.5K SLoC

Virtue, a sinless derive macro helper

Goals

  • Zero dependencies, so fast compile times
  • No other dependencies needed
  • Declarative code generation
  • As much typesystem checking as possible
  • Build for modern rust: 1.57 and up
  • Build with popular crates in mind:
  • Will always respect semver. Minor releases will never have:
    • Breaking API changes
    • MSRV changes

Example

use virtue::prelude::*;

#[proc_macro_derive(YourDerive, attributes(some, attributes, go, here))]
pub fn derive_your_derive(input: TokenStream) -> TokenStream {
    derive_your_derive_inner(input)
        .unwrap_or_else(|error| error.into_token_stream())
}

fn derive_your_derive_inner(input: TokenStream) -> Result<TokenStream> {
    // Parse the struct or enum you want to implement a derive for
    let parse = Parse::new(input)?;
    // Get a reference to the generator
    let (mut generator, body) = parse.into_generator();
    match body {
        Body::Struct(body) => {
            // Implement your struct body here
            // See `Generator` for more information
            generator.impl_for("YourTrait")?
                    .generate_fn("your_fn")
                    .with_self_arg(FnSelfArg::RefSelf)
                    .body(|fn_body| {
                        fn_body.push_parsed("println!(\"Hello world\");");
                    })?;
        },
        Body::Enum(body) => {
            // Implement your enum body here
            // See `Generator` for more information
            generator.impl_for("YourTrait")?
                    .generate_fn("your_fn")
                    .with_self_arg(FnSelfArg::RefSelf)
                    .body(|fn_body| {
                        fn_body.push_parsed("println!(\"Hello world\");");
                    })?;
        },
    }
    generator.finish()
}

Will generate

impl YourTrait for <Struct or Enum> {
    fn your_fn(&self) { // .generate_fn("your_fn").with_self_arg(FnSelfArg::RefSelf)
        println!("Hello world"); // fn_body.push_parsed(...)
    }
}

Dependencies