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 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151
// Copyright (c) 2020 Brendan Molloy <brendan@bbqsrc.net>, // Ilya Solovyiov <ilya.solovyiov@gmail.com>, // Kai Ren <tyranron@gmail.com> // // Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or // http://www.apache.org/licenses/LICENSE-2.0> or the MIT license // <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your // option. This file may not be copied, modified, or distributed // except according to those terms. //! Code generation for [`cucumber_rust`] tests auto-wiring. #![deny( missing_debug_implementations, nonstandard_style, rust_2018_idioms, trivial_casts, trivial_numeric_casts )] #![warn( deprecated_in_future, missing_copy_implementations, missing_docs, unreachable_pub, unused_import_braces, unused_labels, unused_qualifications, unused_results )] mod attribute; mod derive; use proc_macro::TokenStream; macro_rules! step_attribute { ($name:ident) => { /// Attribute to auto-wire the test to the [`World`] implementer. /// /// There are 3 step-specific attributes: /// - [`given`] /// - [`when`] /// - [`then`] /// /// # Example /// /// ``` /// # use std::{convert::Infallible, rc::Rc}; /// # /// # use async_trait::async_trait; /// use cucumber_rust::{given, World, WorldInit}; /// /// #[derive(WorldInit)] /// struct MyWorld; /// /// #[async_trait(?Send)] /// impl World for MyWorld { /// type Error = Infallible; /// /// async fn new() -> Result<Self, Self::Error> { /// Ok(Self {}) /// } /// } /// /// #[given(regex = r"(\S+) is (\d+)")] /// fn test(w: &mut MyWorld, param: String, num: i32) { /// assert_eq!(param, "foo"); /// assert_eq!(num, 0); /// } /// /// #[tokio::main] /// async fn main() { /// let runner = MyWorld::init(&["./features"]); /// runner.run().await; /// } /// ``` /// /// # Arguments /// /// - First argument has to be mutable refence to the [`WorldInit`] deriver (your [`World`] /// implementer). /// - Other argument's types have to implement [`FromStr`] or it has to be a slice where the /// element type also implements [`FromStr`]. /// - To use [`cucumber::StepContext`], name the argument as `context`, **or** mark the argument with /// a `#[given(context)]` attribute. /// /// ``` /// # use std::convert::Infallible; /// # use std::rc::Rc; /// # /// # use async_trait::async_trait; /// # use cucumber_rust::{StepContext, given, World, WorldInit}; /// # /// #[derive(WorldInit)] /// struct MyWorld; /// # /// # #[async_trait(?Send)] /// # impl World for MyWorld { /// # type Error = Infallible; /// # /// # async fn new() -> Result<Self, Self::Error> { /// # Ok(Self {}) /// # } /// # } /// /// #[given(regex = r"(\S+) is not (\S+)")] /// fn test_step( /// w: &mut MyWorld, /// #[given(context)] s: &StepContext, /// ) { /// assert_eq!(s.matches.get(0).unwrap(), "foo"); /// assert_eq!(s.matches.get(1).unwrap(), "bar"); /// assert_eq!(s.step.value, "foo is bar"); /// } /// # /// # #[tokio::main] /// # async fn main() { /// # let runner = MyWorld::init(&["./features"]); /// # runner.run().await; /// # } /// ``` /// /// [`FromStr`]: std::str::FromStr /// [`cucumber::StepContext`]: cucumber_rust::StepContext /// [`World`]: cucumber_rust::World #[proc_macro_attribute] pub fn $name(args: TokenStream, input: TokenStream) -> TokenStream { attribute::step(std::stringify!($name), args.into(), input.into()) .unwrap_or_else(|e| e.to_compile_error()) .into() } }; } macro_rules! steps { ($($name:ident),*) => { /// Derive macro for tests auto-wiring. /// /// See [`given`], [`when`] and [`then`] attributes for further details. #[proc_macro_derive(WorldInit)] pub fn derive_init(input: TokenStream) -> TokenStream { derive::world_init(input.into(), &[$(std::stringify!($name)),*]) .unwrap_or_else(|e| e.to_compile_error()) .into() } $(step_attribute!($name);)* } } steps!(given, when, then);