diff --git a/Cargo.toml b/Cargo.toml index 95a8901253..666e522707 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -557,3 +557,15 @@ default-features = false [workspace.dependencies.paste] version = "~1.0.14" default-features = false + +[workspace.dependencies.tempdir] +version = "~0.3.7" + +[workspace.dependencies.rustversion] +version = "~1.0" + +[workspace.dependencies.num-traits] +version = "~0.2" + +[workspace.dependencies.rand] +version = "0.8.5" diff --git a/module/alias/instance_of/src/typing/implements_lib.rs b/module/alias/instance_of/src/typing/implements_lib.rs index 1a3f76aa7e..4129608ed8 100644 --- a/module/alias/instance_of/src/typing/implements_lib.rs +++ b/module/alias/instance_of/src/typing/implements_lib.rs @@ -15,7 +15,7 @@ // #[ macro_use ] mod implements_impl; -/// Internal namespace. +/// Define a private namespace for all its items. mod private { diff --git a/module/alias/instance_of/src/typing/is_slice_lib.rs b/module/alias/instance_of/src/typing/is_slice_lib.rs index 0f4a45cbc4..f3479787d1 100644 --- a/module/alias/instance_of/src/typing/is_slice_lib.rs +++ b/module/alias/instance_of/src/typing/is_slice_lib.rs @@ -12,7 +12,7 @@ #![ doc = include_str!( concat!( env!( "CARGO_MANIFEST_DIR" ), "/", "Readme.md" ) ) ] -/// Internal namespace. +/// Define a private namespace for all its items. mod private { diff --git a/module/alias/wtest_basic/src/test/basic/helper.rs b/module/alias/wtest_basic/src/test/basic/helper.rs index fd3f8907d2..dc9ed8372b 100644 --- a/module/alias/wtest_basic/src/test/basic/helper.rs +++ b/module/alias/wtest_basic/src/test/basic/helper.rs @@ -3,7 +3,7 @@ //! Helpers. //! -/// Internal namespace. +/// Define a private namespace for all its items. mod private { diff --git a/module/alias/wtest_basic/src/test/basic/mod.rs b/module/alias/wtest_basic/src/test/basic/mod.rs index 9e9e011623..034ebb427a 100644 --- a/module/alias/wtest_basic/src/test/basic/mod.rs +++ b/module/alias/wtest_basic/src/test/basic/mod.rs @@ -3,7 +3,7 @@ //! Basic tools for testing. //! -/// Internal namespace. +/// Define a private namespace for all its items. mod private { } diff --git a/module/core/async_from/src/lib.rs b/module/core/async_from/src/lib.rs index b2419ae521..669dcf988e 100644 --- a/module/core/async_from/src/lib.rs +++ b/module/core/async_from/src/lib.rs @@ -11,7 +11,7 @@ pub mod dependency pub use ::async_trait; } -/// Internal namespace. +/// Define a private namespace for all its items. #[ cfg( feature = "enabled" ) ] mod private { diff --git a/module/core/async_tools/src/lib.rs b/module/core/async_tools/src/lib.rs index ab0bcbf7e8..0390e0dbe2 100644 --- a/module/core/async_tools/src/lib.rs +++ b/module/core/async_tools/src/lib.rs @@ -12,7 +12,7 @@ pub mod dependency pub use ::async_from; } -/// Internal namespace. +/// Define a private namespace for all its items. #[ cfg( feature = "enabled" ) ] mod private { diff --git a/module/core/clone_dyn/src/lib.rs b/module/core/clone_dyn/src/lib.rs index 18e0150163..57ae64c7f8 100644 --- a/module/core/clone_dyn/src/lib.rs +++ b/module/core/clone_dyn/src/lib.rs @@ -14,7 +14,7 @@ pub mod dependency pub use ::clone_dyn_types; } -/// Internal namespace. +/// Define a private namespace for all its items. #[ cfg( feature = "enabled" ) ] mod private { diff --git a/module/core/clone_dyn_types/src/lib.rs b/module/core/clone_dyn_types/src/lib.rs index 3fc94133df..cc55badce4 100644 --- a/module/core/clone_dyn_types/src/lib.rs +++ b/module/core/clone_dyn_types/src/lib.rs @@ -10,7 +10,7 @@ pub mod dependency { } -/// Internal namespace. +/// Define a private namespace for all its items. // #[ cfg( any( not( feature = "no_std" ), feature = "use_alloc" ) ) ] #[ cfg( feature = "enabled" ) ] mod private diff --git a/module/core/data_type/src/dt.rs b/module/core/data_type/src/dt.rs index 69c9e80518..f384f56072 100644 --- a/module/core/data_type/src/dt.rs +++ b/module/core/data_type/src/dt.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { } diff --git a/module/core/diagnostics_tools/src/diag/rta.rs b/module/core/diagnostics_tools/src/diag/rta.rs index 27f8d991ec..46b21050a2 100644 --- a/module/core/diagnostics_tools/src/diag/rta.rs +++ b/module/core/diagnostics_tools/src/diag/rta.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { diff --git a/module/core/error_tools/src/error/assert.rs b/module/core/error_tools/src/error/assert.rs index 50c72b0bdf..52f45d29bf 100644 --- a/module/core/error_tools/src/error/assert.rs +++ b/module/core/error_tools/src/error/assert.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { /// diff --git a/module/core/error_tools/src/error/mod.rs b/module/core/error_tools/src/error/mod.rs index cd999e016d..4d9c79ddaa 100644 --- a/module/core/error_tools/src/error/mod.rs +++ b/module/core/error_tools/src/error/mod.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { pub use std::error::Error as ErrorTrait; diff --git a/module/core/error_tools/src/error/typed.rs b/module/core/error_tools/src/error/typed.rs index e4e341a586..074fb5b61a 100644 --- a/module/core/error_tools/src/error/typed.rs +++ b/module/core/error_tools/src/error/typed.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { diff --git a/module/core/error_tools/src/error/untyped.rs b/module/core/error_tools/src/error/untyped.rs index 17e335473a..8288f32866 100644 --- a/module/core/error_tools/src/error/untyped.rs +++ b/module/core/error_tools/src/error/untyped.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { diff --git a/module/core/for_each/src/lib.rs b/module/core/for_each/src/lib.rs index b106a5110b..00825e5b96 100644 --- a/module/core/for_each/src/lib.rs +++ b/module/core/for_each/src/lib.rs @@ -4,7 +4,7 @@ #![ doc( html_root_url = "https://docs.rs/for_each/latest/for_each/" ) ] #![ doc = include_str!( concat!( env!( "CARGO_MANIFEST_DIR" ), "/", "Readme.md" ) ) ] -/// Internal namespace. +/// Define a private namespace for all its items. #[ cfg( feature = "enabled" ) ] mod private { diff --git a/module/core/format_tools/src/format.rs b/module/core/format_tools/src/format.rs index 2abf7f18a4..fb207181b3 100644 --- a/module/core/format_tools/src/format.rs +++ b/module/core/format_tools/src/format.rs @@ -2,7 +2,7 @@ //! Collection of mechanisms for formatting and serialization into string. //! -/// Internal namespace. +/// Define a private namespace for all its items. mod private { diff --git a/module/core/format_tools/src/format/as_table.rs b/module/core/format_tools/src/format/as_table.rs index b1c48c159f..7409b42952 100644 --- a/module/core/format_tools/src/format/as_table.rs +++ b/module/core/format_tools/src/format/as_table.rs @@ -2,7 +2,7 @@ //! Nice print's wrapper. //! -/// Internal namespace. +/// Define a private namespace for all its items. mod private { diff --git a/module/core/format_tools/src/format/filter.rs b/module/core/format_tools/src/format/filter.rs index 191522e138..1551721570 100644 --- a/module/core/format_tools/src/format/filter.rs +++ b/module/core/format_tools/src/format/filter.rs @@ -2,7 +2,7 @@ //! Print data as table. //! -/// Internal namespace. +/// Define a private namespace for all its items. mod private { diff --git a/module/core/format_tools/src/format/md_math.rs b/module/core/format_tools/src/format/md_math.rs index 196b0ee811..9aa70022d0 100644 --- a/module/core/format_tools/src/format/md_math.rs +++ b/module/core/format_tools/src/format/md_math.rs @@ -5,7 +5,7 @@ // xxx : use crate mdmath -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use core:: diff --git a/module/core/format_tools/src/format/output_format.rs b/module/core/format_tools/src/format/output_format.rs index 69acca8515..1b3e13c5b9 100644 --- a/module/core/format_tools/src/format/output_format.rs +++ b/module/core/format_tools/src/format/output_format.rs @@ -28,7 +28,7 @@ //! ``` //! -/// Internal namespace. +/// Define a private namespace for all its items. mod private { diff --git a/module/core/format_tools/src/format/print.rs b/module/core/format_tools/src/format/print.rs index 858bd7dd57..bc49db448d 100644 --- a/module/core/format_tools/src/format/print.rs +++ b/module/core/format_tools/src/format/print.rs @@ -2,7 +2,7 @@ //! Print data as table. //! -/// Internal namespace. +/// Define a private namespace for all its items. mod private { diff --git a/module/core/format_tools/src/format/string.rs b/module/core/format_tools/src/format/string.rs index 511f44c473..619d1690c2 100644 --- a/module/core/format_tools/src/format/string.rs +++ b/module/core/format_tools/src/format/string.rs @@ -4,7 +4,7 @@ // xxx : move to crate string_tools -/// Internal namespace. +/// Define a private namespace for all its items. mod private { diff --git a/module/core/format_tools/src/format/table.rs b/module/core/format_tools/src/format/table.rs index d3dc8bd71c..27e44ca0e5 100644 --- a/module/core/format_tools/src/format/table.rs +++ b/module/core/format_tools/src/format/table.rs @@ -2,7 +2,7 @@ //! Table interface. //! -/// Internal namespace. +/// Define a private namespace for all its items. mod private { diff --git a/module/core/format_tools/src/format/to_string.rs b/module/core/format_tools/src/format/to_string.rs index 6446e90fa2..8bc9bb538f 100644 --- a/module/core/format_tools/src/format/to_string.rs +++ b/module/core/format_tools/src/format/to_string.rs @@ -2,7 +2,7 @@ //! Flexible ToString augmentation. //! -/// Internal namespace. +/// Define a private namespace for all its items. mod private { diff --git a/module/core/format_tools/src/format/to_string_with_fallback.rs b/module/core/format_tools/src/format/to_string_with_fallback.rs index e79b827896..fb5966bf38 100644 --- a/module/core/format_tools/src/format/to_string_with_fallback.rs +++ b/module/core/format_tools/src/format/to_string_with_fallback.rs @@ -2,7 +2,7 @@ //! Flexible ToString augmentation. //! -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::*; diff --git a/module/core/former_types/src/collection.rs b/module/core/former_types/src/collection.rs index c740510fb3..c7b25889b7 100644 --- a/module/core/former_types/src/collection.rs +++ b/module/core/former_types/src/collection.rs @@ -5,7 +5,7 @@ //! such as vectors, hash maps, and custom collection implementations. //! -/// Internal namespace. +/// Define a private namespace for all its items. mod private { diff --git a/module/core/fs_tools/src/fs/fs.rs b/module/core/fs_tools/src/fs/fs.rs index 25f60b2592..a10288843c 100644 --- a/module/core/fs_tools/src/fs/fs.rs +++ b/module/core/fs_tools/src/fs/fs.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { diff --git a/module/core/implements/src/lib.rs b/module/core/implements/src/lib.rs index 7bdfba2035..989d5e528e 100644 --- a/module/core/implements/src/lib.rs +++ b/module/core/implements/src/lib.rs @@ -16,7 +16,7 @@ #[ cfg( feature = "enabled" ) ] mod implements_impl; -/// Internal namespace. +/// Define a private namespace for all its items. #[ cfg( feature = "enabled" ) ] mod private { diff --git a/module/core/impls_index/Cargo.toml b/module/core/impls_index/Cargo.toml index 1845411740..392f5bf2f0 100644 --- a/module/core/impls_index/Cargo.toml +++ b/module/core/impls_index/Cargo.toml @@ -27,8 +27,6 @@ all-features = false [features] default = [ "enabled" ] full = [ "enabled" ] -no_std = [] -use_alloc = [ "no_std" ] enabled = [ "impls_index_meta/enabled" ] [dependencies] @@ -36,4 +34,4 @@ impls_index_meta = { workspace = true } [dev-dependencies] test_tools = { workspace = true } -tempdir = { version = "0.3.7" } +tempdir = { workspace = true } diff --git a/module/core/impls_index/src/impls_index/func.rs b/module/core/impls_index/src/impls_index/func.rs index 21448b2ef8..da33da0127 100644 --- a/module/core/impls_index/src/impls_index/func.rs +++ b/module/core/impls_index/src/impls_index/func.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { diff --git a/module/core/impls_index/src/impls_index/impls.rs b/module/core/impls_index/src/impls_index/impls.rs index 18d81346a8..b10b4498e3 100644 --- a/module/core/impls_index/src/impls_index/impls.rs +++ b/module/core/impls_index/src/impls_index/impls.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { @@ -382,14 +382,7 @@ pub mod exposed use super::*; #[ doc( inline ) ] pub use prelude::*; -} - -/// Prelude to use essentials: `use my_module::prelude::*`. -#[ allow( unused_imports ) ] -pub mod prelude -{ - use super::*; #[ doc( inline ) ] pub use private:: { @@ -403,9 +396,15 @@ pub mod prelude _impls_callback, }; #[ doc( inline ) ] - #[ allow( unused_imports ) ] pub use ::impls_index_meta::impls3; #[ doc( inline ) ] - #[ allow( unused_imports ) ] pub use impls3 as impls; + +} + +/// Prelude to use essentials: `use my_module::prelude::*`. +#[ allow( unused_imports ) ] +pub mod prelude +{ + use super::*; } diff --git a/module/core/impls_index/src/impls_index/mod.rs b/module/core/impls_index/src/impls_index/mod.rs index f0d3a5f74f..5b54558d8d 100644 --- a/module/core/impls_index/src/impls_index/mod.rs +++ b/module/core/impls_index/src/impls_index/mod.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { @@ -31,6 +31,8 @@ pub mod own use super::*; #[ doc( inline ) ] pub use orphan::*; + #[ doc( inline ) ] + pub use ::impls_index_meta::*; } /// Shared with parent namespace of the module @@ -40,7 +42,6 @@ pub mod orphan use super::*; #[ doc( inline ) ] pub use exposed::*; - // pub use super::dependency; } /// Exposed namespace of the module. @@ -51,11 +52,9 @@ pub mod exposed #[ doc( inline ) ] pub use prelude::*; #[ doc( inline ) ] - #[ allow( unused_imports ) ] - pub use super::impls::exposed::*; + pub use impls::exposed::*; #[ doc( inline ) ] - #[ allow( unused_imports ) ] - pub use super::func::exposed::*; + pub use func::exposed::*; } /// Prelude to use essentials: `use my_module::prelude::*`. @@ -64,13 +63,7 @@ pub mod prelude { use super::*; #[ doc( inline ) ] - #[ allow( unused_imports ) ] - pub use super::impls::prelude::*; + pub use impls::prelude::*; #[ doc( inline ) ] - #[ allow( unused_imports ) ] - pub use super::func::prelude::*; - // #[ cfg( any( feature = "meta", feature = "impls_index_meta" ) ) ] - #[ doc( inline ) ] - #[ allow( unused_imports ) ] - pub use ::impls_index_meta::*; + pub use func::prelude::*; } diff --git a/module/core/impls_index/src/lib.rs b/module/core/impls_index/src/lib.rs index ec229443d8..ac0f33af0a 100644 --- a/module/core/impls_index/src/lib.rs +++ b/module/core/impls_index/src/lib.rs @@ -1,4 +1,4 @@ -#![ cfg_attr( feature = "no_std", no_std ) ] +#![ no_std ] #![ doc( html_logo_url = "https://raw.githubusercontent.com/Wandalen/wTools/master/asset/img/logo_v3_trans_square.png" ) ] #![ doc( html_favicon_url = "https://raw.githubusercontent.com/Wandalen/wTools/alpha/asset/img/logo_v3_trans_square_icon_small_v2.ico" ) ] #![ doc( html_root_url = "https://docs.rs/impls_index/latest/impls_index/" ) ] @@ -30,7 +30,6 @@ pub mod own #[ doc( inline ) ] pub use orphan::*; #[ doc( inline ) ] - #[ allow( unused_imports ) ] pub use super::impls_index::orphan::*; } @@ -53,7 +52,6 @@ pub mod exposed #[ doc( inline ) ] pub use prelude::*; #[ doc( inline ) ] - #[ allow( unused_imports ) ] pub use super::impls_index::exposed::*; } @@ -64,6 +62,5 @@ pub mod prelude { use super::*; #[ doc( inline ) ] - #[ allow( unused_imports ) ] pub use super::impls_index::prelude::*; } diff --git a/module/core/impls_index/tests/inc/func_test.rs b/module/core/impls_index/tests/inc/func_test.rs index 7408b5b3ff..7b5d74bbcc 100644 --- a/module/core/impls_index/tests/inc/func_test.rs +++ b/module/core/impls_index/tests/inc/func_test.rs @@ -2,7 +2,7 @@ use super::*; #[ allow ( unused_imports ) ] -use the_module::prelude::*; +use the_module::exposed::*; // use test_tools::exposed::*; // diff --git a/module/core/impls_index/tests/inc/impls1_test.rs b/module/core/impls_index/tests/inc/impls1_test.rs index c8df2ca220..b49e010b01 100644 --- a/module/core/impls_index/tests/inc/impls1_test.rs +++ b/module/core/impls_index/tests/inc/impls1_test.rs @@ -1,120 +1,118 @@ // use test_tools::exposed::*; use super::*; -use the_module::prelude::impls1; +use the_module::exposed::impls1; +// use the_module::exposed::{ index }; // -tests_impls! +#[ test ] +fn impls_basic() { - fn impls_basic() + // test.case( "impls1 basic" ); { - // test.case( "impls1 basic" ); + impls1! { - - impls1! + fn f1() { - fn f1() - { - println!( "f1" ); - } - pub fn f2() - { - println!( "f2" ); - } - }; + println!( "f1" ); + } + pub fn f2() + { + println!( "f2" ); + } + }; - // trace_macros!( true ); - f1!(); - f2!(); - // trace_macros!( false ); + // trace_macros!( true ); + f1!(); + f2!(); + // trace_macros!( false ); - f1(); - f2(); + f1(); + f2(); - } + } + +// // test.case( "impls1 as" ); +// { +// +// impls1! +// { +// fn f1() +// { +// println!( "f1" ); +// } +// pub fn f2() +// { +// println!( "f2" ); +// } +// }; +// +// // trace_macros!( true ); +// f1!( as f1b ); +// f2!( as f2b ); +// // trace_macros!( false ); +// +// f1b(); +// f2b(); +// +// } +// +// // test.case( "impls1 as index" ); +// { +// +// impls1! +// { +// fn f1() +// { +// println!( "f1" ); +// } +// pub fn f2() +// { +// println!( "f2" ); +// } +// }; +// +// // trace_macros!( true ); +// index! +// { +// f1, +// f2 as f2b, +// } +// // trace_macros!( false ); +// +// f1(); +// f2b(); +// +// } - // // test.case( "impls1 as" ); - // { - // - // impls1! - // { - // fn f1() - // { - // println!( "f1" ); - // } - // pub fn f2() - // { - // println!( "f2" ); - // } - // }; - // - // // trace_macros!( true ); - // f1!( as f1b ); - // f2!( as f2b ); - // // trace_macros!( false ); - // - // f1b(); - // f2b(); - // - // } - // - // // test.case( "impls1 as index" ); - // { - // - // impls1! - // { - // fn f1() - // { - // println!( "f1" ); - // } - // pub fn f2() - // { - // println!( "f2" ); - // } - // }; - // - // // trace_macros!( true ); - // index! - // { - // f1, - // f2 as f2b, - // } - // // trace_macros!( false ); - // - // f1(); - // f2b(); - // - // } + // test.case( "macro" ); + { - // test.case( "macro" ); + impls1! { - - impls1! + fn f1() { - fn f1() + macro_rules! macro1 { - macro_rules! macro1 - { - ( $( $Arg : tt )* ) => { }; - } - macro1!(); + ( $( $Arg : tt )* ) => { }; } + macro1!(); } - - // trace_macros!( true ); - f1!(); - // trace_macros!( false ); - } + // trace_macros!( true ); + f1!(); + // trace_macros!( false ); + } + } // -tests_index! -{ - impls_basic, -} +// tests_index! +// { +// impls_basic, +// } diff --git a/module/core/impls_index/tests/inc/impls2_test.rs b/module/core/impls_index/tests/inc/impls2_test.rs index bb5d16eaab..20b83f0731 100644 --- a/module/core/impls_index/tests/inc/impls2_test.rs +++ b/module/core/impls_index/tests/inc/impls2_test.rs @@ -1,121 +1,119 @@ // use test_tools::exposed::*; use super::*; -use the_module::prelude::impls2; +use the_module::exposed::impls2; +use the_module::exposed::{ index }; // -tests_impls! +#[ test ] +fn impls_basic() { - fn impls_basic() + // test.case( "impls2 basic" ); { - // test.case( "impls2 basic" ); + impls2! { - - impls2! + fn f1() { - fn f1() - { - println!( "f1" ); - } - pub fn f2() - { - println!( "f2" ); - } - }; + println!( "f1" ); + } + pub fn f2() + { + println!( "f2" ); + } + }; - // trace_macros!( true ); - f1!(); - f2!(); - // trace_macros!( false ); + // trace_macros!( true ); + f1!(); + f2!(); + // trace_macros!( false ); - f1(); - f2(); + f1(); + f2(); - } + } - // test.case( "impls2 as" ); - { + // test.case( "impls2 as" ); + { - impls2! + impls2! + { + fn f1() { - fn f1() - { - println!( "f1" ); - } - pub fn f2() - { - println!( "f2" ); - } - }; + println!( "f1" ); + } + pub fn f2() + { + println!( "f2" ); + } + }; - // trace_macros!( true ); - f1!( as f1b ); - f2!( as f2b ); - // trace_macros!( false ); + // trace_macros!( true ); + f1!( as f1b ); + f2!( as f2b ); + // trace_macros!( false ); - f1b(); - f2b(); + f1b(); + f2b(); - } + } - // test.case( "impls2 as index" ); - { + // test.case( "impls2 as index" ); + { - impls2! + impls2! + { + fn f1() { - fn f1() - { - println!( "f1" ); - } - pub fn f2() - { - println!( "f2" ); - } - }; - - // trace_macros!( true ); - index! + println!( "f1" ); + } + pub fn f2() { - f1, - f2 as f2b, + println!( "f2" ); } - // trace_macros!( false ); - - f1(); - f2b(); + }; + // trace_macros!( true ); + index! + { + f1, + f2 as f2b, } + // trace_macros!( false ); - // test.case( "macro" ); - { + f1(); + f2b(); - impls2! + } + + // test.case( "macro" ); + { + + impls2! + { + fn f1() { - fn f1() + macro_rules! macro1 { - macro_rules! macro1 - { - ( $( $Arg : tt )* ) => { }; - } - macro1!(); + ( $( $Arg : tt )* ) => { }; } + macro1!(); } - - // trace_macros!( true ); - f1!(); - // trace_macros!( false ); - } + // trace_macros!( true ); + f1!(); + // trace_macros!( false ); + } + } // -tests_index! -{ - // fns, - impls_basic, -} +// tests_index! +// { +// // fns, +// impls_basic, +// } diff --git a/module/core/impls_index/tests/inc/impls3_test.rs b/module/core/impls_index/tests/inc/impls3_test.rs index 860acd126a..1fe454dfc7 100644 --- a/module/core/impls_index/tests/inc/impls3_test.rs +++ b/module/core/impls_index/tests/inc/impls3_test.rs @@ -1,5 +1,6 @@ use super::*; -use the_module::prelude::impls3; +use the_module::exposed::impls3; +use the_module::exposed::{ index }; // @@ -7,7 +8,7 @@ use the_module::prelude::impls3; fn basic() { - impls! + impls3! { fn f1() { diff --git a/module/core/impls_index/tests/inc/impls_basic_test.rs b/module/core/impls_index/tests/inc/impls_basic_test.rs index c488aec5a2..8a9ef8df85 100644 --- a/module/core/impls_index/tests/inc/impls_basic_test.rs +++ b/module/core/impls_index/tests/inc/impls_basic_test.rs @@ -1,6 +1,5 @@ use super::*; -#[ allow( unused_imports ) ] -use the_module::prelude::*; +use the_module::exposed::*; // trace_macros!( true ); tests_impls! diff --git a/module/core/impls_index/tests/inc/index_test.rs b/module/core/impls_index/tests/inc/index_test.rs index de1ed0d9be..561e1ba8ac 100644 --- a/module/core/impls_index/tests/inc/index_test.rs +++ b/module/core/impls_index/tests/inc/index_test.rs @@ -1,155 +1,151 @@ // use test_tools::exposed::*; use super::*; -use the_module::prelude::impls1; +use the_module::exposed::impls1; +use the_module::exposed::{ index }; // -tests_impls! +#[ test ] +fn empty_with_comma() { - - fn empty_with_comma() + // test.case( "impls1 basic" ); { - // test.case( "impls1 basic" ); - { - - impls1!(); - index!(); - - } + impls1!(); + index!(); } +} + +#[ test ] +fn empty_without_comma() +{ - fn empty_without_comma() + // test.case( "impls1 basic" ); { - // test.case( "impls1 basic" ); + impls1! { + }; - impls1! - { - }; - - index! - { - } - + index! + { } } +} + +#[ test ] +fn with_comma() +{ - fn with_comma() + // test.case( "impls1 basic" ); { - // test.case( "impls1 basic" ); + impls1! { - - impls1! + fn f1() -> i32 { - fn f1() -> i32 - { - println!( "f1" ); - 13 - } - }; - - index! - { - f1, + println!( "f1" ); + 13 } + }; - a_id!( f1(), 13 ); + index! + { + f1, } + a_id!( f1(), 13 ); } +} + +#[ test ] +fn without_comma() +{ - fn without_comma() + // test.case( "impls1 basic" ); { - // test.case( "impls1 basic" ); + impls1! { - - impls1! - { - fn f1() -> i32 - { - println!( "f1" ); - 13 - } - }; - - index! + fn f1() -> i32 { - f1 + println!( "f1" ); + 13 } + }; - a_id!( f1(), 13 ); + index! + { + f1 } + a_id!( f1(), 13 ); } +} + +#[ test ] +fn parentheses_with_comma() +{ - fn parentheses_with_comma() + // test.case( "impls1 basic" ); { - // test.case( "impls1 basic" ); + impls1! { - - impls1! + fn f1() -> i32 { - fn f1() -> i32 - { - println!( "f1" ); - 13 - } - }; - - index!( f1, ); + println!( "f1" ); + 13 + } + }; - a_id!( f1(), 13 ); - } + index!( f1, ); + a_id!( f1(), 13 ); } +} - fn parentheses_without_comma() +#[ test ] +fn parentheses_without_comma() +{ + + // test.case( "impls1 basic" ); { - // test.case( "impls1 basic" ); + impls1! { - - impls1! + fn f1() -> i32 { - fn f1() -> i32 - { - println!( "f1" ); - 13 - } - }; - - index!( f1 ); + println!( "f1" ); + 13 + } + }; - a_id!( f1(), 13 ); - } + index!( f1 ); + a_id!( f1(), 13 ); } } // -tests_index! -{ - - empty_with_comma, - empty_without_comma, - with_comma, - without_comma, - parentheses_with_comma, - parentheses_without_comma, - -} +// tests_index! +// { +// +// empty_with_comma, +// empty_without_comma, +// with_comma, +// without_comma, +// parentheses_with_comma, +// parentheses_without_comma, +// +// } diff --git a/module/core/impls_index/tests/inc/mod.rs b/module/core/impls_index/tests/inc/mod.rs index d7b9687e2f..105f2928cd 100644 --- a/module/core/impls_index/tests/inc/mod.rs +++ b/module/core/impls_index/tests/inc/mod.rs @@ -1,5 +1,10 @@ -use super::*; +use super:: +{ + the_module, + only_for_terminal_module, + a_id, +}; mod func_test; mod impls_basic_test; diff --git a/module/core/impls_index/tests/inc/tests_index_test.rs b/module/core/impls_index/tests/inc/tests_index_test.rs index 9c684d5a68..d6cbf4e3c6 100644 --- a/module/core/impls_index/tests/inc/tests_index_test.rs +++ b/module/core/impls_index/tests/inc/tests_index_test.rs @@ -1,155 +1,151 @@ // use test_tools::exposed::*; use super::*; -use the_module::prelude::impls1; +use the_module::exposed::impls1; +use the_module::exposed::{ tests_index }; // -tests_impls! +#[ test ] +fn empty_with_comma() { - - fn empty_with_comma() + // test.case( "impls1 basic" ); { - // test.case( "impls1 basic" ); - { - - impls1!(); - tests_index!(); - - } + impls1!(); + tests_index!(); } +} + +#[ test ] +fn empty_without_comma() +{ - fn empty_without_comma() + // test.case( "impls1 basic" ); { - // test.case( "impls1 basic" ); + impls1! { + }; - impls1! - { - }; - - tests_index! - { - } - + tests_index! + { } } +} + +#[ test ] +fn with_comma() +{ - fn with_comma() + // test.case( "impls1 basic" ); { - // test.case( "impls1 basic" ); + impls1! { - - impls1! + fn f1() -> i32 { - fn f1() -> i32 - { - println!( "f1" ); - 13 - } - }; - - tests_index! - { - f1, + println!( "f1" ); + 13 } + }; - a_id!( f1(), 13 ); + tests_index! + { + f1, } + a_id!( f1(), 13 ); } +} + +#[ test ] +fn without_comma() +{ - fn without_comma() + // test.case( "impls1 basic" ); { - // test.case( "impls1 basic" ); + impls1! { - - impls1! - { - fn f1() -> i32 - { - println!( "f1" ); - 13 - } - }; - - tests_index! + fn f1() -> i32 { - f1 + println!( "f1" ); + 13 } + }; - a_id!( f1(), 13 ); + tests_index! + { + f1 } + a_id!( f1(), 13 ); } +} + +#[ test ] +fn parentheses_with_comma() +{ - fn parentheses_with_comma() + // test.case( "impls1 basic" ); { - // test.case( "impls1 basic" ); + impls1! { - - impls1! + fn f1() -> i32 { - fn f1() -> i32 - { - println!( "f1" ); - 13 - } - }; - - tests_index!( f1, ); + println!( "f1" ); + 13 + } + }; - a_id!( f1(), 13 ); - } + tests_index!( f1, ); + a_id!( f1(), 13 ); } +} - fn parentheses_without_comma() +#[ test ] +fn parentheses_without_comma() +{ + + // test.case( "impls1 basic" ); { - // test.case( "impls1 basic" ); + impls1! { - - impls1! + fn f1() -> i32 { - fn f1() -> i32 - { - println!( "f1" ); - 13 - } - }; - - tests_index!( f1 ); + println!( "f1" ); + 13 + } + }; - a_id!( f1(), 13 ); - } + tests_index!( f1 ); + a_id!( f1(), 13 ); } } // -tests_index! -{ - - empty_with_comma, - empty_without_comma, - with_comma, - without_comma, - parentheses_with_comma, - parentheses_without_comma, - -} +// tests_index! +// { +// +// empty_with_comma, +// empty_without_comma, +// with_comma, +// without_comma, +// parentheses_with_comma, +// parentheses_without_comma, +// +// } diff --git a/module/core/impls_index/tests/tests.rs b/module/core/impls_index/tests/tests.rs index 7d4038e715..b96684ac4a 100644 --- a/module/core/impls_index/tests/tests.rs +++ b/module/core/impls_index/tests/tests.rs @@ -1,3 +1,4 @@ +#![ allow( unused_imports ) ] include!( "../../../../module/step/meta/src/module/terminal.rs" ); diff --git a/module/core/interval_adapter/src/lib.rs b/module/core/interval_adapter/src/lib.rs index 4684d69850..3fcc39e3f1 100644 --- a/module/core/interval_adapter/src/lib.rs +++ b/module/core/interval_adapter/src/lib.rs @@ -4,7 +4,7 @@ #![ doc( html_root_url = "https://docs.rs/winterval/latest/winterval/" ) ] #![ doc = include_str!( concat!( env!( "CARGO_MANIFEST_DIR" ), "/", "Readme.md" ) ) ] -/// Internal namespace. +/// Define a private namespace for all its items. #[ cfg( feature = "enabled" ) ] mod private { diff --git a/module/core/macro_tools/src/attr.rs b/module/core/macro_tools/src/attr.rs index d87c7865b2..15c0d1e69d 100644 --- a/module/core/macro_tools/src/attr.rs +++ b/module/core/macro_tools/src/attr.rs @@ -2,7 +2,7 @@ //! Attributes analyzys and manipulation. //! -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::*; diff --git a/module/core/macro_tools/src/attr_prop.rs b/module/core/macro_tools/src/attr_prop.rs index a5e3aeaecd..8ffa3d9cab 100644 --- a/module/core/macro_tools/src/attr_prop.rs +++ b/module/core/macro_tools/src/attr_prop.rs @@ -102,7 +102,7 @@ mod boolean_optional; mod syn; mod syn_optional; -/// Internal namespace. +/// Define a private namespace for all its items. mod private { // use crate::*; diff --git a/module/core/macro_tools/src/components.rs b/module/core/macro_tools/src/components.rs index 5ff8c6fbe5..4e8b2ccf20 100644 --- a/module/core/macro_tools/src/components.rs +++ b/module/core/macro_tools/src/components.rs @@ -2,7 +2,7 @@ //! Type-based assigning. //! -/// Internal namespace. +/// Define a private namespace for all its items. mod private { } diff --git a/module/core/macro_tools/src/container_kind.rs b/module/core/macro_tools/src/container_kind.rs index b7cedc6149..6dc2719925 100644 --- a/module/core/macro_tools/src/container_kind.rs +++ b/module/core/macro_tools/src/container_kind.rs @@ -2,7 +2,7 @@ //! Determine kind of a container. //! -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::*; diff --git a/module/core/macro_tools/src/ct.rs b/module/core/macro_tools/src/ct.rs index dd3778e29b..1264aea393 100644 --- a/module/core/macro_tools/src/ct.rs +++ b/module/core/macro_tools/src/ct.rs @@ -2,7 +2,7 @@ //! Compile-time tools. //! -/// Internal namespace. +/// Define a private namespace for all its items. mod private { } diff --git a/module/core/macro_tools/src/derive.rs b/module/core/macro_tools/src/derive.rs index 84ab933fb4..dacf84f8e7 100644 --- a/module/core/macro_tools/src/derive.rs +++ b/module/core/macro_tools/src/derive.rs @@ -2,7 +2,7 @@ //! Macro helpers around derive macro and structure [`syn::DeriveInput`]. //! -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::*; diff --git a/module/core/macro_tools/src/diag.rs b/module/core/macro_tools/src/diag.rs index 0f8fa6f6e8..81138cd382 100644 --- a/module/core/macro_tools/src/diag.rs +++ b/module/core/macro_tools/src/diag.rs @@ -2,7 +2,7 @@ //! Macro helpers. //! -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::*; diff --git a/module/core/macro_tools/src/equation.rs b/module/core/macro_tools/src/equation.rs index 6a419dfe07..3d89aa4ba4 100644 --- a/module/core/macro_tools/src/equation.rs +++ b/module/core/macro_tools/src/equation.rs @@ -2,7 +2,7 @@ //! Attributes analyzys and manipulation. //! -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::*; diff --git a/module/core/macro_tools/src/generic_args.rs b/module/core/macro_tools/src/generic_args.rs index 16636e8ac0..1cd40e8f7a 100644 --- a/module/core/macro_tools/src/generic_args.rs +++ b/module/core/macro_tools/src/generic_args.rs @@ -2,7 +2,7 @@ //! This module provides utilities to handle and manipulate generic arguments using the `syn` crate. It includes traits and functions for transforming, merging, and managing generic parameters within procedural macros, enabling seamless syntactic analysis and code generation. //! -/// Internal namespace. +/// Define a private namespace for all its items. mod private { diff --git a/module/core/macro_tools/src/generic_params.rs b/module/core/macro_tools/src/generic_params.rs index 599b5ca7cb..fac0859aa1 100644 --- a/module/core/macro_tools/src/generic_params.rs +++ b/module/core/macro_tools/src/generic_params.rs @@ -2,7 +2,7 @@ //! Functions and structures to handle and manipulate generic parameters using the `syn` crate. It's designed to support macro-driven code generation by simplifying, merging, extracting, and decomposing `syn::Generics`. //! -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::*; diff --git a/module/core/macro_tools/src/item.rs b/module/core/macro_tools/src/item.rs index 605124e8a5..d82f484847 100644 --- a/module/core/macro_tools/src/item.rs +++ b/module/core/macro_tools/src/item.rs @@ -3,7 +3,7 @@ //! to manipulate the structure of items, handle different kinds of fields, and provide a structured approach to //! organizing the codebase into different access levels. -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::*; diff --git a/module/core/macro_tools/src/item_struct.rs b/module/core/macro_tools/src/item_struct.rs index 1855fa67b3..dd8f31f739 100644 --- a/module/core/macro_tools/src/item_struct.rs +++ b/module/core/macro_tools/src/item_struct.rs @@ -2,7 +2,7 @@ //! Parse structures, like `struct { a : i32 }`. //! -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::*; diff --git a/module/core/macro_tools/src/iter.rs b/module/core/macro_tools/src/iter.rs index 6ad9773801..71bf438658 100644 --- a/module/core/macro_tools/src/iter.rs +++ b/module/core/macro_tools/src/iter.rs @@ -2,7 +2,7 @@ //! Tailored iterator. //! -/// Internal namespace. +/// Define a private namespace for all its items. mod private { } diff --git a/module/core/macro_tools/src/kw.rs b/module/core/macro_tools/src/kw.rs index c7910e7571..4a29a6879d 100644 --- a/module/core/macro_tools/src/kw.rs +++ b/module/core/macro_tools/src/kw.rs @@ -2,7 +2,7 @@ //! Keywords //! -/// Internal namespace. +/// Define a private namespace for all its items. mod private { // use crate::*; diff --git a/module/core/macro_tools/src/lib.rs b/module/core/macro_tools/src/lib.rs index a11fdf7f69..8f20b5d77b 100644 --- a/module/core/macro_tools/src/lib.rs +++ b/module/core/macro_tools/src/lib.rs @@ -4,7 +4,7 @@ #![ doc = include_str!( concat!( env!( "CARGO_MANIFEST_DIR" ), "/", "Readme.md" ) ) ] -/// Internal namespace. +/// Define a private namespace for all its items. #[ cfg( feature = "enabled" ) ] mod private { diff --git a/module/core/macro_tools/src/name.rs b/module/core/macro_tools/src/name.rs index a9f53887b0..a5185ea8c4 100644 --- a/module/core/macro_tools/src/name.rs +++ b/module/core/macro_tools/src/name.rs @@ -2,7 +2,7 @@ //! Tait to getn name of an Item. //! -/// Internal namespace. +/// Define a private namespace for all its items. mod private { diff --git a/module/core/macro_tools/src/phantom.rs b/module/core/macro_tools/src/phantom.rs index f4bc1ec350..507a7fe0d1 100644 --- a/module/core/macro_tools/src/phantom.rs +++ b/module/core/macro_tools/src/phantom.rs @@ -4,7 +4,7 @@ //! Functions and structures to handle and manipulate `PhantomData` fields in structs using the `syn` crate. These utilities ensure that generic parameters are correctly accounted for in type checking, even if they are not directly used in the struct's fields. //! -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::*; diff --git a/module/core/macro_tools/src/punctuated.rs b/module/core/macro_tools/src/punctuated.rs index 2257904a81..893e8459fb 100644 --- a/module/core/macro_tools/src/punctuated.rs +++ b/module/core/macro_tools/src/punctuated.rs @@ -4,7 +4,7 @@ //! This module provides functionality to manipulate and ensure correct punctuation in `syn::punctuated::Punctuated` collections, commonly used in procedural macros to represent sequences of elements separated by punctuation marks, such as commas. //! -/// Internal namespace. +/// Define a private namespace for all its items. mod private { diff --git a/module/core/macro_tools/src/quantifier.rs b/module/core/macro_tools/src/quantifier.rs index 379c38e9a4..a1c3cb7833 100644 --- a/module/core/macro_tools/src/quantifier.rs +++ b/module/core/macro_tools/src/quantifier.rs @@ -2,7 +2,7 @@ //! Quantifiers like Pair and Many. //! -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::*; diff --git a/module/core/macro_tools/src/struct_like.rs b/module/core/macro_tools/src/struct_like.rs index 1ec494be89..5b9652b506 100644 --- a/module/core/macro_tools/src/struct_like.rs +++ b/module/core/macro_tools/src/struct_like.rs @@ -2,7 +2,7 @@ //! Parse structures, like `struct { a : i32 }`. //! -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::*; diff --git a/module/core/macro_tools/src/tokens.rs b/module/core/macro_tools/src/tokens.rs index 0d7fd568e8..4785c8dfc8 100644 --- a/module/core/macro_tools/src/tokens.rs +++ b/module/core/macro_tools/src/tokens.rs @@ -2,7 +2,7 @@ //! Attributes analyzys and manipulation. //! -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::*; diff --git a/module/core/macro_tools/src/typ.rs b/module/core/macro_tools/src/typ.rs index 03b535081e..1c1f0e39e5 100644 --- a/module/core/macro_tools/src/typ.rs +++ b/module/core/macro_tools/src/typ.rs @@ -2,7 +2,7 @@ //! Advanced syntax elements. //! -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::*; diff --git a/module/core/macro_tools/src/typed.rs b/module/core/macro_tools/src/typed.rs index 3eeeba271f..5e75476fb1 100644 --- a/module/core/macro_tools/src/typed.rs +++ b/module/core/macro_tools/src/typed.rs @@ -2,7 +2,7 @@ //! Typed parsing. //! -/// Internal namespace. +/// Define a private namespace for all its items. mod private { // use crate::*; diff --git a/module/core/mem_tools/src/mem.rs b/module/core/mem_tools/src/mem.rs index e35cb611cd..8a540d97e2 100644 --- a/module/core/mem_tools/src/mem.rs +++ b/module/core/mem_tools/src/mem.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { // use crate::own::*; diff --git a/module/core/meta_tools/Cargo.toml b/module/core/meta_tools/Cargo.toml index 842fa3143e..ec2054076a 100644 --- a/module/core/meta_tools/Cargo.toml +++ b/module/core/meta_tools/Cargo.toml @@ -24,47 +24,45 @@ workspace = true features = [ "full" ] all-features = false - - [features] default = [ "enabled", "meta_for_each", "meta_impls_index", - # "meta_mod_interface", - # "meta_constructors", + "mod_interface", "meta_idents_concat", ] full = [ "enabled", "meta_for_each", "meta_impls_index", - # "meta_mod_interface", - # "meta_constructors", + "mod_interface", "meta_idents_concat", ] no_std = [] use_alloc = [ "no_std" ] -enabled = [] +enabled = [ + "for_each/enabled", + "impls_index/enabled", + "mod_interface/enabled", +] -meta_for_each = [ "for_each/enabled" ] -meta_impls_index = [ "impls_index/enabled" ] -meta_mod_interface = [ "mod_interface/enabled" ] -# xxx : qqq : make mod_interface optional maybe +meta_for_each = [ "for_each/enabled", "dep:for_each" ] +meta_impls_index = [ "impls_index/enabled", "dep:impls_index" ] +mod_interface = [ "mod_interface/enabled", "dep:mod_interface" ] # meta_constructors = [ "literally" ] -meta_idents_concat = [ "paste" ] +meta_idents_concat = [ "dep:paste" ] [dependencies] # ## external -# literally = { version = "~0.1.3", optional = true, default-features = false } paste = { workspace = true, optional = true, default-features = false } ## internal -impls_index = { workspace = true } -for_each = { workspace = true } -mod_interface = { workspace = true, features = [ "default" ] } +for_each = { workspace = true, optional = true } +impls_index = { workspace = true, optional = true } +mod_interface = { workspace = true, optional = true } [dev-dependencies] test_tools = { workspace = true } diff --git a/module/core/meta_tools/src/lib.rs b/module/core/meta_tools/src/lib.rs index 391eaf5050..e31d911ffe 100644 --- a/module/core/meta_tools/src/lib.rs +++ b/module/core/meta_tools/src/lib.rs @@ -10,35 +10,69 @@ pub mod dependency { - // #[ cfg( feature = "meta_mod_interface" ) ] pub use ::mod_interface; #[ cfg( feature = "meta_for_each" ) ] pub use ::for_each; #[ cfg( feature = "meta_impls_index" ) ] pub use ::impls_index; - - // #[ cfg( feature = "meta_constructors" ) ] - // pub use ::literally; #[ cfg( feature = "meta_idents_concat" ) ] pub use ::paste; - // #[ cfg( feature = "former" ) ] - // pub use ::former; - // #[ cfg( feature = "options" ) ] - // pub use ::woptions; - } mod private {} // -// qqq : meta interface should be optional dependancy. please fix writing equivalent code manually +// // qqq : meta interface should be optional dependancy. please fix writing equivalent code manually +// #[ cfg( feature = "enabled" ) ] +// mod_interface::mod_interface! +// { +// // #![ debug ] +// +// layer meta; +// +// } + +pub mod meta; + +#[ cfg( feature = "enabled" ) ] +#[ allow( unused_imports ) ] +pub use own::*; + +/// Own namespace of the module. +#[ cfg( feature = "enabled" ) ] +#[ allow( unused_imports ) ] +pub mod own +{ + use super::*; + pub use meta::orphan::*; +} + +/// Orphan namespace of the module. #[ cfg( feature = "enabled" ) ] -mod_interface::mod_interface! +#[ allow( unused_imports ) ] +pub mod orphan { - // #![ debug ] + use super::*; + pub use exposed::*; +} - layer meta; +/// Exposed namespace of the module. +#[ cfg( feature = "enabled" ) ] +#[ allow( unused_imports ) ] +pub mod exposed +{ + use super::*; + pub use prelude::*; + pub use meta::exposed::*; +} +/// Prelude to use essentials: `use my_module::prelude::*`. +#[ cfg( feature = "enabled" ) ] +#[ allow( unused_imports ) ] +pub mod prelude +{ + use super::*; + pub use meta::prelude::*; } diff --git a/module/core/meta_tools/src/meta.rs b/module/core/meta_tools/src/meta.rs index 1cda0b024d..1047857beb 100644 --- a/module/core/meta_tools/src/meta.rs +++ b/module/core/meta_tools/src/meta.rs @@ -2,39 +2,82 @@ //! Collection of general purpose meta tools. //! -/// Internal namespace. +/// Define a private namespace for all its items. mod private { } // +// #[ cfg( feature = "enabled" ) ] +// mod_interface::mod_interface! +// { +// #![ debug ] +// +// #[ cfg( feature = "meta_impls_index" ) ] +// use ::impls_index; +// #[ cfg( feature = "meta_for_each" ) ] +// use ::for_each; +// // #[ cfg( feature = "meta_mod_interface" ) ] +// use ::mod_interface; +// // #[ cfg( feature = "meta_mod_interface" ) ] +// prelude use ::mod_interface::mod_interface; +// +// #[ cfg( feature = "meta_idents_concat" ) ] +// prelude use ::paste::paste as meta_idents_concat; +// +// } + +#[ cfg( feature = "enabled" ) ] +#[ allow( unused_imports ) ] +pub use own::*; + +/// Own namespace of the module. +#[ cfg( feature = "enabled" ) ] +pub mod own +{ + use super::*; + pub use ::impls_index::orphan::*; + pub use ::for_each::orphan::*; + pub use ::mod_interface::orphan::*; + pub use orphan::*; +} + +/// Orphan namespace of the module. #[ cfg( feature = "enabled" ) ] -mod_interface::mod_interface! +#[ allow( unused_imports ) ] +pub mod orphan { + use super::*; + + // pub use ::impls_index; + // pub use ::for_each; + // pub use ::mod_interface; - #[ cfg( feature = "meta_impls_index" ) ] - use ::impls_index; - #[ cfg( feature = "meta_for_each" ) ] - use ::for_each; - // #[ cfg( feature = "meta_mod_interface" ) ] - use ::mod_interface; - // #[ cfg( feature = "meta_mod_interface" ) ] - prelude use ::mod_interface::mod_interface; - - // #[ cfg( feature = "meta_constructors" ) ] - // prelude use ::literally::*; - #[ cfg( feature = "meta_idents_concat" ) ] - prelude use ::paste::paste as meta_idents_concat; - - // #[ cfg( feature = "options" ) ] - // use ::woptions; - // #[ cfg( feature = "options" ) ] - // prelude use ::woptions as options; - - // #[ cfg( feature = "former" ) ] - // use ::former; - // #[ cfg( feature = "former" ) ] - // prelude use ::former as former; + pub use exposed::*; +} +/// Exposed namespace of the module. +#[ cfg( feature = "enabled" ) ] +#[ allow( unused_imports ) ] +pub mod exposed +{ + use super::*; + pub use prelude::*; + pub use super::super::meta; + pub use ::impls_index::exposed::*; + pub use ::for_each::exposed::*; + pub use ::mod_interface::exposed::*; + pub use ::paste::paste as meta_idents_concat; +} + +/// Prelude to use essentials: `use my_module::prelude::*`. +#[ cfg( feature = "enabled" ) ] +#[ allow( unused_imports ) ] +pub mod prelude +{ + use super::*; + pub use ::impls_index::prelude::*; + pub use ::for_each::prelude::*; + pub use ::mod_interface::prelude::*; } diff --git a/module/core/mod_interface/Readme.md b/module/core/mod_interface/Readme.md index d9b6f668c5..0bb7e9b255 100644 --- a/module/core/mod_interface/Readme.md +++ b/module/core/mod_interface/Readme.md @@ -11,15 +11,45 @@ Protocol of modularity unifying interface. The `mod_interface` crate provides a structured approach to modularity, addressing two key challenges in software development: -1. **Meaningful Namespace Structuring**: The crate enables developers to organize program entities into meaningful namespaces ( read modules ) without additional development overhead. This is achieved through a set of auto-importing rules and a flexible inversion of control mechanism, allowing parent namespaces to delegate control over its items to child namespaces. This approach ensures that each namespace is self-contained and meaningful, promoting better organization and modularity. +1. **Meaningful Namespace Structuring**: The crate enables developers to organize program entities into meaningful namespaces ( read modules ) without additional development overhead. This is achieved through a set of auto-importing rules and a flexible inversion of control mechanism, allowing parent layers ( namespaces or modules ) to delegate control over its items to child layers. This approach ensures that each namespace is self-contained and meaningful, promoting better organization and modularity. 2. **Enhanced Readability and Tooling Independence**: By requiring a `mod private` section that lists all items ( read functions, structures, traits, types ) the `mod_interface` macro encourages developers to create a concise list of items at the beginning or end of a file. This improves readability, encourages refactoring, and reduces cognitive load by providing a clear, high-level grouping of items. Code tooling is not always reliable and can sometimes be counterproductive by automating tasks that should be done manually to achieve more concise code. While code tooling like `rust_analyzer` are useful, this approach minimizes reliance on them, making the program's structure easier to understand and manage. While some may argue that inversion of control over namespaces may not always achieve the desired outcome, and code tooling can be sufficient, the `mod_interface` crate offers a cathartic solution for designing complex systems where tooling and triditional structuring often fall short. By promoting a clear and organized structure, it helps developers grasp the semantics of their programs more holistically. -### Example : Trivial +### Basic Concepts -This example demonstrates how to use the `mod_interface` crate to organize a Rust program into structured namespaces. The code is divided into a library file (`child.rs`) and a main function. The library file defines a module with private functions and uses the `mod_interface` macro to specify which functions should be exposed in different namespaces. The main function then tests the visibility and accessibility of these functions. +In the `mod_interface` crate, the concepts of layers and namespaces are central to its modularity approach. Here's a refined explanation: + +- **Namespaces**: These are standard Rust modules that help organize code into logical groups. +- **Layers**: A layer is a specialized module that contains a set of predefined submodules, referred to as chapters. These chapters dictate how the contents of the module are propagated to parent layers. + +The chapters within a layer are: + +- **Private Chapter (`private`)**: This is where all the code and entities are initially defined. It is not accessible outside the module. +- **Public Chapter (`own`)**: Contains items that are not propagated to any parent layers. They remain within the module. +- **Public Chapter (`orphan`)**: Shares its contents with the immediate parent layer only. +- **Public Chapter (`exposed`)**: Propagates its contents to all parent layers, making them accessible throughout the hierarchy. +- **Public Chapter (`prelude`)**: Similar to `exposed`, but also serves as a recommendation for other crates to implicitly import its contents, akin to the prelude in the [Rust standard library](https://doc.rust-lang.org/std/prelude/index.html). + +Developers should define all entities within the `private` chapter and then re-export them through the other four chapters based on the desired propagation strategy. + +### Syntax of `mod_interface` Macro + +The `mod_interface` macro provides several directives to manage the relationships between layers and entities: + +- **`layer `**: Establishes a relationship where the current layer uses a child layer. +- **`use `**: Allows the current layer to use another layer defined elsewhere. +- **`reuse `**: Enables the current layer to reuse a layer defined anywhere, promoting code reuse. +- **` use `**: Allows the current layer to use an entity defined anywhere, with the specified promotion stategy (``). + +These directives provide flexibility in organizing and managing the modular structure of a Rust program, enhancing both readability and maintainability. + +### Example: Using Layers and Entities + +In this example, we demonstrate the basic use case of one layer utilizing another layer. For a module to be used as a layer, it must contain all the necessary chapters: `orphan`, `exposed`, and `prelude`. Generally, a layer should also have the `own` and `private` chapters, but these are typically not modified directly by the user unless explicitly defined, with the `private` chapter remaining inaccessible from outside the module. + +Below is a simple example where a parent layer imports a `child` layer. The `child` layer defines several functions, each with a different propagation strategy, resulting in each function being placed in a different chapter of the parent layer, while some functions do not reach the parent layer at all. ```rust use mod_interface::mod_interface; @@ -62,7 +92,6 @@ crate::mod_interface! use super::child; } - fn main() { @@ -125,29 +154,34 @@ pub mod child /// Own namespace of the module. pub mod own { - pub use super::orphan::*; - pub use super::private::my_thing; + use super::*; + pub use orphan::*; + pub use private::my_thing; } /// Orphan namespace of the module. pub mod orphan { - pub use super::exposed::*; - pub use super::private::orphan_thing; + use super::*; + pub use exposed::*; + pub use private::orphan_thing; } /// Exposed namespace of the module. pub mod exposed { - pub use super::prelude::*; - pub use super::private::exposed_thing; + use super::*; + pub use prelude::*; + pub use private::exposed_thing; } /// Prelude to use essentials: `use my_module::prelude::*`. pub mod prelude { - pub use super::private::prelude_thing; + use super::*; + pub use private::prelude_thing; } + } // Priave namespaces is necessary. @@ -161,7 +195,7 @@ pub mod own { use super::*; pub use orphan::*; - pub use super::child::orphan::*; + pub use child::orphan::*; pub use super::child; } @@ -179,7 +213,7 @@ pub mod exposed { use super::*; pub use prelude::*; - pub use super::child::exposed::*; + pub use child::exposed::*; } /// Prelude to use essentials: `use my_module::prelude::*`. @@ -187,7 +221,7 @@ pub mod exposed pub mod prelude { use super::*; - pub use super::child::prelude::*; + pub use child::prelude::*; } // @@ -229,6 +263,41 @@ fn main() +As you can see: + +- The content of the `prelude` chapter is automatically propagated into the `exposed` chapter of the same layer. +- The content of the `exposed` chapter is automatically propagated into the `orphan` chapter of the same layer. +- The content of the `orphan` chapter is automatically propagated into the `own` chapter of the same layer. +- The content of the `own` chapter is not automatically propagated anywhere. + +### `layer ` vs `use ` + +The `use ;` syntax is used to import a layer from anywhere within the project or even from external crates. This provides flexibility in how layers are organized, as the layer being used does not need to be a direct submodule of the current module. It allows you to bring any accessible layer into the current scope without enforcing a specific file structure. The visibility of the imported layer remains as it is defined in its original location, and this syntax does not inherently change that visibility. + +In contrast, the `layer ` syntax is used to establish a hierarchical relationship where the current module uses a child layer. This requires the child layer to be a direct submodule, meaning it must be physically present in the file structure as a submodule. The `layer ` syntax implies `pub mod layer1`, making the child layer publicly accessible as a submodule. This enforces a specific organizational structure, where the child layer is part of the current module's hierarchy, and its contents are directly accessible according to the defined propagation strategies. + +Thus, `layer ` acts as a shortcut, combining the definition of a reference to a module file and using it, while `use ` uses a module that is already defined somewhere, not necessarily in the same crate. + +### `reuse ` vs `use ` + +The `reuse ` syntax treats the child layer as an integral part of the parent layer, so the normal rules of propagation do not apply to the content of the child layer. Specifically, the `own` chapter of the child layer is imported into the `own` chapter of the parent layer, and the `orphan` chapter of the child layer is imported into the `orphan` chapter of the parent layer. + +In contrast, `use ` follows the standard propagation rules: + +- `child::own` is not propagated. +- `child::orphan` is imported into `parent::own`. +- `child::exposed` is imported into `parent::exposed`. +- `child::prelude` is imported into `parent::prelude`. + +For `reuse `, the propagation is as follows: + +- `child::own` is imported into `parent::own`. +- `child::orphan` is imported into `parent::orphan`. +- `child::exposed` is imported into `parent::exposed`. +- `child::prelude` is imported into `parent::prelude`. + +`reusing` does not impact parent of parent or child of child. + ### Debugging To debug module interface use directive `#![ debug ]` in macro `mod_interface`. Let's update the main file of the example : diff --git a/module/core/mod_interface/examples/mod_interface_trivial/Readme.md b/module/core/mod_interface/examples/mod_interface_trivial/Readme.md index 343322a31c..e7b67c25d1 100644 --- a/module/core/mod_interface/examples/mod_interface_trivial/Readme.md +++ b/module/core/mod_interface/examples/mod_interface_trivial/Readme.md @@ -1,11 +1,9 @@ -# Sample +### Example: Using Layers and Entities [![discord](https://img.shields.io/discord/872391416519737405?color=eee&logo=discord&logoColor=eee&label=ask)](https://discord.gg/m3YfbXpUUY) [![Open in Gitpod](https://raster.shields.io/static/v1?label=try&message=online&color=eee&logo=gitpod&logoColor=eee)](https://gitpod.io/#RUN_PATH=sample%2Frust%2Fmod_interface_trivial,SAMPLE_FILE=.%2Fsrc%2Fmain.rs/https://github.com/Wandalen/wTools) [![docs.rs](https://raster.shields.io/static/v1?label=docs&message=online&color=eee&logo=docsdotrs&logoColor=eee)](https://docs.rs/mod_interface) -A sample demonstrates basic usage of macro `mod_interface`. +In this example, we demonstrate the basic use case of one layer utilizing another layer. For a module to be used as a layer, it must contain all the necessary chapters: `orphan`, `exposed`, and `prelude`. Generally, a layer should also have the `own` and `private` chapters, but these are typically not modified directly by the user unless explicitly defined, with the `private` chapter remaining inaccessible from outside the module. -In file `inner.rs` demonstrated how to generate module interface from namespace `private` and its public routine. - -In file `main.rs` demonstrated how to generate module interface from layer ( file with full module interface ). +Below is a simple example where a parent layer imports a `child` layer. The `child` layer defines several functions, each with a different propagation strategy, resulting in each function being placed in a different chapter of the parent layer, while some functions do not reach the parent layer at all. diff --git a/module/core/mod_interface/tests/inc/derive/micro_modules_glob/mod.rs b/module/core/mod_interface/tests/inc/derive/micro_modules_glob/mod.rs index b9c78c9198..f567778739 100644 --- a/module/core/mod_interface/tests/inc/derive/micro_modules_glob/mod.rs +++ b/module/core/mod_interface/tests/inc/derive/micro_modules_glob/mod.rs @@ -1,7 +1,7 @@ // use super::*; -/// Internal namespace. +/// Define a private namespace for all its items. mod private { pub struct Struct1; diff --git a/module/core/mod_interface/tests/inc/derive/reuse_basic/mod.rs b/module/core/mod_interface/tests/inc/derive/reuse_basic/mod.rs index 89ae6afbe8..8ee5259142 100644 --- a/module/core/mod_interface/tests/inc/derive/reuse_basic/mod.rs +++ b/module/core/mod_interface/tests/inc/derive/reuse_basic/mod.rs @@ -1,7 +1,7 @@ // use super::*; -/// Internal namespace. +/// Define a private namespace for all its items. mod private { } diff --git a/module/core/mod_interface_meta/src/impls.rs b/module/core/mod_interface_meta/src/impls.rs index 84fd04d881..81c6cec066 100644 --- a/module/core/mod_interface_meta/src/impls.rs +++ b/module/core/mod_interface_meta/src/impls.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::*; diff --git a/module/core/mod_interface_meta/src/record.rs b/module/core/mod_interface_meta/src/record.rs index 70e8f289ec..aeb6a696eb 100644 --- a/module/core/mod_interface_meta/src/record.rs +++ b/module/core/mod_interface_meta/src/record.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::*; diff --git a/module/core/mod_interface_meta/src/use_tree.rs b/module/core/mod_interface_meta/src/use_tree.rs index 2191171530..3f51fccc22 100644 --- a/module/core/mod_interface_meta/src/use_tree.rs +++ b/module/core/mod_interface_meta/src/use_tree.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use macro_tools::prelude::*; diff --git a/module/core/mod_interface_meta/src/visibility.rs b/module/core/mod_interface_meta/src/visibility.rs index acece0cb4f..4e229ed21c 100644 --- a/module/core/mod_interface_meta/src/visibility.rs +++ b/module/core/mod_interface_meta/src/visibility.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use macro_tools::prelude::*; diff --git a/module/core/process_tools/src/environment.rs b/module/core/process_tools/src/environment.rs index 6ba4ba20fd..31d20aa9f0 100644 --- a/module/core/process_tools/src/environment.rs +++ b/module/core/process_tools/src/environment.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { diff --git a/module/core/process_tools/src/process.rs b/module/core/process_tools/src/process.rs index 8636c628b5..d58e95455a 100644 --- a/module/core/process_tools/src/process.rs +++ b/module/core/process_tools/src/process.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { // use crate::*; diff --git a/module/core/program_tools/src/program.rs b/module/core/program_tools/src/program.rs index 70d66a7ead..90737df823 100644 --- a/module/core/program_tools/src/program.rs +++ b/module/core/program_tools/src/program.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { diff --git a/module/core/pth/src/as_path.rs b/module/core/pth/src/as_path.rs index b94a4cf4d4..693532a081 100644 --- a/module/core/pth/src/as_path.rs +++ b/module/core/pth/src/as_path.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { #[ allow( unused_imports ) ] diff --git a/module/core/pth/src/path.rs b/module/core/pth/src/path.rs index 7907a3268a..504dcdd25f 100644 --- a/module/core/pth/src/path.rs +++ b/module/core/pth/src/path.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { diff --git a/module/core/pth/src/path/absolute_path.rs b/module/core/pth/src/path/absolute_path.rs index 13a9686207..c80f0ce2c1 100644 --- a/module/core/pth/src/path/absolute_path.rs +++ b/module/core/pth/src/path/absolute_path.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::*; diff --git a/module/core/pth/src/path/canonical_path.rs b/module/core/pth/src/path/canonical_path.rs index b7a871af4d..dd8a6957c6 100644 --- a/module/core/pth/src/path/canonical_path.rs +++ b/module/core/pth/src/path/canonical_path.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { diff --git a/module/core/pth/src/path/current_path.rs b/module/core/pth/src/path/current_path.rs index cc5fe4aaaa..8ddf322b2a 100644 --- a/module/core/pth/src/path/current_path.rs +++ b/module/core/pth/src/path/current_path.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { diff --git a/module/core/pth/src/path/native_path.rs b/module/core/pth/src/path/native_path.rs index 09dfaaed62..80b75715b2 100644 --- a/module/core/pth/src/path/native_path.rs +++ b/module/core/pth/src/path/native_path.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { diff --git a/module/core/pth/src/transitive.rs b/module/core/pth/src/transitive.rs index 93bbcd3e10..ce1f366765 100644 --- a/module/core/pth/src/transitive.rs +++ b/module/core/pth/src/transitive.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { // xxx : move to derive_tools diff --git a/module/core/pth/src/try_into_cow_path.rs b/module/core/pth/src/try_into_cow_path.rs index b9f04524ce..af03344f74 100644 --- a/module/core/pth/src/try_into_cow_path.rs +++ b/module/core/pth/src/try_into_cow_path.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::*; diff --git a/module/core/pth/src/try_into_path.rs b/module/core/pth/src/try_into_path.rs index 29f508ec1b..979ee754f9 100644 --- a/module/core/pth/src/try_into_path.rs +++ b/module/core/pth/src/try_into_path.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { #[ allow( unused_imports ) ] diff --git a/module/core/reflect_tools/src/reflect.rs b/module/core/reflect_tools/src/reflect.rs index 0cde174ac9..3d363b1c09 100644 --- a/module/core/reflect_tools/src/reflect.rs +++ b/module/core/reflect_tools/src/reflect.rs @@ -52,7 +52,7 @@ // qqq : make the example working. use tests for inpsisrations -/// Internal namespace. +/// Define a private namespace for all its items. mod private { } diff --git a/module/core/reflect_tools/src/reflect/axiomatic.rs b/module/core/reflect_tools/src/reflect/axiomatic.rs index dcc6f044c8..2a092dfd0b 100644 --- a/module/core/reflect_tools/src/reflect/axiomatic.rs +++ b/module/core/reflect_tools/src/reflect/axiomatic.rs @@ -4,7 +4,7 @@ use super::*; -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use super::*; diff --git a/module/core/reflect_tools/src/reflect/entity_array.rs b/module/core/reflect_tools/src/reflect/entity_array.rs index afe3363b7c..3a9e592116 100644 --- a/module/core/reflect_tools/src/reflect/entity_array.rs +++ b/module/core/reflect_tools/src/reflect/entity_array.rs @@ -4,7 +4,7 @@ use super::*; -/// Internal namespace. +/// Define a private namespace for all its items. pub mod private { use super::*; diff --git a/module/core/reflect_tools/src/reflect/entity_hashmap.rs b/module/core/reflect_tools/src/reflect/entity_hashmap.rs index 97d9a821c9..21f7a04f35 100644 --- a/module/core/reflect_tools/src/reflect/entity_hashmap.rs +++ b/module/core/reflect_tools/src/reflect/entity_hashmap.rs @@ -4,7 +4,7 @@ use super::*; -/// Internal namespace. +/// Define a private namespace for all its items. pub mod private { use super::*; diff --git a/module/core/reflect_tools/src/reflect/entity_hashset.rs b/module/core/reflect_tools/src/reflect/entity_hashset.rs index ba48a7a189..84803f0c77 100644 --- a/module/core/reflect_tools/src/reflect/entity_hashset.rs +++ b/module/core/reflect_tools/src/reflect/entity_hashset.rs @@ -4,7 +4,7 @@ use super::*; -/// Internal namespace. +/// Define a private namespace for all its items. pub mod private { use super::*; diff --git a/module/core/reflect_tools/src/reflect/entity_slice.rs b/module/core/reflect_tools/src/reflect/entity_slice.rs index e396f8bcf9..1584c874f2 100644 --- a/module/core/reflect_tools/src/reflect/entity_slice.rs +++ b/module/core/reflect_tools/src/reflect/entity_slice.rs @@ -4,7 +4,7 @@ use super::*; -/// Internal namespace. +/// Define a private namespace for all its items. pub mod private { use super::*; diff --git a/module/core/reflect_tools/src/reflect/entity_vec.rs b/module/core/reflect_tools/src/reflect/entity_vec.rs index c559136729..ec74a41b00 100644 --- a/module/core/reflect_tools/src/reflect/entity_vec.rs +++ b/module/core/reflect_tools/src/reflect/entity_vec.rs @@ -4,7 +4,7 @@ use super::*; -/// Internal namespace. +/// Define a private namespace for all its items. pub mod private { use super::*; diff --git a/module/core/reflect_tools/src/reflect/fields.rs b/module/core/reflect_tools/src/reflect/fields.rs index edbdfbc9b4..811b9835d2 100644 --- a/module/core/reflect_tools/src/reflect/fields.rs +++ b/module/core/reflect_tools/src/reflect/fields.rs @@ -2,7 +2,7 @@ //! Iterator over fields. //! -/// Internal namespace. +/// Define a private namespace for all its items. mod private { diff --git a/module/core/reflect_tools/src/reflect/primitive.rs b/module/core/reflect_tools/src/reflect/primitive.rs index 986291afb8..23ce9a125e 100644 --- a/module/core/reflect_tools/src/reflect/primitive.rs +++ b/module/core/reflect_tools/src/reflect/primitive.rs @@ -2,7 +2,7 @@ //! Define primitive and data types. //! -/// Internal namespace. +/// Define a private namespace for all its items. mod private { diff --git a/module/core/reflect_tools/src/reflect/wrapper.rs b/module/core/reflect_tools/src/reflect/wrapper.rs index 31ad09a99a..8481bce1c7 100644 --- a/module/core/reflect_tools/src/reflect/wrapper.rs +++ b/module/core/reflect_tools/src/reflect/wrapper.rs @@ -2,7 +2,7 @@ //! Collection of wrappers. //! -/// Internal namespace. +/// Define a private namespace for all its items. mod private { } diff --git a/module/core/strs_tools/src/string/indentation.rs b/module/core/strs_tools/src/string/indentation.rs index b4574f3fbc..59c29951eb 100644 --- a/module/core/strs_tools/src/string/indentation.rs +++ b/module/core/strs_tools/src/string/indentation.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { diff --git a/module/core/strs_tools/src/string/number.rs b/module/core/strs_tools/src/string/number.rs index 69f8b2c0d1..1a0df1c3ad 100644 --- a/module/core/strs_tools/src/string/number.rs +++ b/module/core/strs_tools/src/string/number.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { } diff --git a/module/core/strs_tools/src/string/parse_request.rs b/module/core/strs_tools/src/string/parse_request.rs index 432b2098b6..44e215d15d 100644 --- a/module/core/strs_tools/src/string/parse_request.rs +++ b/module/core/strs_tools/src/string/parse_request.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::*; diff --git a/module/core/test_tools/Cargo.toml b/module/core/test_tools/Cargo.toml index f1e7576436..01ee46f740 100644 --- a/module/core/test_tools/Cargo.toml +++ b/module/core/test_tools/Cargo.toml @@ -69,7 +69,7 @@ enabled = [ normal = [ "dep:error_tools", "dep:collection_tools", - "dep:meta_tools", + "dep:impls_index", "dep:mem_tools", "dep:typing_tools", "dep:diagnostics_tools", @@ -78,8 +78,8 @@ normal = [ standalone = [ "standalone_error_tools", "standalone_collection_tools", - - "dep:meta_tools", + "standalone_impls_index", + "standalone_mem_tools", "dep:mem_tools", "dep:typing_tools", "dep:diagnostics_tools", @@ -87,6 +87,8 @@ standalone = [ ] standalone_error_tools = [ "dep:anyhow", "dep:thiserror", "error_typed", "error_untyped" ] standalone_collection_tools = [ "dep:hashbrown", "collection_constructors", "collection_into_constructors" ] +standalone_impls_index = [ "dep:impls_index_meta" ] +standalone_mem_tools = [] # error_tools error_typed = [] @@ -99,18 +101,18 @@ collection_into_constructors = [] ## external -# paste = "~1.0" # zzz : remove later -rustversion = "~1.0" -num-traits = "~0.2" trybuild = { version = "1.0.85", features = [ "diff" ] } -rand = "0.8.5" +rustversion = { workspace = true } +num-traits = { workspace = true } +rand = { workspace = true } +# tempdir = { workspace = true } ## internal error_tools = { workspace = true, features = [ "full" ], optional = true } collection_tools = { workspace = true, features = [ "full" ], optional = true } +impls_index = { workspace = true, features = [ "full" ], optional = true } -meta_tools = { workspace = true, features = [ "full" ], optional = true } mem_tools = { workspace = true, features = [ "full" ], optional = true } typing_tools = { workspace = true, features = [ "full" ], optional = true } diagnostics_tools = { workspace = true, features = [ "full" ], optional = true } @@ -125,6 +127,9 @@ anyhow = { workspace = true, optional = true } thiserror = { workspace = true, optional = true } # collection_tools hashbrown = { workspace = true, optional = true } +# impls_index +impls_index_meta = { workspace = true, optional = true } +# mem_tools [build-dependencies] rustc_version = "0.4" diff --git a/module/core/test_tools/src/lib.rs b/module/core/test_tools/src/lib.rs index ced13dc4d8..cb0d390392 100644 --- a/module/core/test_tools/src/lib.rs +++ b/module/core/test_tools/src/lib.rs @@ -18,26 +18,20 @@ pub mod dependency pub use ::trybuild; #[ doc( inline ) ] pub use ::rustversion; + #[ doc( inline ) ] + pub use ::num_traits; - // #[ doc( inline ) ] - // pub use ::error_tools; -// #[ doc( inline ) ] -// pub use ::meta_tools; -// #[ doc( inline ) ] -// pub use ::mem_tools; -// #[ doc( inline ) ] -// pub use ::typing_tools; -// #[ doc( inline ) ] -// pub use ::num_traits; -// #[ doc( inline ) ] -// pub use ::diagnostics_tools; -// -// #[ doc( inline ) ] -// pub use ::process_tools; - - // #[ doc( inline ) ] - // #[ allow( unused_imports ) ] - // pub use ::process_tools as process_tools; + #[ doc( inline ) ] + pub use super:: + { + error_tools, + collection_tools, + impls_index, + mem_tools, + typing_tools, + diagnostics_tools, + process_tools, + }; } @@ -103,18 +97,47 @@ mod private {} pub mod test; /// Error tools. +#[ cfg( feature = "enabled" ) ] #[ cfg( feature = "standalone" ) ] -#[ path = "../../../core/error_tools/src/error/mod.rs" ] -pub mod error; -#[ cfg( feature = "standalone" ) ] -pub use error as error_tools; +mod standalone +{ -/// Collection tools. -#[ cfg( feature = "standalone" ) ] -#[ path = "../../../core/collection_tools/src/collection/mod.rs" ] -pub mod collection; + /// Error tools. + #[ path = "../../../../core/error_tools/src/error/mod.rs" ] + pub mod error; + pub use error as error_tools; + + /// Collection tools. + #[ path = "../../../../core/collection_tools/src/collection/mod.rs" ] + pub mod collection; + pub use collection as collection_tools; + + /// impl index macroc. + #[ path = "../../../../core/impls_index/src/impls_index/mod.rs" ] + pub mod impls_index; + +} +#[ cfg( feature = "enabled" ) ] #[ cfg( feature = "standalone" ) ] -pub use collection as collection_tools; +pub use standalone::*; + +#[ cfg( feature = "enabled" ) ] +#[ cfg( not( feature = "standalone" ) ) ] +pub use :: +{ + error_tools, + collection_tools, + impls_index, +}; + +#[ cfg( feature = "enabled" ) ] +pub use :: +{ + mem_tools, + typing_tools, + diagnostics_tools, + process_tools, +}; #[ cfg( feature = "enabled" ) ] #[ doc( inline ) ] diff --git a/module/core/test_tools/src/test/asset.rs b/module/core/test_tools/src/test/asset.rs index e206fc8c0f..c32cf9cb91 100644 --- a/module/core/test_tools/src/test/asset.rs +++ b/module/core/test_tools/src/test/asset.rs @@ -3,7 +3,7 @@ //! Test asset helper. //! -/// Internal namespace. +/// Define a private namespace for all its items. // #[ cfg( not( feature = "no_std" ) ) ] mod private { diff --git a/module/core/test_tools/src/test/compiletime.rs b/module/core/test_tools/src/test/compiletime.rs index 7ea5edf31f..9792d17e3d 100644 --- a/module/core/test_tools/src/test/compiletime.rs +++ b/module/core/test_tools/src/test/compiletime.rs @@ -3,7 +3,7 @@ //! Try building a program for negative testing. //! -/// Internal namespace. +/// Define a private namespace for all its items. mod private { #[ doc( inline ) ] diff --git a/module/core/test_tools/src/test/helper.rs b/module/core/test_tools/src/test/helper.rs index 4a97b134da..16100d426a 100644 --- a/module/core/test_tools/src/test/helper.rs +++ b/module/core/test_tools/src/test/helper.rs @@ -5,7 +5,7 @@ // use super::*; -/// Internal namespace. +/// Define a private namespace for all its items. mod private { diff --git a/module/core/test_tools/src/test/mod.rs b/module/core/test_tools/src/test/mod.rs index 0d62f6e9d2..c13f70ef67 100644 --- a/module/core/test_tools/src/test/mod.rs +++ b/module/core/test_tools/src/test/mod.rs @@ -80,7 +80,8 @@ pub mod exposed version::exposed::*, }; - pub use meta_tools:: + #[ doc( inline ) ] + pub use crate::impls_index:: { impls, index, diff --git a/module/core/test_tools/src/test/smoke_test.rs b/module/core/test_tools/src/test/smoke_test.rs index 0074d4f090..a99b4ee1a0 100644 --- a/module/core/test_tools/src/test/smoke_test.rs +++ b/module/core/test_tools/src/test/smoke_test.rs @@ -8,7 +8,7 @@ // xxx2 : use process_tools to build and run rust programs, introduce program_ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { #[ allow( unused_imports ) ] diff --git a/module/core/test_tools/src/test/version.rs b/module/core/test_tools/src/test/version.rs index 8cdc5cbbc8..f20821e54e 100644 --- a/module/core/test_tools/src/test/version.rs +++ b/module/core/test_tools/src/test/version.rs @@ -3,7 +3,7 @@ //! Version of Rust compiler //! -/// Internal namespace. +/// Define a private namespace for all its items. // #[ cfg( not( feature = "no_std" ) ) ] mod private { diff --git a/module/core/variadic_from/src/variadic.rs b/module/core/variadic_from/src/variadic.rs index 715a135960..1297cb443c 100644 --- a/module/core/variadic_from/src/variadic.rs +++ b/module/core/variadic_from/src/variadic.rs @@ -2,7 +2,7 @@ //! Variadic constructor. Constructor with n arguments. Like Default, but with arguments. //! -/// Internal namespace. +/// Define a private namespace for all its items. mod private { diff --git a/module/move/assistant/src/client.rs b/module/move/assistant/src/client.rs index 51a00cb368..3276edc7a9 100644 --- a/module/move/assistant/src/client.rs +++ b/module/move/assistant/src/client.rs @@ -2,7 +2,7 @@ //! Client of API. //! -/// Internal namespace. +/// Define a private namespace for all its items. mod private { diff --git a/module/move/assistant/src/debug.rs b/module/move/assistant/src/debug.rs index e5966e4f2c..d35c02699a 100644 --- a/module/move/assistant/src/debug.rs +++ b/module/move/assistant/src/debug.rs @@ -2,7 +2,7 @@ //! Client of API. //! -/// Internal namespace. +/// Define a private namespace for all its items. mod private { diff --git a/module/move/assistant/src/lib.rs b/module/move/assistant/src/lib.rs index 2c0c103663..dd2ca047ba 100644 --- a/module/move/assistant/src/lib.rs +++ b/module/move/assistant/src/lib.rs @@ -5,7 +5,7 @@ use mod_interface::mod_interface; -/// Internal namespace. +/// Define a private namespace for all its items. mod private { } diff --git a/module/move/crates_tools/src/lib.rs b/module/move/crates_tools/src/lib.rs index 92dc8c0048..f43c975b7f 100644 --- a/module/move/crates_tools/src/lib.rs +++ b/module/move/crates_tools/src/lib.rs @@ -3,7 +3,7 @@ #![ doc( html_root_url = "https://docs.rs/crates_tools/latest/crates_tools/" ) ] #![ doc = include_str!( concat!( env!( "CARGO_MANIFEST_DIR" ), "/", "Readme.md" ) ) ] -/// Internal namespace. +/// Define a private namespace for all its items. #[ cfg( feature = "enabled" ) ] mod private { diff --git a/module/move/deterministic_rand/src/hrng_deterministic.rs b/module/move/deterministic_rand/src/hrng_deterministic.rs index ceb64b06c0..e489d8522e 100644 --- a/module/move/deterministic_rand/src/hrng_deterministic.rs +++ b/module/move/deterministic_rand/src/hrng_deterministic.rs @@ -6,7 +6,7 @@ //! Both have the same interface and are interchengable by switching on/off a feature `determinsim`. //! -/// Internal namespace. +/// Define a private namespace for all its items. mod private { diff --git a/module/move/deterministic_rand/src/hrng_non_deterministic.rs b/module/move/deterministic_rand/src/hrng_non_deterministic.rs index 1ab19d55d2..57db16656b 100644 --- a/module/move/deterministic_rand/src/hrng_non_deterministic.rs +++ b/module/move/deterministic_rand/src/hrng_non_deterministic.rs @@ -6,7 +6,7 @@ //! Both have the same interface and are interchengable by switching on/off a feature `determinsim`. //! -/// Internal namespace. +/// Define a private namespace for all its items. mod private { diff --git a/module/move/deterministic_rand/src/iter.rs b/module/move/deterministic_rand/src/iter.rs index caab96a148..cdfb83e100 100644 --- a/module/move/deterministic_rand/src/iter.rs +++ b/module/move/deterministic_rand/src/iter.rs @@ -3,7 +3,7 @@ //! Extensions of iterator for determinism. //! -/// Internal namespace. +/// Define a private namespace for all its items. mod private { diff --git a/module/move/deterministic_rand/src/seed.rs b/module/move/deterministic_rand/src/seed.rs index c7f1e078a9..fc68cc4cdf 100644 --- a/module/move/deterministic_rand/src/seed.rs +++ b/module/move/deterministic_rand/src/seed.rs @@ -3,7 +3,7 @@ //! Master seed. //! -/// Internal namespace. +/// Define a private namespace for all its items. mod private { #[ cfg( feature = "no_std" ) ] diff --git a/module/move/graphs_tools/src/abs/edge.rs b/module/move/graphs_tools/src/abs/edge.rs index 550a350efb..214f8f10d9 100644 --- a/module/move/graphs_tools/src/abs/edge.rs +++ b/module/move/graphs_tools/src/abs/edge.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::prelude::*; diff --git a/module/move/graphs_tools/src/abs/factory.rs b/module/move/graphs_tools/src/abs/factory.rs index 0f6d19e324..ad6bc76c8b 100644 --- a/module/move/graphs_tools/src/abs/factory.rs +++ b/module/move/graphs_tools/src/abs/factory.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::prelude::*; diff --git a/module/move/graphs_tools/src/abs/id_generator.rs b/module/move/graphs_tools/src/abs/id_generator.rs index 943315c041..2090439804 100644 --- a/module/move/graphs_tools/src/abs/id_generator.rs +++ b/module/move/graphs_tools/src/abs/id_generator.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { // use crate::prelude::*; diff --git a/module/move/graphs_tools/src/abs/identity.rs b/module/move/graphs_tools/src/abs/identity.rs index 412b759d73..287e69f4b1 100644 --- a/module/move/graphs_tools/src/abs/identity.rs +++ b/module/move/graphs_tools/src/abs/identity.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { // use crate::prelude::*; diff --git a/module/move/graphs_tools/src/abs/node.rs b/module/move/graphs_tools/src/abs/node.rs index b227581718..703bd0893d 100644 --- a/module/move/graphs_tools/src/abs/node.rs +++ b/module/move/graphs_tools/src/abs/node.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::prelude::*; diff --git a/module/move/graphs_tools/src/algo/dfs.rs b/module/move/graphs_tools/src/algo/dfs.rs index 0a75884e2c..13e7c81e84 100644 --- a/module/move/graphs_tools/src/algo/dfs.rs +++ b/module/move/graphs_tools/src/algo/dfs.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::prelude::*; diff --git a/module/move/graphs_tools/src/canonical/edge.rs b/module/move/graphs_tools/src/canonical/edge.rs index 3bf782aaee..4d02b207d4 100644 --- a/module/move/graphs_tools/src/canonical/edge.rs +++ b/module/move/graphs_tools/src/canonical/edge.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::prelude::*; diff --git a/module/move/graphs_tools/src/canonical/factory_generative.rs b/module/move/graphs_tools/src/canonical/factory_generative.rs index ba735895c4..1e2e838081 100644 --- a/module/move/graphs_tools/src/canonical/factory_generative.rs +++ b/module/move/graphs_tools/src/canonical/factory_generative.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::prelude::*; diff --git a/module/move/graphs_tools/src/canonical/factory_readable.rs b/module/move/graphs_tools/src/canonical/factory_readable.rs index 9ec9bf6012..d545d38d89 100644 --- a/module/move/graphs_tools/src/canonical/factory_readable.rs +++ b/module/move/graphs_tools/src/canonical/factory_readable.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::prelude::*; diff --git a/module/move/graphs_tools/src/canonical/identity.rs b/module/move/graphs_tools/src/canonical/identity.rs index 90b53e8879..f4c1a38eba 100644 --- a/module/move/graphs_tools/src/canonical/identity.rs +++ b/module/move/graphs_tools/src/canonical/identity.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::prelude::*; diff --git a/module/move/graphs_tools/src/canonical/node.rs b/module/move/graphs_tools/src/canonical/node.rs index 94d7f7d313..ce0aa547bd 100644 --- a/module/move/graphs_tools/src/canonical/node.rs +++ b/module/move/graphs_tools/src/canonical/node.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::prelude::*; diff --git a/module/move/plot_interface/src/plot/abs/change.rs b/module/move/plot_interface/src/plot/abs/change.rs index b6ba9fc235..fc14b77ec9 100644 --- a/module/move/plot_interface/src/plot/abs/change.rs +++ b/module/move/plot_interface/src/plot/abs/change.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::own::*; diff --git a/module/move/plot_interface/src/plot/abs/changer.rs b/module/move/plot_interface/src/plot/abs/changer.rs index 99e39449e0..9e09820670 100644 --- a/module/move/plot_interface/src/plot/abs/changer.rs +++ b/module/move/plot_interface/src/plot/abs/changer.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::own::*; diff --git a/module/move/plot_interface/src/plot/abs/context.rs b/module/move/plot_interface/src/plot/abs/context.rs index 526b5bf488..c9f844e802 100644 --- a/module/move/plot_interface/src/plot/abs/context.rs +++ b/module/move/plot_interface/src/plot/abs/context.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::own::*; diff --git a/module/move/plot_interface/src/plot/abs/identity.rs b/module/move/plot_interface/src/plot/abs/identity.rs index d8be2ccff7..1fe2b0e613 100644 --- a/module/move/plot_interface/src/plot/abs/identity.rs +++ b/module/move/plot_interface/src/plot/abs/identity.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::own::*; diff --git a/module/move/plot_interface/src/plot/abs/registry.rs b/module/move/plot_interface/src/plot/abs/registry.rs index b6d662b429..21a2cd6be7 100644 --- a/module/move/plot_interface/src/plot/abs/registry.rs +++ b/module/move/plot_interface/src/plot/abs/registry.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::own::*; diff --git a/module/move/plot_interface/src/plot/color.rs b/module/move/plot_interface/src/plot/color.rs index b14a3e268e..fc2b94c17f 100644 --- a/module/move/plot_interface/src/plot/color.rs +++ b/module/move/plot_interface/src/plot/color.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::own::*; diff --git a/module/move/plot_interface/src/plot/sys/context.rs b/module/move/plot_interface/src/plot/sys/context.rs index e5c23e71f6..ee2f95fbf3 100644 --- a/module/move/plot_interface/src/plot/sys/context.rs +++ b/module/move/plot_interface/src/plot/sys/context.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::own::*; diff --git a/module/move/plot_interface/src/plot/sys/context_changer.rs b/module/move/plot_interface/src/plot/sys/context_changer.rs index 2f87310469..fa33094931 100644 --- a/module/move/plot_interface/src/plot/sys/context_changer.rs +++ b/module/move/plot_interface/src/plot/sys/context_changer.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::own::*; diff --git a/module/move/plot_interface/src/plot/sys/drawing.rs b/module/move/plot_interface/src/plot/sys/drawing.rs index 7fdca77c2d..1ec732286b 100644 --- a/module/move/plot_interface/src/plot/sys/drawing.rs +++ b/module/move/plot_interface/src/plot/sys/drawing.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::own::*; diff --git a/module/move/plot_interface/src/plot/sys/drawing/change_new.rs b/module/move/plot_interface/src/plot/sys/drawing/change_new.rs index 914678a907..4661f9587b 100644 --- a/module/move/plot_interface/src/plot/sys/drawing/change_new.rs +++ b/module/move/plot_interface/src/plot/sys/drawing/change_new.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::own::*; diff --git a/module/move/plot_interface/src/plot/sys/drawing/changer.rs b/module/move/plot_interface/src/plot/sys/drawing/changer.rs index bfe7cf170f..7fd62e8e44 100644 --- a/module/move/plot_interface/src/plot/sys/drawing/changer.rs +++ b/module/move/plot_interface/src/plot/sys/drawing/changer.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::own::*; diff --git a/module/move/plot_interface/src/plot/sys/drawing/command.rs b/module/move/plot_interface/src/plot/sys/drawing/command.rs index f98cedfd22..998272ee16 100644 --- a/module/move/plot_interface/src/plot/sys/drawing/command.rs +++ b/module/move/plot_interface/src/plot/sys/drawing/command.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { // use crate::own::*; diff --git a/module/move/plot_interface/src/plot/sys/drawing/queue.rs b/module/move/plot_interface/src/plot/sys/drawing/queue.rs index c68de594ba..c3148011bb 100644 --- a/module/move/plot_interface/src/plot/sys/drawing/queue.rs +++ b/module/move/plot_interface/src/plot/sys/drawing/queue.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { // use crate::own::*; diff --git a/module/move/plot_interface/src/plot/sys/drawing/rect_change_new.rs b/module/move/plot_interface/src/plot/sys/drawing/rect_change_new.rs index 7b1a3acfc7..57fe8b5898 100644 --- a/module/move/plot_interface/src/plot/sys/drawing/rect_change_new.rs +++ b/module/move/plot_interface/src/plot/sys/drawing/rect_change_new.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::own::*; diff --git a/module/move/plot_interface/src/plot/sys/drawing/rect_change_region.rs b/module/move/plot_interface/src/plot/sys/drawing/rect_change_region.rs index bdbb18321d..84c1634301 100644 --- a/module/move/plot_interface/src/plot/sys/drawing/rect_change_region.rs +++ b/module/move/plot_interface/src/plot/sys/drawing/rect_change_region.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::own::*; diff --git a/module/move/plot_interface/src/plot/sys/drawing/rect_changer.rs b/module/move/plot_interface/src/plot/sys/drawing/rect_changer.rs index 85d56d9b48..cb5ddf757f 100644 --- a/module/move/plot_interface/src/plot/sys/drawing/rect_changer.rs +++ b/module/move/plot_interface/src/plot/sys/drawing/rect_changer.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::own::*; diff --git a/module/move/plot_interface/src/plot/sys/stroke_brush.rs b/module/move/plot_interface/src/plot/sys/stroke_brush.rs index 08c73b350b..edfbfc4878 100644 --- a/module/move/plot_interface/src/plot/sys/stroke_brush.rs +++ b/module/move/plot_interface/src/plot/sys/stroke_brush.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::own::*; diff --git a/module/move/plot_interface/src/plot/sys/stroke_brush/change_color.rs b/module/move/plot_interface/src/plot/sys/stroke_brush/change_color.rs index ae615f89a4..76bd951613 100644 --- a/module/move/plot_interface/src/plot/sys/stroke_brush/change_color.rs +++ b/module/move/plot_interface/src/plot/sys/stroke_brush/change_color.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::own::*; diff --git a/module/move/plot_interface/src/plot/sys/stroke_brush/change_new.rs b/module/move/plot_interface/src/plot/sys/stroke_brush/change_new.rs index d147f3241b..caa1c2f75c 100644 --- a/module/move/plot_interface/src/plot/sys/stroke_brush/change_new.rs +++ b/module/move/plot_interface/src/plot/sys/stroke_brush/change_new.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::own::*; diff --git a/module/move/plot_interface/src/plot/sys/stroke_brush/change_width.rs b/module/move/plot_interface/src/plot/sys/stroke_brush/change_width.rs index 192b42e8ad..758fbe75a7 100644 --- a/module/move/plot_interface/src/plot/sys/stroke_brush/change_width.rs +++ b/module/move/plot_interface/src/plot/sys/stroke_brush/change_width.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::own::*; diff --git a/module/move/plot_interface/src/plot/sys/stroke_brush/changer.rs b/module/move/plot_interface/src/plot/sys/stroke_brush/changer.rs index c6f8ab0f5f..d6208455a0 100644 --- a/module/move/plot_interface/src/plot/sys/stroke_brush/changer.rs +++ b/module/move/plot_interface/src/plot/sys/stroke_brush/changer.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::own::*; diff --git a/module/move/plot_interface/src/plot/sys/target.rs b/module/move/plot_interface/src/plot/sys/target.rs index 96f38bfe51..820f3a3b97 100644 --- a/module/move/plot_interface/src/plot/sys/target.rs +++ b/module/move/plot_interface/src/plot/sys/target.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { // use crate::prelude::*; diff --git a/module/move/sqlx_query/src/lib.rs b/module/move/sqlx_query/src/lib.rs index b0855a6219..53d4a4043e 100644 --- a/module/move/sqlx_query/src/lib.rs +++ b/module/move/sqlx_query/src/lib.rs @@ -17,7 +17,7 @@ #![ doc = include_str!( concat!( env!( "CARGO_MANIFEST_DIR" ), "/../../../", "Readme.md" ) ) ] -/// Internal namespace. +/// Define a private namespace for all its items. #[ cfg( feature = "enabled" ) ] mod private { diff --git a/module/move/willbe/src/action/list.rs b/module/move/willbe/src/action/list.rs index 074189cd7f..040c8ba12c 100644 --- a/module/move/willbe/src/action/list.rs +++ b/module/move/willbe/src/action/list.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::*; diff --git a/module/move/willbe/src/action/publish.rs b/module/move/willbe/src/action/publish.rs index 048220bc20..6b8f4dc657 100644 --- a/module/move/willbe/src/action/publish.rs +++ b/module/move/willbe/src/action/publish.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::*; diff --git a/module/move/willbe/src/action/publish_diff.rs b/module/move/willbe/src/action/publish_diff.rs index 500a73a7f8..a6b76e6528 100644 --- a/module/move/willbe/src/action/publish_diff.rs +++ b/module/move/willbe/src/action/publish_diff.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::*; diff --git a/module/move/willbe/src/action/test.rs b/module/move/willbe/src/action/test.rs index be0b90405c..8efcad2f5f 100644 --- a/module/move/willbe/src/action/test.rs +++ b/module/move/willbe/src/action/test.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::*; diff --git a/module/move/willbe/src/command/list.rs b/module/move/willbe/src/command/list.rs index 83e252fc65..98e8b2d2be 100644 --- a/module/move/willbe/src/command/list.rs +++ b/module/move/willbe/src/command/list.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::*; diff --git a/module/move/willbe/src/command/mod.rs b/module/move/willbe/src/command/mod.rs index 5c81dcf47b..d54c8f2df5 100644 --- a/module/move/willbe/src/command/mod.rs +++ b/module/move/willbe/src/command/mod.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::*; diff --git a/module/move/willbe/src/command/publish.rs b/module/move/willbe/src/command/publish.rs index b9ca441ef5..3af3fad60d 100644 --- a/module/move/willbe/src/command/publish.rs +++ b/module/move/willbe/src/command/publish.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::*; diff --git a/module/move/willbe/src/command/test.rs b/module/move/willbe/src/command/test.rs index 9a05c92c89..b56c84a79f 100644 --- a/module/move/willbe/src/command/test.rs +++ b/module/move/willbe/src/command/test.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::*; diff --git a/module/move/willbe/src/entity/files.rs b/module/move/willbe/src/entity/files.rs index 8385e87167..d8941dfa27 100644 --- a/module/move/willbe/src/entity/files.rs +++ b/module/move/willbe/src/entity/files.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::*; diff --git a/module/move/willbe/src/entity/manifest.rs b/module/move/willbe/src/entity/manifest.rs index 4df6ead08d..5a0f7a58aa 100644 --- a/module/move/willbe/src/entity/manifest.rs +++ b/module/move/willbe/src/entity/manifest.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::*; diff --git a/module/move/willbe/src/entity/package_md_extension.rs b/module/move/willbe/src/entity/package_md_extension.rs index 76ffdbac88..29fe95b645 100644 --- a/module/move/willbe/src/entity/package_md_extension.rs +++ b/module/move/willbe/src/entity/package_md_extension.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::*; diff --git a/module/move/willbe/src/entity/version.rs b/module/move/willbe/src/entity/version.rs index 0722b8a59c..7018f00481 100644 --- a/module/move/willbe/src/entity/version.rs +++ b/module/move/willbe/src/entity/version.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::*; diff --git a/module/move/willbe/src/entity/workspace_md_extension.rs b/module/move/willbe/src/entity/workspace_md_extension.rs index f463d4cf60..a6d10dd9cb 100644 --- a/module/move/willbe/src/entity/workspace_md_extension.rs +++ b/module/move/willbe/src/entity/workspace_md_extension.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::*; diff --git a/module/move/willbe/src/lib.rs b/module/move/willbe/src/lib.rs index 87149b74fa..27cf2d036a 100644 --- a/module/move/willbe/src/lib.rs +++ b/module/move/willbe/src/lib.rs @@ -5,7 +5,7 @@ pub use mod_interface::mod_interface; -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::*; diff --git a/module/move/willbe/src/tool/cargo.rs b/module/move/willbe/src/tool/cargo.rs index 780defb921..5a3974ddd9 100644 --- a/module/move/willbe/src/tool/cargo.rs +++ b/module/move/willbe/src/tool/cargo.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::*; diff --git a/module/move/willbe/src/tool/files.rs b/module/move/willbe/src/tool/files.rs index 38878c477d..95f19de887 100644 --- a/module/move/willbe/src/tool/files.rs +++ b/module/move/willbe/src/tool/files.rs @@ -1,5 +1,5 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { #[ allow( unused_imports ) ] diff --git a/module/move/willbe/src/tool/git.rs b/module/move/willbe/src/tool/git.rs index 05b582cd8a..9e240c804b 100644 --- a/module/move/willbe/src/tool/git.rs +++ b/module/move/willbe/src/tool/git.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { #[ allow( unused_imports ) ] diff --git a/module/move/willbe/src/tool/graph.rs b/module/move/willbe/src/tool/graph.rs index 296547ac82..dec62fdc9e 100644 --- a/module/move/willbe/src/tool/graph.rs +++ b/module/move/willbe/src/tool/graph.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { #[ allow( unused_imports ) ] diff --git a/module/move/willbe/src/tool/http.rs b/module/move/willbe/src/tool/http.rs index d682a79d69..81e13a2d74 100644 --- a/module/move/willbe/src/tool/http.rs +++ b/module/move/willbe/src/tool/http.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { #[ allow( unused_imports ) ] diff --git a/module/move/willbe/src/tool/iter.rs b/module/move/willbe/src/tool/iter.rs index a7b82abd7a..855c492006 100644 --- a/module/move/willbe/src/tool/iter.rs +++ b/module/move/willbe/src/tool/iter.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { } diff --git a/module/move/willbe/src/tool/macros.rs b/module/move/willbe/src/tool/macros.rs index 81861cb3de..96f7a3b06d 100644 --- a/module/move/willbe/src/tool/macros.rs +++ b/module/move/willbe/src/tool/macros.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { } diff --git a/module/move/willbe/src/tool/path.rs b/module/move/willbe/src/tool/path.rs index 028bbd4189..611a9c21ed 100644 --- a/module/move/willbe/src/tool/path.rs +++ b/module/move/willbe/src/tool/path.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { } diff --git a/module/move/willbe/src/tool/query.rs b/module/move/willbe/src/tool/query.rs index 3528d887ae..4b8a14d10e 100644 --- a/module/move/willbe/src/tool/query.rs +++ b/module/move/willbe/src/tool/query.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { #[ allow( unused_imports ) ] diff --git a/module/move/willbe/src/tool/repository.rs b/module/move/willbe/src/tool/repository.rs index 66474d906d..c78d304661 100644 --- a/module/move/willbe/src/tool/repository.rs +++ b/module/move/willbe/src/tool/repository.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { #[ allow( unused_imports ) ] diff --git a/module/move/willbe/src/tool/template.rs b/module/move/willbe/src/tool/template.rs index bd90b0b5d7..59040dca01 100644 --- a/module/move/willbe/src/tool/template.rs +++ b/module/move/willbe/src/tool/template.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { #[ allow( unused_imports ) ] @@ -29,7 +29,7 @@ mod private /// The values associated with the template. pub values : TemplateValues, /// Path to the parameter storage for recovering values - /// for already generated templated files. + /// for already generated templated files. pub parameter_storage : &'static Path, /// Name of the template to generate pub template_name : &'static str, diff --git a/module/move/willbe/src/tool/url.rs b/module/move/willbe/src/tool/url.rs index f1ab5b8f9c..58c2792e4c 100644 --- a/module/move/willbe/src/tool/url.rs +++ b/module/move/willbe/src/tool/url.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { #[ allow( unused_imports ) ] diff --git a/module/move/wplot/src/plot/abs/change.rs b/module/move/wplot/src/plot/abs/change.rs index 660a54e108..ad2a0219a2 100644 --- a/module/move/wplot/src/plot/abs/change.rs +++ b/module/move/wplot/src/plot/abs/change.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { // use crate::own::*; diff --git a/module/move/wplot/src/plot/abs/changer.rs b/module/move/wplot/src/plot/abs/changer.rs index 3315e82b38..9c91ad95c2 100644 --- a/module/move/wplot/src/plot/abs/changer.rs +++ b/module/move/wplot/src/plot/abs/changer.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { // use crate::own::*; diff --git a/module/move/wplot/src/plot/abs/context.rs b/module/move/wplot/src/plot/abs/context.rs index c666e3edca..a27efc6748 100644 --- a/module/move/wplot/src/plot/abs/context.rs +++ b/module/move/wplot/src/plot/abs/context.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. #[ cfg( not( feature = "no_std" ) ) ] mod private { diff --git a/module/move/wplot/src/plot/abs/identity.rs b/module/move/wplot/src/plot/abs/identity.rs index 48d9c0426a..9abecc7727 100644 --- a/module/move/wplot/src/plot/abs/identity.rs +++ b/module/move/wplot/src/plot/abs/identity.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. #[ cfg( not( feature = "no_std" ) ) ] mod private { diff --git a/module/move/wplot/src/plot/abs/registry.rs b/module/move/wplot/src/plot/abs/registry.rs index 026c0f5c20..c69f775dca 100644 --- a/module/move/wplot/src/plot/abs/registry.rs +++ b/module/move/wplot/src/plot/abs/registry.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. #[ cfg( not( feature = "no_std" ) ) ] mod private { diff --git a/module/move/wplot/src/plot/color.rs b/module/move/wplot/src/plot/color.rs index 5cf94b95c8..3ae327c824 100644 --- a/module/move/wplot/src/plot/color.rs +++ b/module/move/wplot/src/plot/color.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { // use crate::own::*; diff --git a/module/move/wplot/src/plot/sys/context.rs b/module/move/wplot/src/plot/sys/context.rs index a59ae6343d..19bd3ce2a9 100644 --- a/module/move/wplot/src/plot/sys/context.rs +++ b/module/move/wplot/src/plot/sys/context.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::abs::registry::private::Registry; diff --git a/module/move/wplot/src/plot/sys/context_changer.rs b/module/move/wplot/src/plot/sys/context_changer.rs index e6a91ca8e5..c0f1df3442 100644 --- a/module/move/wplot/src/plot/sys/context_changer.rs +++ b/module/move/wplot/src/plot/sys/context_changer.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { // use crate::own::*; diff --git a/module/move/wplot/src/plot/sys/drawing.rs b/module/move/wplot/src/plot/sys/drawing.rs index 673fd1fa74..9e668966be 100644 --- a/module/move/wplot/src/plot/sys/drawing.rs +++ b/module/move/wplot/src/plot/sys/drawing.rs @@ -1,6 +1,6 @@ pub(crate) mod changer; -/// Internal namespace. +/// Define a private namespace for all its items. mod private { // use crate::own::*; diff --git a/module/move/wplot/src/plot/sys/drawing/change_new.rs b/module/move/wplot/src/plot/sys/drawing/change_new.rs index ab075de7fa..f7628c2566 100644 --- a/module/move/wplot/src/plot/sys/drawing/change_new.rs +++ b/module/move/wplot/src/plot/sys/drawing/change_new.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { // use crate::own::*; diff --git a/module/move/wplot/src/plot/sys/drawing/changer.rs b/module/move/wplot/src/plot/sys/drawing/changer.rs index a7ba4c1b67..84c69db2c3 100644 --- a/module/move/wplot/src/plot/sys/drawing/changer.rs +++ b/module/move/wplot/src/plot/sys/drawing/changer.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { // use crate::own::*; diff --git a/module/move/wplot/src/plot/sys/drawing/command.rs b/module/move/wplot/src/plot/sys/drawing/command.rs index f98cedfd22..998272ee16 100644 --- a/module/move/wplot/src/plot/sys/drawing/command.rs +++ b/module/move/wplot/src/plot/sys/drawing/command.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { // use crate::own::*; diff --git a/module/move/wplot/src/plot/sys/drawing/queue.rs b/module/move/wplot/src/plot/sys/drawing/queue.rs index c68de594ba..c3148011bb 100644 --- a/module/move/wplot/src/plot/sys/drawing/queue.rs +++ b/module/move/wplot/src/plot/sys/drawing/queue.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { // use crate::own::*; diff --git a/module/move/wplot/src/plot/sys/drawing/rect_change_new.rs b/module/move/wplot/src/plot/sys/drawing/rect_change_new.rs index 212ffb82c1..b682c0ead8 100644 --- a/module/move/wplot/src/plot/sys/drawing/rect_change_new.rs +++ b/module/move/wplot/src/plot/sys/drawing/rect_change_new.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { // use crate::own::*; diff --git a/module/move/wplot/src/plot/sys/drawing/rect_change_region.rs b/module/move/wplot/src/plot/sys/drawing/rect_change_region.rs index 463259b6cf..29b6885e63 100644 --- a/module/move/wplot/src/plot/sys/drawing/rect_change_region.rs +++ b/module/move/wplot/src/plot/sys/drawing/rect_change_region.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::own::*; diff --git a/module/move/wplot/src/plot/sys/drawing/rect_changer.rs b/module/move/wplot/src/plot/sys/drawing/rect_changer.rs index bb25c465aa..7e39fb06fc 100644 --- a/module/move/wplot/src/plot/sys/drawing/rect_changer.rs +++ b/module/move/wplot/src/plot/sys/drawing/rect_changer.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::own::*; diff --git a/module/move/wplot/src/plot/sys/stroke_brush.rs b/module/move/wplot/src/plot/sys/stroke_brush.rs index 78ad289dc7..9f52539630 100644 --- a/module/move/wplot/src/plot/sys/stroke_brush.rs +++ b/module/move/wplot/src/plot/sys/stroke_brush.rs @@ -1,7 +1,7 @@ mod change_width; mod change_new; -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::own::*; diff --git a/module/move/wplot/src/plot/sys/stroke_brush/change_color.rs b/module/move/wplot/src/plot/sys/stroke_brush/change_color.rs index ae615f89a4..76bd951613 100644 --- a/module/move/wplot/src/plot/sys/stroke_brush/change_color.rs +++ b/module/move/wplot/src/plot/sys/stroke_brush/change_color.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::own::*; diff --git a/module/move/wplot/src/plot/sys/stroke_brush/change_new.rs b/module/move/wplot/src/plot/sys/stroke_brush/change_new.rs index 077f20f6ba..4e70ba7ee7 100644 --- a/module/move/wplot/src/plot/sys/stroke_brush/change_new.rs +++ b/module/move/wplot/src/plot/sys/stroke_brush/change_new.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { // use crate::own::*; diff --git a/module/move/wplot/src/plot/sys/stroke_brush/change_width.rs b/module/move/wplot/src/plot/sys/stroke_brush/change_width.rs index cf5a548778..a7fcecdcb8 100644 --- a/module/move/wplot/src/plot/sys/stroke_brush/change_width.rs +++ b/module/move/wplot/src/plot/sys/stroke_brush/change_width.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { // use crate::own::*; diff --git a/module/move/wplot/src/plot/sys/stroke_brush/changer.rs b/module/move/wplot/src/plot/sys/stroke_brush/changer.rs index 407b234fac..152dfebaab 100644 --- a/module/move/wplot/src/plot/sys/stroke_brush/changer.rs +++ b/module/move/wplot/src/plot/sys/stroke_brush/changer.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::own::*; diff --git a/module/move/wplot/src/plot/sys/target.rs b/module/move/wplot/src/plot/sys/target.rs index 58634c4e36..95d123186b 100644 --- a/module/move/wplot/src/plot/sys/target.rs +++ b/module/move/wplot/src/plot/sys/target.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { // use crate::prelude::*; diff --git a/module/postponed/type_constructor/src/type_constuctor/enumerable.rs b/module/postponed/type_constructor/src/type_constuctor/enumerable.rs index e17553d21c..fdfa45fb97 100644 --- a/module/postponed/type_constructor/src/type_constuctor/enumerable.rs +++ b/module/postponed/type_constructor/src/type_constuctor/enumerable.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { diff --git a/module/postponed/type_constructor/src/type_constuctor/helper.rs b/module/postponed/type_constructor/src/type_constuctor/helper.rs index 57c9986a69..a4dcf9011f 100644 --- a/module/postponed/type_constructor/src/type_constuctor/helper.rs +++ b/module/postponed/type_constructor/src/type_constuctor/helper.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::exposed::*; diff --git a/module/postponed/type_constructor/src/type_constuctor/make.rs b/module/postponed/type_constructor/src/type_constuctor/make.rs index 807974a4ca..2cdb6d6973 100644 --- a/module/postponed/type_constructor/src/type_constuctor/make.rs +++ b/module/postponed/type_constructor/src/type_constuctor/make.rs @@ -1,4 +1,4 @@ -// /// Internal namespace. +// /// Define a private namespace for all its items. // #[ cfg( feature = "make" ) ] // mod private // { diff --git a/module/postponed/type_constructor/src/type_constuctor/many.rs b/module/postponed/type_constructor/src/type_constuctor/many.rs index 0c81d87180..3ded63125c 100644 --- a/module/postponed/type_constructor/src/type_constuctor/many.rs +++ b/module/postponed/type_constructor/src/type_constuctor/many.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::exposed::*; diff --git a/module/postponed/type_constructor/src/type_constuctor/no_many.rs b/module/postponed/type_constructor/src/type_constuctor/no_many.rs index a36e9829ef..d810f74d08 100644 --- a/module/postponed/type_constructor/src/type_constuctor/no_many.rs +++ b/module/postponed/type_constructor/src/type_constuctor/no_many.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { diff --git a/module/postponed/type_constructor/src/type_constuctor/pair.rs b/module/postponed/type_constructor/src/type_constuctor/pair.rs index 090428e500..56b71bc2ff 100644 --- a/module/postponed/type_constructor/src/type_constuctor/pair.rs +++ b/module/postponed/type_constructor/src/type_constuctor/pair.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::exposed::*; diff --git a/module/postponed/type_constructor/src/type_constuctor/single.rs b/module/postponed/type_constructor/src/type_constuctor/single.rs index 7fcf8642f4..2fd3637235 100644 --- a/module/postponed/type_constructor/src/type_constuctor/single.rs +++ b/module/postponed/type_constructor/src/type_constuctor/single.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::exposed::*; diff --git a/module/postponed/type_constructor/src/type_constuctor/traits.rs b/module/postponed/type_constructor/src/type_constuctor/traits.rs index cd11c438ee..cf4838bee3 100644 --- a/module/postponed/type_constructor/src/type_constuctor/traits.rs +++ b/module/postponed/type_constructor/src/type_constuctor/traits.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { diff --git a/module/postponed/type_constructor/src/type_constuctor/types.rs b/module/postponed/type_constructor/src/type_constuctor/types.rs index 151b33ae42..d9d1de235a 100644 --- a/module/postponed/type_constructor/src/type_constuctor/types.rs +++ b/module/postponed/type_constructor/src/type_constuctor/types.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::exposed::*; diff --git a/module/postponed/type_constructor/src/type_constuctor/vectorized_from.rs b/module/postponed/type_constructor/src/type_constuctor/vectorized_from.rs index c7e366142a..c145e31404 100644 --- a/module/postponed/type_constructor/src/type_constuctor/vectorized_from.rs +++ b/module/postponed/type_constructor/src/type_constuctor/vectorized_from.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { diff --git a/module/postponed/wautomata/src/graph/abs/edge.rs b/module/postponed/wautomata/src/graph/abs/edge.rs index 550a350efb..214f8f10d9 100644 --- a/module/postponed/wautomata/src/graph/abs/edge.rs +++ b/module/postponed/wautomata/src/graph/abs/edge.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::prelude::*; diff --git a/module/postponed/wautomata/src/graph/abs/factory.rs b/module/postponed/wautomata/src/graph/abs/factory.rs index 737cbfdf5c..ddf6012168 100644 --- a/module/postponed/wautomata/src/graph/abs/factory.rs +++ b/module/postponed/wautomata/src/graph/abs/factory.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::prelude::*; diff --git a/module/postponed/wautomata/src/graph/abs/id_generator.rs b/module/postponed/wautomata/src/graph/abs/id_generator.rs index 943315c041..2090439804 100644 --- a/module/postponed/wautomata/src/graph/abs/id_generator.rs +++ b/module/postponed/wautomata/src/graph/abs/id_generator.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { // use crate::prelude::*; diff --git a/module/postponed/wautomata/src/graph/abs/identity.rs b/module/postponed/wautomata/src/graph/abs/identity.rs index c7fdcb3797..1e9c21d2f9 100644 --- a/module/postponed/wautomata/src/graph/abs/identity.rs +++ b/module/postponed/wautomata/src/graph/abs/identity.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { // use crate::prelude::*; diff --git a/module/postponed/wautomata/src/graph/abs/node.rs b/module/postponed/wautomata/src/graph/abs/node.rs index b227581718..703bd0893d 100644 --- a/module/postponed/wautomata/src/graph/abs/node.rs +++ b/module/postponed/wautomata/src/graph/abs/node.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::prelude::*; diff --git a/module/postponed/wautomata/src/graph/algo/dfs.rs b/module/postponed/wautomata/src/graph/algo/dfs.rs index 0a75884e2c..13e7c81e84 100644 --- a/module/postponed/wautomata/src/graph/algo/dfs.rs +++ b/module/postponed/wautomata/src/graph/algo/dfs.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::prelude::*; diff --git a/module/postponed/wautomata/src/graph/canonical/edge.rs b/module/postponed/wautomata/src/graph/canonical/edge.rs index 3bf782aaee..4d02b207d4 100644 --- a/module/postponed/wautomata/src/graph/canonical/edge.rs +++ b/module/postponed/wautomata/src/graph/canonical/edge.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::prelude::*; diff --git a/module/postponed/wautomata/src/graph/canonical/factory_generative.rs b/module/postponed/wautomata/src/graph/canonical/factory_generative.rs index 766002bfb3..0548aa26c5 100644 --- a/module/postponed/wautomata/src/graph/canonical/factory_generative.rs +++ b/module/postponed/wautomata/src/graph/canonical/factory_generative.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::prelude::*; diff --git a/module/postponed/wautomata/src/graph/canonical/factory_readable.rs b/module/postponed/wautomata/src/graph/canonical/factory_readable.rs index d9505b7819..1cad2804dd 100644 --- a/module/postponed/wautomata/src/graph/canonical/factory_readable.rs +++ b/module/postponed/wautomata/src/graph/canonical/factory_readable.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::prelude::*; diff --git a/module/postponed/wautomata/src/graph/canonical/identity.rs b/module/postponed/wautomata/src/graph/canonical/identity.rs index 497da5ff54..6680ead861 100644 --- a/module/postponed/wautomata/src/graph/canonical/identity.rs +++ b/module/postponed/wautomata/src/graph/canonical/identity.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::prelude::*; diff --git a/module/postponed/wautomata/src/graph/canonical/node.rs b/module/postponed/wautomata/src/graph/canonical/node.rs index 94d7f7d313..ce0aa547bd 100644 --- a/module/postponed/wautomata/src/graph/canonical/node.rs +++ b/module/postponed/wautomata/src/graph/canonical/node.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use crate::prelude::*; diff --git a/module/template/layer/layer.rs b/module/template/layer/layer.rs index 45d766e897..b4b8322d92 100644 --- a/module/template/layer/layer.rs +++ b/module/template/layer/layer.rs @@ -1,4 +1,4 @@ -/// Internal namespace. +/// Define a private namespace for all its items. mod private { use super::super::*;