scijava · acardona · Feb 12, 2022 · Dec 4, 2020 · Dec 4, 2020 · Dec 4, 2020
diff --git a/pom.xml b/pom.xml
@@ -127,7 +127,7 @@
 	<scm>
 		<connection>scm:git:git://github.com/scijava/script-editor</connection>
 		<developerConnection>scm:git:git@github.com:scijava/script-editor</developerConnection>
-		<tag>HEAD</tag>
+		<tag>script-editor-0.5.9</tag>
 		<url>https://github.com/scijava/script-editor</url>
 	</scm>
 	<issueManagement>

diff --git a/release.properties b/release.properties
@@ -0,0 +1,19 @@
+#release configuration
+#Wed Dec 16 10:56:44 CET 2020
+project.scm.org.scijava\:script-editor.developerConnection=scm\:git\:git@github.com\:scijava/script-editor
+scm.tagNameFormat=@{project.artifactId}-@{project.version}
+scm.tag=script-editor-0.5.9
+pushChanges=false
+scm.url=scm\:git\:git\://github.com/scijava/script-editor
+preparationGoals=clean verify
+project.scm.org.scijava\:script-editor.tag=HEAD
+project.scm.org.scijava\:script-editor.url=https\://github.com/scijava/script-editor
+remoteTagging=true
+projectVersionPolicyId=default
+scm.commentPrefix=[maven-release-plugin] 
+project.scm.org.scijava\:script-editor.connection=scm\:git\:git\://github.com/scijava/script-editor
+project.dev.org.scijava\:script-editor=0.5.10-SNAPSHOT
+exec.snapshotReleasePluginAllowed=false
+exec.additionalArguments=-Dgpg.skip\=true  -P deploy-to-scijava
+completedPhase=end-release
+project.rel.org.scijava\:script-editor=0.5.9
diff --git a/src/main/java/org/scijava/ui/swing/script/autocompletion/ClassUtil.java b/src/main/java/org/scijava/ui/swing/script/autocompletion/ClassUtil.java
@@ -30,6 +30,9 @@
 
 import java.io.File;
 import java.io.IOException;
+import java.lang.reflect.Field;
+import java.lang.reflect.Method;
+import java.lang.reflect.Parameter;
 import java.net.URL;
 import java.net.URLConnection;
 import java.util.ArrayList;
@@ -46,9 +49,13 @@
 import java.util.regex.Pattern;
 import java.util.stream.Stream;
 
+import org.fife.ui.autocomplete.BasicCompletion;
+import org.fife.ui.autocomplete.Completion;
+import org.fife.ui.autocomplete.CompletionProvider;
+
 public class ClassUtil {
 
-	static private final String scijava_javadoc_URL = "https://javadoc.scijava.org/"; // with ending slash
+	static final String scijava_javadoc_URL = "https://javadoc.scijava.org/"; // with ending slash
 
 	/** Cache of class names vs list of URLs found in the pom.xml files of their contaning jar files, if any. */
 	static private final Map<String, JarProperties> class_urls = new HashMap<>();
@@ -335,4 +342,103 @@ static public final ArrayList<String> findSimpleClassNamesStartingWith(final Str
 		}
 		return matches;
 	}
