https://github.com/python/cpython/commit/978245cbdd4a16881b4168c090451b0d35b96dac commit: 978245cbdd4a16881b4168c090451b0d35b96dac branch: 3.14 author: Miss Islington (bot) <[email protected]> committer: serhiy-storchaka <[email protected]> date: 2026-08-13T10:08:44Z summary:
[3.14] gh-80678: Document the preferred attribute of csv.Sniffer (GH-155068) (GH-155680) It can be modified to change the order in which the delimiters are preferred for breaking ties. (cherry picked from commit 1370f8a8a19a1201b2cc27a301a3f8f1d4478764) Co-authored-by: Serhiy Storchaka <[email protected]> files: M Doc/library/csv.rst diff --git a/Doc/library/csv.rst b/Doc/library/csv.rst index 64065a75917af8..159530937c20ca 100644 --- a/Doc/library/csv.rst +++ b/Doc/library/csv.rst @@ -316,8 +316,8 @@ The :mod:`!csv` module defines the following classes: If several delimiters fit the sample equally well --- for example if both ``','`` and ``';'`` split every row consistently --- - the delimiters ``','``, ``'\t'``, ``';'``, ``' '`` and ``':'`` - are preferred, in this order, + the delimiters listed in the :attr:`~Sniffer.preferred` attribute + are preferred, in that order, no matter how many times each of them occurs. .. method:: has_header(sample) @@ -339,6 +339,15 @@ The :mod:`!csv` module defines the following classes: This method is a rough heuristic and may produce both false positives and negatives. + The :class:`Sniffer` class has the following attribute: + + .. attribute:: preferred + + The list of the delimiters preferred for breaking ties, + in the order of preference. + It can be modified. + Its initial value is ``[',', '\t', ';', ' ', ':']``. + An example for :class:`Sniffer` use:: with open('example.csv', newline='') as csvfile: _______________________________________________ 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]
