Add "spawn" variants for Quick Start guides

crates/re_smart_channel/src/receive_set.rs

@@ -53,6 +53,14 @@ impl<T: Send> ReceiveSet<T> {
         !self.is_empty()
     }
 
+    /// Does this viewer accept inbound TCP connections?
+    pub fn accepts_tcp_connections(&self) -> bool {
+        re_tracing::profile_function!();
+        self.sources()
+            .iter()
+            .any(|s| matches!(**s, SmartChannelSource::TcpServer { .. }))
+    }
+
     /// No connected receivers?
     ///
     /// This gets updated after calling one of the `recv` methods.

crates/re_viewer/data/quick_start_guides/cpp_spawn.md

@@ -0,0 +1,3 @@
+## C++ Quick Start
+
+TODO(ab): https://github.com/rerun-io/rerun/issues/3870

crates/re_viewer/data/quick_start_guides/python_native.md → crates/re_viewer/data/quick_start_guides/python_connect.md

@@ -18,7 +18,7 @@ The Rerun SDK comes with a demo that can be used to try the viewer. You can send
 to this viewer using the following command:
 
 ```sh
-python -m rerun_sdk.demo --connect
+python -m rerun_sdk --connect
 ```
 
 This will open a new recording that looks like this:

crates/re_viewer/data/quick_start_guides/python_spawn.md

