chore: import upstream snapshot with attribution

python/tests/ops/gdocs/__init__.py

@@ -0,0 +1,13 @@
+# ========= 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. =========

python/tests/ops/gdocs/test_gdocs_vfs.py

@@ -0,0 +1,70 @@
+# ========= 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 json
+from unittest.mock import AsyncMock, patch
+
+import pytest
+
+from mirage.accessor.gdocs import GDocsAccessor
+from mirage.cache.index.ram import RAMIndexCacheStore
+from mirage.ops import Ops
+from mirage.ops.config import OpsMount
+from mirage.ops.gdocs import OPS as GDOCS_OPS
+from mirage.types import MountMode
+
+
+def _make_gdocs_ops():
+    accessor = GDocsAccessor(config=None, token_manager=None)
+    ops_list = []
+    for fn in GDOCS_OPS:
+        if hasattr(fn, "_registered_ops"):
+            ops_list.extend(fn._registered_ops)
+    mount = OpsMount(
+        prefix="/gdocs/",
+        resource_type="gdocs",
+        accessor=accessor,
+        index=RAMIndexCacheStore(),
+        mode=MountMode.READ,
+        ops=ops_list,
+    )
+    return Ops([mount])
+
+
+@pytest.mark.asyncio
+async def test_readdir_root():
+    ops = _make_gdocs_ops()
+    with patch(
+            "mirage.ops.gdocs.readdir.core_readdir",
+            new_callable=AsyncMock,
+            return_value=["/gdocs/owned", "/gdocs/shared"],
+    ):
+        result = await ops.readdir("/gdocs/")
+        assert "/gdocs/owned" in result
+        assert "/gdocs/shared" in result
+
+
+@pytest.mark.asyncio
+async def test_read_doc():
+    ops = _make_gdocs_ops()
+    doc_json = json.dumps({"documentId": "doc1", "title": "Report"}).encode()
+    with patch(
+            "mirage.ops.gdocs.read.core_read",
+            new_callable=AsyncMock,
+            return_value=doc_json,
+    ):
+        result = await ops.read(
+            "/gdocs/owned/2026-04-01_Report__doc1.gdoc.json")
+        parsed = json.loads(result)
+        assert parsed["documentId"] == "doc1"

python/tests/ops/gdocs/test_read.py

@@ -0,0 +1,63 @@
+# ========= 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. =========
+
+from unittest.mock import AsyncMock, patch
+
+import pytest
+
+from mirage.accessor.gdocs import GDocsAccessor
+from mirage.ops.gdocs.read import read
+from mirage.types import PathSpec
+from mirage.utils.key_prefix import mount_key
+
+
+def _scope(path: str, prefix: str = "/gdocs") -> PathSpec:
+    return PathSpec(resource_path=mount_key(path, prefix),
+                    virtual=path,
+                    directory=path.rsplit("/", 1)[0] or "/")
+
+
+@pytest.fixture
+def accessor():
+    return GDocsAccessor(config=None, token_manager=None)
+
+
+@pytest.mark.asyncio
+async def test_read_calls_core(accessor):
+    fn = read._registered_ops[0].fn
+    with patch(
+            "mirage.ops.gdocs.read.core_read",
+            new_callable=AsyncMock,
+            return_value=b"doc content",
+    ) as mock:
+        scope = _scope("/gdocs/owned/file.gdoc.json")
+        result = await fn(accessor, scope, index=None)
+        mock.assert_called_once_with(
+            accessor, _scope("/gdocs/owned/file.gdoc.json", prefix="/gdocs"),
+            None)
+        assert result == b"doc content"
+
+
+@pytest.mark.asyncio
+async def test_read_not_found(accessor):
+    fn = read._registered_ops[0].fn
+    with patch(
+            "mirage.ops.gdocs.read.core_read",
+            new_callable=AsyncMock,
+            side_effect=FileNotFoundError("not found"),
+    ):
+        with pytest.raises(FileNotFoundError):
+            await fn(accessor,
+                     _scope("/gdocs/owned/nonexistent.gdoc.json"),
+                     index=None)

python/tests/ops/gdocs/test_readdir.py

