Every Time You Write a Regular Expression You Should Be Required to Put Sample Input in a Comment

There's a reason PERL has a reputation for being unreadable: regular expressions are almost impossible to decipher without any context.

Consider seeing the following in a python script:

conf_regex = " *(\d+) +(\d+\.\d+\.\d+\.\d+)/(\d+) +(\d+\.\d+\.\d+\.\d+) +(\d+) +(.+) *"

From the variable name you can infer it's being used to parse a conf file, but that's about it.  Now compare that to the following:

# regex for parsing conf file, example entry below
# #id     network             addr        port    connections
# 0       155.246.80.0/24     127.0.0.1   5000    0,3
conf_regex = " *(\d+) +(\d+\.\d+\.\d+\.\d+)/(\d+) +(\d+\.\d+\.\d+\.\d+) +(\d+) +(.+) *"

Suddenly it's not so bad.

Comments

Post a Comment

Popular posts from this blog

Terminate Scripted Minicom Session

If you start a minicom session with the -S you can automate a minicom session with runscript.  This starts two separate processes, the minicom process and the runscript process.  If you want to close the minicom session when the script is finished, simply calling exit in the runscript isn't enough. To End the minicom session you have to kill the minicom process, using the ! operator within the script to execute an external command. The easiest method is to run ! killall minicom This isn't recommended if you might have multiple minicom processes running.  A better way is to use pkill to target the correct minicom session ! pkill -f "^minicom conf_file -S script_file$" Where conf_file and script_file are the names of your minicom files.  pkill uses a regex to kill the process that you specify. Of course to use pkill you have to be able to generate the script file dynamically, or make sure you always call minicom with the same command when you use it.  H
Read more

CodinGame: Building an AI to play (and win) at "Penguins"

Image
This November, I came back to the US from visiting South Korea, and while I was self quarantining, I decided to get back into solving puzzles on CodinGame . A game called "Penguins" popped up as the weekly challenge, so I decided to give it a shot. I worked on building an AI for a few days, and made decent progress, but then took a break to compete in the Fall Challenge. After the Fall Challenge was over, I decided to come back to the Penguins game and try to get my AI to first place. I finally achieved my goal on December 3rd! I did this using a variation of Monte Carlo Tree Search with a custom evaluation function for scoring the gamestate. Leaderboard (December 2020) KnightMoves, that's me! What is Penguins? Penguins is a game played on a hexagonal grid, and the goal is to move your penguins around the board and eat as many fish as possible. As you move around, the ice breaks, so you have to be careful not to get trapped or stranded. It's based on the boardgame &q
Read more

Starcraft 2 Galaxy Map Editor - Change the Size of a Building

Image
This tutorial shows how to change the size of a building in the Starcraft 2 Galaxy Editor.  In this example we will modify a Supply Depot to be of size 1x1.  This requires editing 3 different data types for the Supply Depot: the Unit, the Actor, and the Model(s). To get started create a new map and set the type to custom.  Go to View->Show Grid and check the small option.  Now we'll be able to verify that our new Supply Depot is indeed 1x1.  Once that's taken care of hit F7 or go to Modules->Data Editor to fire up the Data Editor. Unit In this section we're going to create a new Supply Depot called Tiny Supply Depot. 1) Select Data Type: Units and find the Supply Depot unit.  You might see several Supply Depot Units with different Sources.  Pick any one, they are the same. 2) Right click the Supply Depot and click Duplicate Unit... Leave Supply Depot checked and don't check anything else.  This will tell our Tiny Supply Depot  to share all of the
Read more