summaryrefslogtreecommitdiff
path: root/morphlib/savefile.py
blob: 7deb2b8920dddde4e08ba1a4b5e77232ec3741fa (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
# Copyright (C) 2012,2015  Codethink Limited
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 2 of the License.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License along
# with this program.  If not, see <http://www.gnu.org/licenses/>.


import logging
import os
import tempfile


class SaveFile(file):

    '''Save files with a temporary name and rename when they're ready.

    This class acts exactly like the normal ``file`` class, except that
    it is meant only for saving data to files. The data is written to
    a temporary file, which gets renamed to the target name when the
    open file is closed. This avoids readers of the file from getting
    an incomplete file.

    Example:

        f = SaveFile('foo', 'w')
        f.write(stuff)
        f.close()

    The file will be called something like ``tmpCAFEBEEF`` until ``close``
    is called, at which point it gets renamed to ``foo``.

    If the writer decides the file is not worth saving, they can call the
    ``abort`` method, which deletes the temporary file.

    '''

    def __init__(self, filename, *args, **kwargs):
        self.real_filename = filename
        dirname = os.path.dirname(filename)
        fd, self._savefile_tempname = tempfile.mkstemp(dir=dirname)
        os.close(fd)
        file.__init__(self, self._savefile_tempname, *args, **kwargs)

    def abort(self):
        '''Abort file saving.

        The temporary file will be removed, and the universe is almost
        exactly as if the file save had never started.

        '''

        os.remove(self._savefile_tempname)
        return file.close(self)

    def close(self):
        ret = file.close(self)
        logging.debug('Rename temporary file %s to %s' %
                      (self._savefile_tempname, self.real_filename))
        os.rename(self._savefile_tempname, self.real_filename)
        return ret