DOC: document authorized_imports and max_print_outputs_length in evaluate_python_code

src/smolagents/local_python_executor.py

@@ -1608,6 +1608,10 @@ def evaluate_python_code(
             A dictionary mapping variable names to values. The `state` should contain the initial inputs but will be
             updated by this function to contain all variables as they are evaluated.
             The print outputs will be stored in the state under the key "_print_outputs".
+        authorized_imports (`list[str]`, *optional*, defaults to `BASE_BUILTIN_MODULES`):
+            List of module names that the evaluated code is allowed to import.
+        max_print_outputs_length (`int`, *optional*, defaults to `DEFAULT_MAX_LEN_OUTPUT`):
+            Maximum length of captured print outputs before they get truncated.
         timeout_seconds (`int`, *optional*, defaults to `MAX_EXECUTION_TIME_SECONDS`):
             Maximum time in seconds allowed for code execution. Set to `None` to disable timeout.
     """

tests/test_local_python_executor.py

@@ -2987,3 +2987,13 @@ def test_vulnerability_via_dunder_call(
         )
         with expectation:
             executor(code)
+
+
+def test_evaluate_python_code_docstring_parameters():
+    import inspect
+
+    sig = inspect.signature(evaluate_python_code)
+    doc = evaluate_python_code.__doc__
+    assert doc is not None
+    for param_name in sig.parameters:
+        assert param_name in doc, f"Parameter '{param_name}' is not documented in evaluate_python_code docstring."