🌈 ~khtdr/

pageboy

Write your shell scripts in any combination of scripting languages.

Example Script example.pb

#!/usr/bin/env pageboy
echo in Bash
$PAGE php
echo back to Bash

#!/usr/bin/env php
<?php echo "in PHP\n";

Running the following, produces:

chmod +x ./example.pb
./example.pb

in Bash
in PHP
back to Bash

You can mix and match all you want. If your script uses valid shebangs, it will work. If it doesn’t, it’s a bug and please let me know. It also supports the (not quite right) awk shebang: #!/usr/bin/env awk.

Test suite status

./run-tests.sh

pageboy-v2.1.3
    ./pageboy-test            # runs as pageboy script
    ./pageboy-test -r <page>  # runs requested page
    ./pageboy-test -p <page>  # prints requested page
    ./pageboy-test -c         # compiles to bash script
    ./pageboy-test -d         # dumps page table
    ./pageboy-test -h         # shows this message
https://github.com/khtdr/pageboy
./tests/aliased.pb ... passed
./tests/args.pb ... passed
./tests/awk.pb ... passed
./tests/confusing.pb ... passed
./tests/dump.pb ... passed
./tests/lots.pb ... passed
./tests/named.pb ... passed
./tests/pageboy.pb ... passed
./tests/paths.pb ... passed
./tests/plain-bash.pb ... passed
./tests/print-php.pb ... passed
./tests/pwd.pb ... passed
./tests/run-php.pb ... passed
./tests/version.pb ... passed

Installation & quickstart

1. Current version: 2.1.3
2. Download the pageboy bash script and put into your $PATH (ie. ~/bin/).
3. Start using #!/usr/bin/env pageboy as your shebang line in your bash scripts.
4. Call other “pages” of your script by using the pre-defined $PAGE command in your scripts.

#!/usr/bin/env pageboy
$PAGE php | wc

#!/usr/bin/env php
<?php
phpinfo();

 934    3524   29671

If you want multiple pages of the same language, append an index, starting at 1, to the pagename.

#!/usr/bin/env pageboy
cat <($PAGE php1) <($PAGE php2)

#!/usr/bin/env php
<?php echo "one";

#!/usr/bin/env php
<?php echo "two";

onetwo

You can distribute a version of your script without the dependency on pageboy by compiling it:

# copy above into `onetwo.pb`
onetwo.pb -c > onetwo.sh
chmod +x ./onetwo.sh
./onetwo.sh

onetwo

Big Example

#!/usr/bin/env pageboy
cat <($PAGE php) <($PAGE ruby) <($PAGE bash1) <($PAGE bash2) <($PAGE php2)

#!/usr/bin/env php
<?php
for ($i=10; $i<=20; $i++) {
  echo $i . "\n";
}

#!/usr/bin/env ruby
5.times do
  puts "Hello, World! ~ruby1"
end

#!/bin/bash
echo "Hello, World! ~bash2"
whoami

#!/usr/bin/env bash
env | grep TERM

#!/usr/bin/env php
<?php
echo __DIR__;

10
11
12
13
14
15
16
17
18
19
20
Hello, World! ~ruby1
Hello, World! ~ruby1
Hello, World! ~ruby1
Hello, World! ~ruby1
Hello, World! ~ruby1
Hello, World! ~bash2
khtdr
TERM_PROGRAM=iTerm.app
TERM=xterm-256color
ITERM_PROFILE=Default
ITERM_SESSION_ID=w0t0p0
/home/khtdr/

Standard features

pageboy -h

pageboy-v2.1.3
    pageboy            # runs as pageboy script
    pageboy -r <page>  # runs requested page
    pageboy -p <page>  # prints requested page
    pageboy -c         # compiles to bash script
    pageboy -d         # dumps page table
    pageboy -h         # shows this message
https://github.com/khtdr/pageboy

More examples can be found in the tests directory.

Advanced features

• Pages can be named, see pageboy/tests/named.pb
• Args can be passed in, see pageboy/tests/args.pb

The full source code and examples are available at: khtdr/pageboy