Paramiko SFTPAttributes未文档化属性来源及官方文档查询方法问询

关于SFTPAttributes未文档化属性的说明 #

这些属性的来源和查询方式如下：

• filename、longname属性由listdir_attr()方法自动填充
  调用sftp.listdir_attr()查询目录列表时，SFTP服务器返回的响应中除了基础的文件大小、权限、时间等属性外，还会携带每个目录条目的文件名、类ls -l格式的长描述字符串，Paramiko解析响应后会将这两个字段直接附加到返回的SFTPAttributes实例上，不属于该类初始化的默认通用属性，因此在SFTPAttributes类的核心属性文档中没有单独列出。
• asbytes是SFTPAttributes类的内置底层方法
  该方法的作用是将当前属性对象序列化为SFTP协议要求的二进制报文格式，属于供内部协议交互调用的方法，面向普通用户的文档默认不会公开这类偏实现细节的方法。

要查询这类属性的相关说明，可以直接查看Paramiko官方文档中listdir_attr等对应方法的描述，其中明确标注了返回的SFTPAttributes实例会额外携带filename属性存储目录条目名称。如果需要更完整的说明，也可以直接查看Paramiko源码中sftp_attr.py文件的注释，所有内置属性、方法的作用都有详细标注。

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