chore: import upstream snapshot with attribution

python/tests/accessor/test_hf_buckets.py

@@ -0,0 +1,67 @@
+# ========= 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 pytest
+
+from mirage.accessor.hf_buckets import HfBucketsAccessor, HfBucketsConfig
+from mirage.resource.secrets import reveal_secret
+
+
+def test_config_defaults():
+    cfg = HfBucketsConfig(bucket="myorg/mybkt")
+    assert cfg.bucket == "myorg/mybkt"
+    assert cfg.namespace == "myorg"
+    assert cfg.bucket_name == "mybkt"
+    assert cfg.token is None
+    assert cfg.endpoint == "https://huggingface.co"
+    assert cfg.timeout == 30
+    assert cfg.key_prefix is None
+
+
+def test_config_immutable():
+    cfg = HfBucketsConfig(bucket="myorg/mybkt")
+    with pytest.raises(Exception):
+        cfg.bucket = "other/other"
+
+
+def test_config_rejects_bad_bucket_format():
+    with pytest.raises(ValueError):
+        HfBucketsConfig(bucket="just-one-segment")
+    with pytest.raises(ValueError):
+        HfBucketsConfig(bucket="too/many/slashes")
+    with pytest.raises(ValueError):
+        HfBucketsConfig(bucket="/leading")
+
+
+def test_config_token_secret():
+    cfg = HfBucketsConfig(bucket="myorg/mybkt", token="hf_abc123")
+    assert reveal_secret(cfg.token) == "hf_abc123"
+    assert "hf_abc123" not in repr(cfg)
+
+
+def test_accessor_holds_config():
+    cfg = HfBucketsConfig(bucket="myorg/mybkt")
+    acc = HfBucketsAccessor(cfg)
+    assert acc.config is cfg
+
+
+def test_bucket_uri():
+    cfg = HfBucketsConfig(bucket="myorg/mybkt")
+    acc = HfBucketsAccessor(cfg)
+    assert acc.bucket_uri == "hf://buckets/myorg/mybkt"
+
+
+def test_key_prefix_normalized():
+    cfg = HfBucketsConfig(bucket="myorg/mybkt", key_prefix="/data/sub/")
+    assert cfg.key_prefix == "data/sub/"

python/tests/accessor/test_hf_datasets.py

@@ -0,0 +1,54 @@
+# ========= 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 pytest
+
+from mirage.accessor.hf_datasets import HfDatasetsAccessor, HfDatasetsConfig
+from mirage.resource.secrets import reveal_secret
+
+
+def test_config_defaults():
+    cfg = HfDatasetsConfig(repo_id="org/dataset")
+    assert cfg.repo_id == "org/dataset"
+    assert cfg.namespace == "org"
+    assert cfg.repo_name == "dataset"
+    assert cfg.token is None
+    assert cfg.endpoint == "https://huggingface.co"
+    assert cfg.key_prefix is None
+    assert cfg.revision is None
+
+
+def test_config_rejects_bad_repo_id():
+    with pytest.raises(ValueError):
+        HfDatasetsConfig(repo_id="just-one-segment")
+    with pytest.raises(ValueError):
+        HfDatasetsConfig(repo_id="too/many/slashes")
+
+
+def test_config_token_secret():
+    cfg = HfDatasetsConfig(repo_id="org/dataset", token="hf_abc123")
+    assert reveal_secret(cfg.token) == "hf_abc123"
+    assert "hf_abc123" not in repr(cfg)
+
+
+def test_accessor_repo_type_and_uri():
+    cfg = HfDatasetsConfig(repo_id="org/dataset")
+    acc = HfDatasetsAccessor(cfg)
+    assert acc.REPO_TYPE == "dataset"
+    assert acc.bucket_uri == "hf://datasets/org/dataset"
+
+
+def test_key_prefix_normalized():
+    cfg = HfDatasetsConfig(repo_id="org/dataset", key_prefix="/data/sub/")
+    assert cfg.key_prefix == "data/sub/"

python/tests/accessor/test_hf_models.py

