I've come across a few difficulties of late with the io module's handling of files opened in append mode (any variation on 'a', 'ab', 'a+', 'ab+', etc.

The biggest problem is that the io module does not in any way keep track of whether a file was opened in append mode, and it's essentially impossible to determine the original mode string that was provided by the user.  For example:

>>> f = open('test', mode='ab+', buffering=0)
>>> f
<_io.FileIO name='test' mode='rb+'>

The 'a' is gone.  That doesn't mean the file *isn't* in append mode.  If supported, in fileio_init this still causes the O_APPEND flag to be added to the open() call.  But the *only* way to find out after the fact that the file  was actually opened in append mode is with fcntl:

>>> fcntl.fcntl(f.fileno(), fnctl.F_GETFL) & os.O_APPEND
1024

but this is hardly easily accessible or portable.  So it's possible to have two files open in 'rb+' mode but that have wildly differing behaviors.

The only other thing fileio_init does differently with append mode is that it seeks to the end of the file by default.  But that does not make the append behavior "portable".  If, on a system where O_APPEND was not supported, I seek to a different part of the file and the call write() it will *not* append to the end of the file.  Whereas the behavior of O_APPEND causes an automatic seek to the end before any write().

The fact that no record of the request for 'append' mode is kept leads to further bugs, particularly in BufferedWriter.  It doesn't know the raw file was opened with O_APPEND so the writes it shows in the buffer differ from what will actually end up in the file.  For example:

>>> f = open('test', 'wb')
>>> f.write(b'testest')
7
>>> f.close()
>>> f = open('test', 'ab+')
>>> f.tell()
7
>>> f.write(b'A')
1
>>> f.seek(0)
0
>>> f.read()
b'testestA'
>>> f.seek(0)
0
>>> f.read(1)
b't'
>>> f.write(b'B')
1
>>> f.seek(0)
0
>>> f.read()
b'tBstestA'
>>> f.flush()
>>> f.seek(0)
0
>>> f.read()
b'testestAB'

In this example, I read 1 byte from the beginning of the file, then write one byte.  Because of O_APPEND, the effect of the write() call on the raw file is to append, regardless of where BufferedWriter seeks it to first.  But before the f.flush() call f.read() just shows what's in the buffer which is not what will actually be written to the file.  (Naturally, unbuffered io does not have this particular problem.)

So, I'm thinking maybe the fileio struct needs to grow an 'append' member.  This could be used to provide a more accurate mode string, and could for example in fileio_write to provide append-like support where it isn't natively supported (though perhaps without any guarantees as to atomicity).

Hi, Erik.  I changed the versions because we use versions in this tracker to indicate which versions we intend to *fix* the problem in.  I left 2.7 and 3.3 marked for the moment, but I have a feeling that this will need to be a feature-release-only change.  Not only does it require a new attribute, it also changes the semantics (albeit in a sensible way), and as such could break working code if applied to a maintenance release.

Ah right, sorry about that. I just came over from the Trac site for one of my projects where the version field is used for affected versions :)

On which systems is O_APPEND not supported? It's part of the POSIX standard, and even Windows seems to have it.

> Whereas the behavior of O_APPEND causes an automatic seek to the end
> before any write().

True, but IIRC some systems seek on open() and some systems seek just before write().

Agreed about the "mode" attribute problem, though. And the BufferedWriter bug is truly embarassing, sorry :-(

> On which systems is O_APPEND not supported? It's part of the POSIX standard, and even Windows seems to have it.

That would be surprising.
An easy way to find this out would be to remove the ifdef:
352 #ifdef O_APPEND
353 if (append)
354 flags |= O_APPEND;
355 #endif

>> Whereas the behavior of O_APPEND causes an automatic seek to the end
>> before any write().
>
> True, but IIRC some systems seek on open() and some systems seek just before write().

POSIX makes it clear that only the later behavior is legal:
O_APPENDIf set, the file offset shall be set to the end of the file
prior to each write.

>> Whereas the behavior of O_APPEND causes an automatic seek to the end
>> before any write().

> True, but IIRC some systems seek on open() and some systems seek just before write().

I figured that workaround that seeks to the end on open was an attempt to normalize behavior between different systems, and seems to me like a reasonable compromise to support systems that somehow don't support append.

But a better compromise I think would be to seek to the beginning of the file and modify fileio_write and friends to always seek to the end before a write if the file was opened in append mode. This would be more in line with the POSIX behavior.

I have no idea on what systems O_APPEND isn't supported, but I figured they must exist because someone put an #ifdef in there once :)

Here's an initial stab at a simple patch that just addresses the issue of 'append' not being in the mode string.  Amazingly this did not break a single existing test, though I added a new one to test how FileIO objects display their mode string after being initialized (normalizes modes like 'r+b' to 'rb+', etc.)  Most of what it tests is the existing behavior, but it also tests for the reintroduction of the 'a' mode.

This doesn't address the BufferedWriter issue, nor does it address cross-platform issues.

Thanks for the patch. It looks mostly ok.
Could you sign a contributor agreement so that we can move forward?
http://www.python.org/psf/contrib/

New changeset 33bd39b67cc1 by Antoine Pitrou in branch '3.3':
Issue #18876: The FileIO.mode attribute now better reflects the actual mode under which the file was opened.
http://hg.python.org/cpython/rev/33bd39b67cc1

New changeset b5530669ef70 by Antoine Pitrou in branch 'default':
Issue #18876: The FileIO.mode attribute now better reflects the actual mode under which the file was opened.
http://hg.python.org/cpython/rev/b5530669ef70

New changeset fc2b88a27fa1 by Antoine Pitrou in branch '2.7':
Issue #18876: The FileIO.mode attribute now better reflects the actual mode under which the file was opened.
http://hg.python.org/cpython/rev/fc2b88a27fa1

I have committed your patch. Thank you!

Thank you!  Has there been a separate issue opened for the BufferedWriter bug or can that be covered by this issue as well?

> Erik Bray added the comment:
> 
> Thank you!  Has there been a separate issue opened for the
> BufferedWriter bug or can that be covered by this issue as well?

No other issue has been opened as I know of, but indeed it would be
clearer to open a separate one.

I believe Erik opened #20082 for the BufferedWriter bug, so I think this issue can be closed as Resolved?

Indeed, this can be closed.