1 #!/usr/bin/env python 2 3 """ 4 Translate the AST of a Python program into a more interpretable representation. 5 6 Copyright (C) 2007, 2008, 2009 Paul Boddie <paul@boddie.org.uk> 7 8 This program is free software; you can redistribute it and/or modify it under 9 the terms of the GNU General Public License as published by the Free Software 10 Foundation; either version 3 of the License, or (at your option) any later 11 version. 12 13 This program is distributed in the hope that it will be useful, but WITHOUT 14 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS 15 FOR A PARTICULAR PURPOSE. See the GNU General Public License for more 16 details. 17 18 You should have received a copy of the GNU General Public License along with 19 this program. If not, see <http://www.gnu.org/licenses/>. 20 """ 21 22 from micropython.opt import Optimiser 23 from micropython.common import * 24 from micropython.data import * 25 from micropython.rsvp import * 26 from micropython.trans import Helper 27 import compiler.ast 28 from compiler.visitor import ASTVisitor 29 30 # Program visitors. 31 32 class Translation(ASTVisitor, Helper): 33 34 "A translated module." 35 36 # Attribute access instructions, for use with the appropriate handlers. 37 38 attribute_load_instructions = ( 39 LoadAddress, LoadAddressContext, LoadAddressContextCond, 40 LoadAttr, LoadAttrIndex, LoadAttrIndexContext, LoadAttrIndexContextCond 41 ) 42 attribute_store_instructions = ( 43 None, None, None, 44 StoreAttr, StoreAttrIndex, None, None 45 ) 46 47 # Name access instructions, for use with the appropriate handlers. 48 49 name_load_instructions = (LoadName, LoadAddress) 50 name_store_instructions = (StoreName, StoreAddress) 51 52 def __init__(self, module, program): 53 54 """ 55 Initialise the translation with an inspected 'module' and the 'program' 56 container. 57 """ 58 59 ASTVisitor.__init__(self) 60 self.visitor = self 61 self.module = module 62 63 # Global program dependencies. 64 65 self.program = program 66 self.objtable = self.program.get_object_table() 67 self.paramtable = self.program.get_parameter_table() 68 self.importer = self.program.get_importer() 69 self.builtins = self.importer.modules.get("__builtins__") 70 71 # Optimisation. 72 73 self.optimiser = Optimiser(self, program.optimisations) 74 75 # The current unit being translated. 76 77 self.unit = None 78 79 # The temporary storage used by the current assignment expression. 80 81 self.expr_temp = [] 82 83 # Wiring within the code. 84 85 self.labels = {} 86 self.label_number = 0 87 self.loop_blocks = [] 88 self.exception_blocks = [] 89 90 self.reset() 91 92 def __repr__(self): 93 return "Translation(%r)" % self.module 94 95 def reset(self): 96 97 "Reset the state of the translator." 98 99 # The code itself. This is limited to the code for a particular block 100 # being processed. 101 102 self.blocks = [] 103 104 # Information about temporary values. 105 106 self.temp_positions = set() 107 self.max_temp_position = -1 108 109 # Information about instructions which construct frames. 110 111 self.frame_makers = [] 112 113 # Optimiser state must be reset for each unit. 114 115 self.optimiser.reset() 116 117 def get_module_code(self, final=0): 118 119 """ 120 Return the top-level module code including finalising code if 'final' is 121 set to a true value. 122 """ 123 124 self.unit = self.module 125 self.reset() 126 127 block = self.new_block() 128 self.set_block(block) 129 130 if self.module.module is not None: 131 self.dispatch(self.module.module) 132 133 # Finish off the translated program if appropriate. 134 135 if final: 136 self.new_op(Return()) 137 138 self.unit.temp_usage = self.max_temp_position + 1 139 self.unit.blocks = self.blocks 140 return self.blocks 141 142 def get_code(self, unit): 143 144 "Return the code for the given 'unit'." 145 146 self.unit = unit 147 self.reset() 148 149 block = self.new_block() 150 self.set_block(block) 151 152 if unit.astnode is not None: 153 self.dispatch(unit.astnode) 154 155 self.unit.temp_usage = self.max_temp_position + 2 # include space for instantiators to expand backwards 156 self.unit.blocks = self.blocks 157 return self.blocks 158 159 def get_instantiator_code(self, cls): 160 161 "Return the code for the given class 'cls'." 162 163 self.unit = cls.get_instantiator() 164 self.reset() 165 166 block = self.new_block() 167 self.set_block(block) 168 169 init_method = cls.get_init_method() 170 171 # Convert this frame back to being an invocation frame. 172 173 self.new_op(RecoverFrame()) 174 175 # Fix the current frame to include a new storage slot at the beginning. 176 177 self.new_op(AdjustFrame(-1)) 178 179 # Make an object. 180 181 self.make_object(cls, len(cls.instance_attributes())) 182 self.new_op(StoreFrame(0)) 183 184 # Invoke the appropriate initialiser. 185 186 self.new_op(LoadConst(init_method)) 187 self.new_op(LoadCallable()) 188 self.new_op(JumpWithFrame()) 189 190 # Store the object as the result. 191 192 self.new_op(LoadName(init_method.all_locals()["self"])) # load the context in the invocation frame 193 self.new_op(StoreResult()) 194 195 # Fix the current frame to release the storage slot at the beginning. 196 197 self.new_op(AdjustFrame(1)) 198 self.new_op(Return()) 199 200 self.unit.blocks = self.blocks 201 return self.blocks 202 203 # Visitor methods. 204 205 def default(self, node, *args): 206 raise TranslateError(self.module.full_name(), node, "Node class %r is not supported." % node.__class__) 207 208 def dispatch(self, node, *args): 209 return ASTVisitor.dispatch(self, node, *args) 210 211 # Concrete visitor methods. 212 213 # Binary operators. 214 215 visitAdd = Helper._visitBinary 216 visitBitand = Helper._visitBinary 217 visitBitor = Helper._visitBinary 218 visitBitxor = Helper._visitBinary 219 visitDiv = Helper._visitBinary 220 visitFloorDiv = Helper._visitBinary 221 visitLeftShift = Helper._visitBinary 222 visitMod = Helper._visitBinary 223 visitMul = Helper._visitBinary 224 visitPower = Helper._visitBinary 225 visitRightShift = Helper._visitBinary 226 visitSub = Helper._visitBinary 227 228 # Unary operators. 229 230 visitInvert = Helper._visitUnary 231 visitUnaryAdd = Helper._visitUnary 232 visitUnarySub = Helper._visitUnary 233 234 # Logical operators. 235 236 def visitAnd(self, node): 237 end_block = self.new_block() 238 temp_pos = self.reserve_temp() 239 temp = LoadTemp(temp_pos) 240 241 for n in node.nodes[:-1]: 242 self.dispatch(n) 243 self.new_op(StoreTemp(temp_pos)) 244 245 self._generateTestBoolean(n, temp) 246 self.new_op(JumpIfFalse(end_block)) 247 248 self.dispatch(node.nodes[-1]) 249 self.new_op(StoreTemp(temp_pos)) 250 251 self.set_block(end_block) 252 253 self.new_op(temp) 254 self.discard_temp(temp) 255 256 def visitNot(self, node): 257 self.dispatch(node.expr) 258 259 temp = self.optimiser.optimise_temp_storage() 260 self._generateTestBoolean(node.expr, temp) 261 self.discard_temp(temp) 262 263 self.new_op(InvertBoolean()) 264 self._generateLoadBoolean(node) 265 266 def visitOr(self, node): 267 end_block = self.new_block() 268 temp_pos = self.reserve_temp() 269 temp = LoadTemp(temp_pos) 270 271 for n in node.nodes[:-1]: 272 self.dispatch(n) 273 self.new_op(StoreTemp(temp_pos)) 274 275 self._generateTestBoolean(n, temp) 276 self.new_op(JumpIfTrue(end_block)) 277 278 self.dispatch(node.nodes[-1]) 279 self.new_op(StoreTemp(temp_pos)) 280 281 self.set_block(end_block) 282 283 self.new_op(temp) 284 self.discard_temp(temp) 285 286 # Comparisons. 287 288 def visitCompare(self, node): 289 290 """ 291 _t1 = node.expr 292 _t1 op1 _t2 and _t2 op2 _t3 and ... 293 """ 294 295 end_block = self.new_block() 296 297 self.dispatch(node.expr) 298 temp2 = self.optimiser.optimise_temp_storage() 299 300 # NOTE: Replicated by some code in micropython.inspect.visitCompare. 301 302 last_op = node.ops[-1] 303 304 for op in node.ops: 305 op_name, next_node = op 306 methods = comparison_methods[op_name] 307 308 # Propagate the arguments as we traverse the construct. 309 310 temp1 = temp2 311 self.dispatch(next_node) 312 temp2 = self.optimiser.optimise_temp_storage() 313 314 # Use the appropriate mechanism, setting the boolean status for the 315 # comparison. 316 317 if methods is not None: 318 left_method, right_method = methods 319 320 # Generate method call using evaluated argument and next node. 321 322 temp_result = self._generateBinary(node, temp1, temp2, left_method, right_method) 323 self.new_op(temp_result) 324 self._generateTestBoolean(node, temp_result) 325 self.discard_temp(temp_result) 326 327 else: 328 # Deal with the special operators. 329 330 if op_name.startswith("is"): 331 self.new_op(temp1) 332 self.record_value() 333 self.new_op(temp2) 334 self.new_op(TestIdentity()) 335 self.set_source() 336 self.discard_value() 337 338 elif op_name.endswith("in"): 339 self.new_op(temp2) 340 341 # Get method on temp2. 342 343 self._generateAttr(node, "__contains__", self.attribute_load_instructions) 344 temp_method = self.optimiser.optimise_temp_storage() 345 346 # Add arguments. 347 # NOTE: No support for defaults. 348 349 self._startCallFunc() 350 self.new_op(temp2) 351 self.new_op(StoreFrame(0)) 352 self.new_op(temp1) 353 self.new_op(StoreFrame(1)) 354 self._endCallFuncArgs(2) 355 self._doCallFunc(temp_method) 356 self._endCallFunc(temp_method) 357 358 temp_result = self.get_temp() 359 self._generateTestBoolean(node, temp_result) 360 self.discard_temp(temp_result) 361 362 if op_name.find("not") != -1: 363 self.new_op(InvertBoolean()) 364 365 # Test the result and jump to the end block if false. 366 367 if op is not last_op: 368 self.new_op(JumpIfFalse(end_block)) 369 370 # Compilation duties... 371 372 self.discard_temp(temp1) 373 374 self.discard_temp(temp2) 375 376 # With the status set above, produce a boolean result. 377 378 self.set_block(end_block) 379 380 # Yield the appropriate value. 381 382 self._generateLoadBoolean(node) 383 384 # Expressions. 385 386 def visitBackquote(self, node): raise TranslationNotImplementedError(self.module.full_name(), node, "Backquote") 387 388 def visitCallFunc(self, node): 389 390 """ 391 Evaluate positional arguments, evaluate and store keyword arguments in 392 the correct location, then invoke the function. 393 """ 394 395 # Mark the frame, evaluate the target, generate the call. 396 397 self._startCallFunc() 398 self.dispatch(node.node) 399 temp, target = self._generateCallFunc(node.args, node) 400 self._doCallFunc(temp, target) 401 self._endCallFunc(temp, target) 402 403 def visitConst(self, node): 404 const = self.importer.get_constant(node.value) 405 self.new_op(LoadConst(const)) 406 407 def visitDict(self, node): raise TranslationNotImplementedError(self.module.full_name(), node, "Dict") 408 409 def visitEllipsis(self, node): raise TranslationNotImplementedError(self.module.full_name(), node, "Ellipsis") 410 411 def visitExec(self, node): raise TranslationNotImplementedError(self.module.full_name(), node, "Exec") 412 413 def visitExpression(self, node): raise TranslationNotImplementedError(self.module.full_name(), node, "Expression") 414 415 def visitGenExpr(self, node): raise TranslationNotImplementedError(self.module.full_name(), node, "GenExpr") 416 417 def visitGenExprFor(self, node): raise TranslationNotImplementedError(self.module.full_name(), node, "GenExprFor") 418 419 def visitGenExprIf(self, node): raise TranslationNotImplementedError(self.module.full_name(), node, "GenExprIf") 420 421 def visitGenExprInner(self, node): raise TranslationNotImplementedError(self.module.full_name(), node, "GenExprInner") 422 423 def visitGetattr(self, node): 424 self._visitAttr(node, self.attribute_load_instructions) 425 426 def visitList(self, node): 427 self._generateSequence("list", node) 428 429 def visitListComp(self, node): raise TranslationNotImplementedError(self.module.full_name(), node, "ListComp") 430 431 def visitListCompFor(self, node): raise TranslationNotImplementedError(self.module.full_name(), node, "ListCompFor") 432 433 def visitListCompIf(self, node): raise TranslationNotImplementedError(self.module.full_name(), node, "ListCompIf") 434 435 def visitName(self, node): 436 if self.importer.predefined_constants.has_key(node.name): 437 const = self.importer.get_predefined_constant(node.name) 438 self.new_op(LoadConst(const)) 439 else: 440 self._visitName(node, self.name_load_instructions) 441 442 def visitSlice(self, node): raise TranslationNotImplementedError(self.module.full_name(), node, "Slice") 443 444 def visitSubscript(self, node): 445 self.dispatch(node.expr) 446 self._startCallFunc() 447 self._generateAttr(node, "__getitem__", self.attribute_load_instructions) 448 temp, target = self._generateCallFunc(node.subs, node) 449 self._doCallFunc(temp, target) 450 self._endCallFunc(temp, target) 451 452 def visitTuple(self, node): 453 self._generateSequence("tuple", node) 454 455 # Definitions. 456 457 def visitAssign(self, node): 458 459 """ 460 Evaluate the expression from the given 'node' and assign it to the 461 associated recipients. 462 """ 463 464 self.dispatch(node.expr) 465 466 # Record the value and then dispatch to the assignment targets. 467 468 self.record_value(self.has_immediate_usage(node.nodes)) 469 470 for n in node.nodes: 471 self.dispatch(n) 472 473 self.discard_value() 474 475 def visitAssAttr(self, node): 476 477 "Assign the assignment expression to the recipient 'node'." 478 479 self._visitAttr(node, self.attribute_store_instructions) 480 self.set_source() 481 482 def visitAssList(self, node): 483 484 """ 485 Assign items from the assignment expression to each of the recipients 486 found within the given 'node'. 487 """ 488 489 for i, n in enumerate(node.nodes): 490 self._startCallFunc() 491 self.new_op(self.expr_temp[-1]) 492 self._generateAttr(node, "__getitem__", self.attribute_load_instructions) 493 temp, target = self._generateCallFunc([compiler.ast.Const(i)], node) 494 self._doCallFunc(temp, target) 495 self._endCallFunc(temp, target) 496 497 # Provide a different source value. 498 # NOTE: Permitting immediate usage given that neither name nor 499 # NOTE: attribute accesses should involve a function call 500 # NOTE: overwriting the above result. 501 502 self.record_value(self.is_immediate_user(n)) 503 self.dispatch(n) 504 self.discard_value() 505 506 def visitAssName(self, node): 507 508 "Assign the assignment expression to the recipient 'node'." 509 510 self._visitName(node, self.name_store_instructions) 511 self.set_source() 512 513 visitAssTuple = visitAssList 514 515 def visitAugAssign(self, node): 516 use_binary_block = self.new_block() 517 end_block = self.new_block() 518 519 # Evaluate the expression. 520 521 self.dispatch(node.expr) 522 temp2 = self.optimiser.optimise_temp_storage() 523 524 # Evaluate the target. 525 526 self.dispatch(node.node) 527 temp1 = self.optimiser.optimise_temp_storage() 528 529 # Find the augmented assignment method and attempt to use it. 530 531 aug_method, (left_method, right_method) = augassign_methods[node.op] 532 temp_out = self._generateOpMethod(node, temp1, temp2, aug_method, use_binary_block, end_block) 533 self.discard_temp(temp_out) # NOTE: Will re-use the same storage. 534 535 # Where no such method exists, use the binary operator methods. 536 537 self.set_block(use_binary_block) 538 temp_out = self._generateBinary(node, temp1, temp2, left_method, right_method) 539 540 # Assign the result to the name. 541 542 self.set_block(end_block) 543 self.new_op(temp_out) 544 self.record_value(1) 545 546 if isinstance(node.node, compiler.ast.Name): 547 self.visitAssName(node.node) 548 elif isinstance(node.node, compiler.ast.Getattr): 549 self.visitAssAttr(node.node) 550 else: 551 raise TranslationNotImplementedError(self.module.full_name(), node, "AugAssign(Slice or Subscript)") 552 553 self.discard_value() 554 555 # Compilation duties... 556 557 self.discard_temp(temp1) 558 self.discard_temp(temp2) 559 560 def visitClass(self, node): 561 if not node.unit.referenced: 562 return 563 564 # Store the name. 565 566 self.new_op(LoadConst(node.unit)) 567 self.record_value() 568 self._visitName(node, self.name_store_instructions) 569 self.set_source() 570 self.discard_value() 571 572 # Visit the code. 573 574 unit = self.unit 575 self.unit = node.unit 576 self.dispatch(node.code) 577 self.unit = unit 578 579 def visitDecorators(self, node): raise TranslationNotImplementedError(self.module.full_name(), node, "Decorators") 580 581 def visitFrom(self, node): pass 582 583 def visitFunction(self, node): 584 if not node.unit.referenced and (not node.unit.is_method() or not node.unit.parent.has_key(node.unit.name)): 585 return 586 587 # Only store the name when visiting this node from outside. 588 589 if self.unit is not node.unit: 590 self.new_op(LoadConst(node.unit)) 591 592 self.record_value() 593 self._visitName(node, self.name_store_instructions) # AssName equivalent 594 self.set_source() 595 self.discard_value() 596 597 self._generateFunctionDefaults(node.unit) 598 599 # Visiting of the code occurs when get_code is invoked on this node. 600 601 else: 602 body_block = self.new_block() 603 604 # Check frames using the function's details. 605 606 fn = node.unit 607 nparams = len(fn.positional_names) 608 ndefaults = len(fn.defaults) 609 610 self.new_op(CheckFrame((nparams, ndefaults, fn.has_star))) 611 if ndefaults > 0: 612 self.new_op(FillDefaults((nparams, ndefaults, fn))) 613 614 # Produce the body. 615 616 self.set_block(body_block) 617 618 extend = ExtendFrame() 619 self.new_op(extend) 620 621 self.dispatch(node.code) 622 623 if not isinstance(self.last_op(), Return): 624 self.dispatch(compiler.ast.Name("None")) 625 self.new_op(StoreResult()) 626 self.new_op(Return()) 627 628 # Make sure that enough frame space is reserved from the start. 629 630 self.set_frame_usage(node, extend) 631 632 def visitGlobal(self, node): pass 633 634 def visitImport(self, node): pass 635 636 def visitKeyword(self, node): pass 637 638 def visitLambda(self, node): 639 640 """ 641 Lambda functions can be represented as globally defined functions 642 provided they do not define any default parameter values, since these 643 may defined in a non-global scope. 644 645 Where defaults are defined, an object must be created and its content 646 defined: the callable member of the object's structure must be set to 647 the lambda function definition; each default must be attached to the 648 object as an attribute, as is the case with normal functions and 649 methods. 650 """ 651 652 # Produce the reference to this function when visiting this node from 653 # outside. 654 655 if self.unit is not node.unit: 656 temp = self._generateFunctionDefaults(node.unit) 657 self.new_op(LoadConst(node.unit)) 658 659 # Populate the new object required for the function. 660 661 if temp is not None: 662 self.new_op(LoadCallable()) 663 self.new_op(temp) 664 self.new_op(StoreCallable()) 665 666 self.new_op(temp) 667 #self.discard_temp(temp) 668 669 # Visiting of the code occurs when get_code is invoked on this node. 670 671 else: 672 body_block = self.new_block() 673 674 # Check frames using the function's details. 675 676 fn = node.unit 677 nparams = len(fn.positional_names) 678 ndefaults = len(fn.defaults) 679 680 self.new_op(CheckFrame((nparams, ndefaults, fn.has_star))) 681 if ndefaults > 0: 682 self.new_op(FillDefaults((nparams, ndefaults, fn))) 683 684 # Produce the body. 685 686 self.set_block(body_block) 687 688 extend = ExtendFrame() 689 self.new_op(extend) 690 691 self.dispatch(node.code) 692 693 self.new_op(StoreResult()) 694 self.new_op(Return()) 695 696 # Make sure that enough frame space is reserved from the start. 697 698 self.set_frame_usage(node, extend) 699 700 def visitModule(self, node): 701 extend = ExtendFrame() 702 self.new_op(extend) 703 self.dispatch(node.node) 704 self.set_frame_usage(node, extend) 705 706 # Statements. 707 708 def visitStmt(self, node): 709 710 "Process the collection of statements provided by 'node'." 711 712 for n in node.nodes: 713 714 # Process the statement. 715 716 self.dispatch(n) 717 718 # Discard temporary storage. 719 720 if self.temp_positions: 721 #print "Had temp", self.temp_positions 722 self.temp_positions = set() 723 724 # Prevent incorrect optimisation by resetting the optimiser after 725 # each statement. 726 727 self.optimiser.reset() 728 729 def visitAssert(self, node): raise TranslationNotImplementedError(self.module.full_name(), node, "Assert") 730 731 def visitBreak(self, node): 732 next_block, exit_block = self.get_loop_blocks() 733 self.new_op(Jump(exit_block)) 734 735 def visitContinue(self, node): 736 next_block, exit_block = self.get_loop_blocks() 737 self.new_op(Jump(next_block)) 738 739 def visitDiscard(self, node): 740 self.dispatch(node.expr) 741 self.optimiser.optimise_unused_results() 742 743 def visitFor(self, node): 744 next_handler_block = self.new_block() 745 end_handler_block = self.new_block() 746 exit_block = self.new_block() 747 next_block = self.new_block() 748 else_block = self.new_block() 749 750 # Get the "list" to be iterated over, obtain its iterator. 751 752 self._startCallFunc() 753 self.dispatch(node.list) 754 self._generateAttr(node, "__iter__", self.attribute_load_instructions) 755 temp, target = self._generateCallFunc([], node) 756 self._doCallFunc(temp, target) 757 self._endCallFunc(temp, target) 758 759 temp_iterator = self.optimiser.optimise_temp_storage() 760 761 # In the loop... 762 763 self.set_block(next_block) 764 765 # Handle exceptions when calling "next"... 766 767 self.new_op(PushHandler(next_handler_block)) 768 769 # Use the iterator to get the next value. 770 771 self._startCallFunc() 772 self.new_op(temp_iterator) 773 self._generateAttr(node, "next", self.attribute_load_instructions) 774 temp, target = self._generateCallFunc([], node) 775 self._doCallFunc(temp, target) 776 self._endCallFunc(temp, target) 777 778 # Record the value to be assigned. 779 780 self.record_value() 781 782 # Skip the handler where the call was successful. 783 784 self.new_op(Jump(end_handler_block)) 785 786 # Enter the exception handler. 787 788 self.set_block(next_handler_block) 789 self.new_op(PopHandler()) 790 791 # Test for StopIteration. 792 793 self.load_builtin("StopIteration", node) 794 self.new_op(CheckException()) 795 if node.else_ is not None: 796 self.new_op(JumpIfTrue(else_block)) 797 else: 798 self.new_op(JumpIfTrue(exit_block)) 799 800 # Re-raise the exception otherwise. 801 802 self.new_op(RaiseException()) 803 804 # After the handler. 805 806 self.set_block(end_handler_block) 807 808 # Assign to the target. 809 810 self.dispatch(node.assign) 811 self.discard_value() 812 813 # Process the body with the current next and exit points. 814 815 self.add_loop_blocks(next_block, exit_block) 816 self.dispatch(node.body) 817 self.drop_loop_blocks() 818 819 # Repeat the loop. 820 821 self.new_op(Jump(next_block)) 822 823 # Produce the "else" section. 824 825 if node.else_ is not None: 826 self.set_block(exit_block) 827 828 self.dispatch(node.else_) 829 830 # After the loop... 831 832 self.set_block(exit_block) 833 834 # Compilation duties... 835 836 self.discard_temp(temp_iterator) 837 838 def visitIf(self, node): 839 first = 1 840 exit_block = self.new_block() 841 842 clauses = node.tests + [(None, node.else_)] 843 last_clause = clauses[-1] 844 845 for clause in clauses: 846 test, body = clause 847 if body is None: 848 break 849 if not first: 850 self.set_block(next_block) 851 if test is not None: 852 self.dispatch(test) 853 next_block = self.new_block() 854 self.new_op(JumpIfFalse(next_block)) 855 self.dispatch(body) 856 if clause is not last_clause: 857 self.new_op(Jump(exit_block)) 858 859 first = 0 860 861 self.set_block(exit_block) 862 863 def visitPass(self, node): pass 864 865 def visitPrint(self, node): raise TranslationNotImplementedError(self.module.full_name(), node, "Print") 866 867 def visitPrintnl(self, node): raise TranslationNotImplementedError(self.module.full_name(), node, "Printnl") 868 869 def visitRaise(self, node): 870 # NOTE: expr1 only => instance provided 871 self.dispatch(node.expr1) 872 873 if node.expr2 is not None: 874 temp = self.optimiser.optimise_temp_storage() 875 876 self.dispatch(node.expr2) 877 temp_arg = self.optimiser.optimise_temp_storage() 878 879 self._startCallFunc() 880 self.new_op(temp_arg) 881 self.new_op(StoreFrame(0)) 882 self._endCallFuncArgs(1) 883 self._doCallFunc(temp) 884 self._endCallFunc(temp) 885 886 self.discard_temp(temp_arg) 887 888 self.new_op(StoreException()) 889 self.new_op(RaiseException()) 890 891 def visitReturn(self, node): 892 if node.value is not None: 893 self.dispatch(node.value) 894 else: 895 self.dispatch(compiler.ast.Name("None")) 896 897 self.new_op(StoreResult()) 898 self.new_op(Return()) 899 900 def visitTryExcept(self, node): 901 exit_block = self.new_block() 902 else_block = self.new_block() 903 handler_block = self.new_block() 904 905 self.add_exception_blocks(handler_block, exit_block) 906 907 # Try... 908 # Produce the code, then jump to the exit. 909 910 self.new_op(PushHandler(handler_block)) 911 self.dispatch(node.body) 912 self.new_op(PopHandler()) 913 914 if node.else_ is not None: 915 self.new_op(Jump(else_block)) 916 else: 917 self.new_op(Jump(exit_block)) 918 919 # Start of handlers. 920 921 self.set_block(handler_block) 922 923 self.new_op(PopHandler()) 924 925 for name, assignment, handler in node.handlers: 926 next_block = self.new_block() 927 928 # Test the given exception against the current exception. 929 930 if name is not None: 931 self.dispatch(name) 932 933 self.new_op(CheckException()) 934 self.new_op(JumpIfFalse(next_block)) 935 936 # Handle assignment to exception variable. 937 938 if assignment is not None: 939 self.new_op(LoadException()) 940 941 # Record the value to be assigned. 942 943 self.record_value() 944 self.dispatch(assignment) 945 self.discard_value() 946 947 # Produce the handler code, then jump to the exit. 948 949 self.dispatch(handler) 950 self.new_op(Jump(exit_block)) 951 952 self.set_block(next_block) 953 954 # Unhandled exceptions. 955 956 self.new_op(RaiseException()) 957 958 # Optional else clause. 959 960 if node.else_ is not None: 961 self.set_block(else_block) 962 963 self.dispatch(node.else_) 964 965 self.set_block(exit_block) 966 self.drop_exception_blocks() 967 968 def visitTryFinally(self, node): raise TranslationNotImplementedError(self.module.full_name(), node, "TryFinally") 969 970 def visitWhile(self, node): 971 exit_block = self.new_block() 972 next_block = self.new_block() 973 else_block = self.new_block() 974 975 self.set_block(next_block) 976 self.dispatch(node.test) 977 if node.else_ is not None: 978 self.new_op(JumpIfFalse(else_block)) 979 else: 980 self.new_op(JumpIfFalse(exit_block)) 981 982 self.add_loop_blocks(next_block, exit_block) 983 984 self.dispatch(node.body) 985 self.new_op(Jump(next_block)) 986 987 if node.else_ is not None: 988 self.set_block(else_block) 989 990 self.dispatch(node.else_) 991 992 self.set_block(exit_block) 993 994 self.drop_loop_blocks() 995 996 def visitWith(self, node): raise TranslationNotImplementedError(self.module.full_name(), node, "With") 997 998 def visitYield(self, node): raise TranslationNotImplementedError(self.module.full_name(), node, "Yield") 999 1000 # vim: tabstop=4 expandtab shiftwidth=4