Python library gives confusing error message when malformed function path contains multiple `:`

[ortonomy]

Folder organization and query:

Convex call:

cclient.query("queries:activity:list", {"lessonId": "123"})

Error

[2025-06-16 08:53:29,096: ERROR/ForkPoolWorker-8] Task tasks.lesson_tasks.generate_vrps[eaac34c8-5b29-490e-a2c2-b5f86bd6cf7a] raised unexpected: Exception('Path component queries:activity.js can only contain alphanumeric characters, underscores, or periods.')
Traceback (most recent call last):
  File "/Users/gregory.orton/Personal/perlea.ai/sensei-mono/apps/ai-service/.venv/lib/python3.12/site-packages/celery/app/trace.py", line 453, in trace_task
    R = retval = fun(*args, **kwargs)
                 ^^^^^^^^^^^^^^^^^^^^
  File "/Users/gregory.orton/Personal/perlea.ai/sensei-mono/apps/ai-service/.venv/lib/python3.12/site-packages/celery/app/trace.py", line 736, in __protected_call__
    return self.run(*args, **kwargs)
           ^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/Users/gregory.orton/Personal/perlea.ai/sensei-mono/apps/ai-service/src/tasks/lesson_tasks.py", line 19, in generate_vrps
    cclient.query("queries:activity:list", {"lessonId": "123"})
  File "/Users/gregory.orton/Personal/perlea.ai/sensei-mono/apps/ai-service/.venv/lib/python3.12/site-packages/convex/__init__.py", line 209, in query
    result = self.client.query(name, coerce_args_to_convex(args))
             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Exception: Path component queries:activity.js can only contain alphanumeric characters, underscores, or periods.

Please handle this case correctly. It forces us to put all functions that need to be called by our non front-end clients to be put at the root of the convex functions and makes organizing code v. frustrating

[nipunn1313]

I think it needs to be queries/activity:list.

Does that work? If so, there's probably an improvement to the error message we could do to make that more clear, which could be a good action item.

[ortonomy]

Does that work? If so, there's probably an improvement to the error message we could do to make that more clear, which could be a good action item.

It worked! that's non-obvious, hey. Yeah, that needs to be fixed.

[nipunn1313]

Given that this is a common confusion, we can special case the multiple-colons case for a better error message.

It's actually in the convex rust client code (which is a dependency of convex-py)
https://github.com/get-convex/convex-backend/blob/main/crates/convex/sync_types/src/path.rs#L25