Python built-in function "compile". What is it used for?
Question:
I came across a built-in function compile today. Though i read the documentation but still do not understand it’s usage or where it is applicable. Please can anyone explain with example the use of this function. I will really appreciate examples.
From the documentation, the function takes some parameters as shown below.
compile(source, filename, mode[, flags[, dont_inherit]])
Answers:
It is not that commonly used. It is used when you have Python source code in string form, and you want to make it into a Python code object that you can keep and use. Here’s a trivial example:
>>> codeobj = compile('x = 2nprint "X is", x', 'fakemodule', 'exec')
>>> exec(codeobj)
X is 2
Basically, the code object converts a string into an object that you can later call exec on to run the source code in the string. (This is for “exec” mode; the “eval” mode allows use of eval instead, if the string contains code for a single expression.) This is not a common task, which is why you may never run across a need for it.
The main use for it is in metaprogramming or embedding situations. For instance, if you have a Python program that allows users to script its behavior with custom Python code, you might use compile and exec to store and execute these user-defined scripts.
Another reason compile is rarely used is that, like exec, eval, and their ilk, compile is a potential security hole. If you take user code in string form and compile it and later exec it, you could be running unsafe code. (For instance, imagine that in my example above the code was formatYourHardDrive() instead of print x.)
What specifically don’t you understand? The documentation explains that it will:
Compile the source into a code or AST object. Code objects can be executed by an exec statement or evaluated by a call to eval(). source can either be a Unicode string, a Latin-1 encoded string or an AST object. Refer to the ast module documentation for information on how to work with AST objects.
So it takes python code, and returns on of those two things
exec will execute the python codeeval will evaluate an expression, which is less functional than execast allows you to navigate the Abstract Syntax Tree that the code generates
compile is a lower level version of exec and eval. It does not execute or evaluate your statements or expressions, but returns a code object that can do it. The modes are as follows:
compile(string, '', 'eval') returns the code object that would have been executed had you done eval(string). Note that you cannot use statements in this mode; only a (single) expression is valid. Used for a single expression.compile(string, '', 'exec') returns the code object that would have been executed had you done exec(string). You can use any number of statements here. Used for an entire module.compile(string, '', 'single') is like the exec mode, but it will ignore everything except for the first statement. Note that an if/else statement with its results is considered a single statement. Used for one single statement.
Take a look that the documentation. There is also an awesome (well, dumbed down) explanation at http://joequery.me/code/python-builtin-functions/#compile with an excellent example of usage.
I came across a built-in function compile today. Though i read the documentation but still do not understand it’s usage or where it is applicable. Please can anyone explain with example the use of this function. I will really appreciate examples.
From the documentation, the function takes some parameters as shown below.
compile(source, filename, mode[, flags[, dont_inherit]])
It is not that commonly used. It is used when you have Python source code in string form, and you want to make it into a Python code object that you can keep and use. Here’s a trivial example:
>>> codeobj = compile('x = 2nprint "X is", x', 'fakemodule', 'exec')
>>> exec(codeobj)
X is 2
Basically, the code object converts a string into an object that you can later call exec on to run the source code in the string. (This is for “exec” mode; the “eval” mode allows use of eval instead, if the string contains code for a single expression.) This is not a common task, which is why you may never run across a need for it.
The main use for it is in metaprogramming or embedding situations. For instance, if you have a Python program that allows users to script its behavior with custom Python code, you might use compile and exec to store and execute these user-defined scripts.
Another reason compile is rarely used is that, like exec, eval, and their ilk, compile is a potential security hole. If you take user code in string form and compile it and later exec it, you could be running unsafe code. (For instance, imagine that in my example above the code was formatYourHardDrive() instead of print x.)
What specifically don’t you understand? The documentation explains that it will:
Compile the source into a code or AST object. Code objects can be executed by an
execstatement or evaluated by a call toeval(). source can either be a Unicode string, a Latin-1 encoded string or an AST object. Refer to theastmodule documentation for information on how to work with AST objects.
So it takes python code, and returns on of those two things
execwill execute the python codeevalwill evaluate an expression, which is less functional thanexecastallows you to navigate the Abstract Syntax Tree that the code generates
compile is a lower level version of exec and eval. It does not execute or evaluate your statements or expressions, but returns a code object that can do it. The modes are as follows:
compile(string, '', 'eval')returns the code object that would have been executed had you doneeval(string). Note that you cannot use statements in this mode; only a (single) expression is valid. Used for a single expression.compile(string, '', 'exec')returns the code object that would have been executed had you doneexec(string). You can use any number of statements here. Used for an entire module.compile(string, '', 'single')is like theexecmode, but it will ignore everything except for the first statement. Note that anif/elsestatement with its results is considered a single statement. Used for one single statement.
Take a look that the documentation. There is also an awesome (well, dumbed down) explanation at http://joequery.me/code/python-builtin-functions/#compile with an excellent example of usage.