graph_tools wip

Author: Wandalen

module/move/graphs_tools/Cargo.toml

@@ -4,7 +4,6 @@ version = "0.3.0"
 edition = "2021"
 authors = [
   "Kostiantyn Wandalen <[email protected]>",
-  "Dmytro Kryvoruchko <[email protected]>",
 ]
 license = "MIT"
 readme = "Readme.md"

module/move/graphs_tools/src/abs.rs

@@ -0,0 +1,52 @@
+
+/// Define a private namespace for all its items.
+mod private
+{
+
+  use std::
+  {
+    hash::Hash,
+    fmt,
+  };
+
+  ///
+  /// Interface to identify an instance of somthing, for exampel a node.
+  ///
+
+  pub trait IdentityInterface
+  where
+    Self :
+      'static +
+      Copy +
+      Hash +
+      fmt::Debug +
+      PartialEq +
+      Eq
+    ,
+  {
+  }
+
+  impl< T > IdentityInterface for T
+  where
+    T :
+      'static +
+      Copy +
+      Hash +
+      fmt::Debug +
+      PartialEq +
+      Eq
+    ,
+  {
+  }
+
+  /// Uniquely identify the node.
+  pub trait NodeId : IdentityInterface
+  {
+  }
+
+}
+
+crate::mod_interface!
+{
+  own use { IdentityInterface, NodeId };
+}

module/move/graphs_tools/src/canonical.rs

@@ -0,0 +1,9 @@
+
+/// Define a private namespace for all its items.
+mod private
+{
+}
+
+crate::mod_interface!
+{
+}

module/move/graphs_tools/src/lib.rs

@@ -2,15 +2,8 @@
 #![ doc( html_logo_url = "https://raw.githubusercontent.com/Wandalen/wTools/alpha/asset/img/graph_logo_v1_trans.png" ) ]
 #![ doc( html_favicon_url = "https://raw.githubusercontent.com/Wandalen/wTools/alpha/asset/img/graph_logo_v1_trans.ico" ) ]
 #![ doc( html_root_url = "https://docs.rs/graphs_tools/latest/graphs_tools/" ) ]
-// #![ deny( rust_2018_idioms ) ]
-// #![ deny( missing_debug_implementations ) ]
-// #![ deny( missing_docs ) ]
 #![ deny( unused_imports ) ]
 
-// #![ feature( type_name_of_val ) ]
-// #![ feature( type_alias_impl_trait ) ]
-// #![ feature( trace_macros ) ]
-
 //!
 //! Implementation of automata.
 //!
@@ -19,24 +12,32 @@
 
 #![ allow( unused_imports ) ]
 use iter_tools::iter;
-use data_type::dt;
+// use data_type::dt;
 use meta_tools::meta;
 use strs_tools::string;
-
 use meta_tools::mod_interface;
+
+/// Define a private namespace for all its items.
+mod private
+{
+}
+
 mod_interface!
 {
+
   /// Abstract layer.
   #[ cfg( not( feature = "no_std" ) ) ]
   layer abs;
+
   /// Canonical representation.
   #[ cfg( not( feature = "no_std" ) ) ]
   layer canonical;
-  /// Algorithms.
-  #[ cfg( not( feature = "no_std" ) ) ]
-  layer algo;
 
-  own use ::meta_tools::prelude::*;
+  // /// Algorithms.
+  // #[ cfg( not( feature = "no_std" ) ) ]
+  // layer algo;
+
+  // own use ::meta_tools::prelude::*;
 }
 
 // zzz : implement checks

module/move/graphs_tools/tests/inc/basic_test.rs

@@ -1,15 +1,7 @@
 #![ allow( unused_imports ) ]
 
 use super::*;
-use std::collections::HashSet;
+// use std::collections::HashSet;
 // use wtools::prelude::*;
 
-#[ cfg( not( feature = "no_std" ) ) ]
-mod canonical_node_test;
-#[ cfg( not( feature = "no_std" ) ) ]
-// mod cell_factory_test;
-// #[ cfg( not( feature = "no_std" ) ) ]
-mod factory_test;
-#[ cfg( not( feature = "no_std" ) ) ]
-mod identity_test;
-mod factory_impls;
+mod basic_test;

module/move/graphs_tools/tests/inc/mod.rs

