如何在Python中兼容同名属性与待废弃的函数调用？

我正在重构某API，需要给即将移除的.length()函数调用添加废弃警告，最终用同名属性.length替换它。想实现：

• 访问.length时直接返回属性值
• 调用.length()时触发废弃警告，同时返回值
  尝试过__getattribute__和__getattr__但没找到可行方案。

初始尝试（无效） #

Python不允许类中同时定义同名的@property和方法，后定义的会覆盖前者，所以以下写法无法实现需求：

import warnings
class A:
    @property
    def length(self):
        return 1

    def length(self):
        warnings.warn(".length function is deprecated. Use the .length property", DeprecationWarning)
        return 1

兼容Python2.7的可行方案 #

核心思路是：当访问.length时，返回一个**既是数值（支持属性访问的直接取值）又可调用（触发警告）**的对象。以下是优化后的实现：

import warnings

class LengthProxy(object):
    def __init__(self, value):
        self.value = value

    def __call__(self, *args, **kwargs):
        warnings.warn(".length() is deprecated, use .length property instead", DeprecationWarning)
        return self.value

    # 模拟数值类型的行为，让代理对象能像普通数值一样使用
    def __float__(self):
        return float(self.value)
    
    def __int__(self):
        return int(self.value)
    
    def __eq__(self, other):
        return self.value == other
    
    def __repr__(self):
        return repr(self.value)

class A(object):
    def __getattribute__(self, item):
        if item == "length":
            return LengthProxy(1)
        return super(A, self).__getattribute__(item)

# 测试示例
a = A()
print(a.length)          # 直接输出1，无警告
print(a.length())        # 输出1，同时触发DeprecationWarning
print(float(a.length))   # 支持类型转换
print(a.length == 1)     # 支持比较操作

方案说明 #

1. LengthProxy类封装了实际的属性值，通过__call__方法处理函数调用场景，触发废弃警告
2. 实现__float__、__int__、__eq__等方法，让代理对象兼容原有代码中对.length的数值操作逻辑
3. 等所有用户完成迁移、不再使用.length()调用后，即可移除__getattribute__的逻辑，直接用标准属性定义：

class A(object):
    @property
    def length(self):
        return 1

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