Skip to content
Python command line utility to easily record WTF moments.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

WTF (╯°□°)╯︵ ┻━┻

Most programmers are familiar with this iconic comic:

WTF Source

And anyone who has ever done code review or even just tried to read code knows how true this is.

WTF. Why?

Well, I've been doing more code reviews lately, and I found myself wishing I had an easy way to record those moments that just make me go: "WTF".

Seriously, though, it's useful to keep a log of your thoughts while doing code review for later summary. I thought it might be even better to timestamp those thoughts. That way, I could quantify exactly how much of my life had been wasted on crappy code. Inspired by the comic above, I also wanted to generate a WTF/min score as a useful (stretching that word) code review benchmark.

It's also just plain cathartic to pound out a WTF or two if ever you find yourself looking at very. bad. code.


WTF is a single, dependency-free Python file. I recommend Python 3.3 and above.

To record a WTF moment, just execute it:


By default this will write a timestamp to a file in the local directory called 'wtfs.txt'.

Want to add some detail about the sheer idiocy that's blowing your mind right now? Just use the --message argument (-m for short). Make sure your message is in quotes (just like git commit -m):

./ -m "Why the hell would someone indent with tabs in this module, when all of the other modules use spaces!? ARG1!@!fk.dfaskdnfasvnowe"

You can change the location of the output file with the --output/-o option:

./ -m "I just can't even." -o code-review-01.txt

And finally, you can get summary stats with the --read/-r options. Just supply the name of the file to read:

./ -r code-review-01.txt

And you'll get an output like this:

Total WTFs: 35
Duration (minutes): 20.54
WTFs/min: 1.704

Run ./ -h to see the complete usage info:

usage: [-h] [-m MESSAGE] [-o OUTFILE] [-r READ]

Easily record WTF moments.

optional arguments:
  -h, --help            show this help message and exit
  -m MESSAGE, --message MESSAGE
                        Record the thing that made you go WTF
  -o OUTFILE, --outfile OUTFILE
                        Specify a filename for your WTF log.
  -r READ, --read READ  Read a WTF log file. Outputs stats and WTFs per
You can’t perform that action at this time.