Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 1 | /* Author: Daniel Stutzbach */ |
| 2 | |
| 3 | #define PY_SSIZE_T_CLEAN |
| 4 | #include "Python.h" |
| 5 | #include <sys/types.h> |
| 6 | #include <sys/stat.h> |
| 7 | #include <fcntl.h> |
| 8 | #include <stddef.h> /* For offsetof */ |
| 9 | |
| 10 | /* |
| 11 | * Known likely problems: |
| 12 | * |
| 13 | * - Files larger then 2**32-1 |
| 14 | * - Files with unicode filenames |
| 15 | * - Passing numbers greater than 2**32-1 when an integer is expected |
| 16 | * - Making it work on Windows and other oddball platforms |
| 17 | * |
| 18 | * To Do: |
| 19 | * |
| 20 | * - autoconfify header file inclusion |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 21 | */ |
| 22 | |
| 23 | #ifdef MS_WINDOWS |
| 24 | /* can simulate truncate with Win32 API functions; see file_truncate */ |
Thomas Heller | fdeee3a | 2007-07-12 11:21:36 +0000 | [diff] [blame] | 25 | #define HAVE_FTRUNCATE |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 26 | #define WIN32_LEAN_AND_MEAN |
| 27 | #include <windows.h> |
| 28 | #endif |
| 29 | |
| 30 | typedef struct { |
| 31 | PyObject_HEAD |
| 32 | int fd; |
Neal Norwitz | 88b44da | 2007-08-12 17:23:54 +0000 | [diff] [blame] | 33 | unsigned readable : 1; |
| 34 | unsigned writable : 1; |
| 35 | int seekable : 2; /* -1 means unknown */ |
Guido van Rossum | 2dced8b | 2007-10-30 17:27:30 +0000 | [diff] [blame] | 36 | int closefd : 1; |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 37 | PyObject *weakreflist; |
| 38 | } PyFileIOObject; |
| 39 | |
Collin Winter | af33438 | 2007-03-08 21:46:15 +0000 | [diff] [blame] | 40 | PyTypeObject PyFileIO_Type; |
| 41 | |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 42 | #define PyFileIO_Check(op) (PyObject_TypeCheck((op), &PyFileIO_Type)) |
| 43 | |
Neal Norwitz | 88b44da | 2007-08-12 17:23:54 +0000 | [diff] [blame] | 44 | /* Returns 0 on success, errno (which is < 0) on failure. */ |
| 45 | static int |
| 46 | internal_close(PyFileIOObject *self) |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 47 | { |
Neal Norwitz | 88b44da | 2007-08-12 17:23:54 +0000 | [diff] [blame] | 48 | int save_errno = 0; |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 49 | if (self->fd >= 0) { |
Guido van Rossum | b042815 | 2007-04-08 17:44:42 +0000 | [diff] [blame] | 50 | int fd = self->fd; |
| 51 | self->fd = -1; |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 52 | Py_BEGIN_ALLOW_THREADS |
Neal Norwitz | 88b44da | 2007-08-12 17:23:54 +0000 | [diff] [blame] | 53 | if (close(fd) < 0) |
| 54 | save_errno = errno; |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 55 | Py_END_ALLOW_THREADS |
Neal Norwitz | 88b44da | 2007-08-12 17:23:54 +0000 | [diff] [blame] | 56 | } |
| 57 | return save_errno; |
| 58 | } |
| 59 | |
| 60 | static PyObject * |
| 61 | fileio_close(PyFileIOObject *self) |
| 62 | { |
Guido van Rossum | 2dced8b | 2007-10-30 17:27:30 +0000 | [diff] [blame] | 63 | if (!self->closefd) { |
| 64 | if (PyErr_WarnEx(PyExc_RuntimeWarning, |
| 65 | "Trying to close unclosable fd!", 3) < 0) { |
| 66 | return NULL; |
| 67 | } |
| 68 | Py_RETURN_NONE; |
| 69 | } |
Neal Norwitz | 88b44da | 2007-08-12 17:23:54 +0000 | [diff] [blame] | 70 | errno = internal_close(self); |
| 71 | if (errno < 0) { |
| 72 | PyErr_SetFromErrno(PyExc_IOError); |
| 73 | return NULL; |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 74 | } |
| 75 | |
| 76 | Py_RETURN_NONE; |
| 77 | } |
| 78 | |
| 79 | static PyObject * |
| 80 | fileio_new(PyTypeObject *type, PyObject *args, PyObject *kews) |
| 81 | { |
| 82 | PyFileIOObject *self; |
| 83 | |
| 84 | assert(type != NULL && type->tp_alloc != NULL); |
| 85 | |
| 86 | self = (PyFileIOObject *) type->tp_alloc(type, 0); |
| 87 | if (self != NULL) { |
| 88 | self->fd = -1; |
| 89 | self->weakreflist = NULL; |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 90 | } |
| 91 | |
| 92 | return (PyObject *) self; |
| 93 | } |
| 94 | |
| 95 | /* On Unix, open will succeed for directories. |
| 96 | In Python, there should be no file objects referring to |
| 97 | directories, so we need a check. */ |
| 98 | |
| 99 | static int |
| 100 | dircheck(PyFileIOObject* self) |
| 101 | { |
| 102 | #if defined(HAVE_FSTAT) && defined(S_IFDIR) && defined(EISDIR) |
| 103 | struct stat buf; |
| 104 | if (self->fd < 0) |
| 105 | return 0; |
| 106 | if (fstat(self->fd, &buf) == 0 && S_ISDIR(buf.st_mode)) { |
| 107 | #ifdef HAVE_STRERROR |
| 108 | char *msg = strerror(EISDIR); |
| 109 | #else |
| 110 | char *msg = "Is a directory"; |
| 111 | #endif |
| 112 | PyObject *exc; |
Neal Norwitz | 88b44da | 2007-08-12 17:23:54 +0000 | [diff] [blame] | 113 | internal_close(self); |
Guido van Rossum | 53807da | 2007-04-10 19:01:47 +0000 | [diff] [blame] | 114 | |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 115 | exc = PyObject_CallFunction(PyExc_IOError, "(is)", |
| 116 | EISDIR, msg); |
| 117 | PyErr_SetObject(PyExc_IOError, exc); |
| 118 | Py_XDECREF(exc); |
| 119 | return -1; |
| 120 | } |
| 121 | #endif |
| 122 | return 0; |
| 123 | } |
| 124 | |
| 125 | |
| 126 | static int |
| 127 | fileio_init(PyObject *oself, PyObject *args, PyObject *kwds) |
| 128 | { |
| 129 | PyFileIOObject *self = (PyFileIOObject *) oself; |
Guido van Rossum | 2dced8b | 2007-10-30 17:27:30 +0000 | [diff] [blame] | 130 | static char *kwlist[] = {"file", "mode", "closefd", NULL}; |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 131 | char *name = NULL; |
| 132 | char *mode = "r"; |
Guido van Rossum | 53807da | 2007-04-10 19:01:47 +0000 | [diff] [blame] | 133 | char *s; |
Thomas Heller | af2be26 | 2007-07-12 11:03:13 +0000 | [diff] [blame] | 134 | #ifdef MS_WINDOWS |
| 135 | Py_UNICODE *widename = NULL; |
| 136 | #endif |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 137 | int ret = 0; |
| 138 | int rwa = 0, plus = 0, append = 0; |
| 139 | int flags = 0; |
Guido van Rossum | b042815 | 2007-04-08 17:44:42 +0000 | [diff] [blame] | 140 | int fd = -1; |
Guido van Rossum | 2dced8b | 2007-10-30 17:27:30 +0000 | [diff] [blame] | 141 | int closefd = 1; |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 142 | |
| 143 | assert(PyFileIO_Check(oself)); |
Neal Norwitz | 88b44da | 2007-08-12 17:23:54 +0000 | [diff] [blame] | 144 | if (self->fd >= 0) { |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 145 | /* Have to close the existing file first. */ |
Neal Norwitz | 88b44da | 2007-08-12 17:23:54 +0000 | [diff] [blame] | 146 | if (internal_close(self) < 0) |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 147 | return -1; |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 148 | } |
| 149 | |
Guido van Rossum | 2dced8b | 2007-10-30 17:27:30 +0000 | [diff] [blame] | 150 | if (PyArg_ParseTupleAndKeywords(args, kwds, "i|si:fileio", |
| 151 | kwlist, &fd, &mode, &closefd)) { |
Guido van Rossum | b042815 | 2007-04-08 17:44:42 +0000 | [diff] [blame] | 152 | if (fd < 0) { |
| 153 | PyErr_SetString(PyExc_ValueError, |
| 154 | "Negative filedescriptor"); |
| 155 | return -1; |
| 156 | } |
| 157 | } |
| 158 | else { |
| 159 | PyErr_Clear(); |
| 160 | |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 161 | #ifdef Py_WIN_WIDE_FILENAMES |
Guido van Rossum | b042815 | 2007-04-08 17:44:42 +0000 | [diff] [blame] | 162 | if (GetVersion() < 0x80000000) { |
| 163 | /* On NT, so wide API available */ |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 164 | PyObject *po; |
Guido van Rossum | 2dced8b | 2007-10-30 17:27:30 +0000 | [diff] [blame] | 165 | if (PyArg_ParseTupleAndKeywords(args, kwds, "U|si:fileio", |
| 166 | kwlist, &po, &mode, &closefd) |
| 167 | ) { |
Thomas Heller | af2be26 | 2007-07-12 11:03:13 +0000 | [diff] [blame] | 168 | widename = PyUnicode_AS_UNICODE(po); |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 169 | } else { |
| 170 | /* Drop the argument parsing error as narrow |
| 171 | strings are also valid. */ |
| 172 | PyErr_Clear(); |
| 173 | } |
Guido van Rossum | b042815 | 2007-04-08 17:44:42 +0000 | [diff] [blame] | 174 | } |
Guido van Rossum | 2dced8b | 2007-10-30 17:27:30 +0000 | [diff] [blame] | 175 | if (widename == NULL) |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 176 | #endif |
Thomas Heller | af2be26 | 2007-07-12 11:03:13 +0000 | [diff] [blame] | 177 | { |
Guido van Rossum | 2dced8b | 2007-10-30 17:27:30 +0000 | [diff] [blame] | 178 | if (!PyArg_ParseTupleAndKeywords(args, kwds, "et|si:fileio", |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 179 | kwlist, |
| 180 | Py_FileSystemDefaultEncoding, |
Guido van Rossum | 2dced8b | 2007-10-30 17:27:30 +0000 | [diff] [blame] | 181 | &name, &mode, &closefd)) |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 182 | goto error; |
Guido van Rossum | b042815 | 2007-04-08 17:44:42 +0000 | [diff] [blame] | 183 | } |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 184 | } |
| 185 | |
| 186 | self->readable = self->writable = 0; |
Thomas Heller | af2be26 | 2007-07-12 11:03:13 +0000 | [diff] [blame] | 187 | self->seekable = -1; |
Guido van Rossum | 53807da | 2007-04-10 19:01:47 +0000 | [diff] [blame] | 188 | s = mode; |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 189 | while (*s) { |
| 190 | switch (*s++) { |
| 191 | case 'r': |
| 192 | if (rwa) { |
| 193 | bad_mode: |
| 194 | PyErr_SetString(PyExc_ValueError, |
| 195 | "Must have exactly one of read/write/append mode"); |
| 196 | goto error; |
| 197 | } |
| 198 | rwa = 1; |
| 199 | self->readable = 1; |
| 200 | break; |
| 201 | case 'w': |
| 202 | if (rwa) |
| 203 | goto bad_mode; |
| 204 | rwa = 1; |
| 205 | self->writable = 1; |
| 206 | flags |= O_CREAT | O_TRUNC; |
| 207 | break; |
| 208 | case 'a': |
| 209 | if (rwa) |
| 210 | goto bad_mode; |
| 211 | rwa = 1; |
| 212 | self->writable = 1; |
| 213 | flags |= O_CREAT; |
| 214 | append = 1; |
| 215 | break; |
| 216 | case '+': |
| 217 | if (plus) |
| 218 | goto bad_mode; |
| 219 | self->readable = self->writable = 1; |
| 220 | plus = 1; |
| 221 | break; |
| 222 | default: |
| 223 | PyErr_Format(PyExc_ValueError, |
| 224 | "invalid mode: %.200s", mode); |
| 225 | goto error; |
| 226 | } |
| 227 | } |
| 228 | |
| 229 | if (!rwa) |
| 230 | goto bad_mode; |
| 231 | |
| 232 | if (self->readable && self->writable) |
| 233 | flags |= O_RDWR; |
| 234 | else if (self->readable) |
| 235 | flags |= O_RDONLY; |
| 236 | else |
| 237 | flags |= O_WRONLY; |
| 238 | |
| 239 | #ifdef O_BINARY |
| 240 | flags |= O_BINARY; |
| 241 | #endif |
| 242 | |
Walter Dörwald | 0e41148 | 2007-06-06 16:55:38 +0000 | [diff] [blame] | 243 | #ifdef O_APPEND |
| 244 | if (append) |
| 245 | flags |= O_APPEND; |
| 246 | #endif |
| 247 | |
Guido van Rossum | b042815 | 2007-04-08 17:44:42 +0000 | [diff] [blame] | 248 | if (fd >= 0) { |
| 249 | self->fd = fd; |
Guido van Rossum | 2dced8b | 2007-10-30 17:27:30 +0000 | [diff] [blame] | 250 | self->closefd = closefd; |
Guido van Rossum | b042815 | 2007-04-08 17:44:42 +0000 | [diff] [blame] | 251 | } |
| 252 | else { |
Guido van Rossum | 2dced8b | 2007-10-30 17:27:30 +0000 | [diff] [blame] | 253 | self->closefd = 1; |
| 254 | if (!closefd) { |
| 255 | PyErr_SetString(PyExc_ValueError, |
| 256 | "Cannot use closefd=True with file name"); |
| 257 | goto error; |
| 258 | } |
| 259 | |
Guido van Rossum | b042815 | 2007-04-08 17:44:42 +0000 | [diff] [blame] | 260 | Py_BEGIN_ALLOW_THREADS |
| 261 | errno = 0; |
Thomas Heller | af2be26 | 2007-07-12 11:03:13 +0000 | [diff] [blame] | 262 | #ifdef MS_WINDOWS |
| 263 | if (widename != NULL) |
Neal Norwitz | 88b44da | 2007-08-12 17:23:54 +0000 | [diff] [blame] | 264 | self->fd = _wopen(widename, flags, 0666); |
Thomas Heller | af2be26 | 2007-07-12 11:03:13 +0000 | [diff] [blame] | 265 | else |
| 266 | #endif |
Neal Norwitz | 88b44da | 2007-08-12 17:23:54 +0000 | [diff] [blame] | 267 | self->fd = open(name, flags, 0666); |
Guido van Rossum | b042815 | 2007-04-08 17:44:42 +0000 | [diff] [blame] | 268 | Py_END_ALLOW_THREADS |
| 269 | if (self->fd < 0 || dircheck(self) < 0) { |
Christian Heimes | 0b48954 | 2007-10-31 19:20:48 +0000 | [diff] [blame] | 270 | #ifdef MS_WINDOWS |
| 271 | PyErr_SetFromErrnoWithUnicodeFilename(PyExc_IOError, widename); |
| 272 | #else |
Guido van Rossum | b042815 | 2007-04-08 17:44:42 +0000 | [diff] [blame] | 273 | PyErr_SetFromErrnoWithFilename(PyExc_IOError, name); |
Christian Heimes | 0b48954 | 2007-10-31 19:20:48 +0000 | [diff] [blame] | 274 | #endif |
Guido van Rossum | b042815 | 2007-04-08 17:44:42 +0000 | [diff] [blame] | 275 | goto error; |
| 276 | } |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 277 | } |
| 278 | |
| 279 | goto done; |
| 280 | |
| 281 | error: |
| 282 | ret = -1; |
Guido van Rossum | 53807da | 2007-04-10 19:01:47 +0000 | [diff] [blame] | 283 | |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 284 | done: |
| 285 | PyMem_Free(name); |
| 286 | return ret; |
| 287 | } |
| 288 | |
| 289 | static void |
| 290 | fileio_dealloc(PyFileIOObject *self) |
| 291 | { |
| 292 | if (self->weakreflist != NULL) |
| 293 | PyObject_ClearWeakRefs((PyObject *) self); |
| 294 | |
Guido van Rossum | 2dced8b | 2007-10-30 17:27:30 +0000 | [diff] [blame] | 295 | if (self->fd >= 0 && self->closefd) { |
Neal Norwitz | 88b44da | 2007-08-12 17:23:54 +0000 | [diff] [blame] | 296 | errno = internal_close(self); |
| 297 | if (errno < 0) { |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 298 | #ifdef HAVE_STRERROR |
Guido van Rossum | 53807da | 2007-04-10 19:01:47 +0000 | [diff] [blame] | 299 | PySys_WriteStderr("close failed: [Errno %d] %s\n", |
| 300 | errno, strerror(errno)); |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 301 | #else |
| 302 | PySys_WriteStderr("close failed: [Errno %d]\n", errno); |
| 303 | #endif |
Neal Norwitz | 88b44da | 2007-08-12 17:23:54 +0000 | [diff] [blame] | 304 | } |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 305 | } |
| 306 | |
Martin v. Löwis | 9f2e346 | 2007-07-21 17:22:18 +0000 | [diff] [blame] | 307 | Py_Type(self)->tp_free((PyObject *)self); |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 308 | } |
| 309 | |
| 310 | static PyObject * |
| 311 | err_closed(void) |
| 312 | { |
| 313 | PyErr_SetString(PyExc_ValueError, "I/O operation on closed file"); |
| 314 | return NULL; |
| 315 | } |
| 316 | |
| 317 | static PyObject * |
Guido van Rossum | 53807da | 2007-04-10 19:01:47 +0000 | [diff] [blame] | 318 | err_mode(char *action) |
| 319 | { |
| 320 | PyErr_Format(PyExc_ValueError, "File not open for %s", action); |
| 321 | return NULL; |
| 322 | } |
| 323 | |
| 324 | static PyObject * |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 325 | fileio_fileno(PyFileIOObject *self) |
| 326 | { |
| 327 | if (self->fd < 0) |
| 328 | return err_closed(); |
| 329 | return PyInt_FromLong((long) self->fd); |
| 330 | } |
| 331 | |
| 332 | static PyObject * |
| 333 | fileio_readable(PyFileIOObject *self) |
| 334 | { |
| 335 | if (self->fd < 0) |
| 336 | return err_closed(); |
Neal Norwitz | 88b44da | 2007-08-12 17:23:54 +0000 | [diff] [blame] | 337 | return PyBool_FromLong((long) self->readable); |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 338 | } |
| 339 | |
| 340 | static PyObject * |
| 341 | fileio_writable(PyFileIOObject *self) |
| 342 | { |
| 343 | if (self->fd < 0) |
| 344 | return err_closed(); |
Neal Norwitz | 88b44da | 2007-08-12 17:23:54 +0000 | [diff] [blame] | 345 | return PyBool_FromLong((long) self->writable); |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 346 | } |
| 347 | |
| 348 | static PyObject * |
| 349 | fileio_seekable(PyFileIOObject *self) |
| 350 | { |
| 351 | if (self->fd < 0) |
| 352 | return err_closed(); |
| 353 | if (self->seekable < 0) { |
| 354 | int ret; |
| 355 | Py_BEGIN_ALLOW_THREADS |
| 356 | ret = lseek(self->fd, 0, SEEK_CUR); |
| 357 | Py_END_ALLOW_THREADS |
| 358 | if (ret < 0) |
| 359 | self->seekable = 0; |
| 360 | else |
| 361 | self->seekable = 1; |
| 362 | } |
Thomas Heller | fdeee3a | 2007-07-12 11:21:36 +0000 | [diff] [blame] | 363 | return PyBool_FromLong((long) self->seekable); |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 364 | } |
| 365 | |
| 366 | static PyObject * |
| 367 | fileio_readinto(PyFileIOObject *self, PyObject *args) |
| 368 | { |
| 369 | char *ptr; |
| 370 | Py_ssize_t n; |
Guido van Rossum | 53807da | 2007-04-10 19:01:47 +0000 | [diff] [blame] | 371 | |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 372 | if (self->fd < 0) |
| 373 | return err_closed(); |
Guido van Rossum | 53807da | 2007-04-10 19:01:47 +0000 | [diff] [blame] | 374 | if (!self->readable) |
| 375 | return err_mode("reading"); |
| 376 | |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 377 | if (!PyArg_ParseTuple(args, "w#", &ptr, &n)) |
| 378 | return NULL; |
| 379 | |
| 380 | Py_BEGIN_ALLOW_THREADS |
| 381 | errno = 0; |
| 382 | n = read(self->fd, ptr, n); |
| 383 | Py_END_ALLOW_THREADS |
| 384 | if (n < 0) { |
| 385 | if (errno == EAGAIN) |
| 386 | Py_RETURN_NONE; |
| 387 | PyErr_SetFromErrno(PyExc_IOError); |
| 388 | return NULL; |
| 389 | } |
| 390 | |
Neal Norwitz | 88b44da | 2007-08-12 17:23:54 +0000 | [diff] [blame] | 391 | return PyInt_FromSsize_t(n); |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 392 | } |
| 393 | |
Guido van Rossum | 7165cb1 | 2007-07-10 06:54:34 +0000 | [diff] [blame] | 394 | #define DEFAULT_BUFFER_SIZE (8*1024) |
| 395 | |
| 396 | static PyObject * |
| 397 | fileio_readall(PyFileIOObject *self) |
| 398 | { |
| 399 | PyObject *result; |
| 400 | Py_ssize_t total = 0; |
| 401 | int n; |
| 402 | |
Guido van Rossum | 98297ee | 2007-11-06 21:34:58 +0000 | [diff] [blame^] | 403 | result = PyString_FromStringAndSize(NULL, DEFAULT_BUFFER_SIZE); |
Guido van Rossum | 7165cb1 | 2007-07-10 06:54:34 +0000 | [diff] [blame] | 404 | if (result == NULL) |
| 405 | return NULL; |
| 406 | |
| 407 | while (1) { |
| 408 | Py_ssize_t newsize = total + DEFAULT_BUFFER_SIZE; |
Guido van Rossum | 98297ee | 2007-11-06 21:34:58 +0000 | [diff] [blame^] | 409 | if (PyString_GET_SIZE(result) < newsize) { |
| 410 | if (_PyString_Resize(&result, newsize) < 0) { |
Guido van Rossum | 7165cb1 | 2007-07-10 06:54:34 +0000 | [diff] [blame] | 411 | if (total == 0) { |
| 412 | Py_DECREF(result); |
| 413 | return NULL; |
| 414 | } |
| 415 | PyErr_Clear(); |
| 416 | break; |
| 417 | } |
| 418 | } |
| 419 | Py_BEGIN_ALLOW_THREADS |
| 420 | errno = 0; |
| 421 | n = read(self->fd, |
Guido van Rossum | 98297ee | 2007-11-06 21:34:58 +0000 | [diff] [blame^] | 422 | PyString_AS_STRING(result) + total, |
Guido van Rossum | 7165cb1 | 2007-07-10 06:54:34 +0000 | [diff] [blame] | 423 | newsize - total); |
| 424 | Py_END_ALLOW_THREADS |
| 425 | if (n == 0) |
| 426 | break; |
| 427 | if (n < 0) { |
| 428 | if (total > 0) |
| 429 | break; |
| 430 | if (errno == EAGAIN) { |
| 431 | Py_DECREF(result); |
| 432 | Py_RETURN_NONE; |
| 433 | } |
| 434 | Py_DECREF(result); |
| 435 | PyErr_SetFromErrno(PyExc_IOError); |
| 436 | return NULL; |
| 437 | } |
| 438 | total += n; |
| 439 | } |
| 440 | |
Guido van Rossum | 98297ee | 2007-11-06 21:34:58 +0000 | [diff] [blame^] | 441 | if (PyString_GET_SIZE(result) > total) { |
| 442 | if (_PyString_Resize(&result, total) < 0) { |
Guido van Rossum | 7165cb1 | 2007-07-10 06:54:34 +0000 | [diff] [blame] | 443 | /* This should never happen, but just in case */ |
| 444 | Py_DECREF(result); |
| 445 | return NULL; |
| 446 | } |
| 447 | } |
| 448 | return result; |
| 449 | } |
| 450 | |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 451 | static PyObject * |
| 452 | fileio_read(PyFileIOObject *self, PyObject *args) |
| 453 | { |
| 454 | char *ptr; |
Guido van Rossum | 7165cb1 | 2007-07-10 06:54:34 +0000 | [diff] [blame] | 455 | Py_ssize_t n; |
| 456 | Py_ssize_t size = -1; |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 457 | PyObject *bytes; |
| 458 | |
| 459 | if (self->fd < 0) |
| 460 | return err_closed(); |
Guido van Rossum | 53807da | 2007-04-10 19:01:47 +0000 | [diff] [blame] | 461 | if (!self->readable) |
| 462 | return err_mode("reading"); |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 463 | |
Neal Norwitz | 3c8ba93 | 2007-08-08 04:36:17 +0000 | [diff] [blame] | 464 | if (!PyArg_ParseTuple(args, "|n", &size)) |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 465 | return NULL; |
| 466 | |
Guido van Rossum | c2f93dc | 2007-05-24 00:50:02 +0000 | [diff] [blame] | 467 | if (size < 0) { |
Guido van Rossum | 7165cb1 | 2007-07-10 06:54:34 +0000 | [diff] [blame] | 468 | return fileio_readall(self); |
Guido van Rossum | c2f93dc | 2007-05-24 00:50:02 +0000 | [diff] [blame] | 469 | } |
| 470 | |
Guido van Rossum | 98297ee | 2007-11-06 21:34:58 +0000 | [diff] [blame^] | 471 | bytes = PyString_FromStringAndSize(NULL, size); |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 472 | if (bytes == NULL) |
| 473 | return NULL; |
Guido van Rossum | 98297ee | 2007-11-06 21:34:58 +0000 | [diff] [blame^] | 474 | ptr = PyString_AS_STRING(bytes); |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 475 | |
| 476 | Py_BEGIN_ALLOW_THREADS |
| 477 | errno = 0; |
| 478 | n = read(self->fd, ptr, size); |
| 479 | Py_END_ALLOW_THREADS |
| 480 | |
| 481 | if (n < 0) { |
| 482 | if (errno == EAGAIN) |
| 483 | Py_RETURN_NONE; |
| 484 | PyErr_SetFromErrno(PyExc_IOError); |
| 485 | return NULL; |
| 486 | } |
| 487 | |
| 488 | if (n != size) { |
Guido van Rossum | 98297ee | 2007-11-06 21:34:58 +0000 | [diff] [blame^] | 489 | if (_PyString_Resize(&bytes, n) < 0) { |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 490 | Py_DECREF(bytes); |
Guido van Rossum | 53807da | 2007-04-10 19:01:47 +0000 | [diff] [blame] | 491 | return NULL; |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 492 | } |
Guido van Rossum | 53807da | 2007-04-10 19:01:47 +0000 | [diff] [blame] | 493 | } |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 494 | |
| 495 | return (PyObject *) bytes; |
| 496 | } |
| 497 | |
| 498 | static PyObject * |
| 499 | fileio_write(PyFileIOObject *self, PyObject *args) |
| 500 | { |
| 501 | Py_ssize_t n; |
| 502 | char *ptr; |
| 503 | |
| 504 | if (self->fd < 0) |
| 505 | return err_closed(); |
Guido van Rossum | 53807da | 2007-04-10 19:01:47 +0000 | [diff] [blame] | 506 | if (!self->writable) |
| 507 | return err_mode("writing"); |
| 508 | |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 509 | if (!PyArg_ParseTuple(args, "s#", &ptr, &n)) |
| 510 | return NULL; |
| 511 | |
| 512 | Py_BEGIN_ALLOW_THREADS |
| 513 | errno = 0; |
| 514 | n = write(self->fd, ptr, n); |
| 515 | Py_END_ALLOW_THREADS |
| 516 | |
| 517 | if (n < 0) { |
| 518 | if (errno == EAGAIN) |
| 519 | Py_RETURN_NONE; |
| 520 | PyErr_SetFromErrno(PyExc_IOError); |
| 521 | return NULL; |
| 522 | } |
| 523 | |
Neal Norwitz | 88b44da | 2007-08-12 17:23:54 +0000 | [diff] [blame] | 524 | return PyInt_FromSsize_t(n); |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 525 | } |
| 526 | |
Guido van Rossum | 53807da | 2007-04-10 19:01:47 +0000 | [diff] [blame] | 527 | /* XXX Windows support below is likely incomplete */ |
| 528 | |
| 529 | #if defined(MS_WIN64) || defined(MS_WINDOWS) |
| 530 | typedef PY_LONG_LONG Py_off_t; |
| 531 | #else |
| 532 | typedef off_t Py_off_t; |
| 533 | #endif |
| 534 | |
| 535 | /* Cribbed from posix_lseek() */ |
| 536 | static PyObject * |
| 537 | portable_lseek(int fd, PyObject *posobj, int whence) |
| 538 | { |
| 539 | Py_off_t pos, res; |
| 540 | |
| 541 | #ifdef SEEK_SET |
| 542 | /* Turn 0, 1, 2 into SEEK_{SET,CUR,END} */ |
| 543 | switch (whence) { |
| 544 | #if SEEK_SET != 0 |
| 545 | case 0: whence = SEEK_SET; break; |
| 546 | #endif |
| 547 | #if SEEK_CUR != 1 |
| 548 | case 1: whence = SEEK_CUR; break; |
| 549 | #endif |
| 550 | #if SEEL_END != 2 |
| 551 | case 2: whence = SEEK_END; break; |
| 552 | #endif |
| 553 | } |
| 554 | #endif /* SEEK_SET */ |
| 555 | |
| 556 | if (posobj == NULL) |
| 557 | pos = 0; |
| 558 | else { |
| 559 | #if !defined(HAVE_LARGEFILE_SUPPORT) |
| 560 | pos = PyInt_AsLong(posobj); |
| 561 | #else |
| 562 | pos = PyLong_Check(posobj) ? |
| 563 | PyLong_AsLongLong(posobj) : PyInt_AsLong(posobj); |
| 564 | #endif |
| 565 | if (PyErr_Occurred()) |
| 566 | return NULL; |
| 567 | } |
| 568 | |
| 569 | Py_BEGIN_ALLOW_THREADS |
| 570 | #if defined(MS_WIN64) || defined(MS_WINDOWS) |
| 571 | res = _lseeki64(fd, pos, whence); |
| 572 | #else |
| 573 | res = lseek(fd, pos, whence); |
| 574 | #endif |
| 575 | Py_END_ALLOW_THREADS |
| 576 | if (res < 0) |
| 577 | return PyErr_SetFromErrno(PyExc_IOError); |
| 578 | |
| 579 | #if !defined(HAVE_LARGEFILE_SUPPORT) |
| 580 | return PyInt_FromLong(res); |
| 581 | #else |
| 582 | return PyLong_FromLongLong(res); |
| 583 | #endif |
| 584 | } |
| 585 | |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 586 | static PyObject * |
| 587 | fileio_seek(PyFileIOObject *self, PyObject *args) |
| 588 | { |
Guido van Rossum | 53807da | 2007-04-10 19:01:47 +0000 | [diff] [blame] | 589 | PyObject *posobj; |
| 590 | int whence = 0; |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 591 | |
| 592 | if (self->fd < 0) |
| 593 | return err_closed(); |
| 594 | |
Guido van Rossum | 53807da | 2007-04-10 19:01:47 +0000 | [diff] [blame] | 595 | if (!PyArg_ParseTuple(args, "O|i", &posobj, &whence)) |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 596 | return NULL; |
| 597 | |
Guido van Rossum | 53807da | 2007-04-10 19:01:47 +0000 | [diff] [blame] | 598 | return portable_lseek(self->fd, posobj, whence); |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 599 | } |
| 600 | |
| 601 | static PyObject * |
| 602 | fileio_tell(PyFileIOObject *self, PyObject *args) |
| 603 | { |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 604 | if (self->fd < 0) |
| 605 | return err_closed(); |
| 606 | |
Guido van Rossum | 53807da | 2007-04-10 19:01:47 +0000 | [diff] [blame] | 607 | return portable_lseek(self->fd, NULL, 1); |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 608 | } |
| 609 | |
Thomas Heller | c6a55ee | 2007-07-11 12:45:46 +0000 | [diff] [blame] | 610 | #ifdef HAVE_FTRUNCATE |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 611 | static PyObject * |
| 612 | fileio_truncate(PyFileIOObject *self, PyObject *args) |
| 613 | { |
Guido van Rossum | 53807da | 2007-04-10 19:01:47 +0000 | [diff] [blame] | 614 | PyObject *posobj = NULL; |
| 615 | Py_off_t pos; |
Thomas Heller | fdeee3a | 2007-07-12 11:21:36 +0000 | [diff] [blame] | 616 | int ret; |
Guido van Rossum | dc0b1a1 | 2007-04-12 22:55:07 +0000 | [diff] [blame] | 617 | int fd; |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 618 | |
Guido van Rossum | 53807da | 2007-04-10 19:01:47 +0000 | [diff] [blame] | 619 | fd = self->fd; |
| 620 | if (fd < 0) |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 621 | return err_closed(); |
Guido van Rossum | 53807da | 2007-04-10 19:01:47 +0000 | [diff] [blame] | 622 | if (!self->writable) |
| 623 | return err_mode("writing"); |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 624 | |
Guido van Rossum | 53807da | 2007-04-10 19:01:47 +0000 | [diff] [blame] | 625 | if (!PyArg_ParseTuple(args, "|O", &posobj)) |
| 626 | return NULL; |
| 627 | |
Guido van Rossum | dc0b1a1 | 2007-04-12 22:55:07 +0000 | [diff] [blame] | 628 | if (posobj == Py_None || posobj == NULL) { |
| 629 | posobj = portable_lseek(fd, NULL, 1); |
| 630 | if (posobj == NULL) |
| 631 | return NULL; |
| 632 | } |
| 633 | else { |
| 634 | Py_INCREF(posobj); |
| 635 | } |
Guido van Rossum | 53807da | 2007-04-10 19:01:47 +0000 | [diff] [blame] | 636 | |
| 637 | #if !defined(HAVE_LARGEFILE_SUPPORT) |
| 638 | pos = PyInt_AsLong(posobj); |
| 639 | #else |
| 640 | pos = PyLong_Check(posobj) ? |
| 641 | PyLong_AsLongLong(posobj) : PyInt_AsLong(posobj); |
| 642 | #endif |
Guido van Rossum | 8742977 | 2007-04-10 21:06:59 +0000 | [diff] [blame] | 643 | if (PyErr_Occurred()) { |
| 644 | Py_DECREF(posobj); |
Guido van Rossum | 53807da | 2007-04-10 19:01:47 +0000 | [diff] [blame] | 645 | return NULL; |
Guido van Rossum | 8742977 | 2007-04-10 21:06:59 +0000 | [diff] [blame] | 646 | } |
Guido van Rossum | 53807da | 2007-04-10 19:01:47 +0000 | [diff] [blame] | 647 | |
Thomas Heller | fdeee3a | 2007-07-12 11:21:36 +0000 | [diff] [blame] | 648 | #ifdef MS_WINDOWS |
| 649 | /* MS _chsize doesn't work if newsize doesn't fit in 32 bits, |
| 650 | so don't even try using it. */ |
| 651 | { |
| 652 | HANDLE hFile; |
Guido van Rossum | 57233cb | 2007-10-26 17:19:33 +0000 | [diff] [blame] | 653 | PyObject *pos2, *oldposobj; |
| 654 | |
| 655 | /* store the current position */ |
| 656 | oldposobj = portable_lseek(self->fd, NULL, 1); |
| 657 | if (oldposobj == NULL) { |
| 658 | Py_DECREF(posobj); |
| 659 | return NULL; |
| 660 | } |
Thomas Heller | fdeee3a | 2007-07-12 11:21:36 +0000 | [diff] [blame] | 661 | |
| 662 | /* Have to move current pos to desired endpoint on Windows. */ |
| 663 | errno = 0; |
| 664 | pos2 = portable_lseek(fd, posobj, SEEK_SET); |
Guido van Rossum | 57233cb | 2007-10-26 17:19:33 +0000 | [diff] [blame] | 665 | if (pos2 == NULL) { |
Thomas Heller | fdeee3a | 2007-07-12 11:21:36 +0000 | [diff] [blame] | 666 | Py_DECREF(posobj); |
Guido van Rossum | 57233cb | 2007-10-26 17:19:33 +0000 | [diff] [blame] | 667 | Py_DECREF(oldposobj); |
Thomas Heller | fdeee3a | 2007-07-12 11:21:36 +0000 | [diff] [blame] | 668 | return NULL; |
| 669 | } |
| 670 | Py_DECREF(pos2); |
| 671 | |
| 672 | /* Truncate. Note that this may grow the file! */ |
| 673 | Py_BEGIN_ALLOW_THREADS |
| 674 | errno = 0; |
| 675 | hFile = (HANDLE)_get_osfhandle(fd); |
| 676 | ret = hFile == (HANDLE)-1; |
| 677 | if (ret == 0) { |
| 678 | ret = SetEndOfFile(hFile) == 0; |
| 679 | if (ret) |
| 680 | errno = EACCES; |
| 681 | } |
| 682 | Py_END_ALLOW_THREADS |
Guido van Rossum | 57233cb | 2007-10-26 17:19:33 +0000 | [diff] [blame] | 683 | |
| 684 | if (ret == 0) { |
| 685 | /* Move to the previous position in the file */ |
| 686 | pos2 = portable_lseek(fd, oldposobj, SEEK_SET); |
| 687 | if (pos2 == NULL) { |
| 688 | Py_DECREF(posobj); |
| 689 | Py_DECREF(oldposobj); |
| 690 | return NULL; |
| 691 | } |
| 692 | } |
| 693 | Py_DECREF(pos2); |
| 694 | Py_DECREF(oldposobj); |
Thomas Heller | fdeee3a | 2007-07-12 11:21:36 +0000 | [diff] [blame] | 695 | } |
| 696 | #else |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 697 | Py_BEGIN_ALLOW_THREADS |
| 698 | errno = 0; |
Thomas Heller | fdeee3a | 2007-07-12 11:21:36 +0000 | [diff] [blame] | 699 | ret = ftruncate(fd, pos); |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 700 | Py_END_ALLOW_THREADS |
Thomas Heller | fdeee3a | 2007-07-12 11:21:36 +0000 | [diff] [blame] | 701 | #endif /* !MS_WINDOWS */ |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 702 | |
Thomas Heller | fdeee3a | 2007-07-12 11:21:36 +0000 | [diff] [blame] | 703 | if (ret != 0) { |
Guido van Rossum | 8742977 | 2007-04-10 21:06:59 +0000 | [diff] [blame] | 704 | Py_DECREF(posobj); |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 705 | PyErr_SetFromErrno(PyExc_IOError); |
Thomas Heller | fdeee3a | 2007-07-12 11:21:36 +0000 | [diff] [blame] | 706 | return NULL; |
Guido van Rossum | 8742977 | 2007-04-10 21:06:59 +0000 | [diff] [blame] | 707 | } |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 708 | |
Guido van Rossum | 8742977 | 2007-04-10 21:06:59 +0000 | [diff] [blame] | 709 | return posobj; |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 710 | } |
Thomas Heller | c6a55ee | 2007-07-11 12:45:46 +0000 | [diff] [blame] | 711 | #endif |
Guido van Rossum | 53807da | 2007-04-10 19:01:47 +0000 | [diff] [blame] | 712 | |
| 713 | static char * |
| 714 | mode_string(PyFileIOObject *self) |
| 715 | { |
| 716 | if (self->readable) { |
| 717 | if (self->writable) |
| 718 | return "r+"; |
| 719 | else |
| 720 | return "r"; |
| 721 | } |
| 722 | else |
| 723 | return "w"; |
| 724 | } |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 725 | |
| 726 | static PyObject * |
| 727 | fileio_repr(PyFileIOObject *self) |
| 728 | { |
Guido van Rossum | 53807da | 2007-04-10 19:01:47 +0000 | [diff] [blame] | 729 | if (self->fd < 0) |
Walter Dörwald | 1ab8330 | 2007-05-18 17:15:44 +0000 | [diff] [blame] | 730 | return PyUnicode_FromFormat("_fileio._FileIO(-1)"); |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 731 | |
Walter Dörwald | 1ab8330 | 2007-05-18 17:15:44 +0000 | [diff] [blame] | 732 | return PyUnicode_FromFormat("_fileio._FileIO(%d, '%s')", |
Guido van Rossum | 53807da | 2007-04-10 19:01:47 +0000 | [diff] [blame] | 733 | self->fd, mode_string(self)); |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 734 | } |
| 735 | |
| 736 | static PyObject * |
| 737 | fileio_isatty(PyFileIOObject *self) |
| 738 | { |
| 739 | long res; |
Guido van Rossum | 53807da | 2007-04-10 19:01:47 +0000 | [diff] [blame] | 740 | |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 741 | if (self->fd < 0) |
| 742 | return err_closed(); |
| 743 | Py_BEGIN_ALLOW_THREADS |
| 744 | res = isatty(self->fd); |
| 745 | Py_END_ALLOW_THREADS |
| 746 | return PyBool_FromLong(res); |
| 747 | } |
| 748 | |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 749 | |
| 750 | PyDoc_STRVAR(fileio_doc, |
| 751 | "file(name: str[, mode: str]) -> file IO object\n" |
| 752 | "\n" |
| 753 | "Open a file. The mode can be 'r', 'w' or 'a' for reading (default),\n" |
| 754 | "writing or appending. The file will be created if it doesn't exist\n" |
| 755 | "when opened for writing or appending; it will be truncated when\n" |
| 756 | "opened for writing. Add a '+' to the mode to allow simultaneous\n" |
| 757 | "reading and writing."); |
| 758 | |
| 759 | PyDoc_STRVAR(read_doc, |
| 760 | "read(size: int) -> bytes. read at most size bytes, returned as bytes.\n" |
| 761 | "\n" |
| 762 | "Only makes one system call, so less data may be returned than requested\n" |
Guido van Rossum | 7165cb1 | 2007-07-10 06:54:34 +0000 | [diff] [blame] | 763 | "In non-blocking mode, returns None if no data is available.\n" |
| 764 | "On end-of-file, returns ''."); |
| 765 | |
| 766 | PyDoc_STRVAR(readall_doc, |
| 767 | "readall() -> bytes. read all data from the file, returned as bytes.\n" |
| 768 | "\n" |
| 769 | "In non-blocking mode, returns as much as is immediately available,\n" |
| 770 | "or None if no data is available. On end-of-file, returns ''."); |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 771 | |
| 772 | PyDoc_STRVAR(write_doc, |
| 773 | "write(b: bytes) -> int. Write bytes b to file, return number written.\n" |
| 774 | "\n" |
| 775 | "Only makes one system call, so not all of the data may be written.\n" |
| 776 | "The number of bytes actually written is returned."); |
| 777 | |
| 778 | PyDoc_STRVAR(fileno_doc, |
| 779 | "fileno() -> int. \"file descriptor\".\n" |
| 780 | "\n" |
| 781 | "This is needed for lower-level file interfaces, such the fcntl module."); |
| 782 | |
| 783 | PyDoc_STRVAR(seek_doc, |
| 784 | "seek(offset: int[, whence: int]) -> None. Move to new file position.\n" |
| 785 | "\n" |
| 786 | "Argument offset is a byte count. Optional argument whence defaults to\n" |
| 787 | "0 (offset from start of file, offset should be >= 0); other values are 1\n" |
| 788 | "(move relative to current position, positive or negative), and 2 (move\n" |
| 789 | "relative to end of file, usually negative, although many platforms allow\n" |
| 790 | "seeking beyond the end of a file)." |
| 791 | "\n" |
| 792 | "Note that not all file objects are seekable."); |
| 793 | |
Thomas Heller | c6a55ee | 2007-07-11 12:45:46 +0000 | [diff] [blame] | 794 | #ifdef HAVE_FTRUNCATE |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 795 | PyDoc_STRVAR(truncate_doc, |
| 796 | "truncate([size: int]) -> None. Truncate the file to at most size bytes.\n" |
| 797 | "\n" |
| 798 | "Size defaults to the current file position, as returned by tell()."); |
Thomas Heller | c6a55ee | 2007-07-11 12:45:46 +0000 | [diff] [blame] | 799 | #endif |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 800 | |
| 801 | PyDoc_STRVAR(tell_doc, |
| 802 | "tell() -> int. Current file position"); |
| 803 | |
| 804 | PyDoc_STRVAR(readinto_doc, |
| 805 | "readinto() -> Undocumented. Don't use this; it may go away."); |
| 806 | |
| 807 | PyDoc_STRVAR(close_doc, |
| 808 | "close() -> None. Close the file.\n" |
| 809 | "\n" |
| 810 | "A closed file cannot be used for further I/O operations. close() may be\n" |
| 811 | "called more than once without error. Changes the fileno to -1."); |
| 812 | |
| 813 | PyDoc_STRVAR(isatty_doc, |
| 814 | "isatty() -> bool. True if the file is connected to a tty device."); |
| 815 | |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 816 | PyDoc_STRVAR(seekable_doc, |
| 817 | "seekable() -> bool. True if file supports random-access."); |
| 818 | |
| 819 | PyDoc_STRVAR(readable_doc, |
| 820 | "readable() -> bool. True if file was opened in a read mode."); |
| 821 | |
| 822 | PyDoc_STRVAR(writable_doc, |
| 823 | "writable() -> bool. True if file was opened in a write mode."); |
| 824 | |
| 825 | static PyMethodDef fileio_methods[] = { |
| 826 | {"read", (PyCFunction)fileio_read, METH_VARARGS, read_doc}, |
Guido van Rossum | 7165cb1 | 2007-07-10 06:54:34 +0000 | [diff] [blame] | 827 | {"readall", (PyCFunction)fileio_readall, METH_NOARGS, readall_doc}, |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 828 | {"readinto", (PyCFunction)fileio_readinto, METH_VARARGS, readinto_doc}, |
| 829 | {"write", (PyCFunction)fileio_write, METH_VARARGS, write_doc}, |
| 830 | {"seek", (PyCFunction)fileio_seek, METH_VARARGS, seek_doc}, |
| 831 | {"tell", (PyCFunction)fileio_tell, METH_VARARGS, tell_doc}, |
Thomas Heller | c6a55ee | 2007-07-11 12:45:46 +0000 | [diff] [blame] | 832 | #ifdef HAVE_FTRUNCATE |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 833 | {"truncate", (PyCFunction)fileio_truncate, METH_VARARGS, truncate_doc}, |
Thomas Heller | c6a55ee | 2007-07-11 12:45:46 +0000 | [diff] [blame] | 834 | #endif |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 835 | {"close", (PyCFunction)fileio_close, METH_NOARGS, close_doc}, |
| 836 | {"seekable", (PyCFunction)fileio_seekable, METH_NOARGS, seekable_doc}, |
| 837 | {"readable", (PyCFunction)fileio_readable, METH_NOARGS, readable_doc}, |
| 838 | {"writable", (PyCFunction)fileio_writable, METH_NOARGS, writable_doc}, |
| 839 | {"fileno", (PyCFunction)fileio_fileno, METH_NOARGS, fileno_doc}, |
| 840 | {"isatty", (PyCFunction)fileio_isatty, METH_NOARGS, isatty_doc}, |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 841 | {NULL, NULL} /* sentinel */ |
| 842 | }; |
| 843 | |
Guido van Rossum | 53807da | 2007-04-10 19:01:47 +0000 | [diff] [blame] | 844 | /* 'closed' and 'mode' are attributes for backwards compatibility reasons. */ |
| 845 | |
Guido van Rossum | b042815 | 2007-04-08 17:44:42 +0000 | [diff] [blame] | 846 | static PyObject * |
Guido van Rossum | 53807da | 2007-04-10 19:01:47 +0000 | [diff] [blame] | 847 | get_closed(PyFileIOObject *self, void *closure) |
Guido van Rossum | b042815 | 2007-04-08 17:44:42 +0000 | [diff] [blame] | 848 | { |
Guido van Rossum | 53807da | 2007-04-10 19:01:47 +0000 | [diff] [blame] | 849 | return PyBool_FromLong((long)(self->fd < 0)); |
| 850 | } |
| 851 | |
| 852 | static PyObject * |
| 853 | get_mode(PyFileIOObject *self, void *closure) |
| 854 | { |
Guido van Rossum | c43e79f | 2007-06-18 18:26:36 +0000 | [diff] [blame] | 855 | return PyUnicode_FromString(mode_string(self)); |
Guido van Rossum | b042815 | 2007-04-08 17:44:42 +0000 | [diff] [blame] | 856 | } |
| 857 | |
| 858 | static PyGetSetDef fileio_getsetlist[] = { |
| 859 | {"closed", (getter)get_closed, NULL, "True if the file is closed"}, |
Guido van Rossum | 53807da | 2007-04-10 19:01:47 +0000 | [diff] [blame] | 860 | {"mode", (getter)get_mode, NULL, "String giving the file mode"}, |
Guido van Rossum | b042815 | 2007-04-08 17:44:42 +0000 | [diff] [blame] | 861 | {0}, |
| 862 | }; |
| 863 | |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 864 | PyTypeObject PyFileIO_Type = { |
Martin v. Löwis | 9f2e346 | 2007-07-21 17:22:18 +0000 | [diff] [blame] | 865 | PyVarObject_HEAD_INIT(&PyType_Type, 0) |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 866 | "FileIO", |
| 867 | sizeof(PyFileIOObject), |
| 868 | 0, |
| 869 | (destructor)fileio_dealloc, /* tp_dealloc */ |
| 870 | 0, /* tp_print */ |
| 871 | 0, /* tp_getattr */ |
| 872 | 0, /* tp_setattr */ |
| 873 | 0, /* tp_compare */ |
| 874 | (reprfunc)fileio_repr, /* tp_repr */ |
| 875 | 0, /* tp_as_number */ |
| 876 | 0, /* tp_as_sequence */ |
| 877 | 0, /* tp_as_mapping */ |
| 878 | 0, /* tp_hash */ |
| 879 | 0, /* tp_call */ |
| 880 | 0, /* tp_str */ |
| 881 | PyObject_GenericGetAttr, /* tp_getattro */ |
| 882 | 0, /* tp_setattro */ |
| 883 | 0, /* tp_as_buffer */ |
| 884 | Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE, /* tp_flags */ |
| 885 | fileio_doc, /* tp_doc */ |
| 886 | 0, /* tp_traverse */ |
| 887 | 0, /* tp_clear */ |
| 888 | 0, /* tp_richcompare */ |
| 889 | offsetof(PyFileIOObject, weakreflist), /* tp_weaklistoffset */ |
| 890 | 0, /* tp_iter */ |
| 891 | 0, /* tp_iternext */ |
| 892 | fileio_methods, /* tp_methods */ |
| 893 | 0, /* tp_members */ |
Guido van Rossum | b042815 | 2007-04-08 17:44:42 +0000 | [diff] [blame] | 894 | fileio_getsetlist, /* tp_getset */ |
Guido van Rossum | a9e2024 | 2007-03-08 00:43:48 +0000 | [diff] [blame] | 895 | 0, /* tp_base */ |
| 896 | 0, /* tp_dict */ |
| 897 | 0, /* tp_descr_get */ |
| 898 | 0, /* tp_descr_set */ |
| 899 | 0, /* tp_dictoffset */ |
| 900 | fileio_init, /* tp_init */ |
| 901 | PyType_GenericAlloc, /* tp_alloc */ |
| 902 | fileio_new, /* tp_new */ |
| 903 | PyObject_Del, /* tp_free */ |
| 904 | }; |
| 905 | |
| 906 | static PyMethodDef module_methods[] = { |
| 907 | {NULL, NULL} |
| 908 | }; |
| 909 | |
| 910 | PyMODINIT_FUNC |
| 911 | init_fileio(void) |
| 912 | { |
| 913 | PyObject *m; /* a module object */ |
| 914 | |
| 915 | m = Py_InitModule3("_fileio", module_methods, |
| 916 | "Fast implementation of io.FileIO."); |
| 917 | if (m == NULL) |
| 918 | return; |
| 919 | if (PyType_Ready(&PyFileIO_Type) < 0) |
| 920 | return; |
| 921 | Py_INCREF(&PyFileIO_Type); |
| 922 | PyModule_AddObject(m, "_FileIO", (PyObject *) &PyFileIO_Type); |
| 923 | } |