如何实现可直接返回值且支持调用方法的Python类属性？

我想创建一个类，其中的属性既可以直接返回一个值，又能调用自身的方法，期望的使用方式如下：

f = CSVFile()
f.valid_transactions # 返回元素列表
f.valid_transactions.to_csv() # 返回该列表的CSV格式字符串

该如何实现此需求？

我尝试了以下代码，但这种方式需要使用f.valid_transactions()（带括号），而非我想要的f.valid_transactions：

import csv
from io import StringIO
from typing import List, Iterable, Mapping

from models.ValidTransaction import ValidTransaction

class CSVFile:
    class ValidTransactions:
        def __init__(self) -> None:
            self._transactions: List[ValidTransaction] = []

        def __call__(self) -> List[ValidTransaction]:
            return self._transactions

        def __len__(self) -> int:
            return len(self._transactions)

        def to_csv(self):
            output = StringIO()
            header = ValidTransaction.get_output_header()
            writer = csv.DictWriter(output, header)
            writer.writeheader()
            
            for tx in self._transactions:
                writer.writerow(tx.dict())

            return output.getvalue()

    def __init__(self, rows: Iterable[Mapping]) -> None:
        self.valid_transactions: self.ValidTransactions = self.ValidTransactions()

        for row in rows:
            valid_tx = ValidTransaction(**row)
            self.valid_transactions._transactions.append(valid_tx)

这种使用方式是否推荐？或者我是否应该改用如下写法：

f = CSVFile()
f.valid_transactions.get_value() # 返回元素列表
f.valid_transactions.to_csv() # 返回该列表的CSV格式字符串

实现目标需求的方法 #

要实现f.valid_transactions直接返回列表、同时可调用to_csv()的效果，最直接的方式是让内部的ValidTransactions类继承自list——这样它本身就是一个列表实例，天然具备列表的所有特性，同时可以添加自定义方法。修改后的代码如下：

import csv
from io import StringIO
from typing import List, Iterable, Mapping

from models.ValidTransaction import ValidTransaction

class CSVFile:
    class ValidTransactions(list):
        def to_csv(self):
            output = StringIO()
            header = ValidTransaction.get_output_header()
            writer = csv.DictWriter(output, header)
            writer.writeheader()
            
            for tx in self:
                writer.writerow(tx.dict())

            return output.getvalue()

    def __init__(self, rows: Iterable[Mapping]) -> None:
        self.valid_transactions: self.ValidTransactions = self.ValidTransactions()

        for row in rows:
            valid_tx = ValidTransaction(**row)
            self.valid_transactions.append(valid_tx)

此时f.valid_transactions就是列表对象，直接访问会返回列表内容，同时能直接调用to_csv()方法，完全符合你的期望。

如果不想继承list，也可以通过实现__iter__、__getitem__等方法让ValidTransactions模拟列表的行为，但继承list是最省心的方案，无需手动实现列表的基础功能。

使用方式的合理性对比 #

第一种方式（直接访问属性返回列表+调用方法） #

• 优点：语法简洁，使用起来符合直觉，减少代码冗余。
• 缺点：属性具备“双重身份”——既是列表又是带自定义方法的对象，对不熟悉代码的开发者来说可能存在可读性困惑，不清楚为什么列表会有额外方法。

第二种方式（通过get_value()获取列表） #

• 优点：语义清晰，明确区分“获取值”和“执行操作”的逻辑，代码可读性、可维护性更高，避免了身份混淆的问题。
• 缺点：需要多写一次方法调用，语法上稍显繁琐。

推荐方案 #

如果你的核心诉求是简化语法，且valid_transactions的主要用途就是作为列表使用，那么继承list的方案完全适用。

如果更看重代码的可读性和明确性，希望避免“双重身份”带来的认知成本，那么推荐使用第二种方式，通过get_value()明确获取列表值。

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