feat: add TrialPruned error variant and Pruned trial state

- Add `Pruned` variant to `TrialState`
- Add `Error::TrialPruned` variant and standalone `TrialPruned` struct
  with `From<TrialPruned> for Error` for ergonomic `?` usage
- Add `state` field to `CompletedTrial` (defaults to `Complete`)
- Add `Study::prune_trial()` and `Study::n_pruned_trials()`
- `optimize()` and `optimize_with_callback()` detect `TrialPruned`
  errors via Any downcasting and record pruned trials instead of
  failing them
- `best_trial()` / `best_value()` now filter to only `Complete` trials
- Re-export `TrialPruned` from crate root and prelude

This commit is contained in:

Manuel Raimann

2026-02-11 16:24:57 +01:00

parent 4d8af3242b

commit abe15bdd7b

6 changed files with 144 additions and 23 deletions

									
										src/types.rs
									
		+2
		
												View File
												
				@@ -18,4 +18,6 @@ pub enum TrialState {

				    Complete,

				    /// The trial failed with an error.

				    Failed,

				    /// The trial was pruned (stopped early).

				    Pruned,

				}