fluid 0.4.1

An human readable test library.
Documentation 
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

//! This module contains all that is used to create an assertion.
//!
//! The value that will be tested is called the **left element**.
//!
//! # Example
//!
//! ```
//! // Import the needed definitions:
//! use fluid::core::prelude::*;
//!
//! // Create the struct used for the assertion.
//! // The assertion is done in the destructor, so a `Drop` implementation
//! // must be added:
//! #[derive(Drop)]
//! pub struct BeTheAnswer<L: Debug> where L: PartialEq<i32> {
//!     should: Should<L>,
//! }
//!
//! // Implement the trait `AssertionImpl` so that it can be effectively used as
//! // an assertion:
//! impl<L: Debug> AssertionImpl for BeTheAnswer<L> where L: PartialEq<i32> {
//!     // You must specify the type of the left element there:
//!     type Left = L;
//!
//!     // If the test failed, you must return a String with the
//!     // (nicer possible) error message:
//!     fn failure_message(&mut self) -> Option<String> {
//!         let should: &mut ShouldImpl<Self::Left> = (&mut self.should).into();
//!         // The `dbg` method must be used for the style consistency,
//!         // and to shorten the value if it is too long:
//!         let left_dbg = should.left_dbg();
//!         let truthness = should.truthness();
//!
//!         // If the test failed:
//!         if (should.left.as_ref()? == &42) != truthness {
//!             let message = if let Some(stringified) = should.stringified() {
//!                 format!(
//!                     "\t{} is equal to {}.\n\
//!                      \tIt should{} be equal to 42 (the answer).",
//!                     stringified,
//!                     left_dbg,
//!                     truthness,
//!                 )
//!             // A simpler message is created if the left element is not
//!             // stringified:
//!             } else {
//!                 format!(
//!                     "\t{} is{} equal to 42.",
//!                     left_dbg,
//!                     truthness,
//!                 )
//!             };
//!             Some(message)
//!         } else {
//!             None
//!         }
//!     }
//!
//!     // Unfortunately, because virtual fields do not exist in Rust,
//!     // the following 2 methods must be added:
//!
//!     fn consume_as_should(mut self) -> ShouldImpl<Self::Left> {
//!         self.should.take().into()
//!     }
//!
//!     fn should_mut(&mut self) -> &mut ShouldImpl<Self::Left> {
//!         (&mut self.should).into()
//!     }
//! }
//!
//! // You must then create your own extension:
//! pub trait MyAssertionExt<L: Debug> where L: PartialEq<i32> {
//!     fn be_the_answer(self) -> ChainableAssert<BeTheAnswer<L>>;
//! }
//!
//! impl<L: Debug> MyAssertionExt<L> for Should<L> where L: PartialEq<i32> {
//!     fn be_the_answer(self) -> ChainableAssert<BeTheAnswer<L>> {
//!         let implem = BeTheAnswer {
//!             should: self,
//!         };
//!         ChainableAssert(implem)
//!     }
//! }
//!
//! // Now the user can write:
//!
//! use fluid::prelude::*;
//!
//! fn the_meaning_of_life() -> i32 {
//!     42
//! }
//!
//! #[fact]
//! fn the_answer_should_be_ok() {
//!     the_meaning_of_life().should().be_the_answer();
//! }
//! ```

pub mod assert;
mod assertion_impl;
pub(crate) mod display;
pub(crate) mod information;
pub mod should;
mod take;

pub use assertion_impl::AssertionImpl;

/// The things needed to import to create an assertion.
/// See the parent module documentation.
pub mod prelude {
    pub use super::assert::{ChainableAssert, ConsumingAssert};
    pub use super::display::*;
    pub use super::should::{Should, ShouldImpl};
    pub use super::take::Take;
    pub use super::AssertionImpl;
    pub use fluid_attributes::Drop;
    pub use std::fmt::Debug;
}