Undebt is a fast, straightforward, reliable tool for performing massive, automated code refactoring used @Yelp. Undebt lets you define complex find-and-replace rules using standard, straightforward Python that can be applied quickly to an entire code base with a simple command.
To learn about what Undebt is and why we created it, check out our post on the Yelp Engineering Blog.
To get started using Undebt, install with
pip install undebt
then head over to our documentation for more information.
While the full list of examples can be found in the documentation, to show you how it's done we'll go in-depth into one example in particular,
class_inherit_object.py. Like most of the examples, this pattern is built for Python, but in theory Undebt could be used with any language. The idea of this pattern is to convert any usage of old-style classes to new-style classes by making all classes that don't inherit from anything else inherit from
object. The code for this pattern is incredibly simple—a mere four lines not counting imports:
grammar = INDENT + Keyword("class").suppress() + NAME + (Optional(LPAREN + RPAREN) + COLON).suppress() @tokens_as_list(assert_len=2) def replace(tokens): return tokens + "class " + tokens + "(object):"
What's going on here? The basic idea is that
grammar defines what to look for, and
replace defines how to change it. Undebt scans your files looking for
grammar, tokenizes the matching text, passes the tokens to
replace, and replaces the original text with the return value. For a more in-depth explanation of how to use
replace in a pattern file, see the pattern files documentation.
In this particular case,
grammar is defined to match an indent (
INDENT), followed by a class definition (
+ Keyword("class") + NAME) that doesn't inherit from anything (
+ Optional(LPAREN + RPAREN) + COLON). Along the way, all the tokens except for the indent and the class name are suppressed, that way
replace only gets those two tokens, which it reassembles into a class definition that inherits from
object. For a full specification of all of the helper objects used here, see the pattern utilities documentation.
To run this pattern on your code:
(1) Install Undebt by entering into your command line
pip install undebt
class_inherit_object as the pattern
undebt --pattern undebt.examples.class_inherit_object <file to undebt> ...
For a complete command line example and the full command line help, see the command line documentation, which includes tips and tricks to show how you how to use Undebt with other common Unix utilities.