home *** CD-ROM | disk | FTP | other *** search
/ GameStar 2006 January / Gamestar_80_2006-01_dvd.iso / Dema / Civilization4 / data1.cab / Civ4DemoComponent / Assets / Python / System / codeop.pyc (.txt) < prev    next >
Encoding:
Python Compiled Bytecode  |  2005-11-09  |  6.5 KB  |  202 lines
  1. # Source Generated with Decompyle++
  2. # File: in.pyc (Python 2.4)
  3.  
  4. """Utilities to compile possibly incomplete Python source code.
  5.  
  6. This module provides two interfaces, broadly similar to the builtin
  7. function compile(), which take program text, a filename and a 'mode'
  8. and:
  9.  
  10. - Return code object if the command is complete and valid
  11. - Return None if the command is incomplete
  12. - Raise SyntaxError, ValueError or OverflowError if the command is a
  13.   syntax error (OverflowError and ValueError can be produced by
  14.   malformed literals).
  15.  
  16. Approach:
  17.  
  18. First, check if the source consists entirely of blank lines and
  19. comments; if so, replace it with 'pass', because the built-in
  20. parser doesn't always do the right thing for these.
  21.  
  22. Compile three times: as is, with \\n, and with \\n\\n appended.  If it
  23. compiles as is, it's complete.  If it compiles with one \\n appended,
  24. we expect more.  If it doesn't compile either way, we compare the
  25. error we get when compiling with \\n or \\n\\n appended.  If the errors
  26. are the same, the code is broken.  But if the errors are different, we
  27. expect more.  Not intuitive; not even guaranteed to hold in future
  28. releases; but this matches the compiler's behavior from Python 1.4
  29. through 2.2, at least.
  30.  
  31. Caveat:
  32.  
  33. It is possible (but not likely) that the parser stops parsing with a
  34. successful outcome before reaching the end of the source; in this
  35. case, trailing symbols may be ignored instead of causing an error.
  36. For example, a backslash followed by two newlines may be followed by
  37. arbitrary garbage.  This will be fixed once the API for the parser is
  38. better.
  39.  
  40. The two interfaces are:
  41.  
  42. compile_command(source, filename, symbol):
  43.  
  44.     Compiles a single command in the manner described above.
  45.  
  46. CommandCompiler():
  47.  
  48.     Instances of this class have __call__ methods identical in
  49.     signature to compile_command; the difference is that if the
  50.     instance compiles program text containing a __future__ statement,
  51.     the instance 'remembers' and compiles all subsequent program texts
  52.     with the statement in force.
  53.  
  54. The module also provides another class:
  55.  
  56. Compile():
  57.  
  58.     Instances of this class act like the built-in function compile,
  59.     but with 'memory' in the sense described above.
  60. """
  61. import __future__
  62. _features = [ getattr(__future__, fname) for fname in __future__.all_feature_names ]
  63. __all__ = [
  64.     'compile_command',
  65.     'Compile',
  66.     'CommandCompiler']
  67. PyCF_DONT_IMPLY_DEDENT = 512
  68.  
  69. def _maybe_compile(compiler, source, filename, symbol):
  70.     for line in source.split('\n'):
  71.         line = line.strip()
  72.         if line and line[0] != '#':
  73.             break
  74.             continue
  75.     elif symbol != 'eval':
  76.         source = 'pass'
  77.     
  78.     err = None
  79.     err1 = None
  80.     err2 = None
  81.     code = None
  82.     code1 = None
  83.     code2 = None
  84.     
  85.     try:
  86.         code = compiler(source, filename, symbol)
  87.     except SyntaxError:
  88.         err = None
  89.  
  90.     
  91.     try:
  92.         code1 = compiler(source + '\n', filename, symbol)
  93.     except SyntaxError:
  94.         err1 = None
  95.  
  96.     
  97.     try:
  98.         code2 = compiler(source + '\n\n', filename, symbol)
  99.     except SyntaxError:
  100.         err2 = None
  101.  
  102.     if code:
  103.         return code
  104.     
  105.     
  106.     try:
  107.         e1 = err1.__dict__
  108.     except AttributeError:
  109.         e1 = err1
  110.  
  111.     
  112.     try:
  113.         e2 = err2.__dict__
  114.     except AttributeError:
  115.         e2 = err2
  116.  
  117.     if not code1 and e1 == e2:
  118.         raise SyntaxError, err1
  119.     
  120.  
  121.  
  122. def _compile(source, filename, symbol):
  123.     return compile(source, filename, symbol, PyCF_DONT_IMPLY_DEDENT)
  124.  
  125.  
  126. def compile_command(source, filename = '<input>', symbol = 'single'):
  127.     '''Compile a command and determine whether it is incomplete.
  128.  
  129.     Arguments:
  130.  
  131.     source -- the source string; may contain \\n characters
  132.     filename -- optional filename from which source was read; default
  133.                 "<input>"
  134.     symbol -- optional grammar start symbol; "single" (default) or "eval"
  135.  
  136.     Return value / exceptions raised:
  137.  
  138.     - Return a code object if the command is complete and valid
  139.     - Return None if the command is incomplete
  140.     - Raise SyntaxError, ValueError or OverflowError if the command is a
  141.       syntax error (OverflowError and ValueError can be produced by
  142.       malformed literals).
  143.     '''
  144.     return _maybe_compile(_compile, source, filename, symbol)
  145.  
  146.  
  147. class Compile:
  148.     '''Instances of this class behave much like the built-in compile
  149.     function, but if one is used to compile text containing a future
  150.     statement, it "remembers" and compiles all subsequent program texts
  151.     with the statement in force.'''
  152.     
  153.     def __init__(self):
  154.         self.flags = PyCF_DONT_IMPLY_DEDENT
  155.  
  156.     
  157.     def __call__(self, source, filename, symbol):
  158.         codeob = compile(source, filename, symbol, self.flags, 1)
  159.         for feature in _features:
  160.             if codeob.co_flags & feature.compiler_flag:
  161.                 self.flags |= feature.compiler_flag
  162.                 continue
  163.             self
  164.         
  165.         return codeob
  166.  
  167.  
  168.  
  169. class CommandCompiler:
  170.     """Instances of this class have __call__ methods identical in
  171.     signature to compile_command; the difference is that if the
  172.     instance compiles program text containing a __future__ statement,
  173.     the instance 'remembers' and compiles all subsequent program texts
  174.     with the statement in force."""
  175.     
  176.     def __init__(self):
  177.         self.compiler = Compile()
  178.  
  179.     
  180.     def __call__(self, source, filename = '<input>', symbol = 'single'):
  181.         '''Compile a command and determine whether it is incomplete.
  182.  
  183.         Arguments:
  184.  
  185.         source -- the source string; may contain \\n characters
  186.         filename -- optional filename from which source was read;
  187.                     default "<input>"
  188.         symbol -- optional grammar start symbol; "single" (default) or
  189.                   "eval"
  190.  
  191.         Return value / exceptions raised:
  192.  
  193.         - Return a code object if the command is complete and valid
  194.         - Return None if the command is incomplete
  195.         - Raise SyntaxError, ValueError or OverflowError if the command is a
  196.           syntax error (OverflowError and ValueError can be produced by
  197.           malformed literals).
  198.         '''
  199.         return _maybe_compile(self.compiler, source, filename, symbol)
  200.  
  201.  
  202.