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" },