"typing.BinaryIO" missing "readinto" method

Bug report

Bug description:

typeing.BinaryIO is completely missing the readinto method. All binary mode return values of open support the readinto method, and the lack of it on the BinaryIO type makes type-hinting difficult when using this method. One could try to use io.RawIOBase | io.BufferedIOBase but this looses the fact that the result of open has a name property. This has been brought up in python/typing#659 and python/typeshed#2166.

Furthmore, the write method in BinaryIO is declared to only be compatible with Union[bytes, bytearray] when it should be anything that satisfies collections.abc.Buffer.

I propose that BinaryIO should look something more like:

class BinaryIO(IO[bytes]):
    """Typed version of the return of open() in binary mode."""

    __slots__ = ()

    @abstractmethod
    def readinto(self, b: collections.abc.Buffer) -> int:
        pass

    @abstractmethod
    def write(self, s: collections.abc.Buffer) -> int:
        pass

    @abstractmethod
    def __enter__(self) -> 'BinaryIO':
        pass

CPython versions tested on:

CPython main branch

Operating systems tested on:

No response

Bắt đầu từ định nghĩa typing.BinaryIO và so sánh nó với các giá trị trả về của open() ở chế độ nhị phân, tập trung vào các chữ ký readinto và write tương thích với Buffer được đề xuất. Xác minh rằng BinaryIO vẫn cung cấp thuộc tính name và hành vi typing được cập nhật đã được các bài kiểm thử hiện có liên quan bao phủ; issue không nêu tên tệp hoặc bài kiểm thử cụ thể nào.