diff options
author | Jeff Quast <contact@jeffquast.com> | 2016-07-01 21:56:38 -0700 |
---|---|---|
committer | Jeff Quast <contact@jeffquast.com> | 2016-07-02 08:47:41 -0700 |
commit | 935fc210302ff394ef028f98a075546ca271feb5 (patch) | |
tree | c56e9f69285db2af9ac85c7ea4bf0ae345e8f65b /pexpect/fdpexpect.py | |
parent | 248cb49a55b4e01560ad1149ec0cec61daf80c82 (diff) | |
download | pexpect-935fc210302ff394ef028f98a075546ca271feb5.tar.gz |
suggest docstring improvements for fdpexpect.py
Diffstat (limited to 'pexpect/fdpexpect.py')
-rw-r--r-- | pexpect/fdpexpect.py | 21 |
1 files changed, 12 insertions, 9 deletions
diff --git a/pexpect/fdpexpect.py b/pexpect/fdpexpect.py index 40817b9..ac7443e 100644 --- a/pexpect/fdpexpect.py +++ b/pexpect/fdpexpect.py @@ -115,17 +115,20 @@ class fdspawn(SpawnBase): self.write(s) def read_nonblocking(self, size=1, timeout=-1): - """ Read from the file descriptor and return the result as a string. + """ + Read from the file descriptor and return the result as a string. + + The read_nonblocking method of :class:`SpawnBase` assumes that a call + to os.read will not block (timeout parameter is ignored). This is not + the case for POSIX file-like objects such as sockets and serial ports. - The read_nonblocking method of SpawnBase assumes that a call to - os.read will not block. This is not the case for POSIX file like - objects like sockets and serial ports. So we use select to implement - the timeout on POSIX. + Use :func:`select.select`, timeout is implemented conditionally for + POSIX systems. - :param size: Read at most size bytes - :param timeout: Wait timeout seconds for file descriptor to be ready - to read. If -1, use self.timeout. If 0, poll. - :return: String containing the bytes read + :param int size: Read at most *size* bytes. + :param int timeout: Wait timeout seconds for file descriptor to be + ready to read. When -1 (default), use self.timeout. When 0, poll. + :return: String containing the bytes read """ if os.name == 'posix': if timeout == -1: |