Bash one-liner using Template Toolkit

| Perl | 3 Comments

I've been doing alot of bash scripting the last few weeks. Struggling with all kinds of nasty problems and error handling stuff, I have discovered what a powerful utility this bash thing is.

Of course, when it comes to powerful scripting languages there's no substitute for Perl. Sometimes certain problems are a bit too complex for bash and it is nice to be able to fall back on Perl.

Let's say that I have an input file config.tmpl with a single line containing [% base_url %] and I want to generate a configuration file config replacing the value of base_url with $BASE_URL as defined earlier in the bash script, e.g. BASE_URL=

One way of managing this is by using good old sed like this:

cat config.tmpl | sed 's!\[% base_url %\]!'$BASE_URL'!' >config

Sure this is fine and dandy, but what do you do if you have multiple lines in config.tmpl which need to be substituted on the fly? This is where Template Toolkit comes to the rescue.

I've added another line in containing [% index_file %] which needs to be replaced with the value of $INDEX_FILE. A bash one-liner with the help of Template Toolkit works wonders:

perl -MTemplate -e '$t = Template->new(); $t->process('config.tmpl', {base_url => '$BASE_URL', index_file => '$INDEX_FILE'})' > config

If you are bit paranoid, you can extend the above one-liner with some error checking just in case:

perl -MTemplate -e '$t = Template->new() || die "$Template::ERROR\n"; $t->process('config.tmpl',{base_url => '$BASE_URL', index_file => '$INDEX_FILE'}) || die $t->error()' >config

Now if you are like me and even more overcautious. one more sanity check is in order. Always expect the worst, and if this worst happens, make sure that you can trouble-shoot the situation quickly and efficiently.

That's why at the beginning of the bash script, I also double-check that the Template Toolkit module is indeed installed.

# Make sure that the Template Toolkit is installed
perl -MTemplate -e1 &>/dev/null
if [ $? -ne 0 ]
    echo Template Toolkit is not installed, please install first.
    exit $?

Isn't the Template Toolkit truly magical? That's why I use it very often to help automate even the most complex chores. Thanks alot Andy.


Hi Kiffin,

Nice to read your blog :)

You might be interested to transform your sed to Perl like this:

cat config.tmpl | perl -ne 's/\[% base_url %\]/\$BASE_URL/;print' > config

The regex and the print are implicitly applied to $_

Also , I have a closer look at '"'"''$X''"'"'
If you write
p as '
q as " then

I tried to write it as pqp___qpp$Xppq___pqp , it was still hard to understand.(ignore the _)
Usually when these problems appear I escape with \

Can you explain how to parse the '"'"''$X''"'"' ?


Leave a comment

Random entries

Here are some random entries that you might be interested in:

Recent Assets

  • embedding-rust-in-nodejs-applications.png
  • finally-golf-again.jpg
  • corona-virus.png
  • long-walk.jpg
  • zonnepanelen.png
  • UC-0122abb7-1b51-422a-9e9b-56c5f86ee741.jpg
  • napolean-the-great.png
  • construct3.png
  • array-tally-ruby-2.7.png
  • ng-be-2019.png

Recent Comments

Golf Handicap


This personal weblog was started way back on July 21, 2001 which means that it is 7-21-2001 old.

So far this blog contains no less than 2388 entries and as many as 1877 comments.

Important events

Graduated from Stanford 6-5-1979 ago.

Kiffin Rockwell was shot down and killed 9-23-1916 ago.

Believe it or not but I am 10-11-1957 young.

First met Thea in Balestrand, Norway 6-14-1980 ago.

Began well-balanced and healthy life style 1-8-2013 ago.

My father passed away 10-20-2000 ago.

My mother passed away 3-27-2018 ago.

Started Gishtech 04-25-2016 ago.