Add Rust bindings and CLI example

.gitignore

@@ -1,6 +1,7 @@
 build
 dist
 node_modules
+target
 
 .merlin
 .cljs_node_repl

rs/Cargo.toml

@@ -0,0 +1,29 @@
+[workspace]
+members = ["cli", "elementary"]
+default-members = ["elementary"]
+resolver = "2"
+
+[workspace.package]
+authors = ["The Elementary Authors"]
+categories = ["multimedia::audio"]
+edition = "2021"
+license = "MIT"
+repository = "https://github.com/elemaudio/elementary"
+rust-version = "1.75.0"
+# TODO Update on release
+version = "5.0.0"
+
+[workspace.dependencies]
+
+[profile.dev.package."*"]
+debug-assertions = false
+
+# Speedup build on macOS
+# See https://blog.rust-lang.org/2021/03/25/Rust-1.51.0.html#splitting-debug-information
+[profile.dev]
+debug-assertions = true
+split-debuginfo = "unpacked"
+
+[profile.release]
+# Will slow-down compile, but improve perf on generated code.
+codegen-units = 1

rs/cli/Cargo.toml

@@ -0,0 +1,20 @@
+[package]
+name = "elementary-cli"
+publish = false
+version = { workspace = true }
+description = "An example CLI project demonstrating Elementary Audio runtime bindings"
+license = { workspace = true }
+readme = "README.md"
+repository = { workspace = true }
+edition = { workspace = true }
+rust-version = { workspace = true }
+
+[[bin]]
+name = "elementary"
+path = "src/main.rs"
+doc = false
+bench = false
+
+[dependencies]
+# TODO Update version on release
+elementary = { version = "5.0.0", path = "../elementary" }

rs/cli/README.md

@@ -0,0 +1 @@
+TODO

rs/cli/src/main.rs

@@ -0,0 +1,5 @@
+use elementary::say_name;
+
+fn main() {
+    println!("Hello from {}!", say_name());
+}

rs/elementary/Cargo.toml

@@ -0,0 +1,26 @@
+[package]
+name = "elementary"
+version = { workspace = true }
+description = "Elementary Audio runtime bindings"
+keywords = ["audio", "dsp"]
+categories = { workspace = true }
+license = { workspace = true }
+readme = "README.md"
+# TODO Update with appropriate docs link
+documentation = "https://www.elementary.audio/docs"
+repository = { workspace = true }
+authors = { workspace = true }
+edition = { workspace = true }
+rust-version = { workspace = true }
+
+[lib]
+path = "src/lib.rs"
+bench = false
+doctest = true
+
+[dependencies]
+ciborium = "0.2.2"
+cxx = "1.0"
+
+[build-dependencies]
+cxx-build = "1.0"

rs/elementary/README.md

@@ -0,0 +1 @@
+TODO

rs/elementary/build.rs

@@ -0,0 +1,11 @@
+fn main() {
+    cxx_build::bridge("src/lib.rs")
+        .flag_if_supported("-std=c++20")
+        .compile("elementary");
+
+    println!("cargo:rerun-if-changed=src/lib.rs");
+    println!("cargo:rerun-if-changed=src/include/Main.cpp");
+    println!("cargo:rerun-if-changed=src/include/Runtime.h");
+    println!("cargo:rerun-if-changed=src/include/cxx.h");
+    println!("cargo:rerun-if-changed=src/include/JSON.h");
+}

rs/elementary/compile_flags.txt

@@ -0,0 +1,2 @@
+-xc++
+-std=c++20