Today I intentionally copied a bugGuessing what code is meant to do is hard work.
Today I was rewriting a function. The function makes an HTTP request with a form-encoded request body. But after preparing the body of the reqeust, it runs it through a regular expression to replace
There’s no comment explaining why this is done, so I have to guess.
I have a couple guesses.
- The API we’re calling doesn’t like the array indexes (the
\d+part in the regular expression).
- The API we’re calling doesn’t properly unescape the
- Maybe both?
I really suspect it’s #1. If the case were #2, surely we’d just replace all occurrences of
], not only the occurrences with digits between.
But that leaves the question: Why don’t we replace matches with
%5B%5D=? Why do we un-escape these characters, too?
So what did I do?
I copied this dubious behavior into my new function. Even though it’s sloppy and confusing, it’s probably harmless. And removing it is sure to cause problems, since I don’t know exactly what behavior it’s trying to correct for.
What’s the lesson? Two, I think:
- Make your code obvious. If you can’t explain why the code exists with the function name, use comments.
- Rewrites are dangerous. Code, no matter how poorly organized and ugly, contains months or years of accumulated bug fixes and wisdom. As tempting as it is to rewrite, do it carefully, lest you re-introduce bugs you don’t understand!
Hair cuts and peekaboo
How often do you come across code that look completely superfluous? Like a towel to a toddler during a haircut.
Regular Expressions Are the Best! s/Best/Worst/
Regular Expressions. Ya love 'em or ya hate 'em. But it shouldn't be so black-or-white. Here's when they do, and don't make sense.
Improve your software delivery