Tutorial: Refactoring
Refactoring is a general term for renaming or restructuring code in a way that does not alter its functionality. It is useful for cleaning up code or to prepare code for easier extension or reuse.
Wing implements a number of refactoring operations. Let's try some of these now in example1.py.
Rename Symbol
Click on kCannedData in the import statement at the top of the file and select RenameSymbol from the Refactor menu.
Wing will bring up the refactoring tool and enumerate the points of use for the symbol that you have selected:
Now enter kCannedTuna as the new name to use and press Enter or the RenameChecked button. Wing instantly renames all uses of the symbol.
Move Symbol
Now try moving PromptToContinue into subdir/path_example.py with the MoveSymbol operation. In the refactoring tool, use Browse... to select subdir/path_example.py as the target location and leave Scope set to <moduleglobalscope>. Then press Move&UpdateChecked. Wing moves the point of definition into the target file and introduces the necessary import so it can still be used from example1.py.
Note that the whole module is imported and you would have to manually fix up the import if you instead wished to add the symbol to the existing frompath_exampleimport statement.
Extract Function/Method
Next select the first larger block in ReadPythonNews as follows:
Then select the ExtractFunction/Method refactoring operation and enter ReadNewsCache as the name for a new top-level function. Wing will create a new function and convert the point of use to a call to that function, as follows, inserting all the necessary arguments and return values:
txt=ReadNewsCache(force,newscache)Click on ReadNewsCache and use F4 to visit its point of definition. Then use the history back arrow to get back to the point of use and press Revert in the Refactoring tool to undo this change.
Try it again now after selecting NestedFunction instead to see how that operation differs. Then press Revert again.
Introduce Variable
Wing can also introduce new variables for an expression. For example, select time.time()-mtime in ReadPythonNews and use IntroduceVariable to create a variable called duration. Wing inserts the variable and substitutes it into the original expression:
If there had been multiple instances of time.time()-mtime in the scope, all of them would have been replaced.
Symbol to *
Several refactoring operations are given to easily convert the name of a symbol between UpperCamelCase, lowerCamelCase, under_scored_name, and UNDER_SCORED_NAME naming styles. These work the same way as RenameSymbol but prefill the new symbol name field with the selected style of name.
See the Refactoring documentation for details.
