chore: import upstream snapshot with attribution

examples/python/shared_recording/README.md

@@ -0,0 +1,19 @@
+<!--[metadata]
+title = "Shared recording"
+-->
+
+
+<picture>
+  <img src="https://static.rerun.io/shared_recording/c3da85f1d4c158b8c7afb6bd3278db000b58049d/full.png" alt="">
+  <source media="(max-width: 480px)" srcset="https://static.rerun.io/shared_recording/c3da85f1d4c158b8c7afb6bd3278db000b58049d/480w.png">
+  <source media="(max-width: 768px)" srcset="https://static.rerun.io/shared_recording/c3da85f1d4c158b8c7afb6bd3278db000b58049d/768w.png">
+  <source media="(max-width: 1024px)" srcset="https://static.rerun.io/shared_recording/c3da85f1d4c158b8c7afb6bd3278db000b58049d/1024w.png">
+  <source media="(max-width: 1200px)" srcset="https://static.rerun.io/shared_recording/c3da85f1d4c158b8c7afb6bd3278db000b58049d/1200w.png">
+</picture>
+
+This example demonstrates how to use `RecordingId`s to create a single shared recording across multiple processes.
+
+Run the following multiple times, and you'll see that each invocation adds data to the existing recording rather than creating a new one:
+```bash
+python examples/python/shared_recording/shared_recording.py
+```

examples/python/shared_recording/pyproject.toml

@@ -0,0 +1,12 @@
+[project]
+name = "shared_recording"
+version = "0.1.0"
+readme = "README.md"
+dependencies = ["rerun-sdk"]
+
+[project.scripts]
+shared_recording = "shared_recording:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"

examples/python/shared_recording/shared_recording.py

@@ -0,0 +1,24 @@
+#!/usr/bin/env python3
+"""Demonstrates how to use `RecordingId`s to build a single recording from multiple processes."""
+
+from __future__ import annotations
+
+import os
+import sys
+
+import rerun as rr  # pip install rerun-sdk
+
+
+def main() -> None:
+    # sanity-check since all other example scripts take arguments:
+    assert len(sys.argv) == 1, f"{sys.argv[0]} does not take any arguments"
+
+    rr.init("rerun_example_shared_recording", recording_id="my_shared_recording", spawn=True)
+
+    rr.log("updates", rr.TextLog(f"hello from {os.getpid()}"))
+
+    print("Run me again to append more data to the recording!")
+
+
+if __name__ == "__main__":
+    main()