bpp
Class BPP

java.lang.Object
  bpp.BPP

public class BPP

extends java.lang.Object

This is the main preprocessor class. See main() for command line arguments.

The Beanshell Preprocessor
Copyright (C) 2003-2004 Warren D. MacEvoy jr.

Field Summary

static boolean

DEBUG If the bpp.debug property is a non-emtpy string, this is initialized to true.

Constructor Summary

BPP()

Method Summary

static void

main(java.lang.String[] args) Command-line interface for the preprocessor.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DEBUG

public static boolean DEBUG

If the bpp.debug property is a non-emtpy string, this is initialized to true.

Constructor Detail

BPP

public BPP()

Method Detail

main

public static void main(java.lang.String[] args)
                 throws java.lang.Exception

Command-line interface for the preprocessor. See http://bpp.sourceforge.net for tutorials and information on using BPP.

Examples

Example 1. Process all bpp files in in a directory:

java -jar bp.jar *.bpp
The default output file is the same as the input file, except that the .bpp extension is removed, so a file called Thing.java.bpp will be preprocessed to produce Thing.java.

Example 2. Create beanshell script from a source file:

java -jar bp.jar -b thing.bpp thang.jpp
Files with a .bpp exension will produce .bsh extensions, and .jpp extensions will produce .java extensions. The internal translations are the same for either extension.

Command Line Arguments

Command line arguments are:

-q

Quote exact by default. Lines with no particular translation code in column 1 are translated exactly by default.

-qq

Quote magically by default. Lines with no particular translation code in column 1 are translated magically by default. This is the standard behavior of BPP.

-b

Generate (but do not execute) beanshell script

Source extension	Default output extension
.bpp	.bsh
.jpp	.java
This is equivalent to -s 2.

+b

Send beanshell script through bsh and save output generated by script instead. If the source file ends in .bpp and no output file is specified, then the output file is the same as the input file with the extendsion deleted. Otherwise the output is sent to the standard output.
This is equivalent to -s 0.

-o file

Specify output file ("-" for stdout).

-s stage

Generate output from given stage only:
Stage	0	1	2	3	4	5
Filter	None	beanshell # interpreter	beanshell # decorator	beanshell ## interpreter	beanshell ## decorator	...
The decorator filters take input and produces output suitable for running through beanshell. The interpreter filters are beanshell interpreters executing those scripts.

-maxline value

Use this as the maximum line length for the preprocessor instead of the DEFAULT_MAX_LINE_LENGTH.

-Dname=value

Set system property (available as System.getProperty(name)).

+cp=globbed-paths

Add these to the classpath for each BeanShell interpreter. Paths are separated by a ; and path parts are separated by a /. See Unglobber for globbing patterns. I like -cp=--/bpp/bin/++/*.jar;--/bpp/bin/++/classes. This class path will adjust the class path used by BeanShell, not for BeanShell. The BPP and BeanShell jar must appear in the standard class path.

-a arg

Add arg to the list of args passed to each bsh interpreter. (available as BPP.args)

-z

Empty the arg list passed to each bsh interpreter.

-u

Use the specified class for the specified stage. Only even (decorator) stages can be replaced, and the defined stage must be a subclass of the BeanshellDecoratorFilter and have the same constructor.

Preprocessor automatically defined values:

As a file is preprocessed, the follwing variables are set in beanshell:
• BPP The top BPPFilter.
• BPP.source The source file name.
• BPP.destination The destination file name.
• BPP.args The command-line arguments (configured with -a and -z)
• after The root namespace for the post-processor of this preprocessor stage (defined only if it exists). Tricky to use correctly! Use at your own risk.
• before The root namespace for the pre-processor of this preprocessor (defined only if it exists). Tricky to use correctly! Use at your own risk.

Throws:

java.lang.Exception