chore: import upstream snapshot with attribution

examples/python/ssh/ssh.py

@@ -0,0 +1,157 @@
+# ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+
+import asyncio
+
+from mirage import MountMode, Workspace
+from mirage.resource.ssh import SSHConfig, SSHResource
+
+# ~/.ssh/config:
+#   Host dev
+#       HostName ec2-18-224-181-224.us-east-2.compute.amazonaws.com
+#       IdentityFile ~/.ssh/dev.pem
+#       User ubuntu
+#       Port 22
+
+config = SSHConfig(
+    host="dev",
+    root="/home/ubuntu/mirage-test",
+    known_hosts=None,
+)
+
+resource = SSHResource(config)
+
+
+async def main() -> None:
+    ws = Workspace({"/ssh/": resource}, mode=MountMode.WRITE)
+
+    print("=== ls /ssh/ ===")
+    result = await ws.execute("ls /ssh/")
+    print(await result.stdout_str())
+
+    print("=== stat /ssh/ ===")
+    result = await ws.execute("stat /ssh/")
+    print(await result.stdout_str())
+
+    print("=== tree /ssh/ ===")
+    result = await ws.execute("tree /ssh/")
+    print(await result.stdout_str())
+
+    print("=== find /ssh/ ===")
+    result = await ws.execute("find /ssh/")
+    print(await result.stdout_str())
+
+    print("=== du /ssh/ ===")
+    result = await ws.execute("du /ssh/")
+    print(await result.stdout_str())
+
+    print("=== cat /ssh/readme.txt ===")
+    result = await ws.execute("cat /ssh/readme.txt")
+    print(await result.stdout_str())
+
+    print("=== head -n 1 /ssh/data.txt ===")
+    result = await ws.execute("head -n 1 /ssh/data.txt")
+    print(await result.stdout_str())
+
+    print("=== wc /ssh/readme.txt ===")
+    result = await ws.execute("wc /ssh/readme.txt")
+    print(await result.stdout_str())
+
+    print("=== grep hello /ssh/readme.txt ===")
+    result = await ws.execute("grep hello /ssh/readme.txt")
+    print(await result.stdout_str())
+
+    # ── generic text commands (delegate to shared generics) ──
+    for cmd in [
+            "sort /ssh/data.txt",
+            "sort -r /ssh/data.txt",
+            "nl /ssh/data.txt",
+            "rev /ssh/data.txt",
+            "tac /ssh/data.txt",
+            "cut -c1-4 /ssh/data.txt",
+            "uniq /ssh/data.txt",
+            "fold -w 3 /ssh/data.txt",
+            "head -n 2 /ssh/data.txt",
+            "tail -n 1 /ssh/data.txt",
+            "wc -l /ssh/data.txt",
+            "sha256sum /ssh/data.txt",
+    ]:
+        print(f"=== {cmd} ===")
+        result = await ws.execute(cmd)
+        print(await result.stdout_str())
+
+    print("=== cd /ssh/ && ls ===")
+    await ws.execute("cd /ssh/")
+    result = await ws.execute("ls")
+    print(await result.stdout_str())
+
+    print("=== pwd ===")
+    result = await ws.execute("pwd")
+    print(await result.stdout_str())
+
+    print("=== cd /ssh/docs && cat guide.txt ===")
+    await ws.execute("cd /ssh/docs")
+    result = await ws.execute("cat guide.txt")
+    print(await result.stdout_str())
+
+    print("=== cd .. && ls ===")
+    await ws.execute("cd ..")
+    result = await ws.execute("ls")
+    print(await result.stdout_str())
+
+    print("=== echo hello > /ssh/test.txt ===")
+    await ws.execute("echo hello > /ssh/test.txt")
+
+    print("=== cat /ssh/test.txt ===")
+    result = await ws.execute("cat /ssh/test.txt")
+    print(await result.stdout_str())
+
+    print("=== cp /ssh/test.txt /ssh/test2.txt ===")
+    await ws.execute("cp /ssh/test.txt /ssh/test2.txt")
+    result = await ws.execute("ls /ssh/")
+    print(await result.stdout_str())
+
+    print("=== mv /ssh/test2.txt /ssh/renamed.txt ===")
+    await ws.execute("mv /ssh/test2.txt /ssh/renamed.txt")
+    result = await ws.execute("ls /ssh/")
+    print(await result.stdout_str())
+
+    print("=== mkdir /ssh/subdir ===")
+    await ws.execute("mkdir /ssh/subdir")
+
+    print("=== echo world > /ssh/subdir/nested.txt ===")
+    await ws.execute("echo world > /ssh/subdir/nested.txt")
+
+    print("=== tree /ssh/ ===")
+    result = await ws.execute("tree /ssh/")
+    print(await result.stdout_str())
+
+    print("=== rm /ssh/renamed.txt ===")
+    await ws.execute("rm /ssh/renamed.txt")
+
+    print("=== rm -r /ssh/subdir ===")
+    await ws.execute("rm -r /ssh/subdir")
+
+    print("=== rm /ssh/test.txt ===")
+    await ws.execute("rm /ssh/test.txt")
+
+    print("=== final ls /ssh/ ===")
+    result = await ws.execute("ls /ssh/")
+    print(await result.stdout_str())
+
+    await resource.accessor.close()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