@@ -0,0 +1,64 @@
+# ========= 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. =========
+
+from unittest.mock import AsyncMock, patch
+
+import pytest
+
+from mirage.accessor.gdocs import GDocsAccessor
+from mirage.ops.gdocs.readdir import readdir
+from mirage.types import PathSpec
+from mirage.utils.key_prefix import mount_key
+
+
+def _scope(path: str, prefix: str = "/gdocs") -> PathSpec:
+    return PathSpec(resource_path=mount_key(path, prefix),
+                    virtual=path,
+                    directory=path.rsplit("/", 1)[0] or "/")
+
+
+@pytest.fixture
+def accessor():
+    return GDocsAccessor(config=None, token_manager=None)
+
+
+@pytest.mark.asyncio
+async def test_readdir_calls_core(accessor):
+    fn = readdir._registered_ops[0].fn
+    with patch(
+            "mirage.ops.gdocs.readdir.core_readdir",
+            new_callable=AsyncMock,
+            return_value=["/gdocs/owned", "/gdocs/shared"],
+    ) as mock:
+        scope = _scope("/gdocs")
+        result = await fn(accessor, scope, index=None)
+        mock.assert_called_once_with(accessor, _scope("/gdocs",
+                                                      prefix="/gdocs"), None)
+        assert result == ["/gdocs/owned", "/gdocs/shared"]
+
+
+@pytest.mark.asyncio
+async def test_readdir_owned(accessor):
+    fn = readdir._registered_ops[0].fn
+    with patch(
+            "mirage.ops.gdocs.readdir.core_readdir",
+            new_callable=AsyncMock,
+            return_value=["/gdocs/owned/file.gdoc.json"],
+    ) as mock:
+        scope = _scope("/gdocs/owned")
+        result = await fn(accessor, scope, index=None)
+        mock.assert_called_once_with(accessor,
+                                     _scope("/gdocs/owned", prefix="/gdocs"),
+                                     None)
+        assert "/gdocs/owned/file.gdoc.json" in result

python/tests/ops/gdocs/test_stat.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. =========
+
+from unittest.mock import AsyncMock, patch
+
+import pytest
+
+from mirage.accessor.gdocs import GDocsAccessor
+from mirage.ops.gdocs.stat import stat
+from mirage.types import FileStat, FileType, PathSpec
+from mirage.utils.key_prefix import mount_key
+
+
+def _scope(path: str, prefix: str = "/gdocs") -> PathSpec:
+    return PathSpec(resource_path=mount_key(path, prefix),
+                    virtual=path,
+                    directory=path.rsplit("/", 1)[0] or "/")
+
+
+@pytest.fixture
+def accessor():
+    return GDocsAccessor(config=None, token_manager=None)
+
+
+@pytest.mark.asyncio
+async def test_stat_calls_core(accessor):
+    fn = stat._registered_ops[0].fn
+    fake_stat = FileStat(name="/", type=FileType.DIRECTORY)
+    with patch(
+            "mirage.ops.gdocs.stat.core_stat",
+            new_callable=AsyncMock,
+            return_value=fake_stat,
+    ) as mock:
+        scope = _scope("/gdocs")
+        result = await fn(accessor, scope, index=None)
+        mock.assert_called_once_with(accessor, _scope("/gdocs",
+                                                      prefix="/gdocs"), None)
+        assert result == fake_stat
+
+
+@pytest.mark.asyncio
+async def test_stat_doc(accessor):
+    fn = stat._registered_ops[0].fn
+    fake_stat = FileStat(name="file.gdoc.json", type=FileType.JSON)
+    with patch(
+            "mirage.ops.gdocs.stat.core_stat",
+            new_callable=AsyncMock,
+            return_value=fake_stat,
+    ) as mock:
+        scope = _scope("/gdocs/owned/file.gdoc.json")
+        result = await fn(accessor, scope, index=None)
+        mock.assert_called_once_with(
+            accessor, _scope("/gdocs/owned/file.gdoc.json", prefix="/gdocs"),
+            None)
+        assert result.name == "file.gdoc.json"
+
+
+@pytest.mark.asyncio
+async def test_stat_not_found(accessor):
+    fn = stat._registered_ops[0].fn
+    with patch(
+            "mirage.ops.gdocs.stat.core_stat",
+            new_callable=AsyncMock,
+            side_effect=FileNotFoundError("not found"),
+    ):
+        with pytest.raises(FileNotFoundError):
+            await fn(accessor,
+                     _scope("/gdocs/owned/nonexistent.gdoc.json"),
+                     index=None)