12.20.2 Dialects and Formatting Parameters
To make it easier to specify the format of input and output records, specific formatting
parameters are grouped together into dialects. A dialect is a subclass of the Dialect class having a set of specific methods and a single validate() method. When creating reader or writer objects, the programmer can specify a string or a subclass of the Dialect class as the dialect parameter. In addition to, or instead of, the dialect
parameter, the programmer can also specify individual formatting parameters, which have the
same names as the attributes defined below for the Dialect class.
Dialects support the following attributes:
- A one-character string used to separate fields. It defaults to
- Controls how instances of quotechar appearing inside a field should be
themselves be quoted. When True, the character is doubledd. When
False, the escapechar must be a one-character string
which is used as a prefix to the quotechar. It defaults to True.
- A one-character string used to escape the delimiter if quoting is
set to QUOTE_NONE. It defaults to None.
- The string used to terminate lines in the CSV file. It defaults to
- A one-character string used to quote elements containing the delimiter or
which start with the quotechar. It defaults to
- Controls when quotes should be generated by the writer. It can take on any of the QUOTE_* constants (see section 12.20.1) and defaults to QUOTE_MINIMAL.
- When True, whitespace immediately following the delimiter
is ignored. The default is False.