@@ -0,0 +1,45 @@
+# ========= 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 pytest
+
+from mirage.accessor.hf_models import HfModelsAccessor, HfModelsConfig
+from mirage.resource.secrets import reveal_secret
+
+
+def test_config_defaults():
+    cfg = HfModelsConfig(repo_id="org/model")
+    assert cfg.repo_id == "org/model"
+    assert cfg.namespace == "org"
+    assert cfg.repo_name == "model"
+    assert cfg.token is None
+    assert cfg.endpoint == "https://huggingface.co"
+    assert cfg.revision is None
+
+
+def test_config_rejects_bad_repo_id():
+    with pytest.raises(ValueError):
+        HfModelsConfig(repo_id="just-one-segment")
+
+
+def test_config_token_secret():
+    cfg = HfModelsConfig(repo_id="org/model", token="hf_abc123")
+    assert reveal_secret(cfg.token) == "hf_abc123"
+
+
+def test_accessor_repo_type_and_uri():
+    cfg = HfModelsConfig(repo_id="org/model")
+    acc = HfModelsAccessor(cfg)
+    assert acc.REPO_TYPE == "model"
+    assert acc.bucket_uri == "hf://models/org/model"

python/tests/accessor/test_hf_spaces.py

@@ -0,0 +1,45 @@
+# ========= 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 pytest
+
+from mirage.accessor.hf_spaces import HfSpacesAccessor, HfSpacesConfig
+from mirage.resource.secrets import reveal_secret
+
+
+def test_config_defaults():
+    cfg = HfSpacesConfig(repo_id="org/space")
+    assert cfg.repo_id == "org/space"
+    assert cfg.namespace == "org"
+    assert cfg.repo_name == "space"
+    assert cfg.token is None
+    assert cfg.endpoint == "https://huggingface.co"
+    assert cfg.revision is None
+
+
+def test_config_rejects_bad_repo_id():
+    with pytest.raises(ValueError):
+        HfSpacesConfig(repo_id="just-one-segment")
+
+
+def test_config_token_secret():
+    cfg = HfSpacesConfig(repo_id="org/space", token="hf_abc123")
+    assert reveal_secret(cfg.token) == "hf_abc123"
+
+
+def test_accessor_repo_type_and_uri():
+    cfg = HfSpacesConfig(repo_id="org/space")
+    acc = HfSpacesAccessor(cfg)
+    assert acc.REPO_TYPE == "space"
+    assert acc.bucket_uri == "hf://spaces/org/space"

python/tests/accessor/test_mongodb.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 MagicMock, patch
+
+import pytest
+from pymongo.driver_info import DriverInfo
+
+from mirage.accessor.mongodb import _DRIVER_INFO, MongoDBAccessor
+from mirage.resource.mongodb.config import MongoDBConfig
+
+
+@pytest.fixture
+def accessor():
+    return MongoDBAccessor(config=MongoDBConfig(
+        uri="mongodb://localhost:27017"))
+
+
+def test_driver_info_is_pymongo_driverinfo_named_mirage():
+    assert isinstance(_DRIVER_INFO, DriverInfo)
+    assert _DRIVER_INFO.name == "Mirage"
+
+
+@pytest.mark.asyncio
+async def test_client_constructs_async_mongo_client_with_driver_info(accessor):
+    sentinel = MagicMock()
+    with patch("mirage.accessor.mongodb.AsyncMongoClient",
+               return_value=sentinel) as ctor:
+        client = accessor.client
+    assert client is sentinel
+    ctor.assert_called_once_with("mongodb://localhost:27017",
+                                 driver=_DRIVER_INFO)
+
+
+@pytest.mark.asyncio
+async def test_client_is_cached_per_event_loop(accessor):
+    with patch("mirage.accessor.mongodb.AsyncMongoClient",
+               side_effect=lambda *a, **k: MagicMock()) as ctor:
+        first = accessor.client
+        second = accessor.client
+    assert first is second
+    ctor.assert_called_once()
+
+
+def test_client_built_outside_event_loop_uses_loopless_key(accessor):
+    with patch("mirage.accessor.mongodb.AsyncMongoClient",
+               side_effect=lambda *a, **k: MagicMock()) as ctor:
+        first = accessor.client
+        second = accessor.client
+    assert first is second
+    ctor.assert_called_once()
+    assert 0 in accessor._clients