parameters: (filename, args, package=None)
docstring: Run a python file as if it were the main program on the command line.
  
      `filename` is the path to the file to execute, it need not be a .py file.
      `args` is the argument array to present as sys.argv, including the first
      element naming the file being executed.  `package` is the name of the
      enclosing package, if any.
docstring_summary: Run a python file as if it were the main program on the command line.
docstring_tokens: Run a python file as if it were the main program on the command line .
function: def run_python_file(filename, args, package=None):
      """Run a python file as if it were the main program on the command line.
  
      `filename` is the path to the file to execute, it need not be a .py file.
      `args` is the argument array to present as sys.argv, including the first
      element naming the file being executed.  `package` is the name of the
      enclosing package, if any.
  
      """
      # Create a module to serve as __main__
      old_main_mod = sys.modules['__main__']
      main_mod = imp.new_module('__main__')
      sys.modules['__main__'] = main_mod
      main_mod.__file__ = filename
      main_mod.__package__ = package
      main_mod.__builtins__ = BUILTINS
  
      # Set sys.argv and the first path element properly.
      old_argv = sys.argv
      old_path0 = sys.path[0]
      sys.argv = args
      sys.path[0] = os.path.abspath(os.path.dirname(filename))
  
      try:
          # Open the source file.
          try:
              source_file = open_source(filename)
          except IOError:
              raise NoSource("No file to run: %r" % filename)
  
          try:
              source = source_file.read()
          finally:
              source_file.close()
  
          # We have the source.  `compile` still needs the last line to be clean,
          # so make sure it is, then compile a code object from it.
          if source[-1] != '\n':
              source += '\n'
          code = compile(source, filename, "exec")
  
          # Execute the source file.
          try:
              exec_code_object(code, main_mod.__dict__)
          except SystemExit:
              # The user called sys.exit().  Just pass it along to the upper
              # layers, where it will be handled.
              raise
          except:
              # Something went wrong while executing the user code.
              # Get the exc_info, and pack them into an exception that we can
              # throw up to the outer loop.  We peel two layers off the traceback
              # so that the coverage.py code doesn't appear in the final printed
              # traceback.
              typ, err, tb = sys.exc_info()
              raise ExceptionDuringRun(typ, err, tb.tb_next.tb_next)
      finally:
          # Restore the old __main__
          sys.modules['__main__'] = old_main_mod
  
          # Restore the old argv and path
          sys.argv = old_argv
          sys.path[0] = old_path0
function_tokens: def run_python_file ( filename , args , package = None ) : # Create a module to serve as __main__ old_main_mod = sys . modules [ '__main__' ] main_mod = imp . new_module ( '__main__' ) sys . modules [ '__main__' ] = main_mod main_mod . __file__ = filename main_mod . __package__ = package main_mod . __builtins__ = BUILTINS # Set sys.argv and the first path element properly. old_argv = sys . argv old_path0 = sys . path [ 0 ] sys . argv = args sys . path [ 0 ] = os . path . abspath ( os . path . dirname ( filename ) ) try : # Open the source file. try : source_file = open_source ( filename ) except IOError : raise NoSource ( "No file to run: %r" % filename ) try : source = source_file . read ( ) finally : source_file . close ( ) # We have the source.  `compile` still needs the last line to be clean, # so make sure it is, then compile a code object from it. if source [ - 1 ] != '\n' : source += '\n' code = compile ( source , filename , "exec" ) # Execute the source file. try : exec_code_object ( code , main_mod . __dict__ ) except SystemExit : # The user called sys.exit().  Just pass it along to the upper # layers, where it will be handled. raise except : # Something went wrong while executing the user code. # Get the exc_info, and pack them into an exception that we can # throw up to the outer loop.  We peel two layers off the traceback # so that the coverage.py code doesn't appear in the final printed # traceback. typ , err , tb = sys . exc_info ( ) raise ExceptionDuringRun ( typ , err , tb . tb_next . tb_next ) finally : # Restore the old __main__ sys . modules [ '__main__' ] = old_main_mod # Restore the old argv and path sys . argv = old_argv sys . path [ 0 ] = old_path0