@@ -11,7 +11,7 @@ msgid ""
1111msgstr ""
1212"Project-Id-Version : Python 3.15\n "
1313"Report-Msgid-Bugs-To : \n "
14- "POT-Creation-Date : 2026-06-03 18:19 +0000\n "
14+ "POT-Creation-Date : 2026-06-05 16:27 +0000\n "
1515"PO-Revision-Date : 2025-09-16 00:01+0000\n "
1616"Last-Translator : python-doc bot, 2025\n "
1717"Language-Team : Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n "
@@ -150,6 +150,15 @@ msgid ""
150150"The raw stream API is described in detail in the docs of :class:`RawIOBase`."
151151msgstr ""
152152
153+ msgid ""
154+ "Raw I/O is a low-level interface and methods generally must have their "
155+ "return values checked and be explicitly retried to ensure an operation "
156+ "completes. For instance :meth:`~RawIOBase.write` returns the number of bytes "
157+ "written which may be less than the number of bytes provided (a partial "
158+ "write). High-level I/O objects like :ref:`binary-io` and :ref:`text-io` "
159+ "implement retry behavior."
160+ msgstr ""
161+
153162msgid "Text Encoding"
154163msgstr ""
155164
@@ -608,9 +617,14 @@ msgstr ""
608617
609618msgid ""
610619"Read up to *size* bytes from the object and return them. As a convenience, "
611- "if *size* is unspecified or -1, all bytes until EOF are returned. Otherwise, "
612- "only one system call is ever made. Fewer than *size* bytes may be returned "
613- "if the operating system call returns fewer than *size* bytes."
620+ "if *size* is unspecified or -1, all bytes until EOF are returned."
621+ msgstr ""
622+
623+ msgid ""
624+ "Attempts to make only one system call but will retry if interrupted and the "
625+ "signal handler does not raise an exception (see :pep:`475` for the "
626+ "rationale). This means fewer than *size* bytes may be returned if the "
627+ "operating system call returns fewer than *size* bytes."
614628msgstr ""
615629
616630msgid ""
@@ -628,11 +642,22 @@ msgid ""
628642"calls to the stream if necessary."
629643msgstr ""
630644
645+ msgid ""
646+ "If ``0`` bytes are returned this indicates end of file. If the object is in "
647+ "non-blocking mode and the underlying :meth:`read` returns ``None`` "
648+ "indicating no bytes are available, ``None`` is returned."
649+ msgstr ""
650+
631651msgid ""
632652"Read bytes into a pre-allocated, writable :term:`bytes-like object` *b*, and "
633653"return the number of bytes read. For example, *b* might be a :class:"
634- "`bytearray`. If the object is in non-blocking mode and no bytes are "
635- "available, ``None`` is returned."
654+ "`bytearray`."
655+ msgstr ""
656+
657+ msgid ""
658+ "If ``0`` is returned and ``len(b)`` is not ``0``, this indicates end of "
659+ "file. If the object is in non-blocking mode and no bytes are available, "
660+ "``None`` is returned."
636661msgstr ""
637662
638663msgid ""
@@ -645,6 +670,14 @@ msgid ""
645670"the implementation should only access *b* during the method call."
646671msgstr ""
647672
673+ msgid ""
674+ "This function does not ensure all bytes are written or an exception is "
675+ "thrown. Callers may implement that behavior by checking the return value "
676+ "and, if it is less than the length of *b*, looping with additional write "
677+ "calls until all unwritten bytes are written. High-level I/O objects like :"
678+ "ref:`binary-io` and :ref:`text-io` implement retry behavior."
679+ msgstr ""
680+
648681msgid ""
649682"Base class for binary streams that support some kind of buffering. It "
650683"inherits from :class:`IOBase`."
@@ -778,7 +811,11 @@ msgstr ""
778811
779812msgid ""
780813"A raw binary stream representing an OS-level file containing bytes data. It "
781- "inherits from :class:`RawIOBase`."
814+ "inherits from :class:`RawIOBase` and implements its low-level access design. "
815+ "This means :meth:`~RawIOBase.write` does not guarantee all bytes are written "
816+ "and :meth:`~RawIOBase.read` may read less bytes than requested even when "
817+ "more bytes may be present in the underlying file. To get \" write all\" and "
818+ "\" read at least\" behavior, use :ref:`binary-io`."
782819msgstr ""
783820
784821msgid "The *name* can be one of two things:"
@@ -807,12 +844,6 @@ msgid ""
807844"``'+'`` to the mode to allow simultaneous reading and writing."
808845msgstr ""
809846
810- msgid ""
811- "The :meth:`~RawIOBase.read` (when called with a positive argument), :meth:"
812- "`~RawIOBase.readinto` and :meth:`~RawIOBase.write` methods on this class "
813- "will only make one system call."
814- msgstr ""
815-
816847msgid ""
817848"A custom opener can be used by passing a callable as *opener*. The "
818849"underlying file descriptor for the file object is then obtained by calling "
@@ -829,6 +860,14 @@ msgid ""
829860"parameter."
830861msgstr ""
831862
863+ msgid ""
864+ ":class:`FileIO` is a low-level I/O object and members, such as :meth:"
865+ "`~RawIOBase.read` and :meth:`~RawIOBase.write`, need to have their return "
866+ "values checked explicitly in a retry loop to implement \" write all\" and "
867+ "\" read at least\" behavior. High-level I/O objects :ref:`binary-io` and :ref:"
868+ "`text-io` implement retry behavior."
869+ msgstr ""
870+
832871msgid "The *opener* parameter was added. The ``'x'`` mode was added."
833872msgstr ""
834873
0 commit comments