Skip Montanaro | a16b21f | 2003-03-23 14:32:54 +0000 | [diff] [blame] | 1 | /* csv module */ |
| 2 | |
| 3 | /* |
| 4 | |
| 5 | This module provides the low-level underpinnings of a CSV reading/writing |
| 6 | module. Users should not use this module directly, but import the csv.py |
| 7 | module instead. |
| 8 | |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 9 | */ |
| 10 | |
Skip Montanaro | 7b01a83 | 2003-04-12 19:23:46 +0000 | [diff] [blame] | 11 | #define MODULE_VERSION "1.0" |
| 12 | |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 13 | #include "Python.h" |
Victor Stinner | 4a21e57 | 2020-04-15 02:35:41 +0200 | [diff] [blame] | 14 | #include "structmember.h" // PyMemberDef |
Serhiy Storchaka | 323748a | 2018-07-26 13:21:09 +0300 | [diff] [blame] | 15 | #include <stdbool.h> |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 16 | |
Andrew McNamara | 37d2bdf | 2005-01-10 12:22:48 +0000 | [diff] [blame] | 17 | |
Antoine Pitrou | e7672d3 | 2012-05-16 11:33:08 +0200 | [diff] [blame] | 18 | typedef struct { |
| 19 | PyObject *error_obj; /* CSV exception */ |
| 20 | PyObject *dialects; /* Dialect registry */ |
| 21 | long field_limit; /* max parsed field size */ |
| 22 | } _csvstate; |
| 23 | |
Hai Shi | f707d94 | 2020-03-16 21:15:01 +0800 | [diff] [blame] | 24 | static inline _csvstate* |
| 25 | get_csv_state(PyObject *module) |
| 26 | { |
| 27 | void *state = PyModule_GetState(module); |
| 28 | assert(state != NULL); |
| 29 | return (_csvstate *)state; |
| 30 | } |
Antoine Pitrou | e7672d3 | 2012-05-16 11:33:08 +0200 | [diff] [blame] | 31 | |
| 32 | static int |
| 33 | _csv_clear(PyObject *m) |
| 34 | { |
Hai Shi | f707d94 | 2020-03-16 21:15:01 +0800 | [diff] [blame] | 35 | Py_CLEAR(get_csv_state(m)->error_obj); |
| 36 | Py_CLEAR(get_csv_state(m)->dialects); |
Antoine Pitrou | e7672d3 | 2012-05-16 11:33:08 +0200 | [diff] [blame] | 37 | return 0; |
| 38 | } |
| 39 | |
| 40 | static int |
| 41 | _csv_traverse(PyObject *m, visitproc visit, void *arg) |
| 42 | { |
Hai Shi | f707d94 | 2020-03-16 21:15:01 +0800 | [diff] [blame] | 43 | Py_VISIT(get_csv_state(m)->error_obj); |
| 44 | Py_VISIT(get_csv_state(m)->dialects); |
Antoine Pitrou | e7672d3 | 2012-05-16 11:33:08 +0200 | [diff] [blame] | 45 | return 0; |
| 46 | } |
| 47 | |
| 48 | static void |
| 49 | _csv_free(void *m) |
| 50 | { |
| 51 | _csv_clear((PyObject *)m); |
| 52 | } |
| 53 | |
| 54 | static struct PyModuleDef _csvmodule; |
| 55 | |
| 56 | #define _csvstate_global ((_csvstate *)PyModule_GetState(PyState_FindModule(&_csvmodule))) |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 57 | |
| 58 | typedef enum { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 59 | START_RECORD, START_FIELD, ESCAPED_CHAR, IN_FIELD, |
| 60 | IN_QUOTED_FIELD, ESCAPE_IN_QUOTED_FIELD, QUOTE_IN_QUOTED_FIELD, |
R David Murray | c7c42ef | 2013-03-19 22:41:47 -0400 | [diff] [blame] | 61 | EAT_CRNL,AFTER_ESCAPED_CRNL |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 62 | } ParserState; |
| 63 | |
| 64 | typedef enum { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 65 | QUOTE_MINIMAL, QUOTE_ALL, QUOTE_NONNUMERIC, QUOTE_NONE |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 66 | } QuoteStyle; |
| 67 | |
| 68 | typedef struct { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 69 | QuoteStyle style; |
Serhiy Storchaka | 2d06e84 | 2015-12-25 19:53:18 +0200 | [diff] [blame] | 70 | const char *name; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 71 | } StyleDesc; |
| 72 | |
Serhiy Storchaka | 2d06e84 | 2015-12-25 19:53:18 +0200 | [diff] [blame] | 73 | static const StyleDesc quote_styles[] = { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 74 | { QUOTE_MINIMAL, "QUOTE_MINIMAL" }, |
| 75 | { QUOTE_ALL, "QUOTE_ALL" }, |
| 76 | { QUOTE_NONNUMERIC, "QUOTE_NONNUMERIC" }, |
| 77 | { QUOTE_NONE, "QUOTE_NONE" }, |
| 78 | { 0 } |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 79 | }; |
| 80 | |
| 81 | typedef struct { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 82 | PyObject_HEAD |
Guido van Rossum | 4626458 | 2007-08-06 19:32:18 +0000 | [diff] [blame] | 83 | |
Serhiy Storchaka | 323748a | 2018-07-26 13:21:09 +0300 | [diff] [blame] | 84 | char doublequote; /* is " represented by ""? */ |
| 85 | char skipinitialspace; /* ignore spaces following delimiter? */ |
| 86 | char strict; /* raise exception on bad CSV */ |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 87 | int quoting; /* style of quoting to write */ |
Serhiy Storchaka | 323748a | 2018-07-26 13:21:09 +0300 | [diff] [blame] | 88 | Py_UCS4 delimiter; /* field separator */ |
| 89 | Py_UCS4 quotechar; /* quote character */ |
| 90 | Py_UCS4 escapechar; /* escape character */ |
| 91 | PyObject *lineterminator; /* string to write between records */ |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 92 | |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 93 | } DialectObj; |
| 94 | |
Neal Norwitz | 227b533 | 2006-03-22 09:28:35 +0000 | [diff] [blame] | 95 | static PyTypeObject Dialect_Type; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 96 | |
| 97 | typedef struct { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 98 | PyObject_HEAD |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 99 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 100 | PyObject *input_iter; /* iterate over this for input lines */ |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 101 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 102 | DialectObj *dialect; /* parsing dialect */ |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 103 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 104 | PyObject *fields; /* field list for current record */ |
| 105 | ParserState state; /* current CSV parse state */ |
Antoine Pitrou | 77ea640 | 2011-10-07 04:26:55 +0200 | [diff] [blame] | 106 | Py_UCS4 *field; /* temporary buffer */ |
Antoine Pitrou | 4045575 | 2010-08-15 18:51:10 +0000 | [diff] [blame] | 107 | Py_ssize_t field_size; /* size of allocated buffer */ |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 108 | Py_ssize_t field_len; /* length of current field */ |
| 109 | int numeric_field; /* treat field as numeric */ |
| 110 | unsigned long line_num; /* Source-file line number */ |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 111 | } ReaderObj; |
| 112 | |
Neal Norwitz | 227b533 | 2006-03-22 09:28:35 +0000 | [diff] [blame] | 113 | static PyTypeObject Reader_Type; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 114 | |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 115 | typedef struct { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 116 | PyObject_HEAD |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 117 | |
Rémi Lapeyre | 2bc158f | 2019-05-14 15:45:14 +0200 | [diff] [blame] | 118 | PyObject *write; /* write output lines to this file */ |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 119 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 120 | DialectObj *dialect; /* parsing dialect */ |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 121 | |
Antoine Pitrou | 77ea640 | 2011-10-07 04:26:55 +0200 | [diff] [blame] | 122 | Py_UCS4 *rec; /* buffer for parser.join */ |
Antoine Pitrou | 4045575 | 2010-08-15 18:51:10 +0000 | [diff] [blame] | 123 | Py_ssize_t rec_size; /* size of allocated record */ |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 124 | Py_ssize_t rec_len; /* length of record */ |
| 125 | int num_fields; /* number of fields in record */ |
Guido van Rossum | 4626458 | 2007-08-06 19:32:18 +0000 | [diff] [blame] | 126 | } WriterObj; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 127 | |
Neal Norwitz | 227b533 | 2006-03-22 09:28:35 +0000 | [diff] [blame] | 128 | static PyTypeObject Writer_Type; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 129 | |
| 130 | /* |
| 131 | * DIALECT class |
| 132 | */ |
| 133 | |
| 134 | static PyObject * |
| 135 | get_dialect_from_registry(PyObject * name_obj) |
| 136 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 137 | PyObject *dialect_obj; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 138 | |
Serhiy Storchaka | a24107b | 2019-02-25 17:59:46 +0200 | [diff] [blame] | 139 | dialect_obj = PyDict_GetItemWithError(_csvstate_global->dialects, name_obj); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 140 | if (dialect_obj == NULL) { |
| 141 | if (!PyErr_Occurred()) |
Antoine Pitrou | e7672d3 | 2012-05-16 11:33:08 +0200 | [diff] [blame] | 142 | PyErr_Format(_csvstate_global->error_obj, "unknown dialect"); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 143 | } |
| 144 | else |
| 145 | Py_INCREF(dialect_obj); |
| 146 | return dialect_obj; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 147 | } |
| 148 | |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 149 | static PyObject * |
Antoine Pitrou | 77ea640 | 2011-10-07 04:26:55 +0200 | [diff] [blame] | 150 | get_nullchar_as_None(Py_UCS4 c) |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 151 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 152 | if (c == '\0') { |
Serhiy Storchaka | 228b12e | 2017-01-23 09:47:21 +0200 | [diff] [blame] | 153 | Py_RETURN_NONE; |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 154 | } |
| 155 | else |
Martin v. Löwis | d63a3b8 | 2011-09-28 07:41:54 +0200 | [diff] [blame] | 156 | return PyUnicode_FromOrdinal(c); |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 157 | } |
| 158 | |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 159 | static PyObject * |
Serhiy Storchaka | d4f9cf5 | 2018-11-27 19:34:35 +0200 | [diff] [blame] | 160 | Dialect_get_lineterminator(DialectObj *self, void *Py_UNUSED(ignored)) |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 161 | { |
Dong-hee Na | 0383be4 | 2020-06-10 00:33:43 +0900 | [diff] [blame] | 162 | Py_XINCREF(self->lineterminator); |
| 163 | return self->lineterminator; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 164 | } |
| 165 | |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 166 | static PyObject * |
Serhiy Storchaka | d4f9cf5 | 2018-11-27 19:34:35 +0200 | [diff] [blame] | 167 | Dialect_get_delimiter(DialectObj *self, void *Py_UNUSED(ignored)) |
Guido van Rossum | a9769c2 | 2007-08-07 23:59:30 +0000 | [diff] [blame] | 168 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 169 | return get_nullchar_as_None(self->delimiter); |
Guido van Rossum | a9769c2 | 2007-08-07 23:59:30 +0000 | [diff] [blame] | 170 | } |
| 171 | |
| 172 | static PyObject * |
Serhiy Storchaka | d4f9cf5 | 2018-11-27 19:34:35 +0200 | [diff] [blame] | 173 | Dialect_get_escapechar(DialectObj *self, void *Py_UNUSED(ignored)) |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 174 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 175 | return get_nullchar_as_None(self->escapechar); |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 176 | } |
| 177 | |
Andrew McNamara | 1196cf1 | 2005-01-07 04:42:45 +0000 | [diff] [blame] | 178 | static PyObject * |
Serhiy Storchaka | d4f9cf5 | 2018-11-27 19:34:35 +0200 | [diff] [blame] | 179 | Dialect_get_quotechar(DialectObj *self, void *Py_UNUSED(ignored)) |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 180 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 181 | return get_nullchar_as_None(self->quotechar); |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 182 | } |
| 183 | |
| 184 | static PyObject * |
Serhiy Storchaka | d4f9cf5 | 2018-11-27 19:34:35 +0200 | [diff] [blame] | 185 | Dialect_get_quoting(DialectObj *self, void *Py_UNUSED(ignored)) |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 186 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 187 | return PyLong_FromLong(self->quoting); |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 188 | } |
| 189 | |
| 190 | static int |
Serhiy Storchaka | 323748a | 2018-07-26 13:21:09 +0300 | [diff] [blame] | 191 | _set_bool(const char *name, char *target, PyObject *src, bool dflt) |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 192 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 193 | if (src == NULL) |
| 194 | *target = dflt; |
Antoine Pitrou | 6f430e4 | 2012-08-15 23:18:25 +0200 | [diff] [blame] | 195 | else { |
| 196 | int b = PyObject_IsTrue(src); |
| 197 | if (b < 0) |
| 198 | return -1; |
Serhiy Storchaka | 323748a | 2018-07-26 13:21:09 +0300 | [diff] [blame] | 199 | *target = (char)b; |
Antoine Pitrou | 6f430e4 | 2012-08-15 23:18:25 +0200 | [diff] [blame] | 200 | } |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 201 | return 0; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 202 | } |
| 203 | |
Andrew McNamara | 1196cf1 | 2005-01-07 04:42:45 +0000 | [diff] [blame] | 204 | static int |
| 205 | _set_int(const char *name, int *target, PyObject *src, int dflt) |
| 206 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 207 | if (src == NULL) |
| 208 | *target = dflt; |
| 209 | else { |
Victor Stinner | 7a6dbb7 | 2016-10-19 16:00:37 +0200 | [diff] [blame] | 210 | int value; |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 211 | if (!PyLong_CheckExact(src)) { |
| 212 | PyErr_Format(PyExc_TypeError, |
| 213 | "\"%s\" must be an integer", name); |
| 214 | return -1; |
| 215 | } |
Victor Stinner | 7a6dbb7 | 2016-10-19 16:00:37 +0200 | [diff] [blame] | 216 | value = _PyLong_AsInt(src); |
| 217 | if (value == -1 && PyErr_Occurred()) { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 218 | return -1; |
| 219 | } |
Victor Stinner | 7a6dbb7 | 2016-10-19 16:00:37 +0200 | [diff] [blame] | 220 | *target = value; |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 221 | } |
| 222 | return 0; |
Andrew McNamara | 1196cf1 | 2005-01-07 04:42:45 +0000 | [diff] [blame] | 223 | } |
| 224 | |
| 225 | static int |
Antoine Pitrou | 77ea640 | 2011-10-07 04:26:55 +0200 | [diff] [blame] | 226 | _set_char(const char *name, Py_UCS4 *target, PyObject *src, Py_UCS4 dflt) |
Andrew McNamara | 1196cf1 | 2005-01-07 04:42:45 +0000 | [diff] [blame] | 227 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 228 | if (src == NULL) |
| 229 | *target = dflt; |
| 230 | else { |
| 231 | *target = '\0'; |
| 232 | if (src != Py_None) { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 233 | Py_ssize_t len; |
Serhiy Storchaka | cac23a5 | 2013-12-19 16:27:18 +0200 | [diff] [blame] | 234 | if (!PyUnicode_Check(src)) { |
| 235 | PyErr_Format(PyExc_TypeError, |
| 236 | "\"%s\" must be string, not %.200s", name, |
Victor Stinner | daa9756 | 2020-02-07 03:37:06 +0100 | [diff] [blame] | 237 | Py_TYPE(src)->tp_name); |
Serhiy Storchaka | cac23a5 | 2013-12-19 16:27:18 +0200 | [diff] [blame] | 238 | return -1; |
| 239 | } |
Victor Stinner | 9e30aa5 | 2011-11-21 02:49:52 +0100 | [diff] [blame] | 240 | len = PyUnicode_GetLength(src); |
Antoine Pitrou | 77ea640 | 2011-10-07 04:26:55 +0200 | [diff] [blame] | 241 | if (len > 1) { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 242 | PyErr_Format(PyExc_TypeError, |
Berker Peksag | 0f41acb | 2014-07-27 23:22:34 +0300 | [diff] [blame] | 243 | "\"%s\" must be a 1-character string", |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 244 | name); |
| 245 | return -1; |
| 246 | } |
Stefan Krah | e6996ed | 2012-11-02 14:44:20 +0100 | [diff] [blame] | 247 | /* PyUnicode_READY() is called in PyUnicode_GetLength() */ |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 248 | if (len > 0) |
Antoine Pitrou | 77ea640 | 2011-10-07 04:26:55 +0200 | [diff] [blame] | 249 | *target = PyUnicode_READ_CHAR(src, 0); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 250 | } |
| 251 | } |
| 252 | return 0; |
Andrew McNamara | 1196cf1 | 2005-01-07 04:42:45 +0000 | [diff] [blame] | 253 | } |
| 254 | |
| 255 | static int |
| 256 | _set_str(const char *name, PyObject **target, PyObject *src, const char *dflt) |
| 257 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 258 | if (src == NULL) |
| 259 | *target = PyUnicode_DecodeASCII(dflt, strlen(dflt), NULL); |
| 260 | else { |
| 261 | if (src == Py_None) |
| 262 | *target = NULL; |
Stefan Krah | e6996ed | 2012-11-02 14:44:20 +0100 | [diff] [blame] | 263 | else if (!PyUnicode_Check(src)) { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 264 | PyErr_Format(PyExc_TypeError, |
| 265 | "\"%s\" must be a string", name); |
| 266 | return -1; |
| 267 | } |
| 268 | else { |
Stefan Krah | e6996ed | 2012-11-02 14:44:20 +0100 | [diff] [blame] | 269 | if (PyUnicode_READY(src) == -1) |
| 270 | return -1; |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 271 | Py_INCREF(src); |
Serhiy Storchaka | 4884271 | 2016-04-06 09:45:48 +0300 | [diff] [blame] | 272 | Py_XSETREF(*target, src); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 273 | } |
| 274 | } |
| 275 | return 0; |
Andrew McNamara | 1196cf1 | 2005-01-07 04:42:45 +0000 | [diff] [blame] | 276 | } |
| 277 | |
| 278 | static int |
| 279 | dialect_check_quoting(int quoting) |
| 280 | { |
Serhiy Storchaka | 2d06e84 | 2015-12-25 19:53:18 +0200 | [diff] [blame] | 281 | const StyleDesc *qs; |
Andrew McNamara | 1196cf1 | 2005-01-07 04:42:45 +0000 | [diff] [blame] | 282 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 283 | for (qs = quote_styles; qs->name; qs++) { |
Victor Stinner | 706768c | 2014-08-16 01:03:39 +0200 | [diff] [blame] | 284 | if ((int)qs->style == quoting) |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 285 | return 0; |
| 286 | } |
| 287 | PyErr_Format(PyExc_TypeError, "bad \"quoting\" value"); |
| 288 | return -1; |
Andrew McNamara | 1196cf1 | 2005-01-07 04:42:45 +0000 | [diff] [blame] | 289 | } |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 290 | |
| 291 | #define D_OFF(x) offsetof(DialectObj, x) |
| 292 | |
| 293 | static struct PyMemberDef Dialect_memberlist[] = { |
Serhiy Storchaka | 323748a | 2018-07-26 13:21:09 +0300 | [diff] [blame] | 294 | { "skipinitialspace", T_BOOL, D_OFF(skipinitialspace), READONLY }, |
| 295 | { "doublequote", T_BOOL, D_OFF(doublequote), READONLY }, |
| 296 | { "strict", T_BOOL, D_OFF(strict), READONLY }, |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 297 | { NULL } |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 298 | }; |
| 299 | |
| 300 | static PyGetSetDef Dialect_getsetlist[] = { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 301 | { "delimiter", (getter)Dialect_get_delimiter}, |
| 302 | { "escapechar", (getter)Dialect_get_escapechar}, |
| 303 | { "lineterminator", (getter)Dialect_get_lineterminator}, |
| 304 | { "quotechar", (getter)Dialect_get_quotechar}, |
| 305 | { "quoting", (getter)Dialect_get_quoting}, |
| 306 | {NULL}, |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 307 | }; |
| 308 | |
| 309 | static void |
| 310 | Dialect_dealloc(DialectObj *self) |
| 311 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 312 | Py_XDECREF(self->lineterminator); |
| 313 | Py_TYPE(self)->tp_free((PyObject *)self); |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 314 | } |
| 315 | |
Martin v. Löwis | 02cbf4a | 2006-02-27 17:20:04 +0000 | [diff] [blame] | 316 | static char *dialect_kws[] = { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 317 | "dialect", |
| 318 | "delimiter", |
| 319 | "doublequote", |
| 320 | "escapechar", |
| 321 | "lineterminator", |
| 322 | "quotechar", |
| 323 | "quoting", |
| 324 | "skipinitialspace", |
| 325 | "strict", |
| 326 | NULL |
Andrew McNamara | 1196cf1 | 2005-01-07 04:42:45 +0000 | [diff] [blame] | 327 | }; |
| 328 | |
Andrew McNamara | 29bf4e4 | 2005-01-11 04:49:53 +0000 | [diff] [blame] | 329 | static PyObject * |
| 330 | dialect_new(PyTypeObject *type, PyObject *args, PyObject *kwargs) |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 331 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 332 | DialectObj *self; |
| 333 | PyObject *ret = NULL; |
| 334 | PyObject *dialect = NULL; |
| 335 | PyObject *delimiter = NULL; |
| 336 | PyObject *doublequote = NULL; |
| 337 | PyObject *escapechar = NULL; |
| 338 | PyObject *lineterminator = NULL; |
| 339 | PyObject *quotechar = NULL; |
| 340 | PyObject *quoting = NULL; |
| 341 | PyObject *skipinitialspace = NULL; |
| 342 | PyObject *strict = NULL; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 343 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 344 | if (!PyArg_ParseTupleAndKeywords(args, kwargs, |
| 345 | "|OOOOOOOOO", dialect_kws, |
| 346 | &dialect, |
| 347 | &delimiter, |
| 348 | &doublequote, |
| 349 | &escapechar, |
| 350 | &lineterminator, |
| 351 | "echar, |
| 352 | "ing, |
| 353 | &skipinitialspace, |
| 354 | &strict)) |
| 355 | return NULL; |
Andrew McNamara | 29bf4e4 | 2005-01-11 04:49:53 +0000 | [diff] [blame] | 356 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 357 | if (dialect != NULL) { |
Stefan Krah | e6996ed | 2012-11-02 14:44:20 +0100 | [diff] [blame] | 358 | if (PyUnicode_Check(dialect)) { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 359 | dialect = get_dialect_from_registry(dialect); |
| 360 | if (dialect == NULL) |
| 361 | return NULL; |
| 362 | } |
| 363 | else |
| 364 | Py_INCREF(dialect); |
| 365 | /* Can we reuse this instance? */ |
| 366 | if (PyObject_TypeCheck(dialect, &Dialect_Type) && |
Serhiy Storchaka | 0b3ec19 | 2017-03-23 17:53:47 +0200 | [diff] [blame] | 367 | delimiter == NULL && |
| 368 | doublequote == NULL && |
| 369 | escapechar == NULL && |
| 370 | lineterminator == NULL && |
| 371 | quotechar == NULL && |
| 372 | quoting == NULL && |
| 373 | skipinitialspace == NULL && |
| 374 | strict == NULL) |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 375 | return dialect; |
| 376 | } |
Andrew McNamara | 29bf4e4 | 2005-01-11 04:49:53 +0000 | [diff] [blame] | 377 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 378 | self = (DialectObj *)type->tp_alloc(type, 0); |
| 379 | if (self == NULL) { |
| 380 | Py_XDECREF(dialect); |
| 381 | return NULL; |
| 382 | } |
| 383 | self->lineterminator = NULL; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 384 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 385 | Py_XINCREF(delimiter); |
| 386 | Py_XINCREF(doublequote); |
| 387 | Py_XINCREF(escapechar); |
| 388 | Py_XINCREF(lineterminator); |
| 389 | Py_XINCREF(quotechar); |
| 390 | Py_XINCREF(quoting); |
| 391 | Py_XINCREF(skipinitialspace); |
| 392 | Py_XINCREF(strict); |
| 393 | if (dialect != NULL) { |
Andrew McNamara | 1196cf1 | 2005-01-07 04:42:45 +0000 | [diff] [blame] | 394 | #define DIALECT_GETATTR(v, n) \ |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 395 | if (v == NULL) \ |
| 396 | v = PyObject_GetAttrString(dialect, n) |
| 397 | DIALECT_GETATTR(delimiter, "delimiter"); |
| 398 | DIALECT_GETATTR(doublequote, "doublequote"); |
| 399 | DIALECT_GETATTR(escapechar, "escapechar"); |
| 400 | DIALECT_GETATTR(lineterminator, "lineterminator"); |
| 401 | DIALECT_GETATTR(quotechar, "quotechar"); |
| 402 | DIALECT_GETATTR(quoting, "quoting"); |
| 403 | DIALECT_GETATTR(skipinitialspace, "skipinitialspace"); |
| 404 | DIALECT_GETATTR(strict, "strict"); |
| 405 | PyErr_Clear(); |
| 406 | } |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 407 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 408 | /* check types and convert to C values */ |
Andrew McNamara | 1196cf1 | 2005-01-07 04:42:45 +0000 | [diff] [blame] | 409 | #define DIASET(meth, name, target, src, dflt) \ |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 410 | if (meth(name, target, src, dflt)) \ |
| 411 | goto err |
| 412 | DIASET(_set_char, "delimiter", &self->delimiter, delimiter, ','); |
Serhiy Storchaka | 323748a | 2018-07-26 13:21:09 +0300 | [diff] [blame] | 413 | DIASET(_set_bool, "doublequote", &self->doublequote, doublequote, true); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 414 | DIASET(_set_char, "escapechar", &self->escapechar, escapechar, 0); |
| 415 | DIASET(_set_str, "lineterminator", &self->lineterminator, lineterminator, "\r\n"); |
| 416 | DIASET(_set_char, "quotechar", &self->quotechar, quotechar, '"'); |
| 417 | DIASET(_set_int, "quoting", &self->quoting, quoting, QUOTE_MINIMAL); |
Serhiy Storchaka | 323748a | 2018-07-26 13:21:09 +0300 | [diff] [blame] | 418 | DIASET(_set_bool, "skipinitialspace", &self->skipinitialspace, skipinitialspace, false); |
| 419 | DIASET(_set_bool, "strict", &self->strict, strict, false); |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 420 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 421 | /* validate options */ |
| 422 | if (dialect_check_quoting(self->quoting)) |
| 423 | goto err; |
| 424 | if (self->delimiter == 0) { |
Serhiy Storchaka | cac23a5 | 2013-12-19 16:27:18 +0200 | [diff] [blame] | 425 | PyErr_SetString(PyExc_TypeError, |
Berker Peksag | 0f41acb | 2014-07-27 23:22:34 +0300 | [diff] [blame] | 426 | "\"delimiter\" must be a 1-character string"); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 427 | goto err; |
| 428 | } |
| 429 | if (quotechar == Py_None && quoting == NULL) |
| 430 | self->quoting = QUOTE_NONE; |
| 431 | if (self->quoting != QUOTE_NONE && self->quotechar == 0) { |
| 432 | PyErr_SetString(PyExc_TypeError, |
| 433 | "quotechar must be set if quoting enabled"); |
| 434 | goto err; |
| 435 | } |
| 436 | if (self->lineterminator == 0) { |
| 437 | PyErr_SetString(PyExc_TypeError, "lineterminator must be set"); |
| 438 | goto err; |
| 439 | } |
Andrew McNamara | 1196cf1 | 2005-01-07 04:42:45 +0000 | [diff] [blame] | 440 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 441 | ret = (PyObject *)self; |
| 442 | Py_INCREF(self); |
Andrew McNamara | 1196cf1 | 2005-01-07 04:42:45 +0000 | [diff] [blame] | 443 | err: |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 444 | Py_XDECREF(self); |
| 445 | Py_XDECREF(dialect); |
| 446 | Py_XDECREF(delimiter); |
| 447 | Py_XDECREF(doublequote); |
| 448 | Py_XDECREF(escapechar); |
| 449 | Py_XDECREF(lineterminator); |
| 450 | Py_XDECREF(quotechar); |
| 451 | Py_XDECREF(quoting); |
| 452 | Py_XDECREF(skipinitialspace); |
| 453 | Py_XDECREF(strict); |
| 454 | return ret; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 455 | } |
| 456 | |
| 457 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 458 | PyDoc_STRVAR(Dialect_Type_doc, |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 459 | "CSV dialect\n" |
| 460 | "\n" |
| 461 | "The Dialect type records CSV parsing and generation options.\n"); |
| 462 | |
| 463 | static PyTypeObject Dialect_Type = { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 464 | PyVarObject_HEAD_INIT(NULL, 0) |
| 465 | "_csv.Dialect", /* tp_name */ |
| 466 | sizeof(DialectObj), /* tp_basicsize */ |
| 467 | 0, /* tp_itemsize */ |
| 468 | /* methods */ |
| 469 | (destructor)Dialect_dealloc, /* tp_dealloc */ |
Jeroen Demeyer | 530f506 | 2019-05-31 04:13:39 +0200 | [diff] [blame] | 470 | 0, /* tp_vectorcall_offset */ |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 471 | (getattrfunc)0, /* tp_getattr */ |
| 472 | (setattrfunc)0, /* tp_setattr */ |
Jeroen Demeyer | 530f506 | 2019-05-31 04:13:39 +0200 | [diff] [blame] | 473 | 0, /* tp_as_async */ |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 474 | (reprfunc)0, /* tp_repr */ |
| 475 | 0, /* tp_as_number */ |
| 476 | 0, /* tp_as_sequence */ |
| 477 | 0, /* tp_as_mapping */ |
| 478 | (hashfunc)0, /* tp_hash */ |
| 479 | (ternaryfunc)0, /* tp_call */ |
| 480 | (reprfunc)0, /* tp_str */ |
| 481 | 0, /* tp_getattro */ |
| 482 | 0, /* tp_setattro */ |
| 483 | 0, /* tp_as_buffer */ |
| 484 | Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE, /* tp_flags */ |
| 485 | Dialect_Type_doc, /* tp_doc */ |
| 486 | 0, /* tp_traverse */ |
| 487 | 0, /* tp_clear */ |
| 488 | 0, /* tp_richcompare */ |
| 489 | 0, /* tp_weaklistoffset */ |
| 490 | 0, /* tp_iter */ |
| 491 | 0, /* tp_iternext */ |
| 492 | 0, /* tp_methods */ |
| 493 | Dialect_memberlist, /* tp_members */ |
| 494 | Dialect_getsetlist, /* tp_getset */ |
| 495 | 0, /* tp_base */ |
| 496 | 0, /* tp_dict */ |
| 497 | 0, /* tp_descr_get */ |
| 498 | 0, /* tp_descr_set */ |
| 499 | 0, /* tp_dictoffset */ |
| 500 | 0, /* tp_init */ |
| 501 | 0, /* tp_alloc */ |
| 502 | dialect_new, /* tp_new */ |
| 503 | 0, /* tp_free */ |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 504 | }; |
| 505 | |
Andrew McNamara | 91b9746 | 2005-01-11 01:07:23 +0000 | [diff] [blame] | 506 | /* |
| 507 | * Return an instance of the dialect type, given a Python instance or kwarg |
| 508 | * description of the dialect |
| 509 | */ |
| 510 | static PyObject * |
| 511 | _call_dialect(PyObject *dialect_inst, PyObject *kwargs) |
| 512 | { |
Victor Stinner | 6412f49 | 2016-08-23 00:21:34 +0200 | [diff] [blame] | 513 | PyObject *type = (PyObject *)&Dialect_Type; |
| 514 | if (dialect_inst) { |
Petr Viktorin | ffd9753 | 2020-02-11 17:46:57 +0100 | [diff] [blame] | 515 | return PyObject_VectorcallDict(type, &dialect_inst, 1, kwargs); |
Victor Stinner | 6412f49 | 2016-08-23 00:21:34 +0200 | [diff] [blame] | 516 | } |
| 517 | else { |
Petr Viktorin | ffd9753 | 2020-02-11 17:46:57 +0100 | [diff] [blame] | 518 | return PyObject_VectorcallDict(type, NULL, 0, kwargs); |
Victor Stinner | 6412f49 | 2016-08-23 00:21:34 +0200 | [diff] [blame] | 519 | } |
Andrew McNamara | 91b9746 | 2005-01-11 01:07:23 +0000 | [diff] [blame] | 520 | } |
| 521 | |
Andrew McNamara | f69d94f | 2005-01-13 11:30:54 +0000 | [diff] [blame] | 522 | /* |
| 523 | * READER |
| 524 | */ |
Andrew McNamara | 0f0599d | 2005-01-12 09:45:18 +0000 | [diff] [blame] | 525 | static int |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 526 | parse_save_field(ReaderObj *self) |
| 527 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 528 | PyObject *field; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 529 | |
Antoine Pitrou | 77ea640 | 2011-10-07 04:26:55 +0200 | [diff] [blame] | 530 | field = PyUnicode_FromKindAndData(PyUnicode_4BYTE_KIND, |
| 531 | (void *) self->field, self->field_len); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 532 | if (field == NULL) |
| 533 | return -1; |
| 534 | self->field_len = 0; |
| 535 | if (self->numeric_field) { |
| 536 | PyObject *tmp; |
Andrew McNamara | 0f0599d | 2005-01-12 09:45:18 +0000 | [diff] [blame] | 537 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 538 | self->numeric_field = 0; |
| 539 | tmp = PyNumber_Float(field); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 540 | Py_DECREF(field); |
Antoine Pitrou | 77ea640 | 2011-10-07 04:26:55 +0200 | [diff] [blame] | 541 | if (tmp == NULL) |
| 542 | return -1; |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 543 | field = tmp; |
| 544 | } |
Victor Stinner | b80b378 | 2013-11-14 21:29:34 +0100 | [diff] [blame] | 545 | if (PyList_Append(self->fields, field) < 0) { |
| 546 | Py_DECREF(field); |
| 547 | return -1; |
| 548 | } |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 549 | Py_DECREF(field); |
| 550 | return 0; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 551 | } |
| 552 | |
| 553 | static int |
| 554 | parse_grow_buff(ReaderObj *self) |
| 555 | { |
Sergey Fedoseev | 67b9cc8 | 2018-08-16 09:27:50 +0500 | [diff] [blame] | 556 | assert((size_t)self->field_size <= PY_SSIZE_T_MAX / sizeof(Py_UCS4)); |
| 557 | |
| 558 | Py_ssize_t field_size_new = self->field_size ? 2 * self->field_size : 4096; |
| 559 | Py_UCS4 *field_new = self->field; |
| 560 | PyMem_Resize(field_new, Py_UCS4, field_size_new); |
| 561 | if (field_new == NULL) { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 562 | PyErr_NoMemory(); |
| 563 | return 0; |
| 564 | } |
Sergey Fedoseev | 67b9cc8 | 2018-08-16 09:27:50 +0500 | [diff] [blame] | 565 | self->field = field_new; |
| 566 | self->field_size = field_size_new; |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 567 | return 1; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 568 | } |
| 569 | |
Andrew McNamara | e4d05c4 | 2005-01-11 07:32:02 +0000 | [diff] [blame] | 570 | static int |
Antoine Pitrou | 77ea640 | 2011-10-07 04:26:55 +0200 | [diff] [blame] | 571 | parse_add_char(ReaderObj *self, Py_UCS4 c) |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 572 | { |
Antoine Pitrou | e7672d3 | 2012-05-16 11:33:08 +0200 | [diff] [blame] | 573 | if (self->field_len >= _csvstate_global->field_limit) { |
| 574 | PyErr_Format(_csvstate_global->error_obj, "field larger than field limit (%ld)", |
| 575 | _csvstate_global->field_limit); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 576 | return -1; |
| 577 | } |
| 578 | if (self->field_len == self->field_size && !parse_grow_buff(self)) |
| 579 | return -1; |
| 580 | self->field[self->field_len++] = c; |
| 581 | return 0; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 582 | } |
| 583 | |
Andrew McNamara | e4d05c4 | 2005-01-11 07:32:02 +0000 | [diff] [blame] | 584 | static int |
Antoine Pitrou | 77ea640 | 2011-10-07 04:26:55 +0200 | [diff] [blame] | 585 | parse_process_char(ReaderObj *self, Py_UCS4 c) |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 586 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 587 | DialectObj *dialect = self->dialect; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 588 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 589 | switch (self->state) { |
| 590 | case START_RECORD: |
| 591 | /* start of record */ |
| 592 | if (c == '\0') |
| 593 | /* empty line - return [] */ |
| 594 | break; |
| 595 | else if (c == '\n' || c == '\r') { |
| 596 | self->state = EAT_CRNL; |
| 597 | break; |
| 598 | } |
| 599 | /* normal character - handle as START_FIELD */ |
| 600 | self->state = START_FIELD; |
| 601 | /* fallthru */ |
| 602 | case START_FIELD: |
| 603 | /* expecting field */ |
| 604 | if (c == '\n' || c == '\r' || c == '\0') { |
| 605 | /* save empty field - return [fields] */ |
| 606 | if (parse_save_field(self) < 0) |
| 607 | return -1; |
| 608 | self->state = (c == '\0' ? START_RECORD : EAT_CRNL); |
| 609 | } |
| 610 | else if (c == dialect->quotechar && |
| 611 | dialect->quoting != QUOTE_NONE) { |
| 612 | /* start quoted field */ |
| 613 | self->state = IN_QUOTED_FIELD; |
| 614 | } |
| 615 | else if (c == dialect->escapechar) { |
| 616 | /* possible escaped character */ |
| 617 | self->state = ESCAPED_CHAR; |
| 618 | } |
| 619 | else if (c == ' ' && dialect->skipinitialspace) |
| 620 | /* ignore space at start of field */ |
| 621 | ; |
| 622 | else if (c == dialect->delimiter) { |
| 623 | /* save empty field */ |
| 624 | if (parse_save_field(self) < 0) |
| 625 | return -1; |
| 626 | } |
| 627 | else { |
| 628 | /* begin new unquoted field */ |
| 629 | if (dialect->quoting == QUOTE_NONNUMERIC) |
| 630 | self->numeric_field = 1; |
| 631 | if (parse_add_char(self, c) < 0) |
| 632 | return -1; |
| 633 | self->state = IN_FIELD; |
| 634 | } |
| 635 | break; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 636 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 637 | case ESCAPED_CHAR: |
R David Murray | 9a7d376 | 2013-03-20 00:15:20 -0400 | [diff] [blame] | 638 | if (c == '\n' || c=='\r') { |
R David Murray | c7c42ef | 2013-03-19 22:41:47 -0400 | [diff] [blame] | 639 | if (parse_add_char(self, c) < 0) |
| 640 | return -1; |
| 641 | self->state = AFTER_ESCAPED_CRNL; |
| 642 | break; |
| 643 | } |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 644 | if (c == '\0') |
| 645 | c = '\n'; |
| 646 | if (parse_add_char(self, c) < 0) |
| 647 | return -1; |
| 648 | self->state = IN_FIELD; |
| 649 | break; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 650 | |
R David Murray | c7c42ef | 2013-03-19 22:41:47 -0400 | [diff] [blame] | 651 | case AFTER_ESCAPED_CRNL: |
| 652 | if (c == '\0') |
| 653 | break; |
| 654 | /*fallthru*/ |
| 655 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 656 | case IN_FIELD: |
| 657 | /* in unquoted field */ |
| 658 | if (c == '\n' || c == '\r' || c == '\0') { |
| 659 | /* end of line - return [fields] */ |
| 660 | if (parse_save_field(self) < 0) |
| 661 | return -1; |
| 662 | self->state = (c == '\0' ? START_RECORD : EAT_CRNL); |
| 663 | } |
| 664 | else if (c == dialect->escapechar) { |
| 665 | /* possible escaped character */ |
| 666 | self->state = ESCAPED_CHAR; |
| 667 | } |
| 668 | else if (c == dialect->delimiter) { |
| 669 | /* save field - wait for new field */ |
| 670 | if (parse_save_field(self) < 0) |
| 671 | return -1; |
| 672 | self->state = START_FIELD; |
| 673 | } |
| 674 | else { |
| 675 | /* normal character - save in field */ |
| 676 | if (parse_add_char(self, c) < 0) |
| 677 | return -1; |
| 678 | } |
| 679 | break; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 680 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 681 | case IN_QUOTED_FIELD: |
| 682 | /* in quoted field */ |
| 683 | if (c == '\0') |
| 684 | ; |
| 685 | else if (c == dialect->escapechar) { |
| 686 | /* Possible escape character */ |
| 687 | self->state = ESCAPE_IN_QUOTED_FIELD; |
| 688 | } |
| 689 | else if (c == dialect->quotechar && |
| 690 | dialect->quoting != QUOTE_NONE) { |
| 691 | if (dialect->doublequote) { |
| 692 | /* doublequote; " represented by "" */ |
| 693 | self->state = QUOTE_IN_QUOTED_FIELD; |
| 694 | } |
| 695 | else { |
| 696 | /* end of quote part of field */ |
| 697 | self->state = IN_FIELD; |
| 698 | } |
| 699 | } |
| 700 | else { |
| 701 | /* normal character - save in field */ |
| 702 | if (parse_add_char(self, c) < 0) |
| 703 | return -1; |
| 704 | } |
| 705 | break; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 706 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 707 | case ESCAPE_IN_QUOTED_FIELD: |
| 708 | if (c == '\0') |
| 709 | c = '\n'; |
| 710 | if (parse_add_char(self, c) < 0) |
| 711 | return -1; |
| 712 | self->state = IN_QUOTED_FIELD; |
| 713 | break; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 714 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 715 | case QUOTE_IN_QUOTED_FIELD: |
Serhiy Storchaka | 6a7b3a7 | 2016-04-17 08:32:47 +0300 | [diff] [blame] | 716 | /* doublequote - seen a quote in a quoted field */ |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 717 | if (dialect->quoting != QUOTE_NONE && |
| 718 | c == dialect->quotechar) { |
| 719 | /* save "" as " */ |
| 720 | if (parse_add_char(self, c) < 0) |
| 721 | return -1; |
| 722 | self->state = IN_QUOTED_FIELD; |
| 723 | } |
| 724 | else if (c == dialect->delimiter) { |
| 725 | /* save field - wait for new field */ |
| 726 | if (parse_save_field(self) < 0) |
| 727 | return -1; |
| 728 | self->state = START_FIELD; |
| 729 | } |
| 730 | else if (c == '\n' || c == '\r' || c == '\0') { |
| 731 | /* end of line - return [fields] */ |
| 732 | if (parse_save_field(self) < 0) |
| 733 | return -1; |
| 734 | self->state = (c == '\0' ? START_RECORD : EAT_CRNL); |
| 735 | } |
| 736 | else if (!dialect->strict) { |
| 737 | if (parse_add_char(self, c) < 0) |
| 738 | return -1; |
| 739 | self->state = IN_FIELD; |
| 740 | } |
| 741 | else { |
| 742 | /* illegal */ |
Antoine Pitrou | e7672d3 | 2012-05-16 11:33:08 +0200 | [diff] [blame] | 743 | PyErr_Format(_csvstate_global->error_obj, "'%c' expected after '%c'", |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 744 | dialect->delimiter, |
| 745 | dialect->quotechar); |
| 746 | return -1; |
| 747 | } |
| 748 | break; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 749 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 750 | case EAT_CRNL: |
| 751 | if (c == '\n' || c == '\r') |
| 752 | ; |
| 753 | else if (c == '\0') |
| 754 | self->state = START_RECORD; |
| 755 | else { |
Antoine Pitrou | e7672d3 | 2012-05-16 11:33:08 +0200 | [diff] [blame] | 756 | PyErr_Format(_csvstate_global->error_obj, "new-line character seen in unquoted field - do you need to open the file in universal-newline mode?"); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 757 | return -1; |
| 758 | } |
| 759 | break; |
Andrew McNamara | f69d94f | 2005-01-13 11:30:54 +0000 | [diff] [blame] | 760 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 761 | } |
| 762 | return 0; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 763 | } |
| 764 | |
Andrew McNamara | f69d94f | 2005-01-13 11:30:54 +0000 | [diff] [blame] | 765 | static int |
| 766 | parse_reset(ReaderObj *self) |
| 767 | { |
Serhiy Storchaka | 4884271 | 2016-04-06 09:45:48 +0300 | [diff] [blame] | 768 | Py_XSETREF(self->fields, PyList_New(0)); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 769 | if (self->fields == NULL) |
| 770 | return -1; |
| 771 | self->field_len = 0; |
| 772 | self->state = START_RECORD; |
| 773 | self->numeric_field = 0; |
| 774 | return 0; |
Andrew McNamara | f69d94f | 2005-01-13 11:30:54 +0000 | [diff] [blame] | 775 | } |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 776 | |
| 777 | static PyObject * |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 778 | Reader_iternext(ReaderObj *self) |
| 779 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 780 | PyObject *fields = NULL; |
Antoine Pitrou | 77ea640 | 2011-10-07 04:26:55 +0200 | [diff] [blame] | 781 | Py_UCS4 c; |
| 782 | Py_ssize_t pos, linelen; |
| 783 | unsigned int kind; |
Serhiy Storchaka | cd8295f | 2020-04-11 10:48:40 +0300 | [diff] [blame] | 784 | const void *data; |
Antoine Pitrou | 77ea640 | 2011-10-07 04:26:55 +0200 | [diff] [blame] | 785 | PyObject *lineobj; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 786 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 787 | if (parse_reset(self) < 0) |
| 788 | return NULL; |
| 789 | do { |
| 790 | lineobj = PyIter_Next(self->input_iter); |
| 791 | if (lineobj == NULL) { |
| 792 | /* End of input OR exception */ |
Senthil Kumaran | 67b7b98 | 2012-09-25 02:30:27 -0700 | [diff] [blame] | 793 | if (!PyErr_Occurred() && (self->field_len != 0 || |
| 794 | self->state == IN_QUOTED_FIELD)) { |
| 795 | if (self->dialect->strict) |
Senthil Kumaran | 49d1302 | 2012-09-25 02:37:20 -0700 | [diff] [blame] | 796 | PyErr_SetString(_csvstate_global->error_obj, |
| 797 | "unexpected end of data"); |
Senthil Kumaran | 67b7b98 | 2012-09-25 02:30:27 -0700 | [diff] [blame] | 798 | else if (parse_save_field(self) >= 0) |
| 799 | break; |
| 800 | } |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 801 | return NULL; |
| 802 | } |
| 803 | if (!PyUnicode_Check(lineobj)) { |
Antoine Pitrou | e7672d3 | 2012-05-16 11:33:08 +0200 | [diff] [blame] | 804 | PyErr_Format(_csvstate_global->error_obj, |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 805 | "iterator should return strings, " |
| 806 | "not %.200s " |
Ram Rachum | 235f918 | 2020-06-05 23:56:06 +0300 | [diff] [blame] | 807 | "(the file should be opened in text mode)", |
Victor Stinner | daa9756 | 2020-02-07 03:37:06 +0100 | [diff] [blame] | 808 | Py_TYPE(lineobj)->tp_name |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 809 | ); |
| 810 | Py_DECREF(lineobj); |
| 811 | return NULL; |
| 812 | } |
Stefan Krah | e6996ed | 2012-11-02 14:44:20 +0100 | [diff] [blame] | 813 | if (PyUnicode_READY(lineobj) == -1) { |
| 814 | Py_DECREF(lineobj); |
| 815 | return NULL; |
| 816 | } |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 817 | ++self->line_num; |
Antoine Pitrou | 77ea640 | 2011-10-07 04:26:55 +0200 | [diff] [blame] | 818 | kind = PyUnicode_KIND(lineobj); |
| 819 | data = PyUnicode_DATA(lineobj); |
| 820 | pos = 0; |
| 821 | linelen = PyUnicode_GET_LENGTH(lineobj); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 822 | while (linelen--) { |
Antoine Pitrou | 77ea640 | 2011-10-07 04:26:55 +0200 | [diff] [blame] | 823 | c = PyUnicode_READ(kind, data, pos); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 824 | if (c == '\0') { |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 825 | Py_DECREF(lineobj); |
Antoine Pitrou | e7672d3 | 2012-05-16 11:33:08 +0200 | [diff] [blame] | 826 | PyErr_Format(_csvstate_global->error_obj, |
Benjamin Peterson | 7821b4c | 2019-06-18 21:37:58 -0700 | [diff] [blame] | 827 | "line contains NUL"); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 828 | goto err; |
| 829 | } |
| 830 | if (parse_process_char(self, c) < 0) { |
| 831 | Py_DECREF(lineobj); |
| 832 | goto err; |
| 833 | } |
Antoine Pitrou | 77ea640 | 2011-10-07 04:26:55 +0200 | [diff] [blame] | 834 | pos++; |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 835 | } |
| 836 | Py_DECREF(lineobj); |
| 837 | if (parse_process_char(self, 0) < 0) |
| 838 | goto err; |
| 839 | } while (self->state != START_RECORD); |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 840 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 841 | fields = self->fields; |
| 842 | self->fields = NULL; |
Andrew McNamara | f69d94f | 2005-01-13 11:30:54 +0000 | [diff] [blame] | 843 | err: |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 844 | return fields; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 845 | } |
| 846 | |
| 847 | static void |
| 848 | Reader_dealloc(ReaderObj *self) |
| 849 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 850 | PyObject_GC_UnTrack(self); |
| 851 | Py_XDECREF(self->dialect); |
| 852 | Py_XDECREF(self->input_iter); |
| 853 | Py_XDECREF(self->fields); |
| 854 | if (self->field != NULL) |
| 855 | PyMem_Free(self->field); |
| 856 | PyObject_GC_Del(self); |
Jeremy Hylton | 42a8aed | 2003-04-14 02:20:55 +0000 | [diff] [blame] | 857 | } |
| 858 | |
| 859 | static int |
| 860 | Reader_traverse(ReaderObj *self, visitproc visit, void *arg) |
| 861 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 862 | Py_VISIT(self->dialect); |
| 863 | Py_VISIT(self->input_iter); |
| 864 | Py_VISIT(self->fields); |
| 865 | return 0; |
Jeremy Hylton | 42a8aed | 2003-04-14 02:20:55 +0000 | [diff] [blame] | 866 | } |
| 867 | |
| 868 | static int |
| 869 | Reader_clear(ReaderObj *self) |
| 870 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 871 | Py_CLEAR(self->dialect); |
| 872 | Py_CLEAR(self->input_iter); |
| 873 | Py_CLEAR(self->fields); |
| 874 | return 0; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 875 | } |
| 876 | |
| 877 | PyDoc_STRVAR(Reader_Type_doc, |
| 878 | "CSV reader\n" |
| 879 | "\n" |
| 880 | "Reader objects are responsible for reading and parsing tabular data\n" |
| 881 | "in CSV format.\n" |
| 882 | ); |
| 883 | |
| 884 | static struct PyMethodDef Reader_methods[] = { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 885 | { NULL, NULL } |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 886 | }; |
Andrew McNamara | f69d94f | 2005-01-13 11:30:54 +0000 | [diff] [blame] | 887 | #define R_OFF(x) offsetof(ReaderObj, x) |
| 888 | |
| 889 | static struct PyMemberDef Reader_memberlist[] = { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 890 | { "dialect", T_OBJECT, R_OFF(dialect), READONLY }, |
| 891 | { "line_num", T_ULONG, R_OFF(line_num), READONLY }, |
| 892 | { NULL } |
Andrew McNamara | f69d94f | 2005-01-13 11:30:54 +0000 | [diff] [blame] | 893 | }; |
| 894 | |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 895 | |
| 896 | static PyTypeObject Reader_Type = { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 897 | PyVarObject_HEAD_INIT(NULL, 0) |
| 898 | "_csv.reader", /*tp_name*/ |
| 899 | sizeof(ReaderObj), /*tp_basicsize*/ |
| 900 | 0, /*tp_itemsize*/ |
| 901 | /* methods */ |
| 902 | (destructor)Reader_dealloc, /*tp_dealloc*/ |
Jeroen Demeyer | 530f506 | 2019-05-31 04:13:39 +0200 | [diff] [blame] | 903 | 0, /*tp_vectorcall_offset*/ |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 904 | (getattrfunc)0, /*tp_getattr*/ |
| 905 | (setattrfunc)0, /*tp_setattr*/ |
Jeroen Demeyer | 530f506 | 2019-05-31 04:13:39 +0200 | [diff] [blame] | 906 | 0, /*tp_as_async*/ |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 907 | (reprfunc)0, /*tp_repr*/ |
| 908 | 0, /*tp_as_number*/ |
| 909 | 0, /*tp_as_sequence*/ |
| 910 | 0, /*tp_as_mapping*/ |
| 911 | (hashfunc)0, /*tp_hash*/ |
| 912 | (ternaryfunc)0, /*tp_call*/ |
| 913 | (reprfunc)0, /*tp_str*/ |
| 914 | 0, /*tp_getattro*/ |
| 915 | 0, /*tp_setattro*/ |
| 916 | 0, /*tp_as_buffer*/ |
| 917 | Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE | |
| 918 | Py_TPFLAGS_HAVE_GC, /*tp_flags*/ |
| 919 | Reader_Type_doc, /*tp_doc*/ |
| 920 | (traverseproc)Reader_traverse, /*tp_traverse*/ |
| 921 | (inquiry)Reader_clear, /*tp_clear*/ |
| 922 | 0, /*tp_richcompare*/ |
| 923 | 0, /*tp_weaklistoffset*/ |
| 924 | PyObject_SelfIter, /*tp_iter*/ |
| 925 | (getiterfunc)Reader_iternext, /*tp_iternext*/ |
| 926 | Reader_methods, /*tp_methods*/ |
| 927 | Reader_memberlist, /*tp_members*/ |
| 928 | 0, /*tp_getset*/ |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 929 | |
| 930 | }; |
| 931 | |
| 932 | static PyObject * |
| 933 | csv_reader(PyObject *module, PyObject *args, PyObject *keyword_args) |
| 934 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 935 | PyObject * iterator, * dialect = NULL; |
| 936 | ReaderObj * self = PyObject_GC_New(ReaderObj, &Reader_Type); |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 937 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 938 | if (!self) |
| 939 | return NULL; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 940 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 941 | self->dialect = NULL; |
| 942 | self->fields = NULL; |
| 943 | self->input_iter = NULL; |
| 944 | self->field = NULL; |
| 945 | self->field_size = 0; |
| 946 | self->line_num = 0; |
Andrew McNamara | 0f0599d | 2005-01-12 09:45:18 +0000 | [diff] [blame] | 947 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 948 | if (parse_reset(self) < 0) { |
| 949 | Py_DECREF(self); |
| 950 | return NULL; |
| 951 | } |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 952 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 953 | if (!PyArg_UnpackTuple(args, "", 1, 2, &iterator, &dialect)) { |
| 954 | Py_DECREF(self); |
| 955 | return NULL; |
| 956 | } |
| 957 | self->input_iter = PyObject_GetIter(iterator); |
| 958 | if (self->input_iter == NULL) { |
| 959 | PyErr_SetString(PyExc_TypeError, |
| 960 | "argument 1 must be an iterator"); |
| 961 | Py_DECREF(self); |
| 962 | return NULL; |
| 963 | } |
| 964 | self->dialect = (DialectObj *)_call_dialect(dialect, keyword_args); |
| 965 | if (self->dialect == NULL) { |
| 966 | Py_DECREF(self); |
| 967 | return NULL; |
| 968 | } |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 969 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 970 | PyObject_GC_Track(self); |
| 971 | return (PyObject *)self; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 972 | } |
| 973 | |
| 974 | /* |
| 975 | * WRITER |
| 976 | */ |
| 977 | /* ---------------------------------------------------------------- */ |
| 978 | static void |
| 979 | join_reset(WriterObj *self) |
| 980 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 981 | self->rec_len = 0; |
| 982 | self->num_fields = 0; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 983 | } |
| 984 | |
| 985 | #define MEM_INCR 32768 |
| 986 | |
| 987 | /* Calculate new record length or append field to record. Return new |
| 988 | * record length. |
| 989 | */ |
Antoine Pitrou | 4045575 | 2010-08-15 18:51:10 +0000 | [diff] [blame] | 990 | static Py_ssize_t |
Serhiy Storchaka | cd8295f | 2020-04-11 10:48:40 +0300 | [diff] [blame] | 991 | join_append_data(WriterObj *self, unsigned int field_kind, const void *field_data, |
Serhiy Storchaka | 7901b48 | 2015-03-30 09:09:54 +0300 | [diff] [blame] | 992 | Py_ssize_t field_len, int *quoted, |
Antoine Pitrou | 77ea640 | 2011-10-07 04:26:55 +0200 | [diff] [blame] | 993 | int copy_phase) |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 994 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 995 | DialectObj *dialect = self->dialect; |
| 996 | int i; |
Antoine Pitrou | 4045575 | 2010-08-15 18:51:10 +0000 | [diff] [blame] | 997 | Py_ssize_t rec_len; |
Andrew McNamara | c89f284 | 2005-01-12 07:44:42 +0000 | [diff] [blame] | 998 | |
Benjamin Peterson | 6e01d90 | 2016-08-13 17:17:06 -0700 | [diff] [blame] | 999 | #define INCLEN \ |
| 1000 | do {\ |
| 1001 | if (!copy_phase && rec_len == PY_SSIZE_T_MAX) { \ |
| 1002 | goto overflow; \ |
| 1003 | } \ |
| 1004 | rec_len++; \ |
| 1005 | } while(0) |
| 1006 | |
| 1007 | #define ADDCH(c) \ |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1008 | do {\ |
| 1009 | if (copy_phase) \ |
| 1010 | self->rec[rec_len] = c;\ |
Benjamin Peterson | 6e01d90 | 2016-08-13 17:17:06 -0700 | [diff] [blame] | 1011 | INCLEN;\ |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1012 | } while(0) |
Andrew McNamara | c89f284 | 2005-01-12 07:44:42 +0000 | [diff] [blame] | 1013 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1014 | rec_len = self->rec_len; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1015 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1016 | /* If this is not the first field we need a field separator */ |
| 1017 | if (self->num_fields > 0) |
| 1018 | ADDCH(dialect->delimiter); |
Andrew McNamara | c89f284 | 2005-01-12 07:44:42 +0000 | [diff] [blame] | 1019 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1020 | /* Handle preceding quote */ |
| 1021 | if (copy_phase && *quoted) |
| 1022 | ADDCH(dialect->quotechar); |
Andrew McNamara | c89f284 | 2005-01-12 07:44:42 +0000 | [diff] [blame] | 1023 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1024 | /* Copy/count field data */ |
| 1025 | /* If field is null just pass over */ |
Antoine Pitrou | 77ea640 | 2011-10-07 04:26:55 +0200 | [diff] [blame] | 1026 | for (i = 0; field_data && (i < field_len); i++) { |
| 1027 | Py_UCS4 c = PyUnicode_READ(field_kind, field_data, i); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1028 | int want_escape = 0; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1029 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1030 | if (c == dialect->delimiter || |
| 1031 | c == dialect->escapechar || |
| 1032 | c == dialect->quotechar || |
Martin v. Löwis | 5f4f4c5 | 2011-11-01 18:42:23 +0100 | [diff] [blame] | 1033 | PyUnicode_FindChar( |
| 1034 | dialect->lineterminator, c, 0, |
| 1035 | PyUnicode_GET_LENGTH(dialect->lineterminator), 1) >= 0) { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1036 | if (dialect->quoting == QUOTE_NONE) |
| 1037 | want_escape = 1; |
| 1038 | else { |
| 1039 | if (c == dialect->quotechar) { |
| 1040 | if (dialect->doublequote) |
| 1041 | ADDCH(dialect->quotechar); |
| 1042 | else |
| 1043 | want_escape = 1; |
| 1044 | } |
| 1045 | if (!want_escape) |
| 1046 | *quoted = 1; |
| 1047 | } |
| 1048 | if (want_escape) { |
| 1049 | if (!dialect->escapechar) { |
Antoine Pitrou | e7672d3 | 2012-05-16 11:33:08 +0200 | [diff] [blame] | 1050 | PyErr_Format(_csvstate_global->error_obj, |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1051 | "need to escape, but no escapechar set"); |
| 1052 | return -1; |
| 1053 | } |
| 1054 | ADDCH(dialect->escapechar); |
| 1055 | } |
| 1056 | } |
| 1057 | /* Copy field character into record buffer. |
| 1058 | */ |
| 1059 | ADDCH(c); |
| 1060 | } |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1061 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1062 | if (*quoted) { |
| 1063 | if (copy_phase) |
| 1064 | ADDCH(dialect->quotechar); |
Benjamin Peterson | 6e01d90 | 2016-08-13 17:17:06 -0700 | [diff] [blame] | 1065 | else { |
| 1066 | INCLEN; /* starting quote */ |
| 1067 | INCLEN; /* ending quote */ |
| 1068 | } |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1069 | } |
| 1070 | return rec_len; |
Benjamin Peterson | 6e01d90 | 2016-08-13 17:17:06 -0700 | [diff] [blame] | 1071 | |
| 1072 | overflow: |
| 1073 | PyErr_NoMemory(); |
| 1074 | return -1; |
Andrew McNamara | c89f284 | 2005-01-12 07:44:42 +0000 | [diff] [blame] | 1075 | #undef ADDCH |
Benjamin Peterson | 6e01d90 | 2016-08-13 17:17:06 -0700 | [diff] [blame] | 1076 | #undef INCLEN |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1077 | } |
| 1078 | |
| 1079 | static int |
Antoine Pitrou | 4045575 | 2010-08-15 18:51:10 +0000 | [diff] [blame] | 1080 | join_check_rec_size(WriterObj *self, Py_ssize_t rec_len) |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1081 | { |
Sergey Fedoseev | 67b9cc8 | 2018-08-16 09:27:50 +0500 | [diff] [blame] | 1082 | assert(rec_len >= 0); |
Amaury Forgeot d'Arc | 9c74b14 | 2008-06-18 00:47:36 +0000 | [diff] [blame] | 1083 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1084 | if (rec_len > self->rec_size) { |
Sergey Fedoseev | 67b9cc8 | 2018-08-16 09:27:50 +0500 | [diff] [blame] | 1085 | size_t rec_size_new = (size_t)(rec_len / MEM_INCR + 1) * MEM_INCR; |
| 1086 | Py_UCS4 *rec_new = self->rec; |
| 1087 | PyMem_Resize(rec_new, Py_UCS4, rec_size_new); |
| 1088 | if (rec_new == NULL) { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1089 | PyErr_NoMemory(); |
| 1090 | return 0; |
| 1091 | } |
Sergey Fedoseev | 67b9cc8 | 2018-08-16 09:27:50 +0500 | [diff] [blame] | 1092 | self->rec = rec_new; |
| 1093 | self->rec_size = (Py_ssize_t)rec_size_new; |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1094 | } |
| 1095 | return 1; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1096 | } |
| 1097 | |
| 1098 | static int |
Serhiy Storchaka | 7901b48 | 2015-03-30 09:09:54 +0300 | [diff] [blame] | 1099 | join_append(WriterObj *self, PyObject *field, int quoted) |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1100 | { |
Antoine Pitrou | 77ea640 | 2011-10-07 04:26:55 +0200 | [diff] [blame] | 1101 | unsigned int field_kind = -1; |
Serhiy Storchaka | cd8295f | 2020-04-11 10:48:40 +0300 | [diff] [blame] | 1102 | const void *field_data = NULL; |
Antoine Pitrou | 77ea640 | 2011-10-07 04:26:55 +0200 | [diff] [blame] | 1103 | Py_ssize_t field_len = 0; |
Antoine Pitrou | 4045575 | 2010-08-15 18:51:10 +0000 | [diff] [blame] | 1104 | Py_ssize_t rec_len; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1105 | |
Antoine Pitrou | 77ea640 | 2011-10-07 04:26:55 +0200 | [diff] [blame] | 1106 | if (field != NULL) { |
Stefan Krah | e6996ed | 2012-11-02 14:44:20 +0100 | [diff] [blame] | 1107 | if (PyUnicode_READY(field) == -1) |
| 1108 | return 0; |
Antoine Pitrou | 77ea640 | 2011-10-07 04:26:55 +0200 | [diff] [blame] | 1109 | field_kind = PyUnicode_KIND(field); |
| 1110 | field_data = PyUnicode_DATA(field); |
| 1111 | field_len = PyUnicode_GET_LENGTH(field); |
| 1112 | } |
| 1113 | rec_len = join_append_data(self, field_kind, field_data, field_len, |
Serhiy Storchaka | 7901b48 | 2015-03-30 09:09:54 +0300 | [diff] [blame] | 1114 | "ed, 0); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1115 | if (rec_len < 0) |
| 1116 | return 0; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1117 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1118 | /* grow record buffer if necessary */ |
| 1119 | if (!join_check_rec_size(self, rec_len)) |
| 1120 | return 0; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1121 | |
Antoine Pitrou | 77ea640 | 2011-10-07 04:26:55 +0200 | [diff] [blame] | 1122 | self->rec_len = join_append_data(self, field_kind, field_data, field_len, |
Serhiy Storchaka | 7901b48 | 2015-03-30 09:09:54 +0300 | [diff] [blame] | 1123 | "ed, 1); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1124 | self->num_fields++; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1125 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1126 | return 1; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1127 | } |
| 1128 | |
| 1129 | static int |
| 1130 | join_append_lineterminator(WriterObj *self) |
| 1131 | { |
Antoine Pitrou | 77ea640 | 2011-10-07 04:26:55 +0200 | [diff] [blame] | 1132 | Py_ssize_t terminator_len, i; |
| 1133 | unsigned int term_kind; |
Serhiy Storchaka | cd8295f | 2020-04-11 10:48:40 +0300 | [diff] [blame] | 1134 | const void *term_data; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1135 | |
Antoine Pitrou | 77ea640 | 2011-10-07 04:26:55 +0200 | [diff] [blame] | 1136 | terminator_len = PyUnicode_GET_LENGTH(self->dialect->lineterminator); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1137 | if (terminator_len == -1) |
| 1138 | return 0; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1139 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1140 | /* grow record buffer if necessary */ |
| 1141 | if (!join_check_rec_size(self, self->rec_len + terminator_len)) |
| 1142 | return 0; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1143 | |
Antoine Pitrou | 77ea640 | 2011-10-07 04:26:55 +0200 | [diff] [blame] | 1144 | term_kind = PyUnicode_KIND(self->dialect->lineterminator); |
| 1145 | term_data = PyUnicode_DATA(self->dialect->lineterminator); |
| 1146 | for (i = 0; i < terminator_len; i++) |
| 1147 | self->rec[self->rec_len + i] = PyUnicode_READ(term_kind, term_data, i); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1148 | self->rec_len += terminator_len; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1149 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1150 | return 1; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1151 | } |
| 1152 | |
| 1153 | PyDoc_STRVAR(csv_writerow_doc, |
Serhiy Storchaka | 7901b48 | 2015-03-30 09:09:54 +0300 | [diff] [blame] | 1154 | "writerow(iterable)\n" |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1155 | "\n" |
Serhiy Storchaka | 7901b48 | 2015-03-30 09:09:54 +0300 | [diff] [blame] | 1156 | "Construct and write a CSV record from an iterable of fields. Non-string\n" |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1157 | "elements will be converted to string."); |
| 1158 | |
| 1159 | static PyObject * |
| 1160 | csv_writerow(WriterObj *self, PyObject *seq) |
| 1161 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1162 | DialectObj *dialect = self->dialect; |
Serhiy Storchaka | 7901b48 | 2015-03-30 09:09:54 +0300 | [diff] [blame] | 1163 | PyObject *iter, *field, *line, *result; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1164 | |
Serhiy Storchaka | 7901b48 | 2015-03-30 09:09:54 +0300 | [diff] [blame] | 1165 | iter = PyObject_GetIter(seq); |
| 1166 | if (iter == NULL) |
| 1167 | return PyErr_Format(_csvstate_global->error_obj, |
| 1168 | "iterable expected, not %.200s", |
Victor Stinner | daa9756 | 2020-02-07 03:37:06 +0100 | [diff] [blame] | 1169 | Py_TYPE(seq)->tp_name); |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1170 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1171 | /* Join all fields in internal buffer. |
| 1172 | */ |
| 1173 | join_reset(self); |
Serhiy Storchaka | 7901b48 | 2015-03-30 09:09:54 +0300 | [diff] [blame] | 1174 | while ((field = PyIter_Next(iter))) { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1175 | int append_ok; |
| 1176 | int quoted; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1177 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1178 | switch (dialect->quoting) { |
| 1179 | case QUOTE_NONNUMERIC: |
| 1180 | quoted = !PyNumber_Check(field); |
| 1181 | break; |
| 1182 | case QUOTE_ALL: |
| 1183 | quoted = 1; |
| 1184 | break; |
| 1185 | default: |
| 1186 | quoted = 0; |
| 1187 | break; |
| 1188 | } |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1189 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1190 | if (PyUnicode_Check(field)) { |
Serhiy Storchaka | 7901b48 | 2015-03-30 09:09:54 +0300 | [diff] [blame] | 1191 | append_ok = join_append(self, field, quoted); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1192 | Py_DECREF(field); |
| 1193 | } |
| 1194 | else if (field == Py_None) { |
Serhiy Storchaka | 7901b48 | 2015-03-30 09:09:54 +0300 | [diff] [blame] | 1195 | append_ok = join_append(self, NULL, quoted); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1196 | Py_DECREF(field); |
| 1197 | } |
| 1198 | else { |
| 1199 | PyObject *str; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1200 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1201 | str = PyObject_Str(field); |
| 1202 | Py_DECREF(field); |
Serhiy Storchaka | 7901b48 | 2015-03-30 09:09:54 +0300 | [diff] [blame] | 1203 | if (str == NULL) { |
| 1204 | Py_DECREF(iter); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1205 | return NULL; |
Serhiy Storchaka | 7901b48 | 2015-03-30 09:09:54 +0300 | [diff] [blame] | 1206 | } |
| 1207 | append_ok = join_append(self, str, quoted); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1208 | Py_DECREF(str); |
| 1209 | } |
Serhiy Storchaka | 7901b48 | 2015-03-30 09:09:54 +0300 | [diff] [blame] | 1210 | if (!append_ok) { |
| 1211 | Py_DECREF(iter); |
| 1212 | return NULL; |
| 1213 | } |
| 1214 | } |
| 1215 | Py_DECREF(iter); |
| 1216 | if (PyErr_Occurred()) |
| 1217 | return NULL; |
| 1218 | |
Licht Takeuchi | 2001900 | 2017-12-12 18:57:06 +0900 | [diff] [blame] | 1219 | if (self->num_fields > 0 && self->rec_len == 0) { |
Serhiy Storchaka | 7901b48 | 2015-03-30 09:09:54 +0300 | [diff] [blame] | 1220 | if (dialect->quoting == QUOTE_NONE) { |
| 1221 | PyErr_Format(_csvstate_global->error_obj, |
| 1222 | "single empty field record must be quoted"); |
| 1223 | return NULL; |
| 1224 | } |
| 1225 | self->num_fields--; |
| 1226 | if (!join_append(self, NULL, 1)) |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1227 | return NULL; |
| 1228 | } |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1229 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1230 | /* Add line terminator. |
| 1231 | */ |
Rémi Lapeyre | 2bc158f | 2019-05-14 15:45:14 +0200 | [diff] [blame] | 1232 | if (!join_append_lineterminator(self)) { |
Serhiy Storchaka | 7901b48 | 2015-03-30 09:09:54 +0300 | [diff] [blame] | 1233 | return NULL; |
Rémi Lapeyre | 2bc158f | 2019-05-14 15:45:14 +0200 | [diff] [blame] | 1234 | } |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1235 | |
Antoine Pitrou | 72ca65d | 2011-10-07 04:35:30 +0200 | [diff] [blame] | 1236 | line = PyUnicode_FromKindAndData(PyUnicode_4BYTE_KIND, |
| 1237 | (void *) self->rec, self->rec_len); |
Rémi Lapeyre | 2bc158f | 2019-05-14 15:45:14 +0200 | [diff] [blame] | 1238 | if (line == NULL) { |
Antoine Pitrou | 72ca65d | 2011-10-07 04:35:30 +0200 | [diff] [blame] | 1239 | return NULL; |
Rémi Lapeyre | 2bc158f | 2019-05-14 15:45:14 +0200 | [diff] [blame] | 1240 | } |
Petr Viktorin | ffd9753 | 2020-02-11 17:46:57 +0100 | [diff] [blame] | 1241 | result = PyObject_CallOneArg(self->write, line); |
Antoine Pitrou | 72ca65d | 2011-10-07 04:35:30 +0200 | [diff] [blame] | 1242 | Py_DECREF(line); |
| 1243 | return result; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1244 | } |
| 1245 | |
Skip Montanaro | 860fc0b | 2003-04-12 18:57:52 +0000 | [diff] [blame] | 1246 | PyDoc_STRVAR(csv_writerows_doc, |
Serhiy Storchaka | 7901b48 | 2015-03-30 09:09:54 +0300 | [diff] [blame] | 1247 | "writerows(iterable of iterables)\n" |
Skip Montanaro | 860fc0b | 2003-04-12 18:57:52 +0000 | [diff] [blame] | 1248 | "\n" |
Serhiy Storchaka | 7901b48 | 2015-03-30 09:09:54 +0300 | [diff] [blame] | 1249 | "Construct and write a series of iterables to a csv file. Non-string\n" |
Skip Montanaro | 860fc0b | 2003-04-12 18:57:52 +0000 | [diff] [blame] | 1250 | "elements will be converted to string."); |
| 1251 | |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1252 | static PyObject * |
| 1253 | csv_writerows(WriterObj *self, PyObject *seqseq) |
| 1254 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1255 | PyObject *row_iter, *row_obj, *result; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1256 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1257 | row_iter = PyObject_GetIter(seqseq); |
| 1258 | if (row_iter == NULL) { |
| 1259 | PyErr_SetString(PyExc_TypeError, |
| 1260 | "writerows() argument must be iterable"); |
| 1261 | return NULL; |
| 1262 | } |
| 1263 | while ((row_obj = PyIter_Next(row_iter))) { |
| 1264 | result = csv_writerow(self, row_obj); |
| 1265 | Py_DECREF(row_obj); |
| 1266 | if (!result) { |
| 1267 | Py_DECREF(row_iter); |
| 1268 | return NULL; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1269 | } |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1270 | else |
| 1271 | Py_DECREF(result); |
| 1272 | } |
| 1273 | Py_DECREF(row_iter); |
| 1274 | if (PyErr_Occurred()) |
| 1275 | return NULL; |
Serhiy Storchaka | 228b12e | 2017-01-23 09:47:21 +0200 | [diff] [blame] | 1276 | Py_RETURN_NONE; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1277 | } |
| 1278 | |
| 1279 | static struct PyMethodDef Writer_methods[] = { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1280 | { "writerow", (PyCFunction)csv_writerow, METH_O, csv_writerow_doc}, |
| 1281 | { "writerows", (PyCFunction)csv_writerows, METH_O, csv_writerows_doc}, |
| 1282 | { NULL, NULL } |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1283 | }; |
| 1284 | |
| 1285 | #define W_OFF(x) offsetof(WriterObj, x) |
| 1286 | |
| 1287 | static struct PyMemberDef Writer_memberlist[] = { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1288 | { "dialect", T_OBJECT, W_OFF(dialect), READONLY }, |
| 1289 | { NULL } |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1290 | }; |
| 1291 | |
| 1292 | static void |
| 1293 | Writer_dealloc(WriterObj *self) |
| 1294 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1295 | PyObject_GC_UnTrack(self); |
| 1296 | Py_XDECREF(self->dialect); |
Rémi Lapeyre | 2bc158f | 2019-05-14 15:45:14 +0200 | [diff] [blame] | 1297 | Py_XDECREF(self->write); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1298 | if (self->rec != NULL) |
| 1299 | PyMem_Free(self->rec); |
| 1300 | PyObject_GC_Del(self); |
Jeremy Hylton | 42a8aed | 2003-04-14 02:20:55 +0000 | [diff] [blame] | 1301 | } |
| 1302 | |
| 1303 | static int |
| 1304 | Writer_traverse(WriterObj *self, visitproc visit, void *arg) |
| 1305 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1306 | Py_VISIT(self->dialect); |
Rémi Lapeyre | 2bc158f | 2019-05-14 15:45:14 +0200 | [diff] [blame] | 1307 | Py_VISIT(self->write); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1308 | return 0; |
Jeremy Hylton | 42a8aed | 2003-04-14 02:20:55 +0000 | [diff] [blame] | 1309 | } |
| 1310 | |
| 1311 | static int |
| 1312 | Writer_clear(WriterObj *self) |
| 1313 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1314 | Py_CLEAR(self->dialect); |
Rémi Lapeyre | 2bc158f | 2019-05-14 15:45:14 +0200 | [diff] [blame] | 1315 | Py_CLEAR(self->write); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1316 | return 0; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1317 | } |
| 1318 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1319 | PyDoc_STRVAR(Writer_Type_doc, |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1320 | "CSV writer\n" |
| 1321 | "\n" |
| 1322 | "Writer objects are responsible for generating tabular data\n" |
| 1323 | "in CSV format from sequence input.\n" |
| 1324 | ); |
| 1325 | |
| 1326 | static PyTypeObject Writer_Type = { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1327 | PyVarObject_HEAD_INIT(NULL, 0) |
| 1328 | "_csv.writer", /*tp_name*/ |
| 1329 | sizeof(WriterObj), /*tp_basicsize*/ |
| 1330 | 0, /*tp_itemsize*/ |
| 1331 | /* methods */ |
| 1332 | (destructor)Writer_dealloc, /*tp_dealloc*/ |
Jeroen Demeyer | 530f506 | 2019-05-31 04:13:39 +0200 | [diff] [blame] | 1333 | 0, /*tp_vectorcall_offset*/ |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1334 | (getattrfunc)0, /*tp_getattr*/ |
| 1335 | (setattrfunc)0, /*tp_setattr*/ |
Jeroen Demeyer | 530f506 | 2019-05-31 04:13:39 +0200 | [diff] [blame] | 1336 | 0, /*tp_as_async*/ |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1337 | (reprfunc)0, /*tp_repr*/ |
| 1338 | 0, /*tp_as_number*/ |
| 1339 | 0, /*tp_as_sequence*/ |
| 1340 | 0, /*tp_as_mapping*/ |
| 1341 | (hashfunc)0, /*tp_hash*/ |
| 1342 | (ternaryfunc)0, /*tp_call*/ |
| 1343 | (reprfunc)0, /*tp_str*/ |
| 1344 | 0, /*tp_getattro*/ |
| 1345 | 0, /*tp_setattro*/ |
| 1346 | 0, /*tp_as_buffer*/ |
| 1347 | Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE | |
| 1348 | Py_TPFLAGS_HAVE_GC, /*tp_flags*/ |
| 1349 | Writer_Type_doc, |
| 1350 | (traverseproc)Writer_traverse, /*tp_traverse*/ |
| 1351 | (inquiry)Writer_clear, /*tp_clear*/ |
| 1352 | 0, /*tp_richcompare*/ |
| 1353 | 0, /*tp_weaklistoffset*/ |
| 1354 | (getiterfunc)0, /*tp_iter*/ |
| 1355 | (getiterfunc)0, /*tp_iternext*/ |
| 1356 | Writer_methods, /*tp_methods*/ |
| 1357 | Writer_memberlist, /*tp_members*/ |
| 1358 | 0, /*tp_getset*/ |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1359 | }; |
| 1360 | |
| 1361 | static PyObject * |
| 1362 | csv_writer(PyObject *module, PyObject *args, PyObject *keyword_args) |
| 1363 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1364 | PyObject * output_file, * dialect = NULL; |
| 1365 | WriterObj * self = PyObject_GC_New(WriterObj, &Writer_Type); |
Martin v. Löwis | bd928fe | 2011-10-14 10:20:37 +0200 | [diff] [blame] | 1366 | _Py_IDENTIFIER(write); |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1367 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1368 | if (!self) |
| 1369 | return NULL; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1370 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1371 | self->dialect = NULL; |
Rémi Lapeyre | 2bc158f | 2019-05-14 15:45:14 +0200 | [diff] [blame] | 1372 | self->write = NULL; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1373 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1374 | self->rec = NULL; |
| 1375 | self->rec_size = 0; |
| 1376 | self->rec_len = 0; |
| 1377 | self->num_fields = 0; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1378 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1379 | if (!PyArg_UnpackTuple(args, "", 1, 2, &output_file, &dialect)) { |
| 1380 | Py_DECREF(self); |
| 1381 | return NULL; |
| 1382 | } |
Serhiy Storchaka | 41c57b3 | 2019-09-01 12:03:39 +0300 | [diff] [blame] | 1383 | if (_PyObject_LookupAttrId(output_file, &PyId_write, &self->write) < 0) { |
| 1384 | Py_DECREF(self); |
| 1385 | return NULL; |
| 1386 | } |
Rémi Lapeyre | 2bc158f | 2019-05-14 15:45:14 +0200 | [diff] [blame] | 1387 | if (self->write == NULL || !PyCallable_Check(self->write)) { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1388 | PyErr_SetString(PyExc_TypeError, |
| 1389 | "argument 1 must have a \"write\" method"); |
| 1390 | Py_DECREF(self); |
| 1391 | return NULL; |
| 1392 | } |
| 1393 | self->dialect = (DialectObj *)_call_dialect(dialect, keyword_args); |
| 1394 | if (self->dialect == NULL) { |
| 1395 | Py_DECREF(self); |
| 1396 | return NULL; |
| 1397 | } |
| 1398 | PyObject_GC_Track(self); |
| 1399 | return (PyObject *)self; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1400 | } |
| 1401 | |
| 1402 | /* |
| 1403 | * DIALECT REGISTRY |
| 1404 | */ |
| 1405 | static PyObject * |
| 1406 | csv_list_dialects(PyObject *module, PyObject *args) |
| 1407 | { |
Antoine Pitrou | e7672d3 | 2012-05-16 11:33:08 +0200 | [diff] [blame] | 1408 | return PyDict_Keys(_csvstate_global->dialects); |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1409 | } |
| 1410 | |
| 1411 | static PyObject * |
Andrew McNamara | 8662597 | 2005-01-11 01:28:33 +0000 | [diff] [blame] | 1412 | csv_register_dialect(PyObject *module, PyObject *args, PyObject *kwargs) |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1413 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1414 | PyObject *name_obj, *dialect_obj = NULL; |
| 1415 | PyObject *dialect; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1416 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1417 | if (!PyArg_UnpackTuple(args, "", 1, 2, &name_obj, &dialect_obj)) |
| 1418 | return NULL; |
Stefan Krah | e6996ed | 2012-11-02 14:44:20 +0100 | [diff] [blame] | 1419 | if (!PyUnicode_Check(name_obj)) { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1420 | PyErr_SetString(PyExc_TypeError, |
Stefan Krah | e6996ed | 2012-11-02 14:44:20 +0100 | [diff] [blame] | 1421 | "dialect name must be a string"); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1422 | return NULL; |
| 1423 | } |
Stefan Krah | e6996ed | 2012-11-02 14:44:20 +0100 | [diff] [blame] | 1424 | if (PyUnicode_READY(name_obj) == -1) |
| 1425 | return NULL; |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1426 | dialect = _call_dialect(dialect_obj, kwargs); |
| 1427 | if (dialect == NULL) |
| 1428 | return NULL; |
Antoine Pitrou | e7672d3 | 2012-05-16 11:33:08 +0200 | [diff] [blame] | 1429 | if (PyDict_SetItem(_csvstate_global->dialects, name_obj, dialect) < 0) { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1430 | Py_DECREF(dialect); |
| 1431 | return NULL; |
| 1432 | } |
| 1433 | Py_DECREF(dialect); |
Serhiy Storchaka | 228b12e | 2017-01-23 09:47:21 +0200 | [diff] [blame] | 1434 | Py_RETURN_NONE; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1435 | } |
| 1436 | |
| 1437 | static PyObject * |
Skip Montanaro | 577c7a7 | 2003-04-12 19:17:14 +0000 | [diff] [blame] | 1438 | csv_unregister_dialect(PyObject *module, PyObject *name_obj) |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1439 | { |
Serhiy Storchaka | a24107b | 2019-02-25 17:59:46 +0200 | [diff] [blame] | 1440 | if (PyDict_DelItem(_csvstate_global->dialects, name_obj) < 0) { |
| 1441 | if (PyErr_ExceptionMatches(PyExc_KeyError)) { |
| 1442 | PyErr_Format(_csvstate_global->error_obj, "unknown dialect"); |
| 1443 | } |
| 1444 | return NULL; |
| 1445 | } |
Serhiy Storchaka | 228b12e | 2017-01-23 09:47:21 +0200 | [diff] [blame] | 1446 | Py_RETURN_NONE; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1447 | } |
| 1448 | |
| 1449 | static PyObject * |
Skip Montanaro | 577c7a7 | 2003-04-12 19:17:14 +0000 | [diff] [blame] | 1450 | csv_get_dialect(PyObject *module, PyObject *name_obj) |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1451 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1452 | return get_dialect_from_registry(name_obj); |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1453 | } |
| 1454 | |
Andrew McNamara | e4d05c4 | 2005-01-11 07:32:02 +0000 | [diff] [blame] | 1455 | static PyObject * |
Andrew McNamara | 31d8896 | 2005-01-12 03:45:10 +0000 | [diff] [blame] | 1456 | csv_field_size_limit(PyObject *module, PyObject *args) |
Andrew McNamara | e4d05c4 | 2005-01-11 07:32:02 +0000 | [diff] [blame] | 1457 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1458 | PyObject *new_limit = NULL; |
Antoine Pitrou | e7672d3 | 2012-05-16 11:33:08 +0200 | [diff] [blame] | 1459 | long old_limit = _csvstate_global->field_limit; |
Andrew McNamara | e4d05c4 | 2005-01-11 07:32:02 +0000 | [diff] [blame] | 1460 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1461 | if (!PyArg_UnpackTuple(args, "field_size_limit", 0, 1, &new_limit)) |
| 1462 | return NULL; |
| 1463 | if (new_limit != NULL) { |
| 1464 | if (!PyLong_CheckExact(new_limit)) { |
| 1465 | PyErr_Format(PyExc_TypeError, |
| 1466 | "limit must be an integer"); |
| 1467 | return NULL; |
| 1468 | } |
Antoine Pitrou | e7672d3 | 2012-05-16 11:33:08 +0200 | [diff] [blame] | 1469 | _csvstate_global->field_limit = PyLong_AsLong(new_limit); |
| 1470 | if (_csvstate_global->field_limit == -1 && PyErr_Occurred()) { |
| 1471 | _csvstate_global->field_limit = old_limit; |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1472 | return NULL; |
| 1473 | } |
| 1474 | } |
| 1475 | return PyLong_FromLong(old_limit); |
Andrew McNamara | e4d05c4 | 2005-01-11 07:32:02 +0000 | [diff] [blame] | 1476 | } |
| 1477 | |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1478 | /* |
| 1479 | * MODULE |
| 1480 | */ |
| 1481 | |
| 1482 | PyDoc_STRVAR(csv_module_doc, |
| 1483 | "CSV parsing and writing.\n" |
| 1484 | "\n" |
| 1485 | "This module provides classes that assist in the reading and writing\n" |
| 1486 | "of Comma Separated Value (CSV) files, and implements the interface\n" |
| 1487 | "described by PEP 305. Although many CSV files are simple to parse,\n" |
| 1488 | "the format is not formally defined by a stable specification and\n" |
| 1489 | "is subtle enough that parsing lines of a CSV file with something\n" |
| 1490 | "like line.split(\",\") is bound to fail. The module supports three\n" |
| 1491 | "basic APIs: reading, writing, and registration of dialects.\n" |
| 1492 | "\n" |
| 1493 | "\n" |
| 1494 | "DIALECT REGISTRATION:\n" |
| 1495 | "\n" |
| 1496 | "Readers and writers support a dialect argument, which is a convenient\n" |
| 1497 | "handle on a group of settings. When the dialect argument is a string,\n" |
| 1498 | "it identifies one of the dialects previously registered with the module.\n" |
| 1499 | "If it is a class or instance, the attributes of the argument are used as\n" |
| 1500 | "the settings for the reader or writer:\n" |
| 1501 | "\n" |
| 1502 | " class excel:\n" |
| 1503 | " delimiter = ','\n" |
| 1504 | " quotechar = '\"'\n" |
| 1505 | " escapechar = None\n" |
| 1506 | " doublequote = True\n" |
| 1507 | " skipinitialspace = False\n" |
Johannes Gijsbers | 8d3b9dd | 2004-08-15 12:23:10 +0000 | [diff] [blame] | 1508 | " lineterminator = '\\r\\n'\n" |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1509 | " quoting = QUOTE_MINIMAL\n" |
| 1510 | "\n" |
| 1511 | "SETTINGS:\n" |
| 1512 | "\n" |
oldk | aa0735f | 2018-02-02 16:52:55 +0800 | [diff] [blame] | 1513 | " * quotechar - specifies a one-character string to use as the\n" |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1514 | " quoting character. It defaults to '\"'.\n" |
oldk | aa0735f | 2018-02-02 16:52:55 +0800 | [diff] [blame] | 1515 | " * delimiter - specifies a one-character string to use as the\n" |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1516 | " field separator. It defaults to ','.\n" |
| 1517 | " * skipinitialspace - specifies how to interpret whitespace which\n" |
| 1518 | " immediately follows a delimiter. It defaults to False, which\n" |
| 1519 | " means that whitespace immediately following a delimiter is part\n" |
| 1520 | " of the following field.\n" |
oldk | aa0735f | 2018-02-02 16:52:55 +0800 | [diff] [blame] | 1521 | " * lineterminator - specifies the character sequence which should\n" |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1522 | " terminate rows.\n" |
| 1523 | " * quoting - controls when quotes should be generated by the writer.\n" |
| 1524 | " It can take on any of the following module constants:\n" |
| 1525 | "\n" |
| 1526 | " csv.QUOTE_MINIMAL means only when required, for example, when a\n" |
| 1527 | " field contains either the quotechar or the delimiter\n" |
| 1528 | " csv.QUOTE_ALL means that quotes are always placed around fields.\n" |
| 1529 | " csv.QUOTE_NONNUMERIC means that quotes are always placed around\n" |
Skip Montanaro | 148eb6a | 2003-12-02 18:57:47 +0000 | [diff] [blame] | 1530 | " fields which do not parse as integers or floating point\n" |
| 1531 | " numbers.\n" |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1532 | " csv.QUOTE_NONE means that quotes are never placed around fields.\n" |
oldk | aa0735f | 2018-02-02 16:52:55 +0800 | [diff] [blame] | 1533 | " * escapechar - specifies a one-character string used to escape\n" |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1534 | " the delimiter when quoting is set to QUOTE_NONE.\n" |
| 1535 | " * doublequote - controls the handling of quotes inside fields. When\n" |
| 1536 | " True, two consecutive quotes are interpreted as one during read,\n" |
| 1537 | " and when writing, each quote character embedded in the data is\n" |
| 1538 | " written as two quotes\n"); |
| 1539 | |
| 1540 | PyDoc_STRVAR(csv_reader_doc, |
| 1541 | " csv_reader = reader(iterable [, dialect='excel']\n" |
| 1542 | " [optional keyword args])\n" |
| 1543 | " for row in csv_reader:\n" |
| 1544 | " process(row)\n" |
| 1545 | "\n" |
| 1546 | "The \"iterable\" argument can be any object that returns a line\n" |
| 1547 | "of input for each iteration, such as a file object or a list. The\n" |
| 1548 | "optional \"dialect\" parameter is discussed below. The function\n" |
| 1549 | "also accepts optional keyword arguments which override settings\n" |
| 1550 | "provided by the dialect.\n" |
| 1551 | "\n" |
| 1552 | "The returned object is an iterator. Each iteration returns a row\n" |
Berker Peksag | e2382c5 | 2015-10-02 19:25:32 +0300 | [diff] [blame] | 1553 | "of the CSV file (which can span multiple input lines).\n"); |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1554 | |
| 1555 | PyDoc_STRVAR(csv_writer_doc, |
| 1556 | " csv_writer = csv.writer(fileobj [, dialect='excel']\n" |
| 1557 | " [optional keyword args])\n" |
Thomas Wouters | 49fd7fa | 2006-04-21 10:40:58 +0000 | [diff] [blame] | 1558 | " for row in sequence:\n" |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1559 | " csv_writer.writerow(row)\n" |
| 1560 | "\n" |
| 1561 | " [or]\n" |
| 1562 | "\n" |
| 1563 | " csv_writer = csv.writer(fileobj [, dialect='excel']\n" |
| 1564 | " [optional keyword args])\n" |
| 1565 | " csv_writer.writerows(rows)\n" |
| 1566 | "\n" |
| 1567 | "The \"fileobj\" argument can be any object that supports the file API.\n"); |
| 1568 | |
| 1569 | PyDoc_STRVAR(csv_list_dialects_doc, |
| 1570 | "Return a list of all know dialect names.\n" |
| 1571 | " names = csv.list_dialects()"); |
| 1572 | |
| 1573 | PyDoc_STRVAR(csv_get_dialect_doc, |
| 1574 | "Return the dialect instance associated with name.\n" |
| 1575 | " dialect = csv.get_dialect(name)"); |
| 1576 | |
| 1577 | PyDoc_STRVAR(csv_register_dialect_doc, |
| 1578 | "Create a mapping from a string name to a dialect class.\n" |
Berker Peksag | 12b50ce | 2015-06-05 15:17:51 +0300 | [diff] [blame] | 1579 | " dialect = csv.register_dialect(name[, dialect[, **fmtparams]])"); |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1580 | |
| 1581 | PyDoc_STRVAR(csv_unregister_dialect_doc, |
| 1582 | "Delete the name/dialect mapping associated with a string name.\n" |
| 1583 | " csv.unregister_dialect(name)"); |
| 1584 | |
Andrew McNamara | 31d8896 | 2005-01-12 03:45:10 +0000 | [diff] [blame] | 1585 | PyDoc_STRVAR(csv_field_size_limit_doc, |
Andrew McNamara | e4d05c4 | 2005-01-11 07:32:02 +0000 | [diff] [blame] | 1586 | "Sets an upper limit on parsed fields.\n" |
Andrew McNamara | 31d8896 | 2005-01-12 03:45:10 +0000 | [diff] [blame] | 1587 | " csv.field_size_limit([limit])\n" |
Andrew McNamara | e4d05c4 | 2005-01-11 07:32:02 +0000 | [diff] [blame] | 1588 | "\n" |
| 1589 | "Returns old limit. If limit is not given, no new limit is set and\n" |
| 1590 | "the old limit is returned"); |
| 1591 | |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1592 | static struct PyMethodDef csv_methods[] = { |
Serhiy Storchaka | 62be742 | 2018-11-27 13:27:31 +0200 | [diff] [blame] | 1593 | { "reader", (PyCFunction)(void(*)(void))csv_reader, |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1594 | METH_VARARGS | METH_KEYWORDS, csv_reader_doc}, |
Serhiy Storchaka | 62be742 | 2018-11-27 13:27:31 +0200 | [diff] [blame] | 1595 | { "writer", (PyCFunction)(void(*)(void))csv_writer, |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1596 | METH_VARARGS | METH_KEYWORDS, csv_writer_doc}, |
| 1597 | { "list_dialects", (PyCFunction)csv_list_dialects, |
| 1598 | METH_NOARGS, csv_list_dialects_doc}, |
Serhiy Storchaka | 62be742 | 2018-11-27 13:27:31 +0200 | [diff] [blame] | 1599 | { "register_dialect", (PyCFunction)(void(*)(void))csv_register_dialect, |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1600 | METH_VARARGS | METH_KEYWORDS, csv_register_dialect_doc}, |
| 1601 | { "unregister_dialect", (PyCFunction)csv_unregister_dialect, |
| 1602 | METH_O, csv_unregister_dialect_doc}, |
| 1603 | { "get_dialect", (PyCFunction)csv_get_dialect, |
| 1604 | METH_O, csv_get_dialect_doc}, |
| 1605 | { "field_size_limit", (PyCFunction)csv_field_size_limit, |
| 1606 | METH_VARARGS, csv_field_size_limit_doc}, |
| 1607 | { NULL, NULL } |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1608 | }; |
| 1609 | |
Martin v. Löwis | 1a21451 | 2008-06-11 05:26:20 +0000 | [diff] [blame] | 1610 | static struct PyModuleDef _csvmodule = { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1611 | PyModuleDef_HEAD_INIT, |
| 1612 | "_csv", |
| 1613 | csv_module_doc, |
Antoine Pitrou | e7672d3 | 2012-05-16 11:33:08 +0200 | [diff] [blame] | 1614 | sizeof(_csvstate), |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1615 | csv_methods, |
| 1616 | NULL, |
Antoine Pitrou | e7672d3 | 2012-05-16 11:33:08 +0200 | [diff] [blame] | 1617 | _csv_traverse, |
| 1618 | _csv_clear, |
| 1619 | _csv_free |
Martin v. Löwis | 1a21451 | 2008-06-11 05:26:20 +0000 | [diff] [blame] | 1620 | }; |
| 1621 | |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1622 | PyMODINIT_FUNC |
Martin v. Löwis | 1a21451 | 2008-06-11 05:26:20 +0000 | [diff] [blame] | 1623 | PyInit__csv(void) |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1624 | { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1625 | PyObject *module; |
Serhiy Storchaka | 2d06e84 | 2015-12-25 19:53:18 +0200 | [diff] [blame] | 1626 | const StyleDesc *style; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1627 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1628 | if (PyType_Ready(&Reader_Type) < 0) |
| 1629 | return NULL; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1630 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1631 | if (PyType_Ready(&Writer_Type) < 0) |
| 1632 | return NULL; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1633 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1634 | /* Create the module and add the functions */ |
| 1635 | module = PyModule_Create(&_csvmodule); |
| 1636 | if (module == NULL) |
| 1637 | return NULL; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1638 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1639 | /* Add version to the module. */ |
| 1640 | if (PyModule_AddStringConstant(module, "__version__", |
| 1641 | MODULE_VERSION) == -1) |
| 1642 | return NULL; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1643 | |
Antoine Pitrou | e7672d3 | 2012-05-16 11:33:08 +0200 | [diff] [blame] | 1644 | /* Set the field limit */ |
Hai Shi | f707d94 | 2020-03-16 21:15:01 +0800 | [diff] [blame] | 1645 | get_csv_state(module)->field_limit = 128 * 1024; |
Antoine Pitrou | e7672d3 | 2012-05-16 11:33:08 +0200 | [diff] [blame] | 1646 | /* Do I still need to add this var to the Module Dict? */ |
| 1647 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1648 | /* Add _dialects dictionary */ |
Hai Shi | f707d94 | 2020-03-16 21:15:01 +0800 | [diff] [blame] | 1649 | get_csv_state(module)->dialects = PyDict_New(); |
| 1650 | if (get_csv_state(module)->dialects == NULL) |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1651 | return NULL; |
Hai Shi | f707d94 | 2020-03-16 21:15:01 +0800 | [diff] [blame] | 1652 | Py_INCREF(get_csv_state(module)->dialects); |
| 1653 | if (PyModule_AddObject(module, "_dialects", get_csv_state(module)->dialects)) |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1654 | return NULL; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1655 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1656 | /* Add quote styles into dictionary */ |
| 1657 | for (style = quote_styles; style->name; style++) { |
| 1658 | if (PyModule_AddIntConstant(module, style->name, |
| 1659 | style->style) == -1) |
| 1660 | return NULL; |
| 1661 | } |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1662 | |
Dong-hee Na | 37fcbb6 | 2020-03-25 07:08:51 +0900 | [diff] [blame] | 1663 | if (PyModule_AddType(module, &Dialect_Type)) { |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1664 | return NULL; |
Dong-hee Na | 37fcbb6 | 2020-03-25 07:08:51 +0900 | [diff] [blame] | 1665 | } |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1666 | |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1667 | /* Add the CSV exception object to the module. */ |
Hai Shi | f707d94 | 2020-03-16 21:15:01 +0800 | [diff] [blame] | 1668 | get_csv_state(module)->error_obj = PyErr_NewException("_csv.Error", NULL, NULL); |
| 1669 | if (get_csv_state(module)->error_obj == NULL) |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1670 | return NULL; |
Hai Shi | f707d94 | 2020-03-16 21:15:01 +0800 | [diff] [blame] | 1671 | Py_INCREF(get_csv_state(module)->error_obj); |
| 1672 | PyModule_AddObject(module, "Error", get_csv_state(module)->error_obj); |
Antoine Pitrou | f95a1b3 | 2010-05-09 15:52:27 +0000 | [diff] [blame] | 1673 | return module; |
Skip Montanaro | b4a0417 | 2003-03-20 23:29:12 +0000 | [diff] [blame] | 1674 | } |