std_tools 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

/// Internal namespace.
pub( crate ) mod private
{
  use crate::*;

  /// Context.
  pub trait ChangerInterface
  where
    Self :
      fmt::Debug +
      Clone +
    ,
  {
    /// Type of root changer.
    type Root : ChangerInterface;
    /// Type of parent changer.
    type Parent : ChangerInterface;

    /// Get root.
    #[ inline ]
    fn root( &mut self ) -> &mut Self::Root
    {
      // Safaty : that's safe becuase root type is the same for all nodes.
      unsafe
      {
        core::mem::transmute::< _, _ >( self.parent().root() )
      }
    }

    /// Get back to root changer.
    fn context( self ) -> Self::Root;

    /// Get parent.
    fn parent( &mut self ) -> &mut Self::Parent;

    /// Get back to parent changer.
    fn end( self ) -> Self::Parent;

    /// Add change.
    #[ inline ]
    fn change_add< Change >( &mut self, change : Change ) -> &mut Self
    where
      Change : ChangeInterface + 'static,
    {
      self.root().change_add( change );
      self
    }

  }

}

/// Protected namespace of the module.
pub mod protected
{
  pub use super::
  {
    orphan::*,
  };
}

pub use protected::*;

/// Parented namespace of the module.
pub mod orphan
{
  pub use super::exposed::*;
}

/// Exposed namespace of the module.
pub mod exposed
{
  pub use super::
  {
    prelude::*,
  };
}

pub use exposed::*;

/// Prelude to use essentials: `use my_module::prelude::*`.
pub mod prelude
{
  pub use super::
  {
    private::ChangerInterface,
  };
}