@@ -0,0 +1,49 @@
+[package]
+name = "graphs_tools_deprecated"
+version = "0.3.0"
+edition = "2021"
+authors = [
+  "Kostiantyn Wandalen <[email protected]>",
+  "Dmytro Kryvoruchko <[email protected]>",
+]
+license = "MIT"
+readme = "Readme.md"
+documentation = "https://docs.rs/graphs_tools"
+repository = "https://github.com/Wandalen/wTools/tree/master/module/core/graphs_tools"
+homepage = "https://github.com/Wandalen/wTools/tree/master/module/core/graphs_tools"
+description = """
+Graphs tools.
+"""
+categories = [ "algorithms", "development-tools" ]
+keywords = [ "fundamental", "general-purpose" ]
+
+[lints]
+workspace = true
+
+[package.metadata.docs.rs]
+features = [ "full" ]
+all-features = false
+
+
+[features]
+default = [
+  "enabled"
+]
+full = [
+  "enabled",
+]
+no_std = []
+use_alloc = [ "no_std" ]
+enabled = [ "meta_tools/enabled", "iter_tools/enabled", "data_type/enabled", "strs_tools/enabled" ]
+
+[dependencies]
+indexmap = "~1.8"
+meta_tools = { workspace = true, features = [ "default" ] }
+iter_tools = { workspace = true, features = [ "default" ] }
+data_type = { workspace = true, features = [ "default" ] }
+strs_tools = { workspace = true, features = [ "default" ] }
+derive_tools = { workspace = true, features = [ "default" ] }
+# type_constructor ={ workspace = true, features = [ "default" ] }
+
+[dev-dependencies]
+test_tools = { workspace = true }

module/move/graphs_tools_deprecated/Cargo.toml

@@ -0,0 +1,22 @@
+Copyright Kostiantyn Mysnyk and Out of the Box Systems (c) 2021-2024
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.

module/move/graphs_tools_deprecated/License

@@ -0,0 +1,39 @@
+<!-- {{# generate.module_header{} #}} -->
+
+# Module :: graphs_tools
+<!--{ generate.module_header.start() }-->
+ [![experimental](https://raster.shields.io/static/v1?label=&message=experimental&color=orange)](https://github.com/emersion/stability-badges#experimental) [![rust-status](https://github.com/Wandalen/wTools/actions/workflows/module_graphs_tools_push.yml/badge.svg)](https://github.com/Wandalen/wTools/actions/workflows/module_graphs_tools_push.yml) [![docs.rs](https://img.shields.io/docsrs/graphs_tools?color=e3e8f0&logo=docs.rs)](https://docs.rs/graphs_tools) [![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_FILE=module%2Fmove%2Fgraphs_tools%2Fexamples%2Fgraphs_tools_trivial.rs,RUN_POSTFIX=--example%20graphs_tools_trivial/https://github.com/Wandalen/wTools) [![discord](https://img.shields.io/discord/872391416519737405?color=eee&logo=discord&logoColor=eee&label=ask)](https://discord.gg/m3YfbXpUUY)
+<!--{ generate.module_header.end }-->
+
+**NOT ready for production**
+
+<!--
+### Basic use-case
+
+```rust
+#[ cfg( all( feature = "cell_factory", feature = "use_std" ) ) ]
+{
+  use graphs_tools::prelude::*;
+  use wtools::prelude::*;
+  let node : graphs_tools::canonical::Node = from!( 13 );
+  assert_eq!( node.id(), 13.into() );
+  println!( "{:?}", node );
+  /* print : node::13 */
+}
+```
+
+### To add to your project
+
+```bash
+cargo add graphs_tools
+```
+
+### Try out from the repository
+
+``` shell test
+git clone https://github.com/Wandalen/wTools
+cd wTools
+cd examples/graphs_tools_trivial
+cargo run
+```
+-->

module/move/graphs_tools_deprecated/Readme.md

@@ -0,0 +1,11 @@
+//! qqq : write proper description
+fn main()
+{
+  // xxx : fix me
+  // use graphs_tools::prelude::*;
+  // let node : graphs_tools::canonical::Node = from!( 13 );
+  // assert_eq!( node.id(), 13.into() );
+  // println!( "{:?}", node );
+  /* print : node::13 */
+}
+