examples/python/ssh/ssh_fuse.py

@@ -0,0 +1,80 @@
+# ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+
+import os
+
+from mirage import Mount, MountMode, Workspace
+from mirage.resource.ssh import SSHConfig, SSHResource
+
+# ~/.ssh/config:
+#   Host dev
+#       HostName ec2-18-224-181-224.us-east-2.compute.amazonaws.com
+#       IdentityFile ~/.ssh/dev.pem
+#       User ubuntu
+#       Port 22
+
+config = SSHConfig(
+    host="dev",
+    root="/home/ubuntu/mirage-test",
+    known_hosts=None,
+)
+resource = SSHResource(config)
+
+with Workspace({"/ssh/": Mount(resource, mode=MountMode.WRITE,
+                               fuse=True)}) as ws:
+    mp = ws.fuse_mountpoint
+
+    print(f"=== FUSE MODE: mounted at {mp} ===\n")
+
+    print("--- os.listdir() top-level ---")
+    top_level = os.listdir(mp)
+    for entry in top_level:
+        print(f"  {entry}")
+
+    if not top_level:
+        print("  no entries found")
+    else:
+        print(f"\n--- open() + read {top_level[0]} ---")
+        path = f"{mp}/{top_level[0]}"
+        if os.path.isfile(path):
+            with open(path) as f:
+                content = f.read().strip()
+            for line in content.splitlines()[:5]:
+                print(f"  {line[:120]}")
+            if len(content.splitlines()) > 5:
+                print(f"  ... ({len(content.splitlines())} lines total)")
+
+        print("\n--- os.stat() ---")
+        for entry in top_level:
+            st = os.stat(f"{mp}/{entry}")
+            kind = "dir" if os.path.isdir(f"{mp}/{entry}") else "file"
+            print(f"  {entry}: {kind}, {st.st_size} bytes")
+
+        print("\n--- os.walk() ---")
+        for root, dirs, files in os.walk(mp):
+            rel = os.path.relpath(root, mp)
+            for f in files:
+                print(f"  {os.path.join(rel, f)}")
+
+    print(f"\n>>> FUSE mounted at: {mp}")
+    print(">>> Open another terminal and run:")
+    print(f">>>   ls {mp}/")
+    print(f">>>   cat {mp}/readme.txt")
+    print(">>> Press Enter to unmount and exit...")
+    input()
+
+    records = ws.ops.records
+    total = sum(r.bytes for r in records)
+    print(f"\nStats: {len(records)} ops, "
+          f"{total} bytes transferred")