non_std 0.1.4

Collection of general purpose tools for solving problems. Fundamentally extend the language without spoiling, so may be used solely or in conjunction with another module of such kind.
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

/// Internal namespace.
pub( crate ) mod private
{

  // xxx : move here test tools

//   ///
//   /// Mechanism to define test suite.
//   /// This macro encourages refactoring the code of the test in the most readable way, gathering a list of all test routines at the end of the test file.
//   ///
//   /// Name of test routine should have postfix `*_test`. In the index of test routine the postfix should be ommited.
//   ///
//   /// ### Sample
//   /// use wtest_basic::*;
//   ///
//   /// //
//   ///
//   /// fn pass1_test()
//   /// {
//   ///   assert_eq!( true, true );
//   /// }
//   ///
//   /// //
//   ///
//   /// fn pass2_test()
//   /// {
//   ///   assert_eq!( 1, 1 );
//   /// }
//   ///
//   /// //
//   ///
//   /// test_suite!
//   /// {
//   ///   pass1,
//   ///   pass2,
//   /// }
//   ///
//
//   #[ macro_export ]
//   macro_rules! test_suite
//   {
//
//     () => { };
//
//     (
//       $( #[ $Meta : meta ] )*
//       $Name : ident ,
//       $( $Rest : tt )*
//     )
//     =>
//     {
//       $( #[ $Meta ] )*
//       #[test]
//       fn $Name()
//       {
//         $crate::paste::paste!([< $Name _test >])()
//       }
//       $crate::test_suite!( $( $Rest )* );
//     };
//
//   }

  // /// Pass only if callback fails either returning error or panicing.
  //
  // pub fn should_throw< R, F : FnOnce() -> anyhow::Result< R > >( f : F ) -> anyhow::Result< R >
  // {
  //   f()
  // }

  //

  // #[panic_handler]
  // fn panic( info : &core::panic::PanicInfo ) -> !
  // {
  //   println!( "{:?}", info );
  //   loop {}
  // }

  // pub use test_suite;
  // pub use test_suite_internals;
  // pub use index;
}

/// Exposed namespace of the module.
pub mod exposed
{
  // use super::private as i;
  pub use super::prelude::*;
  // pub use super::private::test_suite;
}

pub use exposed::*;

/// Prelude to use essentials: `use my_module::prelude::*`.
pub mod prelude
{
  // use super::private as i;
  // pub use super::private::test_suite;
  pub use core::fmt; // zzz : add to prelude of wtools under feature fair_context
}