# `pp`
a preprocessor
`pp` allows embedding
`sh` code in files of any type by nesting it inside the `#!\n` token,
where `\n` is a new line. That means that if you'd like a simple loop
or an `if` inside an HTML file for instance,
you could use `pp`.
## Usage
For the following code:
pp example
#!
i=1
while test $i -le 10
do
if test $((i % 2)) -eq 0
then
#!
$i
#!
else
#!
$i
#!
fi
i=$((i + 1))
done
#!
`pp` outputs:
pp example
1
2
3
4
5
6
7
8
9
10
## Arguments
You can also pass arguments to it by appending them to the command call:
$1
#!
echo $2
#!
Calling the above code with
`pp tmp.upphtml 'pp example' 'hello, world'`
will result in:
pp example
hello world
## Pipes
`pp`'s `stdin` is sent to the child
[`sh`](https://pubs.opengroup.org/onlinepubs/9699919799/utilities/sh.html)
pp example
#!
cat
#!
`echo 'hello, world' | pp tmp.upphtml` will output:
pp example
hello, world
## Debugging
`pp` also takes an optional `-d` flag. If passed, `pp` will dump
the generated
[`sh`](https://pubs.opengroup.org/onlinepubs/9699919799/utilities/sh.html)
code instead of executing it:
pp example
#!
i=1
while test $i -le 10
do
if test $((i % 2)) -eq 0
then
#!
$i
#!
else
#!
$i
#!
fi
i=$((i + 1))
done
#!
`pp -d tmp.upphtml` will output:
echo "
pp example
"
i=1
while test $i -le 10
do
if test $((i % 2)) -eq 0
then
echo "
$i
"
else
echo "
$i
"
fi
i=$((i + 1))
done
echo "
"
## Example
ppHome
#!
addcls() {
sed "s///g"
}
smu README | addcls
#!
Files
#!
for f in *
do
case $f in
*.upp*|*.html|*.tgz)
continue
;;
esac
#!