mirror of
https://github.com/PrefectHQ/fastmcp.git
synced 2026-08-09 07:09:11 +02:00
39 lines
1.3 KiB
Text
39 lines
1.3 KiB
Text
---
|
|
title: docstring_parsing
|
|
sidebarTitle: docstring_parsing
|
|
---
|
|
|
|
# `fastmcp.utilities.docstring_parsing`
|
|
|
|
|
|
Extract descriptions from function docstrings.
|
|
|
|
Uses griffelib to parse Google, NumPy, and Sphinx-style docstrings. The
|
|
interface is intentionally narrow — a single function returning a
|
|
`ParsedDocstring` — so the implementation can be swapped without touching
|
|
callers.
|
|
|
|
|
|
## Functions
|
|
|
|
### `parse_docstring` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/utilities/docstring_parsing.py#L33" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>
|
|
|
|
```python
|
|
parse_docstring(fn: Callable[..., Any]) -> ParsedDocstring
|
|
```
|
|
|
|
|
|
Parse a function's docstring into a summary and parameter descriptions.
|
|
|
|
Tries Google, NumPy, and Sphinx parsers in order, using the first one that
|
|
successfully extracts parameter descriptions. If none do, returns the full
|
|
docstring as the description with no parameter descriptions.
|
|
|
|
|
|
## Classes
|
|
|
|
### `ParsedDocstring` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/fastmcp_slim/fastmcp/utilities/docstring_parsing.py#L26" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>
|
|
|
|
|
|
The extracted description and per-parameter descriptions from a docstring.
|
|
|