+
+	private static String getJavaDocLink(final Class<?> c) {
+		final String name = c.getCanonicalName();
+		final String pkg = getDocPackage(name);
+		if (pkg == null) return name;
+		final String url = String.format("%s%s/index.html?%s.html", scijava_javadoc_URL, pkg, name.replace(".", "/"));
+		return String.format("<a href='%s';>%s</a>", url, name);
+	}
+
+	private static String getDocPackage(final String classCanonicalName) {
+		//TODO: Do this programatically
+		if (classCanonicalName.startsWith("ij."))
+			return "ImageJ1";
+		else if (classCanonicalName.startsWith("sc.fiji"))
+			return "Fiji";
+		else if (classCanonicalName.startsWith("net.imagej"))
+			return "ImageJ";
+		else if (classCanonicalName.startsWith("net.imglib2"))
+			return "ImgLib2";
+		else if (classCanonicalName.startsWith("org.scijava"))
+			return "SciJava";
+		else if (classCanonicalName.startsWith("loci.formats"))
+			return "Bio-Formats";
+		if (classCanonicalName.startsWith("java."))
+			return "Java8";
+		else if (classCanonicalName.startsWith("sc.iview"))
+			return "SciView";
+		else if (classCanonicalName.startsWith("weka."))
+			return "Weka";
+		else if (classCanonicalName.startsWith("inra.ijpb"))
+			return "MorphoLibJ";
+		return null;
+	}
+
+	/**
+	 * Assembles an HTML-formatted auto-completion summary with functional
+	 * hyperlinks
+	 *
+	 * @param field    the field being documented
+	 * @param c        the class being documented. Expected to be documented at the
+	 *                 Scijava API documentation portal.
+	 * @return the completion summary
+	 */
+	protected static String getSummaryCompletion(final Field field, final Class<?> c) {
+		final StringBuffer summary = new StringBuffer();
+		summary.append("<b>").append(field.getName()).append("</b>");
+		summary.append(" (").append(field.getType().getName()).append(")");
+		summary.append("<DL>");
+		summary.append("<DT><b>Defined in:</b>");
+		summary.append("<DD>").append(getJavaDocLink(c));
+		summary.append("</DL>");
+		return summary.toString();
+	}
+
+	/**
+	 * Assembles an HTML-formatted auto-completion summary with functional
+	 * hyperlinks
+	 *
+	 * @param method   the method being documented
+	 * @param c        the class being documented. Expected to be documented at the
+	 *                 Scijava API documentation portal.
+	 * @return the completion summary
+	 */
+	protected static String getSummaryCompletion(final Method method, final Class<?> c) {
+		final StringBuffer summary = new StringBuffer();
+		final StringBuffer replacementHeader = new StringBuffer(method.getName());
+		final int bIndex = replacementHeader.length(); // remember '(' position
+		replacementHeader.append("(");
+		final Parameter[] params = method.getParameters();
+		if (params.length > 0) {
+			for (final Parameter parameter : params) {
+				replacementHeader.append(parameter.getType().getSimpleName()).append(", ");
+			}
+			replacementHeader.setLength(replacementHeader.length() - 2); // remove trailing ', ';
+		}
+		replacementHeader.append(")");
+		replacementHeader.replace(bIndex, bIndex + 1, "</b>("); // In header, highlight only method name for extra
+																// contrast
+		summary.append("<b>").append(replacementHeader);
+		summary.append("<DL>");
+		summary.append("<DT><b>Returns:</b>");
+		summary.append("<DD>").append(method.getReturnType().getSimpleName());
+		summary.append("<DT><b>Defined in:</b>");
+		summary.append("<DD>").append(getJavaDocLink(c));
+		summary.append("</DL>");
+		return summary.toString();
+	}
+
+	static List<Completion> classUnavailableCompletions(final CompletionProvider provider, final String pre) {
+		// placeholder completions to warn users class was not available (repeated to force pop-up display)
+		final List<Completion> list = new ArrayList<>();
+		final String summary = "Class not found or invalid import. See "
+				+ String.format("<a href='%s';>SciJavaDocs</a>", scijava_javadoc_URL)
+				+ " or <a href='https://search.imagej.net/';>search</a> for help";
+		list.add(new BasicCompletion(provider, pre + "?", null, summary));
+		list.add(new BasicCompletion(provider, pre + "?", null, summary));
+		return list;
+	}
+
 }
