如何将含文档字符串的函数动态关联为类方法并保留特性？

现有如下函数：

def bar(a: str, b: str):
    """
    对a和b执行某些操作。
    """
    print(a, b)

现在有一个Foo类，希望将上述函数适配为该类的方法，同时需要保留原函数的文档字符串、IDE/Notebook中的动态自动补全及帮助信息。当前的实现如下：

class Foo:
    def foo(self, **kwargs):
        bar(a=kwargs.get("a"), b=kwargs.get("b"))
        print("This was called from the class method")

请问：

1. 如何将原函数动态关联到类中，同时保留其文档字符串等元信息？
2. 在不重复定义类方法参数的前提下，**kwargs是否是最优的参数传递方式？
   期望在IDE或Jupyter Notebook中输入Foo.foo()时，能看到原函数的文档字符串。

一、动态关联函数并保留元信息 #

要保留原函数的文档字符串、参数注解及签名信息，推荐使用functools.wraps装饰器——它可以将原函数的元信息（包括__doc__、__annotations__、函数签名）完整复制到类方法上，让IDE能识别并显示这些信息。

实现代码 #

import functools

def bar(a: str, b: str):
    """
    对a和b执行某些操作。
    """
    print(a, b)

class Foo:
    @functools.wraps(bar)
    def foo(self, *args, **kwargs):
        # 直接传递参数给bar，无需手动提取
        bar(*args, **kwargs)
        print("This was called from the class method")

如果需要动态绑定（比如类定义完成后再关联函数），可以直接调用functools.wraps处理类方法：

# 类定义后补全元信息绑定
functools.wraps(bar)(Foo.foo)

设置完成后，在IDE或Jupyter中输入Foo.foo()时，就能看到bar函数的文档字符串，同时参数自动补全会显示a和b的类型提示。

二、参数传递方式的最优选择 #

单独使用**kwargs不是最优方案，因为IDE无法识别原函数的具体参数（只能看到kwargs这个字典参数），无法提供精准的自动补全。

更优的方式是结合*args和**kwargs：

• 无需重复定义a、b参数，完全复用原函数的参数签名
• 配合functools.wraps后，IDE能解析原函数的参数信息，提供正常的自动补全和提示
• 支持位置参数和关键字参数两种调用方式，灵活性更强

比如现在可以这样调用：

# 位置参数调用
Foo().foo("hello", "world")
# 关键字参数调用
Foo().foo(a="hello", b="world")

两种方式都能正常工作，且IDE会给出对应的参数提示。

内容的提问来源于stack exchange，提问作者F. Win