Skip to content

Use Claude Code, Codex, VSCode, Pi, and OpenCode (and 6 other harnesses) for free (1.3B+ free tokens) from your terminal, app, IDE, or phone, and now from the browser with native browser sessions (multi-harness + multi-model) like OpenClaw (voice supported + ToS friendly)

Python

lint

Alishahryar1fabca59f5c70
diff --git a/api/app.py b/api/app.py
index a8d6e688..702b7f4d 100644
--- a/api/app.py
+++ b/api/app.py
@@ -41,7 +41,9 @@ logging.getLogger("uvicorn.error").setLevel(logging.WARNING)
_SHUTDOWN_TIMEOUT_S = 5.0
-async def _best_effort(name: str, awaitable, timeout_s: float = _SHUTDOWN_TIMEOUT_S) -> None:
+async def _best_effort(
+ name: str, awaitable, timeout_s: float = _SHUTDOWN_TIMEOUT_S
+) -> None:
"""Run a shutdown step with timeout; never raise to callers."""
try:
await asyncio.wait_for(awaitable, timeout=timeout_s)
diff --git a/cli/session.py b/cli/session.py
index 261ff7fe..1a28552b 100644
--- a/cli/session.py
+++ b/cli/session.py
@@ -137,9 +137,7 @@ class CLISession:
line = buffer[:newline_pos]
buffer = buffer[newline_pos + 1 :]
- line_str = line.decode(
- "utf-8", errors="replace"
- ).strip()
+ line_str = line.decode("utf-8", errors="replace").strip()
if line_str:
async for event in self._handle_line_gen(
line_str, session_id_extracted
diff --git a/messaging/handler.py b/messaging/handler.py
index f9f1b166..1c5a4e85 100644
--- a/messaging/handler.py
+++ b/messaging/handler.py
@@ -32,9 +32,7 @@ _MD.enable("strikethrough")
_MD.enable("table")
-_TABLE_SEP_RE = re.compile(
- r"^\s*\|?\s*:?-{3,}:?\s*(\|\s*:?-{3,}:?\s*)+\|?\s*$"
-)
+_TABLE_SEP_RE = re.compile(r"^\s*\|?\s*:?-{3,}:?\s*(\|\s*:?-{3,}:?\s*)+\|?\s*$")
_FENCE_RE = re.compile(r"^\s*```")
diff --git a/messaging/limiter.py b/messaging/limiter.py
index 8f7c7e40..b2673801 100644
--- a/messaging/limiter.py
+++ b/messaging/limiter.py
@@ -70,7 +70,9 @@ class MessagingRateLimiter:
if self._worker_task and not self._worker_task.done():
return
# Named task helps debugging shutdown hangs.
- self._worker_task = asyncio.create_task(self._worker(), name="msg-limiter-worker")
+ self._worker_task = asyncio.create_task(
+ self._worker(), name="msg-limiter-worker"
+ )
async def _worker(self):
"""Background worker that processes queued messaging tasks."""
diff --git a/messaging/session.py b/messaging/session.py
index 5b093c2f..f34c442a 100644
--- a/messaging/session.py
+++ b/messaging/session.py
@@ -186,7 +186,8 @@ class SessionStore:
# Drop oldest entries and rebuild seen set.
self._message_log[chat_key] = items[-cap:]
self._message_log_ids[chat_key] = {
- str(x.get("message_id")) for x in self._message_log[chat_key]
+ str(x.get("message_id"))
+ for x in self._message_log[chat_key]
}
except Exception:
pass
@@ -198,7 +199,11 @@ class SessionStore:
chat_key = self._make_chat_key(str(platform), str(chat_id))
with self._lock:
items = self._message_log.get(chat_key, [])
- return [str(x.get("message_id")) for x in items if x.get("message_id") is not None]
+ return [
+ str(x.get("message_id"))
+ for x in items
+ if x.get("message_id") is not None
+ ]
def clear_message_log_for_chat(self, platform: str, chat_id: str) -> None:
"""Clear recorded message IDs for a single chat."""
diff --git a/messaging/tree_queue.py b/messaging/tree_queue.py
index f86e6316..be0c91d3 100644
--- a/messaging/tree_queue.py
+++ b/messaging/tree_queue.py
@@ -332,7 +332,9 @@ class TreeQueueManager:
except Exception:
# Best-effort: if we can't mutate the queue internals, the node will
# still be dequeued later and skipped due to state=ERROR.
- logger.debug("Failed to remove node from queue; will rely on state=ERROR")
+ logger.debug(
+ "Failed to remove node from queue; will rely on state=ERROR"
+ )
node.state = MessageState.ERROR
node.error_message = "Cancelled by user"
diff --git a/tests/test_app_lifespan_and_errors.py b/tests/test_app_lifespan_and_errors.py
index bbe94e82..99253e89 100644
--- a/tests/test_app_lifespan_and_errors.py
+++ b/tests/test_app_lifespan_and_errors.py
@@ -28,8 +28,9 @@ def test_create_app_provider_error_handler_returns_anthropic_format():
max_cli_sessions=1,
log_file="server.log",
)
- with patch.object(api_app_mod, "get_settings", return_value=settings), patch.object(
- api_app_mod, "cleanup_provider", new=AsyncMock()
+ with (
+ patch.object(api_app_mod, "get_settings", return_value=settings),
+ patch.object(api_app_mod, "cleanup_provider", new=AsyncMock()),
):
with TestClient(app) as client:
resp = client.get("/raise_provider")
@@ -60,8 +61,9 @@ def test_create_app_general_exception_handler_returns_500():
max_cli_sessions=1,
log_file="server.log",
)
- with patch.object(api_app_mod, "get_settings", return_value=settings), patch.object(
- api_app_mod, "cleanup_provider", new=AsyncMock()
+ with (
+ patch.object(api_app_mod, "get_settings", return_value=settings),
+ patch.object(api_app_mod, "cleanup_provider", new=AsyncMock()),
):
with TestClient(app, raise_server_exceptions=False) as client:
resp = client.get("/raise_general")
@@ -71,7 +73,9 @@ def test_create_app_general_exception_handler_returns_500():
assert body["error"]["type"] == "api_error"
[email protected]("messaging_enabled", [True, False], ids=["with_platform", "no_platform"])
+ "messaging_enabled", [True, False], ids=["with_platform", "no_platform"]
+)
def test_app_lifespan_sets_state_and_cleans_up(tmp_path, messaging_enabled):
from api.app import create_app
@@ -113,17 +117,18 @@ def test_app_lifespan_sets_state_and_cleans_up(tmp_path, messaging_enabled):
api_app_mod = importlib.import_module("api.app")
cleanup_provider = AsyncMock()
- with patch.object(api_app_mod, "get_settings", return_value=settings), patch.object(
- api_app_mod, "cleanup_provider", new=cleanup_provider
- ), patch(
- "messaging.factory.create_messaging_platform",
- return_value=fake_platform if messaging_enabled else None,
- ) as create_platform, patch(
- "messaging.session.SessionStore", return_value=session_store
- ), patch(
- "cli.manager.CLISessionManager", return_value=cli_manager
- ), patch(
- "messaging.tree_queue.TreeQueueManager.from_dict", return_value=fake_queue
+ with (
+ patch.object(api_app_mod, "get_settings", return_value=settings),
+ patch.object(api_app_mod, "cleanup_provider", new=cleanup_provider),
+ patch(
+ "messaging.factory.create_messaging_platform",
+ return_value=fake_platform if messaging_enabled else None,
+ ) as create_platform,
+ patch("messaging.session.SessionStore", return_value=session_store),
+ patch("cli.manager.CLISessionManager", return_value=cli_manager),
+ patch(
+ "messaging.tree_queue.TreeQueueManager.from_dict", return_value=fake_queue
+ ),
):
with TestClient(app):
pass
@@ -181,15 +186,15 @@ def test_app_lifespan_cleanup_continues_if_platform_stop_raises(tmp_path):
api_app_mod = importlib.import_module("api.app")
cleanup_provider = AsyncMock()
- with patch.object(api_app_mod, "get_settings", return_value=settings), patch.object(
- api_app_mod, "cleanup_provider", new=cleanup_provider
- ), patch(
- "messaging.factory.create_messaging_platform",
- return_value=fake_platform,
- ), patch(
- "messaging.session.SessionStore", return_value=session_store
- ), patch(
- "cli.manager.CLISessionManager", return_value=cli_manager
+ with (
+ patch.object(api_app_mod, "get_settings", return_value=settings),
+ patch.object(api_app_mod, "cleanup_provider", new=cleanup_provider),
+ patch(
+ "messaging.factory.create_messaging_platform",
+ return_value=fake_platform,
+ ),
+ patch("messaging.session.SessionStore", return_value=session_store),
+ patch("cli.manager.CLISessionManager", return_value=cli_manager),
):
with TestClient(app):
pass
diff --git a/tests/test_cli_manager_edge_cases.py b/tests/test_cli_manager_edge_cases.py
index 3a24ac5f..c929fca9 100644
--- a/tests/test_cli_manager_edge_cases.py
+++ b/tests/test_cli_manager_edge_cases.py
@@ -82,7 +82,9 @@ async def test_remove_session_active_removes_temp_mapping():
async def test_get_or_create_session_cleans_up_idle_sessions_when_at_limit():
from cli.manager import CLISessionManager
- manager = CLISessionManager(workspace_path="/tmp", api_url="http://x/v1", max_sessions=1)
+ manager = CLISessionManager(
+ workspace_path="/tmp", api_url="http://x/v1", max_sessions=1
+ )
idle_session = MagicMock()
idle_session.is_busy = False
@@ -107,7 +109,9 @@ async def test_get_or_create_session_cleans_up_idle_sessions_when_at_limit():
async def test_get_or_create_session_raises_when_max_sessions_reached_with_busy_sessions():
from cli.manager import CLISessionManager
- manager = CLISessionManager(workspace_path="/tmp", api_url="http://x/v1", max_sessions=1)
+ manager = CLISessionManager(
+ workspace_path="/tmp", api_url="http://x/v1", max_sessions=1
+ )
busy_session = MagicMock()
busy_session.is_busy = True
@@ -140,4 +144,3 @@ async def test_stop_all_handles_stop_exceptions():
s2.stop.assert_awaited_once()
assert manager.get_stats()["active_sessions"] == 0
assert manager.get_stats()["pending_sessions"] == 0
-
diff --git a/tests/test_handler.py b/tests/test_handler.py
index 063965a5..d1208c30 100644
--- a/tests/test_handler.py
+++ b/tests/test_handler.py
@@ -429,7 +429,9 @@ async def test_handle_message_clear_command_stops_deletes_and_wipes_state(
handler.stop_all_tasks = AsyncMock(side_effect=_stop)
mock_platform.queue_delete_message = AsyncMock(side_effect=_del)
- incoming = incoming_message_factory(text="/clear", chat_id="chat_1", message_id="150")
+ incoming = incoming_message_factory(
+ text="/clear", chat_id="chat_1", message_id="150"
+ )
await handler.handle_message(incoming)
assert events and events[0] == "stop"
@@ -448,7 +450,9 @@ async def test_handle_message_clear_command_with_mention(
):
handler.stop_all_tasks = AsyncMock(return_value=0)
- incoming = incoming_message_factory(text="/clear@MyBot", chat_id="chat_1", message_id="10")
+ incoming = incoming_message_factory(
+ text="/clear@MyBot", chat_id="chat_1", message_id="10"
+ )
await handler.handle_message(incoming)
handler.stop_all_tasks.assert_called_once()
@@ -467,7 +471,9 @@ async def test_handle_message_clear_command_deletes_message_log_ids(
handler.stop_all_tasks = AsyncMock(return_value=0)
mock_session_store.get_message_ids_for_chat.return_value = ["42", "43"]
- incoming = incoming_message_factory(text="/clear", chat_id="chat_1", message_id="150")
+ incoming = incoming_message_factory(
+ text="/clear", chat_id="chat_1", message_id="150"
+ )
await handler.handle_message(incoming)
deleted = {c.args[1] for c in mock_platform.queue_delete_message.call_args_list}
diff --git a/tests/test_handler_context_isolation.py b/tests/test_handler_context_isolation.py
index 84c05029..268399d5 100644
--- a/tests/test_handler_context_isolation.py
+++ b/tests/test_handler_context_isolation.py
@@ -16,17 +16,29 @@ def handler(mock_platform, mock_cli_manager, mock_session_store):
@pytest.mark.asyncio
-async def test_sibling_replies_fork_from_parent_session_id(handler, mock_cli_manager, incoming_message_factory):
+async def test_sibling_replies_fork_from_parent_session_id(
+ handler, mock_cli_manager, incoming_message_factory
+):
# Root node A with a known session_id.
root_incoming = incoming_message_factory(text="A", message_id="A")
- tree = await handler.tree_queue.create_tree(node_id="A", incoming=root_incoming, status_message_id="status_A")
+ tree = await handler.tree_queue.create_tree(
+ node_id="A", incoming=root_incoming, status_message_id="status_A"
+ )
await tree.update_state("A", MessageState.COMPLETED, session_id="sess_A")
# Add two sibling replies R1 and R2 under A.
- r1_incoming = incoming_message_factory(text="R1", message_id="R1", reply_to_message_id="A")
- r2_incoming = incoming_message_factory(text="R2", message_id="R2", reply_to_message_id="A")
- _, r1_node = await handler.tree_queue.add_to_tree("A", "R1", r1_incoming, "status_R1")
- _, r2_node = await handler.tree_queue.add_to_tree("A", "R2", r2_incoming, "status_R2")
+ r1_incoming = incoming_message_factory(
+ text="R1", message_id="R1", reply_to_message_id="A"
+ )
+ r2_incoming = incoming_message_factory(
+ text="R2", message_id="R2", reply_to_message_id="A"
+ )
+ _, r1_node = await handler.tree_queue.add_to_tree(
+ "A", "R1", r1_incoming, "status_R1"
+ )
+ _, r2_node = await handler.tree_queue.add_to_tree(
+ "A", "R2", r2_incoming, "status_R2"
+ )
# Mock a fresh cli_session per node.
calls = []
@@ -46,9 +58,11 @@ async def test_sibling_replies_fork_from_parent_session_id(handler, mock_cli_man
yield ev
cli_session.start_task = _start_task
- return cli_session, f"pending_{len(calls)+1}", True
+ return cli_session, f"pending_{len(calls) + 1}", True
- mock_cli_manager.get_or_create_session = AsyncMock(side_effect=_get_or_create_session)
+ mock_cli_manager.get_or_create_session = AsyncMock(
+ side_effect=_get_or_create_session
+ )
await handler._process_node("R1", r1_node)
await handler._process_node("R2", r2_node)
@@ -64,13 +78,21 @@ async def test_sibling_replies_fork_from_parent_session_id(handler, mock_cli_man
@pytest.mark.asyncio
-async def test_grandchild_reply_forks_from_branch_session(handler, mock_cli_manager, incoming_message_factory):
+async def test_grandchild_reply_forks_from_branch_session(
+ handler, mock_cli_manager, incoming_message_factory
+):
root_incoming = incoming_message_factory(text="A", message_id="A")
- tree = await handler.tree_queue.create_tree(node_id="A", incoming=root_incoming, status_message_id="status_A")
+ tree = await handler.tree_queue.create_tree(
+ node_id="A", incoming=root_incoming, status_message_id="status_A"
+ )
await tree.update_state("A", MessageState.COMPLETED, session_id="sess_A")
- r1_incoming = incoming_message_factory(text="R1", message_id="R1", reply_to_message_id="A")
- _, r1_node = await handler.tree_queue.add_to_tree("A", "R1", r1_incoming, "status_R1")
+ r1_incoming = incoming_message_factory(
+ text="R1", message_id="R1", reply_to_message_id="A"
+ )
+ _, r1_node = await handler.tree_queue.add_to_tree(
+ "A", "R1", r1_incoming, "status_R1"
+ )
calls = []
@@ -92,14 +114,20 @@ async def test_grandchild_reply_forks_from_branch_session(handler, mock_cli_mana
cli_session.start_task = _start_task
return cli_session, "pending_R1", True
- mock_cli_manager.get_or_create_session = AsyncMock(side_effect=_get_or_create_session)
+ mock_cli_manager.get_or_create_session = AsyncMock(
+ side_effect=_get_or_create_session
+ )
await handler._process_node("R1", r1_node)
assert r1_node.session_id == "sess_R1"
# Grandchild C1 replies to R1 and must fork from sess_R1, not sess_A.
- c1_incoming = incoming_message_factory(text="C1", message_id="C1", reply_to_message_id="R1")
- _, c1_node = await handler.tree_queue.add_to_tree("R1", "C1", c1_incoming, "status_C1")
+ c1_incoming = incoming_message_factory(
+ text="C1", message_id="C1", reply_to_message_id="R1"
+ )
+ _, c1_node = await handler.tree_queue.add_to_tree(
+ "R1", "C1", c1_incoming, "status_C1"
+ )
async def _get_or_create_session_c1(session_id=None):
cli_session = MagicMock()
@@ -117,7 +145,9 @@ async def test_grandchild_reply_forks_from_branch_session(handler, mock_cli_mana
cli_session.start_task = _start_task
return cli_session, "pending_C1", True
- mock_cli_manager.get_or_create_session = AsyncMock(side_effect=_get_or_create_session_c1)
+ mock_cli_manager.get_or_create_session = AsyncMock(
+ side_effect=_get_or_create_session_c1
+ )
await handler._process_node("C1", c1_node)
diff --git a/tests/test_handler_markdown_and_status_edges.py b/tests/test_handler_markdown_and_status_edges.py
index 75b25a15..4e939f6d 100644
--- a/tests/test_handler_markdown_and_status_edges.py
+++ b/tests/test_handler_markdown_and_status_edges.py
@@ -37,14 +37,7 @@ def test_render_markdown_to_mdv2_covers_common_structures():
def test_render_markdown_to_mdv2_renders_table_as_code_block():
- md = (
- "| a | b |\n"
- "|---|---|\n"
- "| 1 | 2 |\n"
- "| 3 | 4 |\n"
- "\n"
- "After.\n"
- )
+ md = "| a | b |\n|---|---|\n| 1 | 2 |\n| 3 | 4 |\n\nAfter.\n"
out = render_markdown_to_mdv2(md)
assert "```" in out
assert "| a" in out
@@ -54,12 +47,7 @@ def test_render_markdown_to_mdv2_renders_table_as_code_block():
def test_render_markdown_to_mdv2_table_without_blank_line_still_renders():
- md = (
- "Here's a table:\n"
- "| a | b |\n"
- "|---|---|\n"
- "| 1 | 2 |\n"
- )
+ md = "Here's a table:\n| a | b |\n|---|---|\n| 1 | 2 |\n"
out = render_markdown_to_mdv2(md)
assert "Here's a table" in out
assert "```" in out
@@ -68,11 +56,7 @@ def test_render_markdown_to_mdv2_table_without_blank_line_still_renders():
def test_render_markdown_to_mdv2_table_escapes_backticks_and_backslashes_in_cells():
- md = (
- "| a | b |\n"
- "|---|---|\n"
- "| \\\\ | `` ` `` |\n"
- )
+ md = "| a | b |\n|---|---|\n| \\\\ | `` ` `` |\n"
out = render_markdown_to_mdv2(md)
assert "```" in out
# In Telegram code blocks we escape backslashes and backticks.
@@ -81,12 +65,7 @@ def test_render_markdown_to_mdv2_table_escapes_backticks_and_backslashes_in_cell
def test_render_markdown_to_mdv2_table_inside_list_keeps_bullet_prefix():
- md = (
- "-\n"
- " | a | b |\n"
- " |---|---|\n"
- " | 1 | 2 |\n"
- )
+ md = "-\n | a | b |\n |---|---|\n | 1 | 2 |\n"
out = render_markdown_to_mdv2(md)
assert "```" in out
assert out.lstrip().startswith("\\-")
@@ -237,7 +216,9 @@ async def test_handle_message_reply_with_tree_but_no_parent_treated_as_new():
handler.tree_queue = MagicMock()
handler.tree_queue.get_tree_for_node.return_value = object()
handler.tree_queue.resolve_parent_node_id.return_value = None
- handler.tree_queue.create_tree = AsyncMock(return_value=MagicMock(root_id="root", to_dict=MagicMock(return_value={"t": 1})))
+ handler.tree_queue.create_tree = AsyncMock(
+ return_value=MagicMock(root_id="root", to_dict=MagicMock(return_value={"t": 1}))
+ )
handler.tree_queue.register_node = MagicMock()
handler.tree_queue.enqueue = AsyncMock(return_value=False)
diff --git a/tests/test_restart_reply_restore.py b/tests/test_restart_reply_restore.py
index eff98708..6a76e944 100644
--- a/tests/test_restart_reply_restore.py
+++ b/tests/test_restart_reply_restore.py
@@ -8,7 +8,9 @@ from messaging.models import IncomingMessage
@pytest.mark.asyncio
-async def test_reply_to_old_status_message_after_restore_routes_to_parent(tmp_path, mock_platform, mock_cli_manager):
+async def test_reply_to_old_status_message_after_restore_routes_to_parent(
+ tmp_path, mock_platform, mock_cli_manager
+):
# Build a persisted tree with a root node A and a bot status message id.
store_path = tmp_path / "sessions.json"
store = SessionStore(storage_path=str(store_path))
@@ -21,7 +23,9 @@ async def test_reply_to_old_status_message_after_restore_routes_to_parent(tmp_pa
message_id="A",
platform="telegram",
)
- tree = await handler1.tree_queue.create_tree("A", a_incoming, status_message_id="status_A")
+ tree = await handler1.tree_queue.create_tree(
+ "A", a_incoming, status_message_id="status_A"
+ )
handler1.tree_queue.register_node("status_A", tree.root_id)
store.register_node("status_A", tree.root_id)
store.save_tree(tree.root_id, tree.to_dict())
@@ -59,7 +63,9 @@ async def test_reply_to_old_status_message_after_restore_routes_to_parent(tmp_pa
@pytest.mark.asyncio
-async def test_reply_to_old_status_message_without_mapping_creates_new_conversation(tmp_path, mock_platform, mock_cli_manager):
+async def test_reply_to_old_status_message_without_mapping_creates_new_conversation(
+ tmp_path, mock_platform, mock_cli_manager
+):
store_path = tmp_path / "sessions.json"
store = SessionStore(storage_path=str(store_path))
@@ -71,7 +77,9 @@ async def test_reply_to_old_status_message_without_mapping_creates_new_conversat
message_id="A",
platform="telegram",
)
- tree = await handler1.tree_queue.create_tree("A", a_incoming, status_message_id="status_A")
+ tree = await handler1.tree_queue.create_tree(
+ "A", a_incoming, status_message_id="status_A"
+ )
# Intentionally do NOT register "status_A" mapping.
store.save_tree(tree.root_id, tree.to_dict())
@@ -100,4 +108,3 @@ async def test_reply_to_old_status_message_without_mapping_creates_new_conversat
new_tree = handler2.tree_queue.get_tree_for_node("R1")
assert new_tree is not None
assert new_tree.root_id == "R1"
-
diff --git a/tests/test_telegram_edge_cases.py b/tests/test_telegram_edge_cases.py
index 65a8404f..35348cb7 100644
--- a/tests/test_telegram_edge_cases.py
+++ b/tests/test_telegram_edge_cases.py
@@ -17,8 +17,9 @@ def test_telegram_platform_init_raises_when_dependency_missing():
@pytest.mark.asyncio
async def test_telegram_platform_start_requires_token():
- with patch.dict("os.environ", {}, clear=True), patch(
- "messaging.telegram.TELEGRAM_AVAILABLE", True
+ with (
+ patch.dict("os.environ", {}, clear=True),
+ patch("messaging.telegram.TELEGRAM_AVAILABLE", True),
):
from messaging.telegram import TelegramPlatform
@@ -199,18 +200,16 @@ async def test_telegram_start_retries_on_network_error(monkeypatch):
monkeypatch.setattr(asyncio, "sleep", AsyncMock())
- with patch("telegram.ext.Application.builder") as mock_builder, patch(
- "messaging.limiter.MessagingRateLimiter.get_instance", AsyncMock()
+ with (
+ patch("telegram.ext.Application.builder") as mock_builder,
+ patch("messaging.limiter.MessagingRateLimiter.get_instance", AsyncMock()),
):
mock_app = MagicMock()
mock_app.initialize = AsyncMock(side_effect=[NetworkError("no"), None])
mock_app.start = AsyncMock()
mock_app.updater = None
- mock_builder.return_value.token.return_value.request.return_value.build.return_value = (
- mock_app
- )
+ mock_builder.return_value.token.return_value.request.return_value.build.return_value = mock_app
await platform.start()
assert platform.is_connected is True
-