method: code.Source.compile

 return compiled code object. if filename is None
            invent an artificial filename which displays
            the source/line position of the caller frame.

    def compile(self, filename=None, mode='exec',

origin: code.Source

where:

self :: <Instance of Class Source>
filename :: AnyOf(<String>, <None>)
mode :: <String>
flag :: <Int>
dont_inherit :: <Int>
return value :: AnyOf(<Instance of Class code>, <None>)

exceptions that might appear during execution:

SyntaxError

function source:

def compile(self, filename=None, mode='exec',
            flag=generators.compiler_flag, dont_inherit=0):
    """ return compiled code object. if filename is None
            invent an artificial filename which displays
            the source/line position of the caller frame.
        """
    if not filename or py.path.local(filename).check(file=0): 
        frame = sys._getframe(1) # the caller
        filename = '%s<%s:%d>' % (filename, frame.f_code.co_filename,
                                  frame.f_lineno)
    source = "\n".join(self.lines) + '\n'
    try:
        co = cpy_compile(source, filename, mode, flag)
    except SyntaxError, ex:
        # re-represent syntax errors from parsing python strings
        msglines = self.lines[:ex.lineno]
        if ex.offset:
            msglines.append(" "*ex.offset + '^')
        msglines.append("syntax error probably generated here: %s" % filename)
        newex = SyntaxError('\n'.join(msglines))
        newex.offset = ex.offset
        newex.lineno = ex.lineno
        newex.text = ex.text
        raise newex
    else:
        co_filename = MyStr(filename)
        co_filename.__source__ = self
        return py.code.Code(co).new(rec=1, co_filename=co_filename)