Skip to main content

csv

Comma-separated values reader and writer. Supports custom dialects, quoting policies, and dictionary-shaped rows.

Source-of-record: Lib/csv.py, Modules/_csv.c, csv docs.

Functions and classes

NamePurpose
reader(csvfile, dialect='excel', **fmtparams)Row iterator of list[str].
writer(csvfile, dialect='excel', **fmtparams)Row writer; writerow, writerows.
DictReader(f, fieldnames=None, restkey=None, restval=None, dialect='excel', **kw)Dict rows.
DictWriter(f, fieldnames, restval='', extrasaction='raise', dialect='excel', **kw)Dict rows.
Sniffer()sniff, has_header.
list_dialects() / get_dialect(name)Registered dialects.
register_dialect(name, dialect=None, **fmtparams)Register.
unregister_dialect(name)Remove.
field_size_limit([new_limit])Max field length.

Dialect parameters

ParameterDefaultMeaning
delimiter,Field separator.
quotechar"Quote character.
doublequoteTrueEscape quote by doubling.
escapecharNoneAlternative escape.
lineterminator\r\nWriter row terminator.
quotingQUOTE_MINIMALQuoting policy.
skipinitialspaceFalseIgnore space after delimiter.
strictFalseRaise on bad input.

Quoting constants

QUOTE_ALL, QUOTE_MINIMAL, QUOTE_NONNUMERIC, QUOTE_NONE, QUOTE_STRINGS (3.12+), QUOTE_NOTNULL (3.12+).

Built-in dialects

excel, excel-tab, unix.

Gopy status

AreaState
reader, writerComplete.
DictReader, DictWriterComplete.
SnifferComplete.
All quoting modes incl. 3.12+ additionsComplete.

Reference

  • CPython 3.14: csv.
  • Lib/csv.py, Modules/_csv.c.
  • module/_csv/. gopy port.