mod_interface_runtime 0.1.1

Protocol of modularity unifying interface of a module and introducing layers.
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
}