add Rust IPC example

Author: FranBarInstance

examples/rust/helloworldipc/Cargo.toml

@@ -0,0 +1,8 @@
+[package]
+name = "helloworldipc"
+version = "0.1.0"
+edition = "2021"
+
+[dependencies]
+neutralipcrs = "0.0.0-dev1"
+serde_json = "1.0"

examples/rust/helloworldipc/README.md

@@ -0,0 +1,23 @@
+Neutral TS Hello World IPC example
+==================================
+
+Command line Hello World rust example.
+
+- Requires the IPC server: [Neutral TS IPC Server](https://github.com/FranBarInstance/neutral-ipc/releases)
+- Requires the Rust IPC client: [Neutral TS Rust IPC Client](https://crates.io/crates/neutralipcrs)
+
+Navigate to the examples/rust/helloworldipc directory and then to helloworld:
+
+```
+cargo run
+```
+
+Links
+-----
+
+Neutral TS template engine.
+
+- [Template docs](https://franbarinstance.github.io/neutralts-docs/docs/neutralts/doc/)
+- [Repository](https://github.com/FranBarInstance/neutralts)
+- [Crate](https://crates.io/crates/neutralts)
+- [Examples](https://github.com/FranBarInstance/neutralts-docs/tree/master/examples)

examples/rust/helloworldipc/src/main.rs

@@ -0,0 +1,44 @@
+/**
+ * Neutral TS Hello World Rust IPC example
+ * https://github.com/FranBarInstance/neutralts-docs/
+ */
+
+use neutralipcrs::NeutralIpcTemplate;
+use serde_json::json;
+
+fn main() {
+    // The schema contains among other things the data and variables for the template
+    let schema = json!({
+        "data": {
+            "hello": "Hello World"
+        }
+    });
+
+    // This will also work by doing schema_str.into() later
+    let _schema_str = r#"{
+        "data": {
+            "hello": "Hello World"
+        }
+    }"#;
+
+    // Determine the template full path.
+    // Since the IPC server runs in a separate process,
+    // paths relative to this process will not work.
+    let manifest_dir = env!("CARGO_MANIFEST_DIR");
+    let template_path = format!("{}/template.ntpl", manifest_dir);
+
+    // Create an instance of Template
+    let mut template = NeutralIpcTemplate::from_file_value(&template_path, schema).unwrap();
+
+    // Render the template
+    let contents = template.render().unwrap();
+
+    // Get the status code, text and parameter
+    let status_code: &str = template.get_status_code();
+    let status_text: &str = template.get_status_text();
+    let status_param: &str = template.get_status_param();
+
+    // Print the rendered content, in other cases contents will be sent to output according to framework.
+    println!("{}", contents);
+    println!("Status: {} {} {}", status_code, status_text, status_param);
+}

examples/rust/helloworldipc/template.ntpl

@@ -0,0 +1 @@
+From rust example: {:;hello:}