diff --git a/src/main/java/org/scijava/ui/swing/script/autocompletion/CompletionText.java b/src/main/java/org/scijava/ui/swing/script/autocompletion/CompletionText.java
@@ -0,0 +1,67 @@
+package org.scijava.ui.swing.script.autocompletion;
+
+import java.lang.reflect.Field;
+import java.lang.reflect.Method;
+
+import org.fife.ui.autocomplete.AbstractCompletion;
+import org.fife.ui.autocomplete.BasicCompletion;
+import org.fife.ui.autocomplete.CompletionProvider;
+
+public class CompletionText {
+
+	private String replacementText;
+	private String description;
+	private String summary;
+
+	public CompletionText(final String replacementText) {
+		this(replacementText, (String)null, (String)null);
+	}
+
+	public CompletionText(final String replacementText, final String summary, final String description) {
+		this.replacementText = replacementText;
+		this.summary = summary;
+		this.description = description;
+	}
+
+	public CompletionText(final String replacementText, final Class<?> c, final Field f) {
+		this(replacementText, ClassUtil.getSummaryCompletion(f, c), null);
+	}
+
+	public CompletionText(final String replacementText, final Class<?> c, final Method m) {
+		this(replacementText, ClassUtil.getSummaryCompletion(m, c), null);
+	}
+
+	public String getReplacementText() {
+		return replacementText;
+	}
+
+	public String getDescription() {
+		return description;
+	}
+
+	public String getSummary() {
+		return summary;
+	}
+
+	public AbstractCompletion getCompletion(final CompletionProvider provider, final String replacementText) {
+		return new BasicCompletion(provider, replacementText, description, summary);
+	}
+
+	public void setReplacementText(final String replacementText) {
+		this.replacementText = replacementText;
+	}
+
+	public void setDescription(final String description) {
+		this.description = description;
+	}
+
+	public void setSummary(final String summary) {
+		this.summary = summary;
+	}
+
+	@Override
+	public String toString() {
+		return replacementText + " | " + description + " | " + summary;
+	}
+
+}
diff --git a/src/main/java/org/scijava/ui/swing/script/autocompletion/JythonAutoCompletion.java b/src/main/java/org/scijava/ui/swing/script/autocompletion/JythonAutoCompletion.java
@@ -47,7 +47,8 @@ public JythonAutoCompletion(final CompletionProvider provider) {
 	}
 
 	static private final Pattern importPattern = Pattern.compile("^(from[ \\t]+([a-zA-Z_][a-zA-Z0-9._]*)[ \\t]+|)import[ \\t]+([a-zA-Z_][a-zA-Z0-9_]*[ \\ta-zA-Z0-9_,]*)[ \\t]*([\\\\]*|)[  \\t]*(#.*|)$"),
-								 tripleQuotePattern = Pattern.compile("\"\"\"");
+								 tripleQuotePattern = Pattern.compile("\"\"\""),
+								 variableDeclarationPattern = Pattern.compile("([a-zA-Z_][a-zA-Z0-9._]*)[ \\t]*=[ \\t]*([A-Z_][a-zA-Z0-9._]*)(?:\\()"); // E.g., in 'imp=ImagePlus()' group1: imp; group2: ImagePlus
 
 	static public class Import {
 		final public String className,
@@ -65,7 +66,26 @@ public Import(final String packageName, final String[] parts, final int lineNumb
 			this(packageName + "." + parts[0], 3 == parts.length ? parts[2] : null, lineNumber);
 		}
 	}
-
+
+	static public final String findClassAliasOfVariable(final String variable, String inputText) {
+		final String[] lines = inputText.split("\n");
+		for (int i = 0; i < lines.length; ++i) {
+			final String line = lines[i];
+			final Matcher matcher = variableDeclarationPattern.matcher(line);
+			if (matcher.find()) {
+				// a line containing a variable declaration
+//				System.out.println("Queried variable: " + variable);
+//				System.out.println("Hit: line #" + i + ": " + line);
+//				System.out.println("Matcher g1: " + matcher.group(1));
+//				System.out.println("Matcher g2: " + matcher.group(2));
+				if (variable.equals(matcher.group(1))) {
+					return matcher.group(2);
+				}
+			}
+		}
+		return null;
+	}
+
 	static public final HashMap<String, Import> findImportedClasses(final String text) {
 		final HashMap<String, Import> importedClasses = new HashMap<>();
 		String packageName = "";