org.lsst.ccs.scripting.jython

Class JythonScriptExecutorUtils

java.lang.Object

org.lsst.ccs.scripting.jython.JythonScriptExecutorUtils

public class JythonScriptExecutorUtils
extends Object

Utilities for executing jython scripts in the CCS environment

Author:

The LSST CCS Team

Constructor Summary

Constructors

Constructor and Description
JythonScriptExecutorUtils()

Method Summary

Modifier and Type	Method and Description
static void	executeInteractive() Enter interactive jython accepting commands from stdin.
static void	executeScript(InputStream is, OutputStream out, String... args) Execute in memory the provided script.
static void	executeScript(InputStream is, String... args) Execute in memory the provided script.
static void	executeScript(InputStream is, String fileName, OutputStream out, String... args) Execute the provided script
static void	executeScript(String scriptPath, OutputStream out, String... args) Execute in memory the provided script.
static void	executeScript(String scriptPath, String... args) Execute in memory the provided script.
static String	getArgumentSettingCode(String fileName, String... args) Get Jython exec line to import command line arguments.
static InputStream	getScriptInputStream(String script) Get the InputStream for the provided script path.
static void	handleExecutionException(Throwable e)
static Properties	loadPythonProperties()
static void	main(String[] args)

Methods inherited from class java.lang.Object

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

Constructor Detail

JythonScriptExecutorUtils

public JythonScriptExecutorUtils()

Method Detail

getScriptInputStream

public static InputStream getScriptInputStream(String script)
                                        throws FileNotFoundException

Get the InputStream for the provided script path.

Parameters:

script -

Returns:

Throws:

FileNotFoundException

executeScript

public static void executeScript(String scriptPath,
                                 String... args)
                          throws FileNotFoundException

Execute in memory the provided script.

Parameters:

scriptPath - the path of the script to execute.

args - The command line arguments to be passed to the script.

Throws:

FileNotFoundException

executeScript

public static void executeScript(String scriptPath,
                                 OutputStream out,
                                 String... args)
                          throws FileNotFoundException,
                                 IOException

Execute in memory the provided script.

Parameters:

scriptPath - the path of the script to execute.

out - The output stream for the script output.

args - The command line arguments to be passed to the script.

Throws:

FileNotFoundException

IOException

executeScript

public static void executeScript(InputStream is,
                                 String... args)

Execute in memory the provided script.

Parameters:

is - The Script's InputStream.

args - The command line arguments to be passed to the script.

executeInteractive

public static void executeInteractive()

Enter interactive jython accepting commands from stdin. Optionally execute a "profile.jy" from the bootstrap path if it exists.

executeScript

public static void executeScript(InputStream is,
                                 OutputStream out,
                                 String... args)

Execute in memory the provided script.

Parameters:

is - The Script's InputStream.

out - The output stream for the script output.

args - The command line arguments to be passed to the script.

executeScript

public static void executeScript(InputStream is,
                                 String fileName,
                                 OutputStream out,
                                 String... args)

Execute the provided script

Parameters:

is - The input stream from which to read the script

fileName - The name of the script (for error messages)

out - The output stream to use

args - The command line arguments to be passed to the script.

loadPythonProperties

public static Properties loadPythonProperties()

getArgumentSettingCode

public static String getArgumentSettingCode(String fileName,
                                            String... args)

Get Jython exec line to import command line arguments. In order to do this at the interpreter level we have to execute jython lines to set sys.argv directly on the interpreter.

Parameters:

fileName - The fileName (or null if unknown)

args - The command line arguments

Returns:

The code to be executed to import the arguments in the script.

main

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

Throws:

Exception

handleExecutionException

public static void handleExecutionException(Throwable e)