Align documentation and code with Python style practices

- Adapted documentation to reflect common Python style practices.
- Refactored code to use a clearer variable name.

Author: giosiragusa

Doc/library/io.rst

@@ -65,11 +65,10 @@ In-memory text streams are also available as :class:`StringIO` objects::
    f = io.StringIO("some initial text data")
 
 .. note::
-   If you are working with a non-blocking stream, be aware that operations on text I/O
-   objects may raise a ``BlockingIOError``. This occurs when the underlying stream is
-   in non-blocking mode and a read operation cannot be completed immediately, potentially
-   leading to a ``BlockingIOError``. To handle this, ensure your code properly catches and
-   manages such exceptions when working with non-blocking streams.
+   When working with a non-blocking stream, be aware that operations on text I/O objects
+   might raise a :exc:`BlockingIOError` if the stream cannot perform a read operation
+   immediately.
+
 
 The text stream API is described in detail in the documentation of
 :class:`TextIOBase`.
@@ -778,9 +777,8 @@ than raw I/O does.
       EOF or if the read call would block in non-blocking mode.
 
       .. note::
-         When the underlying raw stream is non-blocking, a ``BlockingIOError``
-         may be raised if the read operation cannot be completed immediately.
-         Ensure proper exception handling in such cases.
+         When the underlying raw stream is non-blocking, a :exc:`BlockingIOError`
+         may be raised if a read operation cannot be completed immediately.
 
    .. method:: read1(size=-1, /)
 

Lib/_pyio.py

@@ -2524,13 +2524,13 @@ def read(self, size=None):
         decoder = self._decoder or self._get_decoder()
         if size < 0:
 
-            b = self.buffer.read()
-            if b is None:
+            chunk = self.buffer.read()
+            if chunk is None:
                 raise BlockingIOError
 
             # Read everything.
             result = (self._get_decoded_chars() +
-                      decoder.decode(b, final=True))
+                      decoder.decode(chunk, final=True))
             if self._snapshot is not None:
                 self._set_decoded_chars('')
                 self._snapshot = None

Modules/_io/textio.c

@@ -1994,9 +1994,7 @@ _io_TextIOWrapper_read_impl(textio *self, Py_ssize_t n)
 
         if (bytes == Py_None){
             PyErr_SetString(PyExc_BlockingIOError, "Unexpected None encountered. This may be due to non-blocking I/O "
-                                                   "or an issue with the underlying I/O implementation. Please refer to "
-                                                   "the documentation or ensure that the I/O operation is properly "
-                                                   "configured.");
+                                                   "or an issue with the underlying I/O implementation.");
             return NULL;
 
         }