https://github.com/python/cpython/commit/e0f54a608eae7cb062b3b22d1b39a0f3fba3e8cb
commit: e0f54a608eae7cb062b3b22d1b39a0f3fba3e8cb
branch: main
author: Maurycy Pawłowski-Wieroński <[email protected]>
committer: hugovk <[email protected]>
date: 2025-09-11T18:11:33+03:00
summary:
gh-138005: Document that CSV `skipinitialspace=True` and `delimiter=' '`
require quotation for empty fields (#138006)
files:
M Doc/library/csv.rst
diff --git a/Doc/library/csv.rst b/Doc/library/csv.rst
index c11c9b8b2bfbe7..3ea7cd210f729d 100644
--- a/Doc/library/csv.rst
+++ b/Doc/library/csv.rst
@@ -468,7 +468,8 @@ Dialects support the following attributes:
.. attribute:: Dialect.skipinitialspace
When :const:`True`, spaces immediately following the *delimiter* are
ignored.
- The default is :const:`False`.
+ The default is :const:`False`. When combining ``delimiter=' '`` with
+ ``skipinitialspace=True``, unquoted empty fields are not allowed.
.. attribute:: Dialect.strict
@@ -637,7 +638,7 @@ done::
.. rubric:: Footnotes
.. [1] If ``newline=''`` is not specified, newlines embedded inside quoted
fields
- will not be interpreted correctly, and on platforms that use ``\r\n``
linendings
+ will not be interpreted correctly, and on platforms that use ``\r\n`` line
endings
on write an extra ``\r`` will be added. It should always be safe to specify
``newline=''``, since the csv module does its own
(:term:`universal <universal newlines>`) newline handling.
_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3//lists/python-checkins.python.org
Member address: [email protected]
