/*
 * #%L
 * ImageJ software for multidimensional image processing and analysis.
 * %%
 * Copyright (C) 2009 - 2013 Board of Regents of the University of
 * Wisconsin-Madison, Broad Institute of MIT and Harvard, and Max Planck
 * Institute of Molecular Cell Biology and Genetics.
 * %%
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are met:
 * 
 * 1. Redistributions of source code must retain the above copyright notice,
 *    this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright notice,
 *    this list of conditions and the following disclaimer in the documentation
 *    and/or other materials provided with the distribution.
 * 
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE
 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 * POSSIBILITY OF SUCH DAMAGE.
 * 
 * The views and conclusions contained in the software and documentation are
 * those of the authors and should not be interpreted as representing official
 * policies, either expressed or implied, of any organization.
 * #L%
 */

package imagej.script;

import java.io.File;
import java.io.FileNotFoundException;
import java.io.IOException;
import java.io.Reader;
import java.io.Writer;
import java.util.List;

import javax.script.ScriptEngine;
import javax.script.ScriptEngineFactory;
import javax.script.ScriptException;

import org.scijava.plugin.SingletonService;

/**
 * Interface for service that works with scripting languages. This service
 * discovers available scripting languages, and provides convenience methods to
 * interact with them.
 * 
 * @author Johannes Schindelin
 */
public interface ScriptService extends SingletonService<ScriptLanguage> {

	/**
	 * The script service puts the current ImageJ context into the engine's bindings
	 * using this key. That way, scripts can access the context by accessing the global
	 * variable of that name.
	 */
	final static String CONTEXT = "IJ";

	/** Gets the index of available script languages. */
	ScriptLanguageIndex getIndex();

	/**
	 * Gets the available scripting languages, including
	 * {@link ScriptEngineFactory} instances available from the Java scripting
	 * framework itself.
	 * <p>
	 * This method is similar to {@link #getInstances()}, except that
	 * {@link #getInstances()} only returns {@link ScriptLanguage} instances. A
	 * {@link ScriptLanguage} is an ImageJ plugin that implements
	 * {@link ScriptEngineFactory} but also provides additional functionality on
	 * top.
	 * </p>
	 */
	List<ScriptEngineFactory> getLanguages();

	/** TODO */
	ScriptEngineFactory getByFileExtension(final String fileExtension);

	/** TODO */
	ScriptEngineFactory getByName(final String name);

	/** TODO */
	Object eval(final File file) throws FileNotFoundException,
		ScriptException;

	/** TODO */
	Object eval(final String filename, final Reader reader)
			throws IOException, ScriptException;

	/** TODO */
	boolean canHandleFile(final File file);

	/** TODO */
	boolean canHandleFile(final String fileName);

	/** TODO */
	void initialize(final ScriptEngine engine, final String fileName,
			final Writer writer, final Writer errorWriter);

	/** TODO */
	boolean isCompiledLanguage(ScriptEngineFactory currentLanguage);

}


@@ -2531,16 +2531,20 @@
 engine's
+%0A%09 *
  binding
@@ -2544,20 +2544,16 @@
 bindings
-%0A%09 *
  using t
@@ -2604,16 +2604,20 @@
 ntext by
+%0A%09 *
  accessi
@@ -2629,20 +2629,16 @@
 e global
-%0A%09 *
  variabl
@@ -3521,19 +3521,17 @@
 ception,
-%0A%09%09
+ 
 ScriptEx
@@ -3609,20 +3609,17 @@
  reader)
-%0A%09%09%09
+ 
 throws I
@@ -3621,33 +3621,35 @@
 ows IOException,
- 
+%0A%09%09
 ScriptException;
@@ -3848,17 +3848,16 @@
 Name,%0A%09%09
-%09
 final Wr
@@ -3979,9 +3979,8 @@
 ge);%0A%0A%7D%0A
-%0A

clean up style