@devries-cameron20 / composio-1 / commits / 87765434a
Fork 0

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

test(py): add test for connected_accounts

jkomyno committed Dec 10, 2025 at 11:48 UTC 87765434a9afd9a388e8f9e98dffcae8b5309f9a
2 files changed +301 -20
python/tests/test_connected_accounts.py new
+281
@@ -0,0 +1,281 @@
1 +import logging
2 +import time
3 +from unittest.mock import Mock, patch
4 +
5 +import pytest
6 +
7 +from composio import exceptions
8 +from composio.core.models.connected_accounts import (
9 + AuthScheme,
10 + ConnectionRequest,
11 + ConnectedAccounts,
12 +)
13 +
14 +
15 +class TestAuthScheme:
16 + def test_oauth2_sets_initializing_status(self):
17 + scheme = AuthScheme()
18 + options = {"client_id": "id", "client_secret": "secret"}
19 +
20 + state = scheme.oauth2(options)
21 +
22 + assert state["auth_scheme"] == "OAUTH2"
23 + assert state["val"]["client_id"] == "id"
24 + assert state["val"]["client_secret"] == "secret"
25 + assert state["val"]["status"] == "INITIALIZING"
26 +
27 + @pytest.mark.parametrize(
28 + "method_name, expected_auth_scheme, expected_status",
29 + [
30 + ("api_key", "API_KEY", "ACTIVE"),
31 + ("basic", "BASIC", "ACTIVE"),
32 + ("bearer_token", "BEARER_TOKEN", "ACTIVE"),
33 + ("google_service_account", "GOOGLE_SERVICE_ACCOUNT", "ACTIVE"),
34 + ("no_auth", "NO_AUTH", "ACTIVE"),
35 + ("calcom_auth", "CALCOM_AUTH", "ACTIVE"),
36 + ("billcom_auth", "BILLCOM_AUTH", "ACTIVE"),
37 + ("basic_with_jwt", "BASIC_WITH_JWT", "ACTIVE"),
38 + ],
39 + )
40 + def test_auth_scheme_helpers_set_expected_auth_scheme_and_status(
41 + self, method_name, expected_auth_scheme, expected_status
42 + ):
43 + scheme = AuthScheme()
44 + method = getattr(scheme, method_name)
45 + options = {"foo": "bar"}
46 +
47 + state = method(options) # type: ignore[misc]
48 +
49 + assert state["auth_scheme"] == expected_auth_scheme
50 + assert state["val"]["foo"] == "bar"
51 + assert state["val"]["status"] == expected_status
52 +
53 +
54 +class TestConnectionRequest:
55 + def test_wait_for_connection_returns_when_active(self, monkeypatch):
56 + mock_client = Mock()
57 + pending = Mock()
58 + pending.status = "PENDING"
59 + active = Mock()
60 + active.status = "ACTIVE"
61 + mock_client.connected_accounts.retrieve.side_effect = [pending, active]
62 +
63 + req = ConnectionRequest(
64 + id="conn-123",
65 + status="PENDING",
66 + redirect_url=None,
67 + client=mock_client,
68 + )
69 +
70 + # Control time to avoid real sleep. Use a monotonic counter instead of a
71 + # finite list, because other code (e.g. tracing) may also call time.time().
72 + current_time = {"value": 0.0}
73 +
74 + def fake_time():
75 + value = current_time["value"]
76 + current_time["value"] += 0.1
77 + return value
78 +
79 + monkeypatch.setattr(time, "time", fake_time)
80 + monkeypatch.setattr(time, "sleep", lambda *_args, **_kwargs: None)
81 +
82 + result = req.wait_for_connection(timeout=1.0)
83 +
84 + assert result is active
85 + assert req.status == "ACTIVE"
86 + assert mock_client.connected_accounts.retrieve.call_count == 2
87 + mock_client.connected_accounts.retrieve.assert_called_with(nanoid="conn-123")
88 +
89 + def test_wait_for_connection_times_out(self, monkeypatch):
90 + mock_client = Mock()
91 + pending = Mock()
92 + pending.status = "PENDING"
93 + mock_client.connected_accounts.retrieve.return_value = pending
94 +
95 + req = ConnectionRequest(
96 + id="conn-timeout",
97 + status="PENDING",
98 + redirect_url=None,
99 + client=mock_client,
100 + )
101 +
102 + # Simulate time moving forward until the timeout is exceeded. Again, use
103 + # a monotonic counter so extra calls to time.time() do not exhaust test
104 + # data.
105 + current_time = {"value": 0.0}
106 +
107 + def fake_time():
108 + value = current_time["value"]
109 + current_time["value"] += 0.6
110 + return value
111 +
112 + monkeypatch.setattr(time, "time", fake_time)
113 + monkeypatch.setattr(time, "sleep", lambda *_args, **_kwargs: None)
114 +
115 + with pytest.raises(exceptions.ComposioSDKTimeoutError) as excinfo:
116 + req.wait_for_connection(timeout=1.0)
117 +
118 + assert "Timeout while waiting for connection conn-timeout" in str(excinfo.value)
119 +
120 + def test_from_id_uses_client_retrieve(self):
121 + mock_client = Mock()
122 + retrieved = Mock()
123 + retrieved.status = "PENDING"
124 + mock_client.connected_accounts.retrieve.return_value = retrieved
125 +
126 + req = ConnectionRequest.from_id("conn-from-id", client=mock_client)
127 +
128 + mock_client.connected_accounts.retrieve.assert_called_once_with(
129 + nanoid="conn-from-id"
130 + )
131 + assert req.id == "conn-from-id"
132 + assert req.status == "PENDING"
133 + assert req.redirect_url is None
134 +
135 +
136 +class TestConnectedAccounts:
137 + @pytest.fixture
138 + def mock_client(self):
139 + client = Mock()
140 + client.connected_accounts.retrieve = Mock()
141 + client.connected_accounts.list = Mock()
142 + client.connected_accounts.delete = Mock()
143 + client.connected_accounts.update_status = Mock()
144 + client.connected_accounts.refresh = Mock()
145 + client.connected_accounts.create = Mock()
146 + client.link.create = Mock()
147 + return client
148 +
149 + @pytest.fixture
150 + def connected_accounts(self, mock_client):
151 + return ConnectedAccounts(client=mock_client)
152 +
153 + def test_constructor_binds_methods(self, connected_accounts, mock_client):
154 + assert connected_accounts.get is mock_client.connected_accounts.retrieve
155 + assert connected_accounts.list is mock_client.connected_accounts.list
156 + assert connected_accounts.delete is mock_client.connected_accounts.delete
157 + assert (
158 + connected_accounts.update_status
159 + is mock_client.connected_accounts.update_status
160 + )
161 + assert connected_accounts.refresh is mock_client.connected_accounts.refresh
162 +
163 + def test_enable_and_disable_partials(self, connected_accounts, mock_client):
164 + connected_accounts.enable("conn-1")
165 + connected_accounts.disable("conn-2")
166 +
167 + mock_client.connected_accounts.update_status.assert_any_call(
168 + "conn-1", enabled=True
169 + )
170 + mock_client.connected_accounts.update_status.assert_any_call(
171 + "conn-2", enabled=False
172 + )
173 +
174 + def test_initiate_raises_when_multiple_accounts_and_not_allow_multiple(
175 + self, connected_accounts, mock_client
176 + ):
177 + mock_accounts = Mock()
178 + mock_accounts.items = [Mock(), Mock()]
179 + mock_client.connected_accounts.list.return_value = mock_accounts
180 +
181 + with pytest.raises(exceptions.ComposioMultipleConnectedAccountsError):
182 + connected_accounts.initiate(
183 + user_id="user-1", auth_config_id="auth-1", allow_multiple=False
184 + )
185 +
186 + def test_initiate_warns_and_creates_when_allow_multiple(
187 + self, connected_accounts, mock_client, caplog
188 + ):
189 + mock_accounts = Mock()
190 + mock_accounts.items = [Mock(), Mock()]
191 + mock_client.connected_accounts.list.return_value = mock_accounts
192 +
193 + mock_response = Mock()
194 + mock_response.id = "conn-123"
195 + mock_response.connection_data.val.status = "PENDING"
196 + mock_response.connection_data.val.redirect_url = "https://redirect"
197 + mock_client.connected_accounts.create.return_value = mock_response
198 +
199 + config = {
200 + "auth_scheme": "API_KEY",
201 + "val": {"key": "secret", "status": "ACTIVE"},
202 + }
203 +
204 + with caplog.at_level(logging.WARNING):
205 + result = connected_accounts.initiate(
206 + user_id="user-1",
207 + auth_config_id="auth-1",
208 + callback_url="https://cb",
209 + allow_multiple=True,
210 + config=config,
211 + )
212 +
213 + mock_client.connected_accounts.list.assert_called_once_with(
214 + user_ids=["user-1"], auth_config_ids=["auth-1"]
215 + )
216 + call_kwargs = mock_client.connected_accounts.create.call_args.kwargs
217 + assert call_kwargs["auth_config"] == {"id": "auth-1"}
218 + assert call_kwargs["connection"]["user_id"] == "user-1"
219 + assert call_kwargs["connection"]["callback_url"] == "https://cb"
220 + assert call_kwargs["connection"]["state"] == config
221 +
222 + assert isinstance(result, ConnectionRequest)
223 + assert result.id == "conn-123"
224 + assert result.status == "PENDING"
225 + assert result.redirect_url == "https://redirect"
226 + assert "[Warn:AllowMultiple] Multiple connected accounts found" in caplog.text
227 +
228 + def test_link_builds_payload_and_returns_connection_request(
229 + self, connected_accounts, mock_client
230 + ):
231 + mock_response = Mock()
232 + mock_response.connected_account_id = "conn-999"
233 + mock_response.redirect_url = "https://redirect"
234 + mock_client.link.create.return_value = mock_response
235 +
236 + result = connected_accounts.link(
237 + user_id="user-1",
238 + auth_config_id="auth-1",
239 + callback_url="https://cb",
240 + )
241 +
242 + call_kwargs = mock_client.link.create.call_args.kwargs
243 + assert call_kwargs["auth_config_id"] == "auth-1"
244 + assert call_kwargs["user_id"] == "user-1"
245 + assert call_kwargs["callback_url"] == "https://cb"
246 +
247 + assert isinstance(result, ConnectionRequest)
248 + assert result.id == "conn-999"
249 + assert result.status == "INITIATED"
250 + assert result.redirect_url == "https://redirect"
251 +
252 + def test_link_omits_callback_url_when_not_provided(
253 + self, connected_accounts, mock_client
254 + ):
255 + mock_response = Mock()
256 + mock_response.connected_account_id = "conn-000"
257 + mock_response.redirect_url = None
258 + mock_client.link.create.return_value = mock_response
259 +
260 + connected_accounts.link(user_id="user-1", auth_config_id="auth-1")
261 +
262 + call_kwargs = mock_client.link.create.call_args.kwargs
263 + assert call_kwargs["auth_config_id"] == "auth-1"
264 + assert call_kwargs["user_id"] == "user-1"
265 + assert "callback_url" not in call_kwargs
266 +
267 + def test_wait_for_connection_delegates_to_connection_request(self, mock_client):
268 + connected_accounts = ConnectedAccounts(client=mock_client)
269 +
270 + with patch(
271 + "composio.core.models.connected_accounts.ConnectionRequest.from_id"
272 + ) as mock_from_id:
273 + mock_request = Mock()
274 + mock_request.wait_for_connection.return_value = "connected"
275 + mock_from_id.return_value = mock_request
276 +
277 + result = connected_accounts.wait_for_connection(id="conn-123", timeout=42.0)
278 +
279 + mock_from_id.assert_called_once_with(id="conn-123", client=mock_client)
280 + mock_request.wait_for_connection.assert_called_once_with(timeout=42.0)
281 + assert result == "connected"
uv.lock
+20 -20
@@ -1,5 +1,5 @@
1 version = 1
2 -revision = 3
2 +revision = 2
3 requires-python = ">=3.12, <4"
4 resolution-markers = [
5 "python_full_version >= '3.13'",
@@ -23,7 +23,7 @@ members = [
23 ]
24
25 [manifest.dependency-groups]
26 -dev = [{ name = "composio", editable = "python" }]
26 +dev = [{ name = "composio", virtual = "python" }]
27
28 [[package]]
29 name = "aiohappyeyeballs"
@@ -478,7 +478,7 @@ wheels = [
478 [[package]]
479 name = "composio"
480 version = "0.9.5rc2"
481 -source = { editable = "python" }
481 +source = { virtual = "python" }
482 dependencies = [
483 { name = "composio-client" },
484 { name = "openai" },
@@ -516,7 +516,7 @@ requires-dist = [
516 [package.metadata.requires-dev]
517 dev = [
518 { name = "click", specifier = ">=8.2.1" },
519 - { name = "composio", editable = "python" },
519 + { name = "composio", virtual = "python" },
520 { name = "fastapi", specifier = ">=0.115.9" },
521 { name = "langchain-openai", specifier = "==1.1.0" },
522 { name = "nox", specifier = ">=2025.5.1" },
@@ -533,7 +533,7 @@ dev = [
533 [[package]]
534 name = "composio-anthropic"
535 version = "0.9.5rc2"
536 -source = { editable = "python/providers/anthropic" }
536 +source = { virtual = "python/providers/anthropic" }
537 dependencies = [
538 { name = "anthropic" },
539 { name = "composio" },
@@ -565,7 +565,7 @@ wheels = [
565 [[package]]
566 name = "composio-crewai"
567 version = "0.9.5rc2"
568 -source = { editable = "python/providers/crewai" }
568 +source = { virtual = "python/providers/crewai" }
569 dependencies = [
570 { name = "composio" },
571 { name = "crewai" },
@@ -580,7 +580,7 @@ requires-dist = [
580 [[package]]
581 name = "composio-gemini"
582 version = "0.9.5rc2"
583 -source = { editable = "python/providers/gemini" }
583 +source = { virtual = "python/providers/gemini" }
584 dependencies = [
585 { name = "composio" },
586 { name = "google-genai" },
@@ -595,7 +595,7 @@ requires-dist = [
595 [[package]]
596 name = "composio-google"
597 version = "0.9.5rc2"
598 -source = { editable = "python/providers/google" }
598 +source = { virtual = "python/providers/google" }
599 dependencies = [
600 { name = "composio" },
601 { name = "google-cloud-aiplatform" },
@@ -610,7 +610,7 @@ requires-dist = [
610 [[package]]
611 name = "composio-google-adk"
612 version = "0.9.5rc2"
613 -source = { editable = "python/providers/google_adk" }
613 +source = { virtual = "python/providers/google_adk" }
614 dependencies = [
615 { name = "composio" },
616 { name = "google-adk" },
@@ -625,7 +625,7 @@ requires-dist = [
625 [[package]]
626 name = "composio-langchain"
627 version = "0.9.5rc2"
628 -source = { editable = "python/providers/langchain" }
628 +source = { virtual = "python/providers/langchain" }
629 dependencies = [
630 { name = "composio" },
631 { name = "langchain" },
@@ -640,7 +640,7 @@ requires-dist = [
640 [[package]]
641 name = "composio-openai"
642 version = "0.9.5rc2"
643 -source = { editable = "python/providers/openai" }
643 +source = { virtual = "python/providers/openai" }
644 dependencies = [
645 { name = "composio" },
646 { name = "openai" },
@@ -655,7 +655,7 @@ requires-dist = [
655 [[package]]
656 name = "composio-openai-agents"
657 version = "0.9.5rc2"
658 -source = { editable = "python/providers/openai_agents" }
658 +source = { virtual = "python/providers/openai_agents" }
659 dependencies = [
660 { name = "composio" },
661 { name = "openai-agents" },
@@ -891,11 +891,11 @@ dev = [
891 [package.metadata]
892 requires-dist = [
893 { name = "click", specifier = ">=8.1.7" },
894 - { name = "composio", editable = "python" },
894 + { name = "composio", virtual = "python" },
895 { name = "composio-client" },
896 - { name = "composio-gemini", editable = "python/providers/gemini" },
897 - { name = "composio-langchain", editable = "python/providers/langchain" },
898 - { name = "composio-openai", editable = "python/providers/openai" },
896 + { name = "composio-gemini", virtual = "python/providers/gemini" },
897 + { name = "composio-langchain", virtual = "python/providers/langchain" },
898 + { name = "composio-openai", virtual = "python/providers/openai" },
899 { name = "gitpython", specifier = ">=3.1.0" },
900 { name = "inflection", specifier = ">=0.5.1" },
901 { name = "nbformat", specifier = ">=5.0.0" },
@@ -910,10 +910,10 @@ requires-dist = [
910
911 [package.metadata.requires-dev]
912 dev = [
913 - { name = "composio", editable = "python" },
914 - { name = "composio-gemini", editable = "python/providers/gemini" },
915 - { name = "composio-langchain", editable = "python/providers/langchain" },
916 - { name = "composio-openai-agents", editable = "python/providers/openai_agents" },
913 + { name = "composio", virtual = "python" },
914 + { name = "composio-gemini", virtual = "python/providers/gemini" },
915 + { name = "composio-langchain", virtual = "python/providers/langchain" },
916 + { name = "composio-openai-agents", virtual = "python/providers/openai_agents" },
917 { name = "google-genai", specifier = ">=1.20.0" },
918 { name = "langchain", specifier = ">=0.3.25" },
919 { name = "openai-agents", specifier = ">=0.0.19" },