"""Test suite for 2to3's parser and grammar files. This is the place to add tests for changes to 2to3's grammar, such as those merging the grammars for Python 2 and 3. In addition to specific tests for parts of the grammar we've changed, we also make sure we can parse the test_grammar.py files from both Python 2 and Python 3. """ # Testing imports from . import support from .support import driver, driver_no_print_statement # Python imports import difflib import importlib import operator import os import pickle import shutil import subprocess import sys import tempfile import test.support import unittest # Local imports from lib2to3.pgen2 import driver as pgen2_driver from lib2to3.pgen2 import tokenize from lib2to3.pgen2.parse import ParseError from lib2to3.pygram import python_symbols as syms class TestDriver(support.TestCase): def test_formfeed(self): s = """print 1\n\x0Cprint 2\n""" t = driver.parse_string(s) self.assertEqual(t.children[0].children[0].type, syms.print_stmt) self.assertEqual(t.children[1].children[0].type, syms.print_stmt) class TestPgen2Caching(support.TestCase): def test_load_grammar_from_txt_file(self): pgen2_driver.load_grammar(support.grammar_path, save=False, force=True) def test_load_grammar_from_pickle(self): # Make a copy of the grammar file in a temp directory we are # guaranteed to be able to write to. tmpdir = tempfile.mkdtemp() try: grammar_copy = os.path.join( tmpdir, os.path.basename(support.grammar_path)) shutil.copy(support.grammar_path, grammar_copy) pickle_name = pgen2_driver._generate_pickle_name(grammar_copy) pgen2_driver.load_grammar(grammar_copy, save=True, force=True) self.assertTrue(os.path.exists(pickle_name)) os.unlink(grammar_copy) # Only the pickle remains... pgen2_driver.load_grammar(grammar_copy, save=False, force=False) finally: shutil.rmtree(tmpdir) @unittest.skipIf(sys.executable is None, 'sys.executable required') @unittest.skipIf( sys.platform in {'emscripten', 'wasi'}, 'requires working subprocess' ) def test_load_grammar_from_subprocess(self): tmpdir = tempfile.mkdtemp() tmpsubdir = os.path.join(tmpdir, 'subdir') try: os.mkdir(tmpsubdir) grammar_base = os.path.basename(support.grammar_path) grammar_copy = os.path.join(tmpdir, grammar_base) grammar_sub_copy = os.path.join(tmpsubdir, grammar_base) shutil.copy(support.grammar_path, grammar_copy) shutil.copy(support.grammar_path, grammar_sub_copy) pickle_name = pgen2_driver._generate_pickle_name(grammar_copy) pickle_sub_name = pgen2_driver._generate_pickle_name( grammar_sub_copy) self.assertNotEqual(pickle_name, pickle_sub_name) # Generate a pickle file from this process. pgen2_driver.load_grammar(grammar_copy, save=True, force=True) self.assertTrue(os.path.exists(pickle_name)) # Generate a new pickle file in a subprocess with a most likely # different hash randomization seed. sub_env = dict(os.environ) sub_env['PYTHONHASHSEED'] = 'random' code = """ from lib2to3.pgen2 import driver as pgen2_driver pgen2_driver.load_grammar(%r, save=True, force=True) """ % (grammar_sub_copy,) cmd = [sys.executable, '-Wignore:lib2to3:DeprecationWarning', '-c', code] subprocess.check_call( cmd, env=sub_env) self.assertTrue(os.path.exists(pickle_sub_name)) with open(pickle_name, 'rb') as pickle_f_1, \ open(pickle_sub_name, 'rb') as pickle_f_2: self.assertEqual( pickle_f_1.read(), pickle_f_2.read(), msg='Grammar caches generated using different hash seeds' ' were not identical.') finally: shutil.rmtree(tmpdir) def test_load_packaged_grammar(self): modname = __name__ + '.load_test' class MyLoader: def get_data(self, where): return pickle.dumps({'elephant': 19}) class MyModule: __file__ = 'parsertestmodule' __spec__ = importlib.util.spec_from_loader(modname, MyLoader()) sys.modules[modname] = MyModule() self.addCleanup(operator.delitem, sys.modules, modname) g = pgen2_driver.load_packaged_grammar(modname, 'Grammar.txt') self.assertEqual(g.elephant, 19) class GrammarTest(support.TestCase): def validate(self, code): support.parse_string(code) def invalid_syntax(self, code): try: self.validate(code) except ParseError: pass else: raise AssertionError("Syntax shouldn't have been valid") class TestMatrixMultiplication(GrammarTest): def test_matrix_multiplication_operator(self): self.validate("a @ b") self.validate("a @= b") class TestYieldFrom(GrammarTest): def test_yield_from(self): self.validate("yield from x") self.validate("(yield from x) + y") self.invalid_syntax("yield from") class TestAsyncAwait(GrammarTest): def test_await_expr(self): self.validate("""async def foo(): await x """) self.validate("""async def foo(): [i async for i in b] """) self.validate("""async def foo(): {i for i in b async for i in a if await i for b in i} """) self.validate("""async def foo(): [await i for i in b if await c] """) self.validate("""async def foo(): [ i for i in b if c] """) self.validate("""async def foo(): def foo(): pass def foo(): pass await x """) self.validate("""async def foo(): return await a""") self.validate("""def foo(): def foo(): pass async def foo(): await x """) self.invalid_syntax("await x") self.invalid_syntax("""def foo(): await x""") self.invalid_syntax("""def foo(): def foo(): pass async def foo(): pass await x """) def test_async_var(self): self.validate("""async = 1""") self.validate("""await = 1""") self.validate("""def async(): pass""") def test_async_for(self): self.validate("""async def foo(): async for a in b: pass""") def test_async_with(self): self.validate("""async def foo(): async with a: pass""") self.invalid_syntax("""def foo(): async with a: pass""") def test_async_generator(self): self.validate( """async def foo(): return (i * 2 async for i in arange(42))""" ) self.validate( """def foo(): return (i * 2 async for i in arange(42))""" ) class TestRaiseChanges(GrammarTest): def test_2x_style_1(self): self.validate("raise") def test_2x_style_2(self): self.validate("raise E, V") def test_2x_style_3(self): self.validate("raise E, V, T") def test_2x_style_invalid_1(self): self.invalid_syntax("raise E, V, T, Z") def test_3x_style(self): self.validate("raise E1 from E2") def test_3x_style_invalid_1(self): self.invalid_syntax("raise E, V from E1") def test_3x_style_invalid_2(self): self.invalid_syntax("raise E from E1, E2") def test_3x_style_invalid_3(self): self.invalid_syntax("raise from E1, E2") def test_3x_style_invalid_4(self): self.invalid_syntax("raise E from") # Modelled after Lib/test/test_grammar.py:TokenTests.test_funcdef issue2292 # and Lib/test/text_parser.py test_list_displays, test_set_displays, # test_dict_displays, test_argument_unpacking, ... changes. class TestUnpackingGeneralizations(GrammarTest): def test_mid_positional_star(self): self.validate("""func(1, *(2, 3), 4)""") def test_double_star_dict_literal(self): self.validate("""func(**{'eggs':'scrambled', 'spam':'fried'})""") def test_double_star_dict_literal_after_keywords(self): self.validate("""func(spam='fried', **{'eggs':'scrambled'})""") def test_double_star_expression(self): self.validate("""func(**{'a':2} or {})""") self.validate("""func(**() or {})""") def test_star_expression(self): self.validate("""func(*[] or [2])""") def test_list_display(self): self.validate("""[*{2}, 3, *[4]]""") def test_set_display(self): self.validate("""{*{2}, 3, *[4]}""") def test_dict_display_1(self): self.validate("""{**{}}""") def test_dict_display_2(self): self.validate("""{**{}, 3:4, **{5:6, 7:8}}""") def test_complex_star_expression(self): self.validate("func(* [] or [1])") def test_complex_double_star_expression(self): self.validate("func(**{1: 3} if False else {x: x for x in range(3)})") def test_argument_unpacking_1(self): self.validate("""f(a, *b, *c, d)""") def test_argument_unpacking_2(self): self.validate("""f(**a, **b)""") def test_argument_unpacking_3(self): self.validate("""f(2, *a, *b, **b, **c, **d)""") def test_trailing_commas_1(self): self.validate("def f(a, b): call(a, b)") self.validate("def f(a, b,): call(a, b,)") def test_trailing_commas_2(self): self.validate("def f(a, *b): call(a, *b)") self.validate("def f(a, *b,): call(a, *b,)") def test_trailing_commas_3(self): self.validate("def f(a, b=1): call(a, b=1)") self.validate("def f(a, b=1,): call(a, b=1,)") def test_trailing_commas_4(self): self.validate("def f(a, **b): call(a, **b)") self.validate("def f(a, **b,): call(a, **b,)") def test_trailing_commas_5(self): self.validate("def f(*a, b=1): call(*a, b=1)") self.validate("def f(*a, b=1,): call(*a, b=1,)") def test_trailing_commas_6(self): self.validate("def f(*a, **b): call(*a, **b)") self.validate("def f(*a, **b,): call(*a, **b,)") def test_trailing_commas_7(self): self.validate("def f(*, b=1): call(*b)") self.validate("def f(*, b=1,): call(*b,)") def test_trailing_commas_8(self): self.validate("def f(a=1, b=2): call(a=1, b=2)") self.validate("def f(a=1, b=2,): call(a=1, b=2,)") def test_trailing_commas_9(self): self.validate("def f(a=1, **b): call(a=1, **b)") self.validate("def f(a=1, **b,): call(a=1, **b,)") def test_trailing_commas_lambda_1(self): self.validate("f = lambda a, b: call(a, b)") self.validate("f = lambda a, b,: call(a, b,)") def test_trailing_commas_lambda_2(self): self.validate("f = lambda a, *b: call(a, *b)") self.validate("f = lambda a, *b,: call(a, *b,)") def test_trailing_commas_lambda_3(self): self.validate("f = lambda a, b=1: call(a, b=1)") self.validate("f = lambda a, b=1,: call(a, b=1,)") def test_trailing_commas_lambda_4(self): self.validate("f = lambda a, **b: call(a, **b)") self.validate("f = lambda a, **b,: call(a, **b,)") def test_trailing_commas_lambda_5(self): self.validate("f = lambda *a, b=1: call(*a, b=1)") self.validate("f = lambda *a, b=1,: call(*a, b=1,)") def test_trailing_commas_lambda_6(self): self.validate("f = lambda *a, **b: call(*a, **b)") self.validate("f = lambda *a, **b,: call(*a, **b,)") def test_trailing_commas_lambda_7(self): self.validate("f = lambda *, b=1: call(*b)") self.validate("f = lambda *, b=1,: call(*b,)") def test_trailing_commas_lambda_8(self): self.validate("f = lambda a=1, b=2: call(a=1, b=2)") self.validate("f = lambda a=1, b=2,: call(a=1, b=2,)") def test_trailing_commas_lambda_9(self): self.validate("f = lambda a=1, **b: call(a=1, **b)") self.validate("f = lambda a=1, **b,: call(a=1, **b,)") # Adapted from Python 3's Lib/test/test_grammar.py:GrammarTests.testFuncdef class TestFunctionAnnotations(GrammarTest): def test_1(self): self.validate("""def f(x) -> list: pass""") def test_2(self): self.validate("""def f(x:int): pass""") def test_3(self): self.validate("""def f(*x:str): pass""") def test_4(self): self.validate("""def f(**x:float): pass""") def test_5(self): self.validate("""def f(x, y:1+2): pass""") def test_6(self): self.validate("""def f(a, (b:1, c:2, d)): pass""") def test_7(self): self.validate("""def f(a, (b:1, c:2, d), e:3=4, f=5, *g:6): pass""") def test_8(self): s = """def f(a, (b:1, c:2, d), e:3=4, f=5, *g:6, h:7, i=8, j:9=10, **k:11) -> 12: pass""" self.validate(s) def test_9(self): s = """def f( a: str, b: int, *, c: bool = False, **kwargs, ) -> None: call(c=c, **kwargs,)""" self.validate(s) def test_10(self): s = """def f( a: str, ) -> None: call(a,)""" self.validate(s) def test_11(self): s = """def f( a: str = '', ) -> None: call(a=a,)""" self.validate(s) def test_12(self): s = """def f( *args: str, ) -> None: call(*args,)""" self.validate(s) def test_13(self): self.validate("def f(a: str, b: int) -> None: call(a, b)") self.validate("def f(a: str, b: int,) -> None: call(a, b,)") def test_14(self): self.validate("def f(a: str, *b: int) -> None: call(a, *b)") self.validate("def f(a: str, *b: int,) -> None: call(a, *b,)") def test_15(self): self.validate("def f(a: str, b: int=1) -> None: call(a, b=1)") self.validate("def f(a: str, b: int=1,) -> None: call(a, b=1,)") def test_16(self): self.validate("def f(a: str, **b: int) -> None: call(a, **b)") self.validate("def f(a: str, **b: int,) -> None: call(a, **b,)") def test_17(self): self.validate("def f(*a: str, b: int=1) -> None: call(*a, b=1)") self.validate("def f(*a: str, b: int=1,) -> None: call(*a, b=1,)") def test_18(self): self.validate("def f(*a: str, **b: int) -> None: call(*a, **b)") self.validate("def f(*a: str, **b: int,) -> None: call(*a, **b,)") def test_19(self): self.validate("def f(*, b: int=1) -> None: call(*b)") self.validate("def f(*, b: int=1,) -> None: call(*b,)") def test_20(self): self.validate("def f(a: str='', b: int=2) -> None: call(a=a, b=2)") self.validate("def f(a: str='', b: int=2,) -> None: call(a=a, b=2,)") def test_21(self): self.validate("def f(a: str='', **b: int) -> None: call(a=a, **b)") self.validate("def f(a: str='', **b: int,) -> None: call(a=a, **b,)") # Adapted from Python 3's Lib/test/test_grammar.py:GrammarTests.test_var_annot class TestVarAnnotations(GrammarTest): def test_1(self): self.validate("var1: int = 5") def test_2(self): self.validate("var2: [int, str]") def test_3(self): self.validate("def f():\n" " st: str = 'Hello'\n" " a.b: int = (1, 2)\n" " return st\n") def test_4(self): self.validate("def fbad():\n" " x: int\n" " print(x)\n") def test_5(self): self.validate("class C:\n" " x: int\n" " s: str = 'attr'\n" " z = 2\n" " def __init__(self, x):\n" " self.x: int = x\n") def test_6(self): self.validate("lst: List[int] = []") class TestExcept(GrammarTest): def test_new(self): s = """ try: x except E as N: y""" self.validate(s) def test_old(self): s = """ try: x except E, N: y""" self.validate(s) class TestStringLiterals(GrammarTest): prefixes = ("'", '"', "r'", 'r"', "R'", 'R"', "u'", 'u"', "U'", 'U"', "b'", 'b"', "B'", 'B"', "f'", 'f"', "F'", 'F"', "ur'", 'ur"', "Ur'", 'Ur"', "uR'", 'uR"', "UR'", 'UR"', "br'", 'br"', "Br'", 'Br"', "bR'", 'bR"', "BR'", 'BR"', "rb'", 'rb"', "Rb'", 'Rb"', "rB'", 'rB"', "RB'", 'RB"',) def test_lit(self): for pre in self.prefixes: single = "{p}spamspamspam{s}".format(p=pre, s=pre[-1]) self.validate(single) triple = "{p}{s}{s}eggs{s}{s}{s}".format(p=pre, s=pre[-1]) self.validate(triple) # Adapted from Python 3's Lib/test/test_grammar.py:GrammarTests.testAtoms class TestSetLiteral(GrammarTest): def test_1(self): self.validate("""x = {'one'}""") def test_2(self): self.validate("""x = {'one', 1,}""") def test_3(self): self.validate("""x = {'one', 'two', 'three'}""") def test_4(self): self.validate("""x = {2, 3, 4,}""") # Adapted from Python 3's Lib/test/test_unicode_identifiers.py and # Lib/test/test_tokenize.py:TokenizeTest.test_non_ascii_identifiers class TestIdentifier(GrammarTest): def test_non_ascii_identifiers(self): self.validate("Örter = 'places'\ngrün = 'green'") self.validate("蟒 = a蟒 = 锦蛇 = 1") self.validate("µ = aµ = µµ = 1") self.validate("𝔘𝔫𝔦𝔠𝔬𝔡𝔢 = a_𝔘𝔫𝔦𝔠𝔬𝔡𝔢 = 1") class TestNumericLiterals(GrammarTest): def test_new_octal_notation(self): self.validate("""0o7777777777777""") self.invalid_syntax("""0o7324528887""") def test_new_binary_notation(self): self.validate("""0b101010""") self.invalid_syntax("""0b0101021""") class TestClassDef(GrammarTest): def test_new_syntax(self): self.validate("class B(t=7): pass") self.validate("class B(t, *args): pass") self.validate("class B(t, **kwargs): pass") self.validate("class B(t, *args, **kwargs): pass") self.validate("class B(t, y=9, *args, **kwargs,): pass") class TestParserIdempotency(support.TestCase): """A cut-down version of pytree_idempotency.py.""" def parse_file(self, filepath): if test.support.verbose: print(f"Parse file: {filepath}") with open(filepath, "rb") as fp: encoding = tokenize.detect_encoding(fp.readline)[0] self.assertIsNotNone(encoding, "can't detect encoding for %s" % filepath) with open(filepath, "r", encoding=encoding) as fp: source = fp.read() try: tree = driver.parse_string(source) except ParseError: try: tree = driver_no_print_statement.parse_string(source) except ParseError as err: self.fail('ParseError on file %s (%s)' % (filepath, err)) new = str(tree) if new != source: print(diff_texts(source, new, filepath)) self.fail("Idempotency failed: %s" % filepath) def test_all_project_files(self): for filepath in support.all_project_files(): with self.subTest(filepath=filepath): self.parse_file(filepath) def test_extended_unpacking(self): driver.parse_string("a, *b, c = x\n") driver.parse_string("[*a, b] = x\n") driver.parse_string("(z, *y, w) = m\n") driver.parse_string("for *z, m in d: pass\n") class TestLiterals(GrammarTest): def validate(self, s): driver.parse_string(support.dedent(s) + "\n\n") def test_multiline_bytes_literals(self): s = """ md5test(b"\xaa" * 80, (b"Test Using Larger Than Block-Size Key " b"and Larger Than One Block-Size Data"), "6f630fad67cda0ee1fb1f562db3aa53e") """ self.validate(s) def test_multiline_bytes_tripquote_literals(self): s = ''' b""" """ ''' self.validate(s) def test_multiline_str_literals(self): s = """ md5test("\xaa" * 80, ("Test Using Larger Than Block-Size Key " "and Larger Than One Block-Size Data"), "6f630fad67cda0ee1fb1f562db3aa53e") """ self.validate(s) class TestNamedAssignments(GrammarTest): """Also known as the walrus operator.""" def test_named_assignment_if(self): driver.parse_string("if f := x(): pass\n") def test_named_assignment_while(self): driver.parse_string("while f := x(): pass\n") def test_named_assignment_generator(self): driver.parse_string("any((lastNum := num) == 1 for num in [1, 2, 3])\n") def test_named_assignment_listcomp(self): driver.parse_string("[(lastNum := num) == 1 for num in [1, 2, 3]]\n") class TestPositionalOnlyArgs(GrammarTest): def test_one_pos_only_arg(self): driver.parse_string("def one_pos_only_arg(a, /): pass\n") def test_all_markers(self): driver.parse_string( "def all_markers(a, b=2, /, c, d=4, *, e=5, f): pass\n") def test_all_with_args_and_kwargs(self): driver.parse_string( """def all_markers_with_args_and_kwargs( aa, b, /, _cc, d, *args, e, f_f, **kwargs, ): pass\n""") def test_lambda_soup(self): driver.parse_string( "lambda a, b, /, c, d, *args, e, f, **kw: kw\n") def test_only_positional_or_keyword(self): driver.parse_string("def func(a,b,/,*,g,e=3): pass\n") class TestPickleableException(unittest.TestCase): def test_ParseError(self): err = ParseError('msg', 2, None, (1, 'context')) for proto in range(pickle.HIGHEST_PROTOCOL + 1): err2 = pickle.loads(pickle.dumps(err, protocol=proto)) self.assertEqual(err.args, err2.args) self.assertEqual(err.msg, err2.msg) self.assertEqual(err.type, err2.type) self.assertEqual(err.value, err2.value) self.assertEqual(err.context, err2.context) def diff_texts(a, b, filename): a = a.splitlines() b = b.splitlines() return difflib.unified_diff(a, b, filename, filename, "(original)", "(reserialized)", lineterm="") if __name__ == '__main__': unittest.main()