Fix performance regression on large .feature files (#352, #331)

- replace `Arc` with `PartialEq`/`Hash` pointer-optimized `Source` in `event`s:
    - `Source<gherkin::Feature>` in `event::Cucumber::Feature`
    - `Source<gherkin::Rule>` in `event::Feature::Rule`
    - `Source<gherkin::Scenario>` in `event::Feature::Scenario` and `event::Rule::Scenario`
    - `Source<gherkin::Step>` in `event::Scenario::Background` and `event::Scenario::Step`
- make non-`const` the following constructor functions for input type polymorphism:
    - `event::Cucumber::feature_started()` and `event::Cucumber::feature_finished()`
    - `event::Cucumber::rule_started()` and `event::Cucumber::rule_finished()`
    - `event::Scenario::step_started()`, `event::Scenario::step_passed()` and `event::Scenario::step_skipped()`
    - `event::Scenario::background_step_started()`, `event::Scenario::background_step_passed()` and `event::Scenario::background_step_skipped()`

CHANGELOG.md

@@ -13,11 +13,27 @@ All user visible changes to `cucumber` crate will be documented in this file. Th
 
 ### BC Breaks
 
-- Bumped up [MSRV] to 1.83 to get rid of `once_cell` crate and for `#[expect]` attribute usage. ([4010c1ad], [f1307038], [todo])
+- Bumped up [MSRV] to 1.83 to get rid of `once_cell` crate and for `#[expect]` attribute usage. ([4010c1ad], [f1307038], [b46930c3])
+- Replaced `Arc` with `PartialEq`/`Hash` pointer-optimized `Source` in `event`s: ([#352])
+    - `Source<gherkin::Feature>` in `event::Cucumber::Feature`.
+    - `Source<gherkin::Rule>` in `event::Feature::Rule`.
+    - `Source<gherkin::Scenario>` in `event::Feature::Scenario` and `event::Rule::Scenario`.
+    - `Source<gherkin::Step>` in `event::Scenario::Background` and `event::Scenario::Step`.
+- Made non-`const` the following constructor functions for input type polymorphism: ([#352])
+    - `event::Cucumber::feature_started()` and `event::Cucumber::feature_finished()`.
+    - `event::Cucumber::rule_started()` and `event::Cucumber::rule_finished()`.
+    - `event::Scenario::step_started()`, `event::Scenario::step_passed()` and `event::Scenario::step_skipped()`.
+    - `event::Scenario::background_step_started()`, `event::Scenario::background_step_passed()` and `event::Scenario::background_step_skipped()`.
 
+### Fixed
+
+- Performance degradation on large `.feature` files. ([#352], [#331])
+
+[#331]: /../../issues/331
+[#352]: /../../pull/352
 [4010c1ad]: /../../commit/4010c1ad6a53d6b7f0b28cefea73c8c13e880e9f
+[b46930c3]: /../../commit/b46930c32ef5ae490df8063905144a45de27eda1
 [f1307038]: /../../commit/f1307038cb6b1e38c1cc259a0e09fb583033d0cf
-[todo]: /../../commit/todo
 
 
 

Cargo.toml

@@ -75,6 +75,7 @@ humantime = "2.1"
 itertools = "0.14"
 linked-hash-map = "0.5.3"
 pin-project = "1.0"
+ref-cast = "1.0.16"
 regex = "1.9"
 sealed = "0.6"
 smart-default = "0.7.1"

book/src/architecture/runner.md

@@ -194,10 +194,10 @@ impl CustomRunner {
 
         panic::set_hook(hook);
 
-        let scenario = Arc::new(scenario);
+        let scenario = event::Source::new(scenario);
         stream::once(future::ready(event::Scenario::Started))
             .chain(stream::iter(steps.into_iter().flat_map(|(step, ev)| {
-                let step = Arc::new(step);
+                let step = event::Source::new(step);
                 [
                     event::Scenario::Step(step.clone(), event::Step::Started),
                     event::Scenario::Step(step, ev),
@@ -213,7 +213,7 @@ impl CustomRunner {
     fn execute_feature(
         feature: gherkin::Feature,
     ) -> impl Stream<Item = event::Cucumber<AnimalWorld>> {
-        let feature = Arc::new(feature);
+        let feature = event::Source::new(feature);
         stream::once(future::ready(event::Feature::Started))
             .chain(
                 stream::iter(feature.scenarios.clone())

book/src/architecture/writer.md

@@ -184,10 +184,10 @@ Finally, let's implement a custom [`Writer`] which simply outputs [cucumber even
 #
 #         panic::set_hook(hook);
 #
-#         let scenario = Arc::new(scenario);
+#         let scenario = event::Source::new(scenario);
 #         stream::once(future::ready(event::Scenario::Started))
 #             .chain(stream::iter(steps.into_iter().flat_map(|(step, ev)| {
-#                 let step = Arc::new(step);
+#                 let step = event::Source::new(step);
 #                 [
 #                     event::Scenario::Step(step.clone(), event::Step::Started),
 #                     event::Scenario::Step(step, ev),
@@ -203,7 +203,7 @@ Finally, let's implement a custom [`Writer`] which simply outputs [cucumber even
 #     fn execute_feature(
 #         feature: gherkin::Feature,
 #     ) -> impl Stream<Item = event::Cucumber<AnimalWorld>> {
-#         let feature = Arc::new(feature);
+#         let feature = event::Source::new(feature);
 #         stream::once(future::ready(event::Feature::Started))
 #             .chain(
 #                 stream::iter(feature.scenarios.clone())

codegen/CHANGELOG.md

@@ -13,11 +13,11 @@ All user visible changes to `cucumber-codegen` crate will be documented in this
 
 ### BC Breaks
 
-- Bumped up [MSRV] to 1.83 to get rid of `once_cell` crate and for `#[expect]` attribute usage. ([4010c1ad], [f1307038], [todo])
+- Bumped up [MSRV] to 1.83 to get rid of `once_cell` crate and for `#[expect]` attribute usage. ([4010c1ad], [f1307038], [b46930c3])
 
 [4010c1ad]: /../../commit/4010c1ad6a53d6b7f0b28cefea73c8c13e880e9f
+[b46930c3]: /../../commit/b46930c32ef5ae490df8063905144a45de27eda1
 [f1307038]: /../../commit/f1307038cb6b1e38c1cc259a0e09fb583033d0cf
-[todo]: /../../commit/todo
 
 
 

codegen/src/lib.rs

@@ -167,6 +167,16 @@ mod attribute;
 mod parameter;
 mod world;
 
+// TODO: Remove once tests run without complains about it.
+#[cfg(test)]
+mod actually_used_crates_in_doc_tests {
+    use cucumber as _;
+    use derive_more as _;
+    use futures as _;
+    use tempfile as _;
+    use tokio as _;
+}
+
 use proc_macro::TokenStream;
 
 /// Helper macro for generating public shims for [`macro@given`], [`macro@when`]