@@ -0,0 +1,36 @@
+## Python Quick Start
+
+${SAFARI_WARNING}
+
+### Installing the Rerun SDK
+
+The Rerun SDK is available on [PyPI](https://pypi.org/) under the
+[`rerun-sdk`](https://pypi.org/project/rerun-sdk/) name. It can be installed like any other
+Python package:
+
+```sh
+pip install rerun-sdk
+```
+
+### Try out the viewer
+
+The Rerun SDK comes with a demo that can be used to try the viewer. You can spawn a native viewer and load a demo using the following command:
+
+```sh
+python -m rerun_sdk
+```
+
+This will open a new recording that looks like this:
+
+![Demo recording](https://static.rerun.io/quickstart2_simple_cube/632a8f1c79f70a2355fad294fe085291fcf3a8ae/768w.png)
+
+
+### Logging your own data
+
+Instead of a pre-packaged demo, you can log your own data. Copy and paste the following snippet in a new Python file and execute it to create a recording in a new viewer:
+
+```python
+${EXAMPLE_CODE}
+```
+
+${HOW_DOES_IT_WORK}

crates/re_viewer/data/quick_start_guides/quick_start_spawn.cpp

@@ -0,0 +1 @@
+../../../../docs/code-examples/quick_start_spawn.cpp

crates/re_viewer/data/quick_start_guides/quick_start_spawn.py

@@ -0,0 +1 @@
+../../../../docs/code-examples/quick_start_spawn.py

crates/re_viewer/data/quick_start_guides/quick_start_spawn.rs

@@ -0,0 +1 @@
+../../../../docs/code-examples/quick_start_spawn.rs

crates/re_viewer/data/quick_start_guides/rust_spawn.md

@@ -0,0 +1,35 @@
+## Rust Quick Start
+
+${SAFARI_WARNING}
+
+### Installing Rerun
+
+To use the Rerun SDK in your project, you need the [rerun crate](https://crates.io/crates/rerun) which you can add with `cargo add rerun`.
+
+Let's try it out in a brand-new Rust project:
+
+```sh
+cargo init cube && cd cube && cargo add rerun --features native_viewer
+```
+
+Note that the Rerun SDK requires a working installation of Rust 1.72+.
+
+### Logging your own data
+
+Add the following code to your `main.rs` file:
+
+```rust
+${EXAMPLE_CODE}
+```
+
+You can now run your application:
+
+```shell
+cargo run
+```
+
+Once everything finishes compiling, a new viewer will start displaying these points:
+
+![Demo recording](https://static.rerun.io/intro_rust_result/cc780eb9bf014d8b1a68fac174b654931f92e14f/768w.png)
+
+${HOW_DOES_IT_WORK}

crates/re_viewer/src/ui/welcome_screen/welcome_page.rs

@@ -22,7 +22,9 @@ pub(super) fn welcome_page_ui(
     command_sender: &re_viewer_context::CommandSender,
 ) -> WelcomeScreenResponse {
     ui.vertical(|ui| {
-        let show_example = onboarding_content_ui(ui, command_sender);
+        let accepts_connections = rx.accepts_tcp_connections();
+
+        let show_example = onboarding_content_ui(ui, command_sender, accepts_connections);
 
         for status_strings in status_strings(rx) {
             if status_strings.long_term {
@@ -52,6 +54,7 @@ struct WelcomePagePanel<'a> {
 fn onboarding_content_ui(
     ui: &mut Ui,
     command_sender: &re_viewer_context::CommandSender,
+    accepts_connections: bool,
 ) -> WelcomeScreenResponse {
     // The panel data is stored in this ad hoc structure such that it can easily be iterated over
     // in chunks, to make the layout grid code simpler.
@@ -63,19 +66,30 @@ fn onboarding_content_ui(
             image: &re_ui::icons::WELCOME_SCREEN_LIVE_DATA,
             add_buttons: Box::new(|ui: &mut egui::Ui| {
                 //TODO(#3870): enable with C++ guides are completed
-                #[allow(clippy::collapsible_if)]
+                #[allow(clippy::collapsible_if, clippy::if_same_then_else)]
                 if false {
                     if large_text_button(ui, "C++").clicked() {
+                        let (markdown, code) = if accepts_connections {
+                            (
+                                include_str!("../../../data/quick_start_guides/cpp_connect.md"),
+                                include_str!(
+                                    "../../../data/quick_start_guides/quick_start_connect.cpp"
+                                ),
+                            )
+                        } else {
+                            (
+                                include_str!("../../../data/quick_start_guides/cpp_spawn.md"),
+                                include_str!(
+                                    "../../../data/quick_start_guides/quick_start_spawn.cpp"
+                                ),
+                            )
+                        };
+
                         open_quick_start(
                             command_sender,
-                            include_str!("../../../data/quick_start_guides/cpp_native.md"),
+                            markdown,
                             [
-                                (
-                                    "EXAMPLE_CODE",
-                                    include_str!(
-                                        "../../../data/quick_start_guides/quick_start_connect.cpp"
-                                    ),
-                                ),
+                                ("EXAMPLE_CODE", code),
                                 ("HOW_DOES_IT_WORK", HOW_DOES_IT_WORK),
                                 ("SAFARI_WARNING", safari_warning()),
                             ]
@@ -86,16 +100,23 @@ fn onboarding_content_ui(
                     }
                 }
                 if large_text_button(ui, "Python").clicked() {
+                    let (markdown, code) = if accepts_connections {
+                        (
+                            include_str!("../../../data/quick_start_guides/python_connect.md"),
+                            include_str!("../../../data/quick_start_guides/quick_start_connect.py"),
+                        )
+                    } else {
+                        (
+                            include_str!("../../../data/quick_start_guides/python_spawn.md"),
+                            include_str!("../../../data/quick_start_guides/quick_start_spawn.py"),
+                        )
+                    };
+
                     open_quick_start(
                         command_sender,
-                        include_str!("../../../data/quick_start_guides/python_native.md"),
+                        markdown,
                         [
-                            (
-                                "EXAMPLE_CODE",
-                                include_str!(
-                                    "../../../data/quick_start_guides/quick_start_connect.py"
-                                ),
-                            ),
+                            ("EXAMPLE_CODE", code),
                             ("HOW_DOES_IT_WORK", HOW_DOES_IT_WORK),
                             ("SAFARI_WARNING", safari_warning()),
                         ]
@@ -105,16 +126,23 @@ fn onboarding_content_ui(
                     );
                 }
                 if large_text_button(ui, "Rust").clicked() {
+                    let (markdown, code) = if accepts_connections {
+                        (
+                            include_str!("../../../data/quick_start_guides/rust_connect.md"),
+                            include_str!("../../../data/quick_start_guides/quick_start_connect.rs"),
+                        )
+                    } else {
+                        (
+                            include_str!("../../../data/quick_start_guides/rust_spawn.md"),
+                            include_str!("../../../data/quick_start_guides/quick_start_spawn.rs"),
+                        )
+                    };
+
                     open_quick_start(
                         command_sender,
-                        include_str!("../../../data/quick_start_guides/rust_native.md"),
+                        markdown,
                         [
-                            (
-                                "EXAMPLE_CODE",
-                                include_str!(
-                                    "../../../data/quick_start_guides/quick_start_connect.rs"
-                                ),
-                            ),
+                            ("EXAMPLE_CODE", code),
                             ("HOW_DOES_IT_WORK", HOW_DOES_IT_WORK),
                             ("SAFARI_WARNING", safari_warning()),
                         ]

docs/code-examples/Cargo.toml

@@ -139,6 +139,10 @@ path = "point3d_simple.rs"
 name = "quick_start_connect"
 path = "quick_start_connect.rs"
 
+[[bin]]
+name = "quick_start_spawn"
+path = "quick_start_spawn.rs"
+
 [[bin]]
 name = "scalar_simple"
 path = "scalar_simple.rs"

docs/code-examples/quick_start_spawn.cpp

@@ -0,0 +1,5 @@
+// TODO(ab): https://github.com/rerun-io/rerun/issues/3870
+
+int main() {
+    return 0;
+}

docs/code-examples/quick_start_spawn.py

@@ -0,0 +1,24 @@
+"""Connect to the viewer and log some data."""
+
+import numpy as np
+import rerun as rr
+
+# Initialize the SDK, give our recording a unique name, and spawn a viewer
+rr.init("rerun_example_demo", spawn=True)
+
+# Create some data
+SIZE = 10
+
+pos_grid = np.meshgrid(*[np.linspace(-10, 10, SIZE)] * 3)
+positions = np.vstack([d.reshape(-1) for d in pos_grid]).T
+
+col_grid = np.meshgrid(*[np.linspace(0, 255, SIZE)] * 3)
+colors = np.vstack([c.reshape(-1) for c in col_grid]).astype(np.uint8).T
+
+# Log the data
+rr.log(
+    # name under which this entity is logged (known as "entity path")
+    "my_points",
+    # log data as a 3D point cloud archetype
+    rr.Points3D(positions, colors=colors, radii=0.5),
+)

docs/code-examples/quick_start_spawn.rs

@@ -0,0 +1,26 @@
+//! Connect to the viewer and log some data.
+
+use rerun::{demo_util::grid, external::glam};
+
+fn main() -> Result<(), Box<dyn std::error::Error>> {
+    // Create a new `RecordingStream` which stores data in memory.
+    let (rec, storage) = rerun::RecordingStreamBuilder::new("rerun_example_minimal_rs").memory()?;
+
+    // Create some data using the `grid` utility function.
+    let points = grid(glam::Vec3::splat(-10.0), glam::Vec3::splat(10.0), 10);
+    let colors = grid(glam::Vec3::ZERO, glam::Vec3::splat(255.0), 10)
+        .map(|v| rerun::Color::from_rgb(v.x as u8, v.y as u8, v.z as u8));
+
+    // Log the "my_points" entity with our data, using the `Points3D` archetype.
+    rec.log(
+        "my_points",
+        &rerun::Points3D::new(points)
+            .with_colors(colors)
+            .with_radii([0.5]),
+    )?;
+
+    // Show the viewer with the recorded data.
+    rerun::native_viewer::show(storage.take())?;
+
+    Ok(())
+}

docs/code-examples/roundtrips.py

@@ -30,6 +30,7 @@
     "image_simple": ["cpp"], # TODO(#2919): Not yet implemented in C++
     "log_line": ["cpp", "rust", "py"], # Not a complete example -- just a single log line
     "quick_start_connect": ["cpp"], # TODO(#3870): Not yet implemented in C++
+    "quick_start_spawn": ["cpp"], # TODO(#3870): Not yet implemented in C++
     "scalar_multiple_plots": ["cpp"], # TODO(#2919): Not yet implemented in C++
     "segmentation_image_simple": ["cpp"], # TODO(#2919): Not yet implemented in C++
     "tensor_simple": ["cpp"], # TODO(#2919): Not yet implemented in C++
@@ -51,6 +52,7 @@
     "point2d_random": ["cpp", "py", "rust"], # TODO(#3206): examples use different RNGs
     "point3d_random": ["cpp", "py", "rust"], # TODO(#3206): examples use different RNGs
     "quick_start_connect":  ["cpp", "py", "rust"], # These example don't have exactly the same implementation.
+    "quick_start_spawn":  ["cpp", "py", "rust"], # These example don't have exactly the same implementation.
     "tensor_simple": ["cpp", "py", "rust"], # TODO(#3206): examples use different RNGs
     "transform3d_simple": ["cpp"], # TODO(#2919): Something broken in the C++ SDK
 }