diff options
| author | Joe Carstairs <me@joeac.net> | 2026-06-17 21:46:49 +0100 |
|---|---|---|
| committer | Joe Carstairs <me@joeac.net> | 2026-06-17 21:48:24 +0100 |
| commit | 6dd4caf947f2997698ebf7354172a6476ad0bf25 (patch) | |
| tree | bcdd557656119dc028234d67396930c124ee0735 /http/pp/README.md | |
| parent | 506d1adfccbb494be598e08f8d45aaae641eb6d2 (diff) | |
adds pp sources
Diffstat (limited to 'http/pp/README.md')
| -rw-r--r-- | http/pp/README.md | 188 |
1 files changed, 188 insertions, 0 deletions
diff --git a/http/pp/README.md b/http/pp/README.md new file mode 100644 index 0000000..f69faf1 --- /dev/null +++ b/http/pp/README.md @@ -0,0 +1,188 @@ +# `pp(1)` + +a preprocessor + +`pp(1)` allows embedding +[`sh(1)`](https://pubs.opengroup.org/onlinepubs/9699919799/utilities/sh.html) +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(1)`. + +## Basic usage + +For the following code: + + <!doctype html> + <title>pp(1) example</title> + <ul> + #! + i=1 + while test $i -le 10 + do + if test $((i % 2)) -eq 0 + then + #! + <li class=even>$i</li> + #! + else + #! + <li class=odd>$i</li> + #! + fi + i=$((i + 1)) + done + #! + </ul> + +`pp(1)` outputs: + + <!doctype html> + <title>pp(1) example</title> + <ul> + <li class=odd>1</li> + <li class=even>2</li> + <li class=odd>3</li> + <li class=even>4</li> + <li class=odd>5</li> + <li class=even>6</li> + <li class=odd>7</li> + <li class=even>8</li> + <li class=odd>9</li> + <li class=even>10</li> + </ul> + +## Arguments + +You can also pass arguments to it by appending them to the command call: + + <!doctype html> + <title>$1</title> + <p> + #! + echo $2 + #! + </p> + +Calling the above code with +`pp tmp.upphtml 'pp(1) example' 'hello, world'` +will result in: + + <!doctype html> + <title>pp(1) example</title> + <p> + hello world + </p> + +## Pipes + +`pp(1)`'s `stdin` is sent to the child +[`sh(1)`](https://pubs.opengroup.org/onlinepubs/9699919799/utilities/sh.html) + + <!doctype html> + <title>pp(1) example</title> + <p> + #! + cat + #! + </p> + +`echo 'hello, world' | pp tmp.upphtml` will output: + + <!doctype html> + <title>pp(1) example</title> + <p> + hello, world + </p> + +## Debugging + +`pp(1)` also takes an optional `-d` flag. If passed, `pp(1)` will dump +the generated +[`sh(1)`](https://pubs.opengroup.org/onlinepubs/9699919799/utilities/sh.html) +code instead of executing it: + + <!doctype html> + <title>pp(1) example</title> + <ul> + #! + i=1 + while test $i -le 10 + do + if test $((i % 2)) -eq 0 + then + #! + <li class=even>$i</li> + #! + else + #! + <li class=odd>$i</li> + #! + fi + i=$((i + 1)) + done + #! + </ul> + +`pp -d tmp.upphtml` will output: + + echo "<!doctype html> + <title>pp(1) example</title> + <ul>" + i=1 + while test $i -le 10 + do + if test $((i % 2)) -eq 0 + then + echo " <li class=even>$i</li>" + else + echo " <li class=odd>$i</li>" + fi + i=$((i + 1)) + done + echo "</ul>" + +## Example + + <!doctype html> + <html lang=en> + <title>pp(1)</title> + <meta charset=UTF-8> + <meta name=viewport content='width=device-width'> + <link rel=stylesheet href=../theme.css> + <body> + <a href=../#myprojects>Home</a> + #! + addcls() { + sed "s/<code>/<code class=language-bash>/g" + } + smu README | addcls + #! + <h2>Files</h2> + <ul> + #! + for f in * + do + case $f in + *.upp*|*.html|*.tgz) + continue + ;; + esac + #! + <li><a href=$f>$f</a></li> + #! + done + #! + </ul> + <h2>Download</h2> + <a href=pp.tgz>pp.tgz</a> + <script src=../prism.js data-manual></script> + <script src=../enhance.js></script> + </body> + </html> + +## See also + +* <https://github.com/radare/spp> +* <https://werc.cat-v.org/docs/rc-template-lang> +* <https://code.9front.org/hg/werc/file/92f7463dac1a/bin/template.awk> |