Add a deprecation notice to the rtthost crate

Author: Yatekii

Cargo.toml

@@ -12,4 +12,4 @@ keywords = ["embedded"]
 license = "MIT OR Apache-2.0"
 
 [workspace]
-members = ["cargo-embed", "cargo-flash", "probe-rs-debugger", "probe-rs-cli"]
+members = ["cargo-embed", "cargo-flash", "probe-rs-debugger", "probe-rs-cli", "rtthost"]

rtthost/Cargo.toml

@@ -0,0 +1,15 @@
+[package]
+name = "rtthost"
+version.workspace = true
+edition.workspace = true
+description.workspace = true
+documentation.workspace = true
+homepage.workspace = true
+repository.workspace = true
+readme.workspace = true
+license.workspace = true
+categories.workspace = true
+keywords.workspace = true
+
+[badges]
+maintenance = { status = "deprecated" }

rtthost/build.rs

@@ -0,0 +1,26 @@
+fn main() {
+    const TEMPLATE: &str = r#"
+!!!!!!!!!!!!!!!!!!!!!!!!
+`rtthost` has been fully moved to `probe-rs`. To install it, {shell}:
+
+{install-command}
+
+To use the installed program, run `probe-rs run` for full `rtthost` functionality.
+
+For more information, please refer to the documentation at https://probe.rs/docs/tools/probe-rs/.
+!!!!!!!!!!!!!!!!!!!!!!!!
+"#;
+
+    let (shell, install_command) = match std::env::consts::OS {
+        "windows" => ("run the following PowerShell command", "irm https://github.com/probe-rs/probe-rs/releases/latest/download/probe-rs-tools-installer.ps1 | iex"),
+        "linux" | "macos" => ("run the following command", "curl --proto '=https' --tlsv1.2 -LsSf https://github.com/probe-rs/probe-rs/releases/latest/download/probe-rs-tools-installer.sh | sh"),
+        _ => ("see the installation instructions on the website:", "https://probe.rs/docs/getting-started/installation/"),
+    };
+
+    panic!(
+        "{}",
+        TEMPLATE
+            .replace("{shell}", shell)
+            .replace("{install-command}", install_command)
+    );
+}

rtthost/src/main.rs

@@ -0,0 +1,3 @@
+fn main() {
+    println!("Hello, world!");
+}