Read Files

from moru import Sandbox

sandbox = Sandbox.create()

# Read as text (default)
content = sandbox.files.read("/etc/hostname")
print(content)

# Explicitly specify text format
content = sandbox.files.read("/home/user/script.py", format="text")

# Read as bytes
data = sandbox.files.read("/path/to/image.png", format="bytes")
print(f"File size: {len(data)} bytes")

# Save locally
with open("local_copy.png", "wb") as f:
    f.write(data)

# Read as stream (iterator)
stream = sandbox.files.read("/path/to/large_file.bin", format="stream")

with open("local_copy.bin", "wb") as f:
    for chunk in stream:
        f.write(chunk)

# Read as root
content = sandbox.files.read("/etc/shadow", user="root")

# Read as another user
content = sandbox.files.read("/home/alice/private.txt", user="alice")

from moru import Sandbox
from moru.exceptions import NotFoundException

try:
    content = sandbox.files.read("/nonexistent/file.txt")
except NotFoundException:
    print("File not found")
except Exception as e:
    print(f"Read failed: {e}")

# Read multiple files
files_to_read = [
    "/home/user/config.json",
    "/home/user/data.csv",
    "/home/user/readme.txt"
]

contents = {}
for path in files_to_read:
    if sandbox.files.exists(path):
        contents[path] = sandbox.files.read(path)

# Get download URL (valid for limited time)
url = sandbox.download_url("/path/to/file.zip")
print(f"Download from: {url}")