From db412e6e8648a5687d73ef4cf28738d1e7f0e53f Mon Sep 17 00:00:00 2001
From: Sergei Izmailov <sergei.a.izmailov@gmail.com>
Date: Thu, 31 Aug 2023 14:43:01 +0900
Subject: [PATCH] fix: Render `py::function` as `Callable` (#4829)

* fix: Render `py::function` as `Callable`

* style: pre-commit fixes

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
---
 include/pybind11/cast.h | 4 ++++
 tests/test_callbacks.py | 7 +++++++
 2 files changed, 11 insertions(+)

diff --git a/include/pybind11/cast.h b/include/pybind11/cast.h
index b3c8ebe17..8a4e2e647 100644
--- a/include/pybind11/cast.h
+++ b/include/pybind11/cast.h
@@ -898,6 +898,10 @@ struct handle_type_name<float_> {
     static constexpr auto name = const_name("float");
 };
 template <>
+struct handle_type_name<function> {
+    static constexpr auto name = const_name("Callable");
+};
+template <>
 struct handle_type_name<none> {
     static constexpr auto name = const_name("None");
 };
diff --git a/tests/test_callbacks.py b/tests/test_callbacks.py
index 4a652f53e..86c767455 100644
--- a/tests/test_callbacks.py
+++ b/tests/test_callbacks.py
@@ -216,3 +216,10 @@ def test_custom_func():
 def test_custom_func2():
     assert m.custom_function2(3) == 27
     assert m.roundtrip(m.custom_function2)(3) == 27
+
+
+def test_callback_docstring():
+    assert (
+        m.test_tuple_unpacking.__doc__.strip()
+        == "test_tuple_unpacking(arg0: Callable) -> object"
+    )