/Lib/test/test_runpy.py

http://unladen-swallow.googlecode.com/ · Python · 253 lines · 219 code · 23 blank · 11 comment · 49 complexity · 624a0d04e01014ae256849247adabc3e MD5 · raw file

  1. # Test the runpy module
  2. import unittest
  3. import os
  4. import os.path
  5. import sys
  6. import tempfile
  7. from test.test_support import verbose, run_unittest, forget
  8. from runpy import _run_code, _run_module_code, run_module
  9. # Note: This module can't safely test _run_module_as_main as it
  10. # runs its tests in the current process, which would mess with the
  11. # real __main__ module (usually test.regrtest)
  12. # See test_cmd_line_script for a test that executes that code path
  13. # Set up the test code and expected results
  14. class RunModuleCodeTest(unittest.TestCase):
  15. expected_result = ["Top level assignment", "Lower level reference"]
  16. test_source = (
  17. "# Check basic code execution\n"
  18. "result = ['Top level assignment']\n"
  19. "def f():\n"
  20. " result.append('Lower level reference')\n"
  21. "f()\n"
  22. "# Check the sys module\n"
  23. "import sys\n"
  24. "run_argv0 = sys.argv[0]\n"
  25. "run_name_in_sys_modules = __name__ in sys.modules\n"
  26. "if run_name_in_sys_modules:\n"
  27. " module_in_sys_modules = globals() is sys.modules[__name__].__dict__\n"
  28. "# Check nested operation\n"
  29. "import runpy\n"
  30. "nested = runpy._run_module_code('x=1\\n', mod_name='<run>')\n"
  31. )
  32. def test_run_code(self):
  33. saved_argv0 = sys.argv[0]
  34. d = _run_code(self.test_source, {})
  35. self.failUnless(d["result"] == self.expected_result)
  36. self.failUnless(d["__name__"] is None)
  37. self.failUnless(d["__file__"] is None)
  38. self.failUnless(d["__loader__"] is None)
  39. self.failUnless(d["__package__"] is None)
  40. self.failUnless(d["run_argv0"] is saved_argv0)
  41. self.failUnless("run_name" not in d)
  42. self.failUnless(sys.argv[0] is saved_argv0)
  43. def test_run_module_code(self):
  44. initial = object()
  45. name = "<Nonsense>"
  46. file = "Some other nonsense"
  47. loader = "Now you're just being silly"
  48. package = '' # Treat as a top level module
  49. d1 = dict(initial=initial)
  50. saved_argv0 = sys.argv[0]
  51. d2 = _run_module_code(self.test_source,
  52. d1,
  53. name,
  54. file,
  55. loader,
  56. package)
  57. self.failUnless("result" not in d1)
  58. self.failUnless(d2["initial"] is initial)
  59. self.failUnless(d2["result"] == self.expected_result)
  60. self.failUnless(d2["nested"]["x"] == 1)
  61. self.failUnless(d2["__name__"] is name)
  62. self.failUnless(d2["run_name_in_sys_modules"])
  63. self.failUnless(d2["module_in_sys_modules"])
  64. self.failUnless(d2["__file__"] is file)
  65. self.failUnless(d2["run_argv0"] is file)
  66. self.failUnless(d2["__loader__"] is loader)
  67. self.failUnless(d2["__package__"] is package)
  68. self.failUnless(sys.argv[0] is saved_argv0)
  69. self.failUnless(name not in sys.modules)
  70. class RunModuleTest(unittest.TestCase):
  71. def expect_import_error(self, mod_name):
  72. try:
  73. run_module(mod_name)
  74. except ImportError:
  75. pass
  76. else:
  77. self.fail("Expected import error for " + mod_name)
  78. def test_invalid_names(self):
  79. # Builtin module
  80. self.expect_import_error("sys")
  81. # Non-existent modules
  82. self.expect_import_error("sys.imp.eric")
  83. self.expect_import_error("os.path.half")
  84. self.expect_import_error("a.bee")
  85. self.expect_import_error(".howard")
  86. self.expect_import_error("..eaten")
  87. # Package
  88. self.expect_import_error("logging")
  89. def test_library_module(self):
  90. run_module("runpy")
  91. def _add_pkg_dir(self, pkg_dir):
  92. os.mkdir(pkg_dir)
  93. pkg_fname = os.path.join(pkg_dir, "__init__"+os.extsep+"py")
  94. pkg_file = open(pkg_fname, "w")
  95. pkg_file.close()
  96. return pkg_fname
  97. def _make_pkg(self, source, depth):
  98. pkg_name = "__runpy_pkg__"
  99. test_fname = "runpy_test"+os.extsep+"py"
  100. pkg_dir = sub_dir = tempfile.mkdtemp()
  101. if verbose: print " Package tree in:", sub_dir
  102. sys.path.insert(0, pkg_dir)
  103. if verbose: print " Updated sys.path:", sys.path[0]
  104. for i in range(depth):
  105. sub_dir = os.path.join(sub_dir, pkg_name)
  106. pkg_fname = self._add_pkg_dir(sub_dir)
  107. if verbose: print " Next level in:", sub_dir
  108. if verbose: print " Created:", pkg_fname
  109. mod_fname = os.path.join(sub_dir, test_fname)
  110. mod_file = open(mod_fname, "w")
  111. mod_file.write(source)
  112. mod_file.close()
  113. if verbose: print " Created:", mod_fname
  114. mod_name = (pkg_name+".")*depth + "runpy_test"
  115. return pkg_dir, mod_fname, mod_name
  116. def _del_pkg(self, top, depth, mod_name):
  117. for entry in list(sys.modules):
  118. if entry.startswith("__runpy_pkg__"):
  119. del sys.modules[entry]
  120. if verbose: print " Removed sys.modules entries"
  121. del sys.path[0]
  122. if verbose: print " Removed sys.path entry"
  123. for root, dirs, files in os.walk(top, topdown=False):
  124. for name in files:
  125. try:
  126. os.remove(os.path.join(root, name))
  127. except OSError, ex:
  128. if verbose: print ex # Persist with cleaning up
  129. for name in dirs:
  130. fullname = os.path.join(root, name)
  131. try:
  132. os.rmdir(fullname)
  133. except OSError, ex:
  134. if verbose: print ex # Persist with cleaning up
  135. try:
  136. os.rmdir(top)
  137. if verbose: print " Removed package tree"
  138. except OSError, ex:
  139. if verbose: print ex # Persist with cleaning up
  140. def _check_module(self, depth):
  141. pkg_dir, mod_fname, mod_name = (
  142. self._make_pkg("x=1\n", depth))
  143. forget(mod_name)
  144. try:
  145. if verbose: print "Running from source:", mod_name
  146. d1 = run_module(mod_name) # Read from source
  147. self.failUnless("x" in d1)
  148. self.failUnless(d1["x"] == 1)
  149. del d1 # Ensure __loader__ entry doesn't keep file open
  150. __import__(mod_name)
  151. os.remove(mod_fname)
  152. if verbose: print "Running from compiled:", mod_name
  153. d2 = run_module(mod_name) # Read from bytecode
  154. self.failUnless("x" in d2)
  155. self.failUnless(d2["x"] == 1)
  156. del d2 # Ensure __loader__ entry doesn't keep file open
  157. finally:
  158. self._del_pkg(pkg_dir, depth, mod_name)
  159. if verbose: print "Module executed successfully"
  160. def _add_relative_modules(self, base_dir, source, depth):
  161. if depth <= 1:
  162. raise ValueError("Relative module test needs depth > 1")
  163. pkg_name = "__runpy_pkg__"
  164. module_dir = base_dir
  165. for i in range(depth):
  166. parent_dir = module_dir
  167. module_dir = os.path.join(module_dir, pkg_name)
  168. # Add sibling module
  169. sibling_fname = os.path.join(module_dir, "sibling"+os.extsep+"py")
  170. sibling_file = open(sibling_fname, "w")
  171. sibling_file.close()
  172. if verbose: print " Added sibling module:", sibling_fname
  173. # Add nephew module
  174. uncle_dir = os.path.join(parent_dir, "uncle")
  175. self._add_pkg_dir(uncle_dir)
  176. if verbose: print " Added uncle package:", uncle_dir
  177. cousin_dir = os.path.join(uncle_dir, "cousin")
  178. self._add_pkg_dir(cousin_dir)
  179. if verbose: print " Added cousin package:", cousin_dir
  180. nephew_fname = os.path.join(cousin_dir, "nephew"+os.extsep+"py")
  181. nephew_file = open(nephew_fname, "w")
  182. nephew_file.close()
  183. if verbose: print " Added nephew module:", nephew_fname
  184. def _check_relative_imports(self, depth, run_name=None):
  185. contents = r"""\
  186. from __future__ import absolute_import
  187. from . import sibling
  188. from ..uncle.cousin import nephew
  189. """
  190. pkg_dir, mod_fname, mod_name = (
  191. self._make_pkg(contents, depth))
  192. try:
  193. self._add_relative_modules(pkg_dir, contents, depth)
  194. pkg_name = mod_name.rpartition('.')[0]
  195. if verbose: print "Running from source:", mod_name
  196. d1 = run_module(mod_name, run_name=run_name) # Read from source
  197. self.failUnless("__package__" in d1)
  198. self.failUnless(d1["__package__"] == pkg_name)
  199. self.failUnless("sibling" in d1)
  200. self.failUnless("nephew" in d1)
  201. del d1 # Ensure __loader__ entry doesn't keep file open
  202. __import__(mod_name)
  203. os.remove(mod_fname)
  204. if verbose: print "Running from compiled:", mod_name
  205. d2 = run_module(mod_name, run_name=run_name) # Read from bytecode
  206. self.failUnless("__package__" in d2)
  207. self.failUnless(d2["__package__"] == pkg_name)
  208. self.failUnless("sibling" in d2)
  209. self.failUnless("nephew" in d2)
  210. del d2 # Ensure __loader__ entry doesn't keep file open
  211. finally:
  212. self._del_pkg(pkg_dir, depth, mod_name)
  213. if verbose: print "Module executed successfully"
  214. def test_run_module(self):
  215. for depth in range(4):
  216. if verbose: print "Testing package depth:", depth
  217. self._check_module(depth)
  218. def test_explicit_relative_import(self):
  219. for depth in range(2, 5):
  220. if verbose: print "Testing relative imports at depth:", depth
  221. self._check_relative_imports(depth)
  222. def test_main_relative_import(self):
  223. for depth in range(2, 5):
  224. if verbose: print "Testing main relative imports at depth:", depth
  225. self._check_relative_imports(depth, "__main__")
  226. def test_main():
  227. run_unittest(RunModuleCodeTest)
  228. run_unittest(RunModuleTest)
  229. if __name__ == "__main__":
  230. test_main()