Skip to content

armgit / cua

Public Imported from GitHub
0

Scale computer-use 2.0 with open-source drivers, cross-OS sandboxes, and benchmarks for training, evaluation, and data generation.

2.4 KB
Raw Blame
"""One Cua SDK tree: task pages lead with local, which needs no `local=`."""

from pathlib import Path
import json
import unittest


DOCS = Path(__file__).resolve().parents[2] / "content" / "docs"

# Task pages: local is the default, so their examples pass no `local=` and
# show no cloud variant (the cloud has its own guide).
UNIFIED = (
    "cua-sdk/index",
    "cua-sdk/quickstart",
    "cua-sdk/guides/services",
    "cua-sdk/guides/images",
    "cua-sdk/guides/lifecycle",
)
# Hand-written Cua SDK pages stay short. A guide that folds in related tasks
# (services with sidecars and secrets, where sandboxes run) gets more room.
MAX_WORDS = 3000


def page(slug: str) -> str:
    return (DOCS / f"{slug}.mdx").read_text()


class UnifiedSandboxDocsTests(unittest.TestCase):
    def test_task_pages_lead_with_local(self):
        for slug in UNIFIED:
            with self.subTest(slug=slug):
                text = page(slug)
                self.assertNotIn("'Local', 'Cloud'", text, f"{slug} has a cloud tab")
                self.assertNotIn("local=False", text, f"{slug} shows a cloud example")
                self.assertNotRegex(text, r"local=True[,)]", f"{slug} passes the default")

    def test_pages_stay_short(self):
        for folder in ("cua-sdk",):
            for path in (DOCS / folder).rglob("*.mdx"):
                if "reference" in path.relative_to(DOCS).parts:
                    continue
                with self.subTest(page=str(path.relative_to(DOCS))):
                    self.assertLess(len(path.read_text().split()), MAX_WORDS)

    def test_happy_path_has_no_pool_vocabulary(self):
        for slug in ("cua-sdk/index", "cua-sdk/quickstart"):
            with self.subTest(slug=slug):
                text = page(slug).lower()
                for word in ("claim_name", "pool_name", "pool.apply", "claim_ttl"):
                    self.assertNotIn(word, text)

    def test_images_page_states_the_windows_license(self):
        text = page("cua-sdk/guides/images")
        self.assertIn("Windows images do not include a Windows license", text)

    def test_cloud_guide_is_removed_and_the_ended_page_stays(self):
        self.assertFalse((DOCS / "cua-sdk" / "guides" / "cloud.mdx").exists())
        text = page("cua-sdk/guides/cua-cloud-ended")
        self.assertIn("Cua Cloud has ended; use a local sandbox or your own computer.", text)
        self.assertFalse((DOCS / "fleets").exists())


if __name__ == "__main__":
    unittest.main()