fileutils Module

This file is part of the web2py Web Framework

Copyrighted by Massimo Di Pierro <mdipierro@cs.depaul.edu>

License: LGPLv3 (http://www.gnu.org/licenses/lgpl.html)

File operations

gluon.fileutils.parse_version(version)

Attempts to parse SemVer, fallbacks on legacy

gluon.fileutils.read_file(filename, mode='r')

Returns content from filename, making sure to close the file explicitly on exit.

gluon.fileutils.write_file(filename, value, mode='w')

Writes <value> to filename, making sure to close the file explicitly on exit.

gluon.fileutils.readlines_file(filename, mode='r')

Applies .split(‘ ‘) to the output of read_file()

gluon.fileutils.up(path)

gluon.fileutils.abspath(*relpath, **base)

Converts relative path to absolute path based (by default) on applications_parent

gluon.fileutils.mktree(path)

gluon.fileutils.listdir(path, expression='^.+$', drop=True, add_dirs=False, sort=True, maxnum=None, exclude_content_from=None)

Like os.listdir() but you can specify a regex pattern to filter files. If add_dirs is True, the returned items will have the full path.

gluon.fileutils.recursive_unlink(f)

Deletes f. If it’s a folder, also its contents will be deleted

gluon.fileutils.cleanpath(path)

Turns any expression/path into a valid filename. replaces / with _ and removes special characters.

gluon.fileutils.tar(file, dir, expression='^.+$', filenames=None, exclude_content_from=None)

Tars dir into file, only tars file that match expression

gluon.fileutils.untar(file, dir)

Untar file into dir

gluon.fileutils.tar_compiled(file, dir, expression='^.+$', exclude_content_from=None)

Used to tar a compiled application. The content of models, views, controllers is not stored in the tar file.

gluon.fileutils.get_session(request, other_application='admin')

Checks that user is authorized to access other_application

gluon.fileutils.check_credentials(request, other_application='admin', expiration=3600, gae_login=True)

Checks that user is authorized to access other_application

gluon.fileutils.w2p_pack(filename, path, compiled=False, filenames=None)

Packs a web2py application.

Parameters:

• filename (str) – path to the resulting archive
• path (str) – path to the application
• compiled (bool) – if True packs the compiled version
• filenames (list) – adds filenames to the archive

gluon.fileutils.w2p_unpack(filename, path, delete_tar=True)

gluon.fileutils.w2p_pack_plugin(filename, path, plugin_name)

Packs the given plugin into a w2p file. Will match files at:

<path>/*/plugin_[name].*
<path>/*/plugin_[name]/*

gluon.fileutils.w2p_unpack_plugin(filename, path, delete_tar=True)

gluon.fileutils.fix_newlines(path)

gluon.fileutils.make_fake_file_like_object()