We're back after a server migration that caused effbot.org to fall over a bit harder than expected. Expect some glitches.


execfile(filename[, globals[, locals]])

This function is similar to the exec statement, but parses a file instead of a string. It is different from the import statement in that it does not use the module administration — it reads the file unconditionally and does not create a new module.

The arguments are a file name and two optional dictionaries. The file is parsed and evaluated as a sequence of Python statements (similarly to a module) using the globals and locals dictionaries as global and local namespace. If provided, locals can be any mapping object.

(Changed in version 2.4: formerly locals was required to be a dict.)

If the locals dictionary is omitted it defaults to the globals dictionary. If both dictionaries are omitted, the expression is executed in the environment where execfile is called. The return value is None.

Warning: The default locals act as described for the locals function: modifications to the default locals dictionary should not be attempted. Pass an explicit locals dictionary if you need to see effects of the code on locals after function execfile returns. execfile cannot be used reliably to modify a function’s locals.