duplicity.dup_temp module

Manage temporary files

class duplicity.dup_temp.Block(data)

Bases: object

Data block to return from SrcIter

__init__(data)

class duplicity.dup_temp.FileobjHooked(fileobj, tdp=None, dirpath=None, partname=None, permname=None, remname=None)

Bases: object

Simulate a file, but add hook on close

__init__(fileobj, tdp=None, dirpath=None, partname=None, permname=None, remname=None)

Initializer. fileobj is the file object to simulate

addhook(hook)

Add hook (function taking no arguments) to run upon closing

close()

Close fileobj, running hooks right afterwards

flush()

Flush fileobj and force sync.

get_name()

Return the name of the file

property name

Return the name of the file

read(length=-1)

Read fileobj, return result of read()

seek(offset)

Seeks to a location of fileobj

tell()

Returns current location of fileobj

to_final()

We are finished, rename to final, gzip if needed.

to_partial()

We have achieved the first checkpoint, make file visible and permanent.

to_remote()

We have written the last checkpoint, now encrypt or compress and send a copy of it to the remote for final storage.

write(buf)

Write fileobj, return result of write()

class duplicity.dup_temp.SrcIter(src)

Bases: object

Iterate over source and return Block of data.

__init__(src)

get_footer()

get_read_size()

class duplicity.dup_temp.TempDupPath(base, index=(), parseresults=None)

Bases: DupPath

Like TempPath, but build around DupPath

delete()

Forget and delete

filtered_open_with_delete(mode)

Returns a filtered fileobj. When that is closed, delete file

open_with_delete(mode='rb')

Returns a fileobj. When that is closed, delete file

class duplicity.dup_temp.TempPath(base, index=())

Bases: Path

Path object used as a temporary file

delete()

Forget and delete

open_with_delete(mode)

Returns a fileobj. When that is closed, delete file

duplicity.dup_temp.get_fileobj_duppath(dirpath, partname, permname, remname, overwrite=False)

Return a file object open for writing, will write to filename

Data will be processed and written to a temporary file. When the return fileobject is closed, rename to final position. filename must be a recognizable duplicity data file.

duplicity.dup_temp.new_tempduppath(parseresults)

Return a new TempDupPath, using settings from parseresults

duplicity.dup_temp.new_temppath()

Return a new TempPath