psychopy.tools.filetools¶

Functions and classes related to file and directory handling

psychopy.tools.filetools.toFile(filename, data)[source]¶

Save data (of any sort) as a pickle file.

simple wrapper of the cPickle module in core python

psychopy.tools.filetools.fromFile(filename, encoding='utf-8-sig')[source]¶

Load data from a psydat, pickle or JSON file.

Parameters:

encoding (str) – The encoding to use when reading a JSON file. This parameter will be ignored for any other file type.

psychopy.tools.filetools.mergeFolder(src, dst, pattern=None)[source]¶

Merge a folder into another.

Existing files in dst folder with the same name will be overwritten. Non-existent files/folders will be created.

psychopy.tools.filetools.openOutputFile(fileName=None, append=False, fileCollisionMethod='rename', encoding='utf-8-sig')[source]¶

Open an output file (or standard output) for writing.

Parameters:

fileNameNone, ‘stdout’, or str

The desired output file name. If None or stdout, return sys.stdout. Any other string will be considered a filename.

appendbool, optional

If True, append data to an existing file; otherwise, overwrite it with new data. Defaults to True, i.e. appending.

fileCollisionMethodstring, optional

How to handle filename collisions. Valid values are ‘rename’, ‘overwrite’, and ‘fail’. This parameter is ignored if append is set to True. Defaults to rename.

encodingstring, optional

The encoding to use when writing the file. This parameter will be ignored if append is False and fileName ends with .psydat or .npy (i.e. if a binary file is to be written). Defaults to 'utf-8'.

Returns:

ffile

A writable file handle.

psychopy.tools.filetools.genDelimiter(fileName)[source]¶

Return a delimiter based on a filename.

Parameters:

fileNamestring

The output file name.

Returns:

delimstring

A delimiter picked based on the supplied filename. This will be , if the filename extension is .csv, and a tabulator character otherwise.