strukto-ai--mirage/examples/python/google/sheets_vfs.py

# ========= 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
import json
import os
import sys

from dotenv import load_dotenv

from mirage import MountMode, Workspace
from mirage.resource.gsheets import GSheetsConfig, GSheetsResource

load_dotenv(".env.development")

config = GSheetsConfig(
    client_id=os.environ["GOOGLE_CLIENT_ID"],
    client_secret=os.environ["GOOGLE_CLIENT_SECRET"],
    refresh_token=os.environ["GOOGLE_REFRESH_TOKEN"],
)
resource = GSheetsResource(config=config)


async def main():
    with Workspace({"/gsheets/": resource}, mode=MountMode.READ) as ws:
        vos = sys.modules["os"]
        print(
            "=== VFS MODE: open() reads from Google Sheets transparently ===\n"
        )

        print("--- os.listdir() root ---")
        dirs = vos.listdir("/gsheets")
        for d in dirs:
            print(f"  {d}")

        print("\n--- os.listdir() owned ---")
        sheets = vos.listdir("/gsheets/owned")
        for s in sheets[:5]:
            print(f"  {s}")

        if sheets:
            first = sheets[0]
            path = f"/gsheets/owned/{first}"
            print("\n--- open() + read first spreadsheet ---")
            with open(path) as f:
                content = f.read()
                parsed = json.loads(content)
                title = parsed.get("properties", {}).get("title", "N/A")
                num_sheets = len(parsed.get("sheets", []))
                print(f"  title: {title}")
                print(f"  sheets: {num_sheets}")
                print(f"  preview: {content[:200]}...")

            print("\n--- os.path.exists() ---")
            print(f"  {first}: {vos.path.exists(path)}")
            print(
                f"  nonexistent: {vos.path.exists('/gsheets/owned/nope.json')}"
            )

        print("\n--- bash history ---")
        with open("/.bash_history") as f:
            for i, line in enumerate(f):
                if i >= 6:
                    break
                print(f"  {line.rstrip()[:120]}")

        records = ws.ops.records
        total = sum(r.bytes for r in records)
        print(f"\nStats: {len(records)} ops, {total} bytes transferred")


asyncio.run(main())