Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
docs(py): render raises sections and normalize reST in SDK reference (#4491)
This PR: - fixes the raw `:raises ...:` reST directives leaking into the generated Python SDK reference, flagged by [Greptile on the auto-generated docs PR](https://github.com/ComposioHQ/composio/pull/4479#discussion_r4004672537) - teaches `python/scripts/generate-docs.py` to parse `:raises Exc:` docstring fields (plus `:raise`/`:except`/`:throws` synonyms) into a structured `**Raises**` section, with indented continuation-line support - normalizes inline reST in all rendered prose: `:class:`/`:func:`/`:meth:`/`:mod:` roles honor `~` short-name semantics, and double-backtick literals become single-backtick inline code - regenerates `docs/content/reference/sdk-reference/python/` pages - adds regression tests for raises parsing and reST normalization in `python/tests/test_generate_docs.py` ## Context The Python SDK reference pages are generated by `python/scripts/generate-docs.py` (workflow: `generate-sdk-docs.yml`), so the fix lives in the generator rather than the MDX — hand-edits would be overwritten by the next auto-regen PR. Unrecognized `:raises` lines previously fell through into the `:returns:` description text.
No changes.