CSV reader and writer¶
Agate contains CSV readers and writers that are intended to be used as a drop-in replacement for csv
. These versions add unicode support for Python 2 and several other minor features.
Agate methods will use these version automatically. If you would like to use them in your own code, you can import them, like this:
from agate import csv
Due to nuanced differences between the versions, these classes are implemented seperately for Python 2 and Python 3. The documentation for both versions is provided below, but only the one for your version of Python is imported with the above code.
Python 3¶
A replacement for Python’s |
|
A replacement for Python’s |
|
A wrapper around Python 3’s builtin |
|
A wrapper around Python 3’s builtin |
|
A wrapper around Python 3’s builtin |
|
A wrapper around Python 3’s builtin |
Python 2¶
A replacement for Python’s |
|
A replacement for Python’s |
|
A unicode-aware CSV reader. |
|
A unicode-aware CSV writer. |
|
A unicode-aware CSV DictReader. |
|
A unicode-aware CSV DictWriter. |
Python 3 details¶
- agate.csv_py3.reader(*args, **kwargs)¶
A replacement for Python’s
csv.reader()
that usescsv_py3.Reader
.
- agate.csv_py3.writer(*args, **kwargs)¶
A replacement for Python’s
csv.writer()
that usescsv_py3.Writer
.
- class agate.csv_py3.Reader(f, field_size_limit=None, line_numbers=False, header=True, **kwargs)¶
A wrapper around Python 3’s builtin
csv.reader()
.
- class agate.csv_py3.Writer(f, line_numbers=False, **kwargs)¶
A wrapper around Python 3’s builtin
csv.writer()
.
- class agate.csv_py3.DictReader(f, fieldnames=None, restkey=None, restval=None, dialect='excel', *args, **kwds)¶
A wrapper around Python 3’s builtin
csv.DictReader
.
- class agate.csv_py3.DictWriter(f, fieldnames, line_numbers=False, **kwargs)¶
A wrapper around Python 3’s builtin
csv.DictWriter
.
Python 2 details¶
- agate.csv_py2.reader(*args, **kwargs)¶
A replacement for Python’s
csv.reader()
that usescsv_py2.Reader
.
- agate.csv_py2.writer(*args, **kwargs)¶
A replacement for Python’s
csv.writer()
that usescsv_py2.Writer
.
- class agate.csv_py2.Reader(f, encoding='utf-8', field_size_limit=None, line_numbers=False, header=True, **kwargs)¶
A unicode-aware CSV reader.
- class agate.csv_py2.Writer(f, encoding='utf-8', line_numbers=False, **kwargs)¶
A unicode-aware CSV writer.
- class agate.csv_py2.DictReader(f, fieldnames=None, restkey=None, restval=None, *args, **kwargs)¶
A unicode-aware CSV DictReader.
- class agate.csv_py2.DictWriter(f, fieldnames, encoding='utf-8', line_numbers=False, **kwargs)¶
A unicode-aware CSV DictWriter.