[aiofiles] `aiofiles.tempfile.NamedTemporaryFile.name` should probably be a `str`

[sashkent3]

When using aiofiles like this:

from aiofiles.tempfile import NamedTemporaryFile


async def main():
    async with NamedTemporaryFile() as f:
        print(f.name)

f.name is reported to be a FileDescriptorOrPath. It should probably be a str instead because that's how it is for the stdlib's tempfile.NamedTemporaryFile and that's the whole point of a named temporary file.

[srittau]

Any improvements welcome!

[larsott1]

I tested this with aiofiles 24.1.0 on Python 3.11.10 (Windows), and f.name correctly returns str. This issue might have been fixed in a recent update. Could you confirm which aiofiles version you were using?

[sashkent3]

I'm on aiofiles 24.1.0 on Python 3.13.2 (Linux) and the issue persists. I understand that the type of f.name is str at runtime, but can you confirm the revealed static type with:

from typing import reveal_type

from aiofiles.tempfile import NamedTemporaryFile


async def main():
    async with NamedTemporaryFile() as f:
        reveal_type(f.name)

The issue stems from:

typeshed/stubs/aiofiles/aiofiles/threadpool/binary.pyi

Line 31 in 714c99b

def name(self) -> FileDescriptorOrPath: ...

so I'm doubtful it's fixed.

[nightcityblade]

Hi, I'd like to work on this. I'll submit a PR shortly.