如何以编程方式将自定义类单例对象转为Python模块？

嘿，我完全get你的需求——不想手动把单例类的方法一个个复制到模块里，而是想直接把单例的方法当成模块级函数来导入调用，对吧？这事儿用Python的动态特性就能搞定，给你两个实用的方案：

方案1：动态绑定单例方法到模块全局作用域 #

这个方案会在模块加载时，自动把单例的所有非特殊方法绑定到模块层面，让外部可以直接导入：

修改后的 mymodule.py #

class MyClass:
    """This is my custom class"""
    def my_method(self):
        return "myValue"
    # 可以加更多方法测试
    def double_num(self, num):
        return num * 2

singleton = MyClass()

# 动态将单例的方法挂载到模块
import sys
current_module = sys.modules[__name__]

# 遍历单例的属性，筛选出可调用的非特殊方法
for attr_name in dir(singleton):
    attr = getattr(singleton, attr_name)
    # 排除以__开头的内置方法/属性，只保留自定义方法
    if not attr_name.startswith('__') and callable(attr):
        setattr(current_module, attr_name, attr)

对应的 main_to_be.py #

from mymodule import my_method, double_num

print(my_method())       # 输出: myValue
print(double_num(5))     # 输出: 10

原理说明：通过sys.modules[__name__]获取当前模块的对象，然后遍历单例实例的属性，把符合条件的方法（非特殊、可调用）赋值给模块的属性。这些方法是已经绑定到单例实例的绑定方法，调用时会自动把单例作为self传入。

方案2：用模块级__getattr__实现按需查找 #

这个方案更灵活，不需要提前遍历绑定，而是当外部请求模块中不存在的属性时，自动去单例里查找：

修改后的 mymodule.py #

class MyClass:
    """This is my custom class"""
    def my_method(self):
        return "myValue"
    def greet(self, name):
        return f"Hello, {name}!"

singleton = MyClass()

def __getattr__(name):
    # 当模块被请求未定义的属性时，尝试从单例中获取
    try:
        attr = getattr(singleton, name)
        # 如果是可调用方法，直接返回绑定好的版本
        if callable(attr):
            return attr
        return attr
    except AttributeError:
        # 抛出标准的模块属性不存在错误，保持行为一致
        raise AttributeError(f"module '{__name__}' has no attribute '{name}'") from None

对应的 main_to_be.py #

from mymodule import my_method, greet

print(my_method())       # 输出: myValue
print(greet("Jerry"))    # 输出: Hello, Jerry!

原理说明：Python 3.7+支持模块级的__getattr__函数，当外部访问模块中不存在的属性时，会调用这个函数。我们在这里把查找逻辑转向单例实例，这样不管单例有什么方法，只要名字正确就能被导入调用，甚至后续动态添加的方法也能生效。

注意事项 #

• 避免命名冲突：如果模块本身已经有同名的函数/变量，那么模块自身的属性会优先被使用，不会被单例的方法覆盖。
• 特殊方法不支持：__init__、__str__这类以__开头的特殊方法，无论是方案1的过滤还是方案2的查找逻辑，都不会被导出（Python对特殊方法的查找有特殊规则，不会走模块的__getattr__，也不建议把它们当成普通方法导出）。

内容的提问来源于stack exchange，提问作者Jerry