Powerful pre-processor for text files - powered by JavaScript.

Pangaea works on any kind of text file including HTML pages, source code files, documents, etc. The easy-to-use command line tool lets you effortlessly bake Pangaea into your build process, providing you with an extremely powerful text pre-processor wherever you need it.

This is just a normal text file that has pangaea scripts embedded, e.g. JavaScript:

<pangaea type="text/javascript">
  function name(){
    return "Pangaea";
  }
</pangaea>

We can call the scripts to get the name, which is <%= name() %>.

Other JavaScript also works, so we know that 5 + 10 is <%= 5 + 10 %>.

The above file, when processed will output as:

This is just a normal text file that has scripts embedded:

We can call the scripts to get the name, which is Pangaea.

Other JavaScript also works, so we know that 5 + 10 is 15.

To embed JavaScript, just use the <pangaea> script tag like this:

<pangaea type="text/javascript">
  // code goes here
</pangaea>

For inline script that will print out the return, use the <%= and %> special tags:

My name is <%= name %>.

The pangaea command reads from the standard in pipe, and writes to the standard out pipe.

cat ./example/source.txt | pangaea >> ./example/output.txt

Or you can use it in an interactive mode:

pangaea

• See some examples of how you can use Pangaea.

Pangaea supports parameters that are made available to your scripts via the $$params global object. You can specify parameters using the -params flag and a URL encoded query string:

pangaea -params="name=Mat&age=30"

This will make the $$params["name"] and $$params["age"] variables available to your scripts.

• All parameter values are strings, if you want to use other types you can cast them in your code.

Pangaea comes with a series of useful built-in methods that would otherwise be impossible when running JavaScript in the browser.

(string) $$contentsOf(filename)

<pangaea type="text/javascript">
  var name = $$contentsOf("name.txt");
</pangaea>
My name is <%= name %>.

(string) $$run(command, [arg1, [arg2, [arg3...]]])

<pangaea type="text/javascript">
  var now = $$run("date");
</pangaea>
The date is <%= now %>.

Check out releases, or download the source and build from source using go install.

• Version v0.3.1 for darwin 386 - pangaea-v0.3.1-darwin-386.tar
• Version v0.3.1 for darwin amd64 - pangaea-v0.3.1-darwin-amd64.tar
• Version v0.3.1 for windows 386 - pangaea-v0.3.1-windows-386.tar
• Version v0.3.1 for windows amd64 - pangaea-v0.3.1-windows-amd64.tar

• Keep <pangaea type="text/javascript"> and </pangaea> tags on their own lines
• Please report any issues
• There are no rules

To build and run the command inside the cmd directory, do:

clear; go build -o pangaea; cat ./example/source.txt | ./pangaea >> ./example/output.txt