Add basic unit tests.

Author: ericpts

apiserver/app.py

@@ -188,7 +188,8 @@ async def delete_session(
 
 
 # Static HTML5 to test the API.
-app.mount("/", StaticFiles(directory="static", html=True), name="static")
+static_dir = os.path.join(os.path.dirname(__file__), "static")
+app.mount("/", StaticFiles(directory=static_dir, html=True), name="static")
 
 if __name__ == "__main__":
     port = int(os.environ.get("PORT", "8000"))

test_agent.py

@@ -0,0 +1,109 @@
+# Copyright 2025 Google LLC
+#
+# 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.
+
+import unittest
+from unittest.mock import MagicMock, patch
+from google.genai import types
+from agent import BrowserAgent, multiply_numbers
+from computers import EnvState
+
+class TestBrowserAgent(unittest.TestCase):
+    def setUp(self):
+        self.mock_browser_computer = MagicMock()
+        self.mock_browser_computer.screen_size.return_value = (1000, 1000)
+        self.agent = BrowserAgent(
+            browser_computer=self.mock_browser_computer,
+            query="test query",
+            model_name="test_model"
+        )
+        # Mock the genai client
+        self.agent._client = MagicMock()
+
+    def test_multiply_numbers(self):
+        self.assertEqual(multiply_numbers(2, 3), {"result": 5})
+
+    def test_handle_action_open_web_browser(self):
+        action = types.FunctionCall(name="open_web_browser", args={})
+        self.agent.handle_action(action)
+        self.mock_browser_computer.open_web_browser.assert_called_once()
+
+    def test_handle_action_click_at(self):
+        action = types.FunctionCall(name="click_at", args={"x": 100, "y": 200})
+        self.agent.handle_action(action)
+        self.mock_browser_computer.click_at.assert_called_once_with(x=100, y=200)
+
+    def test_handle_action_type_text_at(self):
+        action = types.FunctionCall(name="type_text_at", args={"x": 100, "y": 200, "text": "hello"})
+        self.agent.handle_action(action)
+        self.mock_browser_computer.type_text_at.assert_called_once_with(
+            x=100, y=200, text="hello", press_enter=False, clear_before_typing=True
+        )
+
+    def test_handle_action_scroll_document(self):
+        action = types.FunctionCall(name="scroll_document", args={"direction": "down"})
+        self.agent.handle_action(action)
+        self.mock_browser_computer.scroll_document.assert_called_once_with("down")
+
+    def test_handle_action_navigate(self):
+        action = types.FunctionCall(name="navigate", args={"url": "https://example.com"})
+        self.agent.handle_action(action)
+        self.mock_browser_computer.navigate.assert_called_once_with("https://example.com")
+
+    def test_handle_action_unknown_function(self):
+        action = types.FunctionCall(name="unknown_function", args={})
+        with self.assertRaises(ValueError):
+            self.agent.handle_action(action)
+
+    def test_normalize_x(self):
+        self.assertEqual(self.agent.normalize_x(500), 500)
+
+    def test_normalize_y(self):
+        self.assertEqual(self.agent.normalize_y(500), 500)
+
+    @patch('agent.BrowserAgent.get_model_response')
+    def test_run_one_iteration_no_function_calls(self, mock_get_model_response):
+        mock_response = MagicMock()
+        mock_candidate = MagicMock()
+        mock_candidate.content.parts = [types.Part(text="some reasoning")]
+        mock_response.candidates = [mock_candidate]
+        mock_get_model_response.return_value = mock_response
+
+        result = self.agent.run_one_iteration()
+
+        self.assertEqual(result, "COMPLETE")
+        self.assertEqual(len(self.agent._contents), 2)
+        self.assertEqual(self.agent._contents[1], mock_candidate.content)
+
+    @patch('agent.BrowserAgent.get_model_response')
+    @patch('agent.BrowserAgent._execute_function_call')
+    def test_run_one_iteration_with_function_call(self, mock_execute_function_call, mock_get_model_response):
+        mock_response = MagicMock()
+        mock_candidate = MagicMock()
+        function_call = types.FunctionCall(name="navigate", args={"url": "https://example.com"})
+        mock_candidate.content.parts = [types.Part(function_call=function_call)]
+        mock_response.candidates = [mock_candidate]
+        mock_get_model_response.return_value = mock_response
+
+        mock_env_state = EnvState(screenshot=b"screenshot", url="https://example.com")
+        mock_execute_function_call.return_value = mock_env_state
+
+        result = self.agent.run_one_iteration()
+
+        self.assertEqual(result, "CONTINUE")
+        mock_execute_function_call.assert_called_once_with(function_call)
+        self.assertEqual(len(self.agent._contents), 3)
+
+
+if __name__ == "__main__":
+    unittest.main()

test_main.py

@@ -0,0 +1,100 @@
+# Copyright 2025 Google LLC
+#
+# 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.
+
+import unittest
+from unittest.mock import patch, MagicMock
+import main
+
+class TestMain(unittest.TestCase):
+
+    @patch('main.argparse.ArgumentParser')
+    @patch('main.CloudRunComputer')
+    @patch('main.BrowserAgent')
+    def test_main_cloud_run(self, mock_browser_agent, mock_cloud_run_computer, mock_arg_parser):
+        mock_args = MagicMock()
+        mock_args.env = 'cloud-run'
+        mock_args.api_server = 'test_server'
+        mock_args.api_server_key = 'test_key'
+        mock_args.query = 'test_query'
+        mock_args.model = 'test_model'
+        mock_arg_parser.return_value.parse_args.return_value = mock_args
+
+        main.main()
+
+        mock_cloud_run_computer.assert_called_once_with(
+            api_server='test_server',
+            screen_size=main.CLOUD_RUN_SCREEN_SIZE,
+            api_key='test_key'
+        )
+        mock_browser_agent.assert_called_once()
+        mock_browser_agent.return_value.agent_loop.assert_called_once()
+
+    @patch('main.argparse.ArgumentParser')
+    @patch('main.PlaywrightComputer')
+    @patch('main.BrowserAgent')
+    def test_main_playwright(self, mock_browser_agent, mock_playwright_computer, mock_arg_parser):
+        mock_args = MagicMock()
+        mock_args.env = 'playwright'
+        mock_args.initial_url = 'test_url'
+        mock_args.highlight_mouse = True
+        mock_args.query = 'test_query'
+        mock_args.model = 'test_model'
+        mock_args.api_server = None
+        mock_args.api_server_key = None
+        mock_arg_parser.return_value.parse_args.return_value = mock_args
+
+        main.main()
+
+        mock_playwright_computer.assert_called_once_with(
+            screen_size=main.PLAYWRIGHT_SCREEN_SIZE,
+            initial_url='test_url',
+            highlight_mouse=True
+        )
+        mock_browser_agent.assert_called_once()
+        mock_browser_agent.return_value.agent_loop.assert_called_once()
+
+    @patch('main.argparse.ArgumentParser')
+    @patch('main.BrowserbaseComputer')
+    @patch('main.BrowserAgent')
+    def test_main_browserbase(self, mock_browser_agent, mock_browserbase_computer, mock_arg_parser):
+        mock_args = MagicMock()
+        mock_args.env = 'browserbase'
+        mock_args.query = 'test_query'
+        mock_args.model = 'test_model'
+        mock_args.api_server = None
+        mock_args.api_server_key = None
+        mock_args.initial_url = 'https://www.google.com'
+        mock_args.highlight_mouse = False
+        mock_arg_parser.return_value.parse_args.return_value = mock_args
+
+        main.main()
+
+        mock_browserbase_computer.assert_called_once_with(
+            screen_size=main.PLAYWRIGHT_SCREEN_SIZE
+        )
+        mock_browser_agent.assert_called_once()
+        mock_browser_agent.return_value.agent_loop.assert_called_once()
+
+    @patch('main.argparse.ArgumentParser')
+    def test_main_cloud_run_no_api_server(self, mock_arg_parser):
+        mock_args = MagicMock()
+        mock_args.env = 'cloud-run'
+        mock_args.api_server = None
+        mock_arg_parser.return_value.parse_args.return_value = mock_args
+
+        with self.assertRaises(AssertionError):
+            main.main()
+
+if __name__ == '__main__':
+    unittest.main()