feat(plugin-tee): setup

Author: topheman

Cargo.lock

@@ -7,6 +7,7 @@ members = [
     "crates/plugin-ls",
     "crates/plugin-cat",
     "crates/plugin-weather",
+    "crates/plugin-tee",
     "crates/repl-logic-guest",
 ]
 

Cargo.toml

@@ -0,0 +1 @@
+src/bindings.rs

crates/plugin-tee/.gitignore

@@ -0,0 +1,18 @@
+[package]
+name = "plugin-tee"
+version = "0.1.0"
+edition = { workspace = true }
+publish = false
+description = "Example tee plugin for REPL based on WebAssembly Component Model - demonstrates file system access and modification"
+
+[dependencies]
+wit-bindgen-rt = { workspace = true, features = ["bitflags"] }
+
+[lib]
+crate-type = ["cdylib"]
+
+[package.metadata.component]
+package = "repl:api"
+target = { path = "../pluginlab/wit", world = "plugin-api" }
+
+[package.metadata.component.dependencies]

crates/plugin-tee/Cargo.toml

@@ -0,0 +1,14 @@
+# plugin-tee
+
+Basic plugin for this REPL. Behaves like the `tee` command.
+
+## Notes
+
+This crate was initialized with `cargo component new`.
+
+The building process is handled by the [`justfile`](../../justfile) in the root of the project.
+
+The `cargo component build` command is used to build the plugin.
+
+- It generates the `src/bindings.rs` file, based on the `package.metadata.component` section in the `Cargo.toml` file that describes where to find the component definition (wit files).
+- It then compiles the plugin to WebAssembly.

crates/plugin-tee/README.md

@@ -0,0 +1,42 @@
+#[allow(warnings)]
+mod bindings;
+
+use crate::bindings::exports::repl::api::plugin::Guest;
+use crate::bindings::repl::api::transport;
+
+struct Component;
+
+impl Guest for Component {
+    fn name() -> String {
+        "tee".to_string()
+    }
+
+    fn man() -> String {
+        r#"
+NAME
+    tee - Copy $0 content to a file (built with Rust🦀)
+
+USAGE
+    tee <file>
+    tee -a <file>
+
+OPTIONS
+    -a, --append  Append to the file instead of overwriting it
+
+DESCRIPTION
+    Copy $0 content to a file.
+
+        "#
+        .to_string()
+    }
+
+    fn run(payload: String) -> Result<transport::PluginResponse, ()> {
+        Ok(transport::PluginResponse {
+            status: transport::ReplStatus::Success,
+            stdout: Some(format!("{}", payload)),
+            stderr: None,
+        })
+    }
+}
+
+bindings::export!(Component with_types_in bindings);