@@ -11,7 +11,7 @@ msgid ""
1111msgstr ""
1212"Project-Id-Version : Python 3.13\n "
1313"Report-Msgid-Bugs-To : \n "
14- "POT-Creation-Date : 2026-06-03 20:27 +0000\n "
14+ "POT-Creation-Date : 2026-06-05 18:08 +0000\n "
1515"PO-Revision-Date : 2025-09-15 01:04+0000\n "
1616"Last-Translator : python-doc bot, 2025\n "
1717"Language-Team : Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n "
@@ -144,6 +144,15 @@ msgid ""
144144"The raw stream API is described in detail in the docs of :class:`RawIOBase`."
145145msgstr ""
146146
147+ msgid ""
148+ "Raw I/O is a low-level interface and methods generally must have their "
149+ "return values checked and be explicitly retried to ensure an operation "
150+ "completes. For instance :meth:`~RawIOBase.write` returns the number of bytes "
151+ "written which may be less than the number of bytes provided (a partial "
152+ "write). High-level I/O objects like :ref:`binary-io` and :ref:`text-io` "
153+ "implement retry behavior."
154+ msgstr ""
155+
147156msgid "Text Encoding"
148157msgstr ""
149158
@@ -602,9 +611,14 @@ msgstr ""
602611
603612msgid ""
604613"Read up to *size* bytes from the object and return them. As a convenience, "
605- "if *size* is unspecified or -1, all bytes until EOF are returned. Otherwise, "
606- "only one system call is ever made. Fewer than *size* bytes may be returned "
607- "if the operating system call returns fewer than *size* bytes."
614+ "if *size* is unspecified or -1, all bytes until EOF are returned."
615+ msgstr ""
616+
617+ msgid ""
618+ "Attempts to make only one system call but will retry if interrupted and the "
619+ "signal handler does not raise an exception (see :pep:`475` for the "
620+ "rationale). This means fewer than *size* bytes may be returned if the "
621+ "operating system call returns fewer than *size* bytes."
608622msgstr ""
609623
610624msgid ""
@@ -622,11 +636,22 @@ msgid ""
622636"calls to the stream if necessary."
623637msgstr ""
624638
639+ msgid ""
640+ "If ``0`` bytes are returned this indicates end of file. If the object is in "
641+ "non-blocking mode and the underlying :meth:`read` returns ``None`` "
642+ "indicating no bytes are available, ``None`` is returned."
643+ msgstr ""
644+
625645msgid ""
626646"Read bytes into a pre-allocated, writable :term:`bytes-like object` *b*, and "
627647"return the number of bytes read. For example, *b* might be a :class:"
628- "`bytearray`. If the object is in non-blocking mode and no bytes are "
629- "available, ``None`` is returned."
648+ "`bytearray`."
649+ msgstr ""
650+
651+ msgid ""
652+ "If ``0`` is returned and ``len(b)`` is not ``0``, this indicates end of "
653+ "file. If the object is in non-blocking mode and no bytes are available, "
654+ "``None`` is returned."
630655msgstr ""
631656
632657msgid ""
@@ -639,6 +664,14 @@ msgid ""
639664"the implementation should only access *b* during the method call."
640665msgstr ""
641666
667+ msgid ""
668+ "This function does not ensure all bytes are written or an exception is "
669+ "thrown. Callers may implement that behavior by checking the return value "
670+ "and, if it is less than the length of *b*, looping with additional write "
671+ "calls until all unwritten bytes are written. High-level I/O objects like :"
672+ "ref:`binary-io` and :ref:`text-io` implement retry behavior."
673+ msgstr ""
674+
642675msgid ""
643676"Base class for binary streams that support some kind of buffering. It "
644677"inherits from :class:`IOBase`."
@@ -772,7 +805,11 @@ msgstr ""
772805
773806msgid ""
774807"A raw binary stream representing an OS-level file containing bytes data. It "
775- "inherits from :class:`RawIOBase`."
808+ "inherits from :class:`RawIOBase` and implements its low-level access design. "
809+ "This means :meth:`~RawIOBase.write` does not guarantee all bytes are written "
810+ "and :meth:`~RawIOBase.read` may read less bytes than requested even when "
811+ "more bytes may be present in the underlying file. To get \" write all\" and "
812+ "\" read at least\" behavior, use :ref:`binary-io`."
776813msgstr ""
777814
778815msgid "The *name* can be one of two things:"
@@ -801,12 +838,6 @@ msgid ""
801838"``'+'`` to the mode to allow simultaneous reading and writing."
802839msgstr ""
803840
804- msgid ""
805- "The :meth:`~RawIOBase.read` (when called with a positive argument), :meth:"
806- "`~RawIOBase.readinto` and :meth:`~RawIOBase.write` methods on this class "
807- "will only make one system call."
808- msgstr ""
809-
810841msgid ""
811842"A custom opener can be used by passing a callable as *opener*. The "
812843"underlying file descriptor for the file object is then obtained by calling "
@@ -823,6 +854,14 @@ msgid ""
823854"parameter."
824855msgstr ""
825856
857+ msgid ""
858+ ":class:`FileIO` is a low-level I/O object and members, such as :meth:"
859+ "`~RawIOBase.read` and :meth:`~RawIOBase.write`, need to have their return "
860+ "values checked explicitly in a retry loop to implement \" write all\" and "
861+ "\" read at least\" behavior. High-level I/O objects :ref:`binary-io` and :ref:"
862+ "`text-io` implement retry behavior."
863+ msgstr ""
864+
826865msgid "The *opener* parameter was added. The ``'x'`` mode was added."
827866msgstr ""
828867
0 commit comments