| 318 | |
| 319 | @property |
| 320 | def file(self): |
| 321 | # The old 'file' attribute is no longer used now that we do our own |
| 322 | # read() and readline() buffering, with which it conflicts. |
| 323 | # As an undocumented interface, it should never have been accessed by |
| 324 | # external code, and therefore does not warrant deprecation. |
| 325 | # Nevertheless, we provide this property for now, to avoid suddenly |
| 326 | # breaking any code in the wild that might have been using it in a |
| 327 | # harmless way. |
| 328 | import warnings |
| 329 | warnings.warn( |
| 330 | 'IMAP4.file is unsupported, can cause errors, and may be removed.', |
| 331 | RuntimeWarning, |
| 332 | stacklevel=2) |
| 333 | return self._file |
| 334 | |
| 335 | |
| 336 | def read(self, size): |