classification
Title: csv documentation does not note default quote constant
Type: Stage:
Components: Documentation, Library (Lib) Versions: Python 3.10, Python 3.9, Python 3.8
process
Status: open Resolution:
Dependencies: Superseder:
Assigned To: docs@python Nosy List: andrei.avk, bemclaugh, docs@python, r.david.murray, tshepang
Priority: normal Keywords: easy, patch

Created on 2013-08-17 02:24 by bemclaugh, last changed 2021-06-11 14:26 by andrei.avk.

Files
File name Uploaded Description Edit
doc.patch bemclaugh, 2013-08-17 02:24 simple documentation fix review
Messages (3)
msg195448 - (view) Author: Brian McLaughlin (bemclaugh) Date: 2013-08-17 02:24
Documentation should note default quoting behavior of the csv module is csv.QUOTE_MINIMAL

http://hg.python.org/cpython/file/tip/Modules/_csv.c#l420
msg195452 - (view) Author: R. David Murray (r.david.murray) * (Python committer) Date: 2013-08-17 08:04
Well, it does say that QUOTE_MINIMAL is the default for the dialect 'quoting' attribute.  What it doesn't say is that the default dialect (excel) is exactly the documented default values for all the dialect parameters.  (Although having said that, I'm not 100% sure it is true, I didn't fully check the correspondence).
msg395636 - (view) Author: Andrei Kulakov (andrei.avk) * (Python triager) Date: 2021-06-11 14:26
The docs do say that now:

.. attribute:: Dialect.quoting

   Controls when quotes should be generated by the writer and recognised by the
   reader.  It can take on any of the :const:`QUOTE_\*` constants (see section
   :ref:`csv-contents`) and defaults to :const:`QUOTE_MINIMAL`.


.. so this issue can be closed.
History
Date User Action Args
2021-06-11 14:26:45andrei.avksetnosy: + andrei.avk
messages: + msg395636
2021-03-14 17:46:13iritkatrielsetkeywords: + easy
components: + Library (Lib)
versions: + Python 3.8, Python 3.9, Python 3.10, - Python 2.7, Python 3.3, Python 3.4
2013-08-23 16:41:32tshepangsetnosy: + tshepang
2013-08-17 08:04:20r.david.murraysetnosy: + r.david.murray

messages: + msg195452
versions: - Python 2.6, Python 3.1, Python 3.2, Python 3.5
2013-08-17 02:24:13bemclaughcreate