2 * Jalview - A Sequence Alignment Editor and Viewer ($$Version-Rel$$)
3 * Copyright (C) $$Year-Rel$$ The Jalview Authors
5 * This file is part of Jalview.
7 * Jalview is free software: you can redistribute it and/or
8 * modify it under the terms of the GNU General Public License
9 * as published by the Free Software Foundation, either version 3
10 * of the License, or (at your option) any later version.
12 * Jalview is distributed in the hope that it will be useful, but
13 * WITHOUT ANY WARRANTY; without even the implied warranty
14 * of MERCHANTABILITY or FITNESS FOR A PARTICULAR
15 * PURPOSE. See the GNU General Public License for more details.
17 * You should have received a copy of the GNU General Public License
18 * along with Jalview. If not, see <http://www.gnu.org/licenses/>.
19 * The Jalview Authors are detailed in the 'AUTHORS' file.
23 import java.awt.Color;
24 import java.io.BufferedReader;
26 import java.io.FileOutputStream;
27 import java.io.IOException;
28 import java.io.InputStreamReader;
29 import java.io.OutputStream;
30 import java.io.OutputStreamWriter;
31 import java.io.PrintStream;
32 import java.io.PrintWriter;
33 import java.net.MalformedURLException;
35 import java.net.URISyntaxException;
37 import java.security.AllPermission;
38 import java.security.CodeSource;
39 import java.security.PermissionCollection;
40 import java.security.Permissions;
41 import java.security.Policy;
42 import java.util.ArrayList;
43 import java.util.HashMap;
44 import java.util.List;
45 import java.util.Locale;
47 import java.util.Properties;
48 import java.util.Vector;
49 import java.util.logging.ConsoleHandler;
50 import java.util.logging.Level;
51 import java.util.logging.Logger;
52 import java.util.stream.Collectors;
54 import javax.swing.JDialog;
55 import javax.swing.JFrame;
56 import javax.swing.JInternalFrame;
57 import javax.swing.JOptionPane;
58 import javax.swing.SwingUtilities;
59 import javax.swing.UIManager;
60 import javax.swing.UIManager.LookAndFeelInfo;
61 import javax.swing.UnsupportedLookAndFeelException;
63 import com.formdev.flatlaf.FlatLightLaf;
64 import com.formdev.flatlaf.themes.FlatMacLightLaf;
65 import com.formdev.flatlaf.util.SystemInfo;
66 import com.threerings.getdown.util.LaunchUtil;
68 //import edu.stanford.ejalbert.launching.IBrowserLaunching;
69 import groovy.lang.Binding;
70 import groovy.util.GroovyScriptEngine;
71 import jalview.bin.argparser.Arg;
72 import jalview.bin.argparser.Arg.Opt;
73 import jalview.bin.argparser.Arg.Type;
74 import jalview.bin.argparser.ArgParser;
75 import jalview.bin.argparser.BootstrapArgs;
76 import jalview.ext.so.SequenceOntology;
77 import jalview.gui.AlignFrame;
78 import jalview.gui.Desktop;
79 import jalview.gui.PromptUserConfig;
80 import jalview.gui.QuitHandler;
81 import jalview.gui.QuitHandler.QResponse;
82 import jalview.gui.StructureViewerBase;
83 import jalview.io.AppletFormatAdapter;
84 import jalview.io.BioJsHTMLOutput;
85 import jalview.io.DataSourceType;
86 import jalview.io.FileFormat;
87 import jalview.io.FileFormatException;
88 import jalview.io.FileFormatI;
89 import jalview.io.FileFormats;
90 import jalview.io.FileLoader;
91 import jalview.io.HtmlSvgOutput;
92 import jalview.io.IdentifyFile;
93 import jalview.io.NewickFile;
94 import jalview.io.exceptions.ImageOutputException;
95 import jalview.io.gff.SequenceOntologyFactory;
96 import jalview.schemes.ColourSchemeI;
97 import jalview.schemes.ColourSchemeProperty;
98 import jalview.util.ChannelProperties;
99 import jalview.util.HttpUtils;
100 import jalview.util.LaunchUtils;
101 import jalview.util.MessageManager;
102 import jalview.util.Platform;
103 import jalview.ws.jws2.Jws2Discoverer;
106 * Main class for Jalview Application <br>
108 * start with: java -classpath "$PATH_TO_LIB$/*:$PATH_TO_CLASSES$" \
109 * jalview.bin.Jalview
111 * or on Windows: java -classpath "$PATH_TO_LIB$/*;$PATH_TO_CLASSES$" \
112 * jalview.bin.Jalview jalview.bin.Jalview
114 * (ensure -classpath arg is quoted to avoid shell expansion of '*' and do not
115 * embellish '*' to e.g. '*.jar')
118 * @version $Revision$
124 Platform.getURLCommandArguments();
125 Platform.addJ2SDirectDatabaseCall("https://www.jalview.org");
126 Platform.addJ2SDirectDatabaseCall("http://www.jalview.org");
127 Platform.addJ2SDirectDatabaseCall("http://www.compbio.dundee.ac.uk");
128 Platform.addJ2SDirectDatabaseCall("https://www.compbio.dundee.ac.uk");
132 * singleton instance of this class
134 private static Jalview instance;
136 private Desktop desktop;
138 protected Commands cmds;
140 public static AlignFrame currentAlignFrame;
142 public ArgParser argparser = null;
144 public BootstrapArgs bootstrapArgs = null;
146 private boolean QUIET = false;
148 public static boolean quiet()
150 return Jalview.getInstance() != null && Jalview.getInstance().QUIET;
155 if (!Platform.isJS())
162 // grab all the rights we can for the JVM
163 Policy.setPolicy(new Policy()
166 public PermissionCollection getPermissions(CodeSource codesource)
168 Permissions perms = new Permissions();
169 perms.add(new AllPermission());
174 public void refresh()
182 * keep track of feature fetching tasks.
190 * TODO: generalise to track all jalview events to orchestrate batch processing
194 private int queued = 0;
196 private int running = 0;
198 public FeatureFetcher()
203 public void addFetcher(final AlignFrame af,
204 final Vector<String> dasSources)
206 final long id = System.currentTimeMillis();
208 final FeatureFetcher us = this;
209 new Thread(new Runnable()
221 af.setProgressBar(MessageManager
222 .getString("status.das_features_being_retrived"), id);
223 af.featureSettings_actionPerformed(null);
224 af.setProgressBar(null, id);
233 public synchronized boolean allFinished()
235 return queued == 0 && running == 0;
240 public static Jalview getInstance()
246 * main class for Jalview application
249 * open <em>filename</em>
251 public static void main(String[] args)
253 // setLogging(); // BH - for event debugging in JavaScript
254 instance = new Jalview();
255 instance.doMain(args);
258 private static void logClass(String name)
260 // BH - for event debugging in JavaScript
261 ConsoleHandler consoleHandler = new ConsoleHandler();
262 consoleHandler.setLevel(Level.ALL);
263 Logger logger = Logger.getLogger(name);
264 logger.setLevel(Level.ALL);
265 logger.addHandler(consoleHandler);
268 @SuppressWarnings("unused")
269 private static void setLogging()
277 System.out.println("not in js");
280 // BH - for event debugging in JavaScript (Java mode only)
281 if (!Platform.isJS())
288 Logger.getLogger("").setLevel(Level.ALL);
289 logClass("java.awt.EventDispatchThread");
290 logClass("java.awt.EventQueue");
291 logClass("java.awt.Component");
292 logClass("java.awt.focus.Component");
293 logClass("java.awt.focus.DefaultKeyboardFocusManager");
301 void doMain(String[] args)
303 if (!Platform.isJS())
305 System.setSecurityManager(null);
308 if (args == null || args.length == 0 || (args.length == 1
309 && (args[0] == null || args[0].length() == 0)))
311 args = new String[] {};
314 // get args needed before proper ArgParser
315 bootstrapArgs = BootstrapArgs.getBootstrapArgs(args);
317 if (!Platform.isJS())
319 // are we being --quiet ?
320 if (bootstrapArgs.contains(Arg.QUIET))
323 OutputStream devNull = new OutputStream()
327 public void write(int b)
332 System.setOut(new PrintStream(devNull));
333 // redirecting stderr not working
334 if (bootstrapArgs.getList(Arg.QUIET).size() > 1)
336 System.setErr(new PrintStream(devNull));
340 if (bootstrapArgs.contains(Arg.HELP)
341 || bootstrapArgs.contains(Arg.VERSION))
347 // set individual session preferences
348 if (bootstrapArgs.contains(Arg.P))
350 for (String kev : bootstrapArgs.getValueList(Arg.P))
356 int equalsIndex = kev.indexOf(ArgParser.EQUALS);
357 if (equalsIndex > -1)
359 String key = kev.substring(0, equalsIndex);
360 String val = kev.substring(equalsIndex + 1);
361 Cache.setSessionProperty(key, val);
366 // Move any new getdown-launcher-new.jar into place over old
367 // getdown-launcher.jar
368 String appdirString = System.getProperty("getdownappdir");
369 if (appdirString != null && appdirString.length() > 0)
371 final File appdir = new File(appdirString);
378 LaunchUtil.upgradeGetdown(
379 new File(appdir, "getdown-launcher-old.jar"),
380 new File(appdir, "getdown-launcher.jar"),
381 new File(appdir, "getdown-launcher-new.jar"));
386 if (!quiet() || bootstrapArgs.contains(Arg.VERSION))
389 "Java version: " + System.getProperty("java.version"));
390 System.out.println("Java home: " + System.getProperty("java.home"));
391 System.out.println("Java arch: " + System.getProperty("os.arch") + " "
392 + System.getProperty("os.name") + " "
393 + System.getProperty("os.version"));
395 String val = System.getProperty("sys.install4jVersion");
398 System.out.println("Install4j version: " + val);
400 val = System.getProperty("installer_template_version");
403 System.out.println("Install4j template version: " + val);
405 val = System.getProperty("launcher_version");
408 System.out.println("Launcher version: " + val);
412 if (Platform.isLinux() && LaunchUtils.getJavaVersion() < 11)
414 System.setProperty("flatlaf.uiScale", "1");
417 // get bootstrap properties (mainly for the logger level)
418 Properties bootstrapProperties = Cache
419 .bootstrapProperties(bootstrapArgs.getValue(Arg.PROPS));
421 // report Jalview version
422 Cache.loadBuildProperties(
423 !quiet() || bootstrapArgs.contains(Arg.VERSION));
425 // stop now if only after --version
426 if (bootstrapArgs.contains(Arg.VERSION))
428 Jalview.exit(null, 0);
432 ArgsParser aparser = new ArgsParser(args);
435 boolean headless = false;
437 boolean headlessArg = false;
441 String logLevel = null;
442 if (bootstrapArgs.contains(Arg.TRACE))
446 else if (bootstrapArgs.contains(Arg.DEBUG))
450 if (logLevel == null && !(bootstrapProperties == null))
452 logLevel = bootstrapProperties.getProperty(Cache.JALVIEWLOGLEVEL);
454 Console.initLogger(logLevel);
455 } catch (NoClassDefFoundError error)
457 error.printStackTrace();
458 String message = "\nEssential logging libraries not found."
459 + "\nUse: java -classpath \"$PATH_TO_LIB$/*:$PATH_TO_CLASSES$\" jalview.bin.Jalview";
460 Jalview.exit(message, 0);
463 // register SIGTERM listener
464 Runtime.getRuntime().addShutdownHook(new Thread()
469 Console.debug("Running shutdown hook");
470 QuitHandler.startForceQuit();
471 boolean closeExternal = Cache
472 .getDefault("DEFAULT_CLOSE_EXTERNAL_VIEWERS", false)
473 || Cache.getDefault("ALWAYS_CLOSE_EXTERNAL_VIEWERS", false);
474 StructureViewerBase.setQuitClose(closeExternal);
477 for (JInternalFrame frame : Desktop.desktop.getAllFrames())
479 if (frame instanceof StructureViewerBase)
481 ((StructureViewerBase) frame).closeViewer(closeExternal);
486 if (QuitHandler.gotQuitResponse() == QResponse.CANCEL_QUIT)
488 // Got to here by a SIGTERM signal.
489 // Note we will not actually cancel the quit from here -- it's too
490 // late -- but we can wait for saving files and close external viewers
492 // Close viewers/Leave viewers open
493 Console.debug("Checking for saving files");
494 QuitHandler.getQuitResponse(false);
498 Console.debug("Nothing more to do");
500 Console.debug("Exiting, bye!");
501 // shutdownHook cannot be cancelled, JVM will now halt
505 String usrPropsFile = bootstrapArgs.contains(Arg.PROPS)
506 ? bootstrapArgs.getValue(Arg.PROPS)
507 : aparser.getValue("props");
508 // if usrPropsFile == null, loadProperties will use the Channel
510 Cache.loadProperties(usrPropsFile);
511 if (usrPropsFile != null)
514 "CMD [-props " + usrPropsFile + "] executed successfully!");
515 testoutput(bootstrapArgs, Arg.PROPS,
516 "test/jalview/bin/testProps.jvprops", usrPropsFile);
519 // --argfile=... -- OVERRIDES ALL NON-BOOTSTRAP ARGS
520 if (bootstrapArgs.contains(Arg.ARGFILE))
522 argparser = ArgParser.parseArgFiles(
523 bootstrapArgs.getValueList(Arg.ARGFILE),
524 bootstrapArgs.getBoolean(Arg.INITSUBSTITUTIONS),
529 argparser = new ArgParser(args,
530 bootstrapArgs.getBoolean(Arg.INITSUBSTITUTIONS),
534 if (!Platform.isJS())
541 if (bootstrapArgs.contains(Arg.HELP))
543 List<Map.Entry<Type, String>> helpArgs = bootstrapArgs
545 System.out.println(Arg.usage(helpArgs.stream().map(e -> e.getKey())
546 .collect(Collectors.toList())));
547 Jalview.exit(null, 0);
549 if (aparser.contains("help") || aparser.contains("h"))
552 * Now using new usage statement.
555 System.out.println(Arg.usage());
556 Jalview.exit(null, 0);
560 headlessArg = bootstrapArgs.isHeadless();
563 System.setProperty("java.awt.headless", "true");
566 if (aparser.contains("nodisplay") || aparser.contains("nogui")
567 || aparser.contains("headless"))
569 System.setProperty("java.awt.headless", "true");
574 // allow https handshakes to download intermediate certs if necessary
575 System.setProperty("com.sun.security.enableAIAcaIssuers", "true");
577 String jabawsUrl = bootstrapArgs.getValue(Arg.JABAWS);
578 if (jabawsUrl == null)
579 jabawsUrl = aparser.getValue("jabaws");
580 if (jabawsUrl != null)
584 Jws2Discoverer.getDiscoverer().setPreferredUrl(jabawsUrl);
586 "CMD [-jabaws " + jabawsUrl + "] executed successfully!");
587 testoutput(bootstrapArgs, Arg.JABAWS,
588 "http://www.compbio.dundee.ac.uk/jabaws", jabawsUrl);
589 } catch (MalformedURLException e)
592 "Invalid jabaws parameter: " + jabawsUrl + " ignored");
597 List<String> setprops = new ArrayList<>();
598 if (bootstrapArgs.contains(Arg.SETPROP))
600 setprops = bootstrapArgs.getValueList(Arg.SETPROP);
604 String sp = aparser.getValue("setprop");
608 sp = aparser.getValue("setprop");
611 for (String setprop : setprops)
613 int p = setprop.indexOf('=');
617 .println("Ignoring invalid setprop argument : " + setprop);
621 System.out.println("Executing setprop argument: " + setprop);
624 Cache.setProperty(setprop.substring(0, p),
625 setprop.substring(p + 1));
627 // DISABLED FOR SECURITY REASONS
628 // TODO: add a property to allow properties to be overriden by cli args
629 // Cache.setProperty(setprop.substring(0,p), setprop.substring(p+1));
632 if (System.getProperty("java.awt.headless") != null
633 && System.getProperty("java.awt.headless").equals("true"))
637 System.setProperty("http.agent", HttpUtils.getUserAgent());
641 Console.initLogger();
644 NoClassDefFoundError error)
646 error.printStackTrace();
647 String message = "\nEssential logging libraries not found."
648 + "\nUse: java -classpath \"$PATH_TO_LIB$/*:$PATH_TO_CLASSES$\" jalview.bin.Jalview";
649 Jalview.exit(message, 0);
653 if (!(headless || headlessArg))
657 * configure 'full' SO model if preferences say to, else use the default (full SO)
658 * - as JS currently doesn't have OBO parsing, it must use 'Lite' version
660 boolean soDefault = !Platform.isJS();
661 if (Cache.getDefault("USE_FULL_SO", soDefault))
663 SequenceOntologyFactory.setInstance(new SequenceOntology());
666 if (!(headless || headlessArg))
668 Desktop.nosplash = "false".equals(bootstrapArgs.getValue(Arg.SPLASH))
669 || aparser.contains("nosplash")
670 || Cache.getDefault("SPLASH", "true").equals("false");
671 desktop = new Desktop();
672 desktop.setInBatchMode(true); // indicate we are starting up
676 JalviewTaskbar.setTaskbar(this);
677 } catch (Exception e)
679 Console.info("Cannot set Taskbar");
680 Console.error(e.getMessage());
681 // e.printStackTrace();
682 } catch (Throwable t)
684 Console.info("Cannot set Taskbar");
685 Console.error(t.getMessage());
686 // t.printStackTrace();
689 // set Proxy settings before all the internet calls
690 Cache.setProxyPropertiesFromPreferences();
692 desktop.setVisible(true);
694 if (!Platform.isJS())
703 * Check to see that the JVM version being run is suitable for the Java
704 * version this Jalview was compiled for. Popup a warning if not.
706 if (!LaunchUtils.checkJavaVersion())
708 Console.warn("The Java version being used (Java "
709 + LaunchUtils.getJavaVersion()
710 + ") may lead to problems. This installation of Jalview should be used with Java "
711 + LaunchUtils.getJavaCompileVersion() + ".");
714 .getBooleanUserPreference("IGNORE_JVM_WARNING_POPUP"))
717 MessageManager.getString("label.continue") };
718 JOptionPane.showOptionDialog(null,
719 MessageManager.formatMessage(
720 "warning.wrong_jvm_version_message",
721 LaunchUtils.getJavaVersion(),
722 LaunchUtils.getJavaCompileVersion()),
724 .getString("warning.wrong_jvm_version_title"),
725 JOptionPane.DEFAULT_OPTION, JOptionPane.WARNING_MESSAGE,
726 null, options, options[0]);
730 boolean webservicediscovery = bootstrapArgs
731 .getBoolean(Arg.WEBSERVICEDISCOVERY);
732 if (aparser.contains("nowebservicediscovery"))
733 webservicediscovery = false;
734 if (webservicediscovery)
736 desktop.startServiceDiscovery();
740 testoutput(argparser, Arg.WEBSERVICEDISCOVERY);
743 boolean usagestats = !bootstrapArgs.getBoolean(Arg.NOUSAGESTATS);
744 if (aparser.contains("nousagestats"))
748 startUsageStats(desktop);
749 testoutput(argparser, Arg.NOUSAGESTATS);
753 System.out.println("CMD [-nousagestats] executed successfully!");
754 testoutput(argparser, Arg.NOUSAGESTATS);
757 boolean questionnaire = bootstrapArgs.getBoolean(Arg.QUESTIONNAIRE);
758 if (aparser.contains("noquestionnaire"))
759 questionnaire = false;
762 String url = aparser.getValue("questionnaire");
765 // Start the desktop questionnaire prompter with the specified
767 Console.debug("Starting questionnaire url at " + url);
768 desktop.checkForQuestionnaire(url);
769 System.out.println("CMD questionnaire[-" + url
770 + "] executed successfully!");
774 if (Cache.getProperty("NOQUESTIONNAIRES") == null)
776 // Start the desktop questionnaire prompter with the specified
779 // "http://anaplog.compbio.dundee.ac.uk/cgi-bin/questionnaire.pl";
781 String defurl = "https://www.jalview.org/cgi-bin/questionnaire.pl";
783 "Starting questionnaire with default url: " + defurl);
784 desktop.checkForQuestionnaire(defurl);
791 .println("CMD [-noquestionnaire] executed successfully!");
792 testoutput(argparser, Arg.QUESTIONNAIRE);
795 if ((!aparser.contains("nonews")
796 && Cache.getProperty("NONEWS") == null
797 && !"false".equals(bootstrapArgs.getValue(Arg.NEWS)))
798 || "true".equals(bootstrapArgs.getValue(Arg.NEWS)))
800 desktop.checkForNews();
803 if (!aparser.contains("nohtmltemplates")
804 && Cache.getProperty("NOHTMLTEMPLATES") == null)
806 BioJsHTMLOutput.updateBioJS();
810 // Run Commands from cli
811 cmds = new Commands(argparser, headlessArg);
812 boolean commandsSuccess = cmds.argsWereParsed();
818 if (argparser.getBoolean(Arg.NOQUIT))
821 "Completed " + Arg.HEADLESS.getName() + " commands, but "
822 + Arg.NOQUIT + " is set so not quitting!");
826 Jalview.exit("Successfully completed commands in headless mode",
830 Console.info("Successfully completed commands");
836 Jalview.exit("Error when running Commands in headless mode", 1);
838 Console.warn("Error when running commands");
841 // Check if JVM and compile version might cause problems and log if it
843 if (headless && !Platform.isJS() && !LaunchUtils.checkJavaVersion())
845 Console.warn("The Java version being used (Java "
846 + LaunchUtils.getJavaVersion()
847 + ") may lead to problems. This installation of Jalview should be used with Java "
848 + LaunchUtils.getJavaCompileVersion() + ".");
851 String file = null, data = null;
853 FileFormatI format = null;
855 DataSourceType protocol = null;
857 FileLoader fileLoader = new FileLoader(!headless);
859 String groovyscript = null; // script to execute after all loading is
860 // completed one way or another
861 // extract groovy argument and execute if necessary
862 groovyscript = aparser.getValue("groovy", true);
863 file = aparser.getValue("open", true);
865 if (file == null && desktop == null && !commandsSuccess)
867 Jalview.exit("No files to open!", 1);
871 // Finally, deal with the remaining input data.
876 desktop.setProgressBar(
878 .getString("status.processing_commandline_args"),
879 progress = System.currentTimeMillis());
881 System.out.println("CMD [-open " + file + "] executed successfully!");
883 if (!Platform.isJS())
885 * ignore in JavaScript -- can't just file existence - could load it?
890 if (!HttpUtils.startsWithHttpOrHttps(file))
892 if (!(new File(file)).exists())
897 "Can't find file '" + file + "' in headless mode", 1);
899 Console.warn("Can't find file'" + file + "'");
904 protocol = AppletFormatAdapter.checkProtocol(file);
908 format = new IdentifyFile().identify(file, protocol);
909 } catch (FileFormatException e1)
914 AlignFrame af = fileLoader.LoadFileWaitTillLoaded(file, protocol,
918 System.out.println("error");
922 setCurrentAlignFrame(af);
923 data = aparser.getValue("colour", true);
926 data.replaceAll("%20", " ");
928 ColourSchemeI cs = ColourSchemeProperty.getColourScheme(
929 af.getViewport(), af.getViewport().getAlignment(), data);
934 "CMD [-colour " + data + "] executed successfully!");
939 // Must maintain ability to use the groups flag
940 data = aparser.getValue("groups", true);
943 af.parseFeaturesFile(data,
944 AppletFormatAdapter.checkProtocol(data));
945 // System.out.println("Added " + data);
947 "CMD groups[-" + data + "] executed successfully!");
949 data = aparser.getValue("features", true);
952 af.parseFeaturesFile(data,
953 AppletFormatAdapter.checkProtocol(data));
954 // System.out.println("Added " + data);
956 "CMD [-features " + data + "] executed successfully!");
959 data = aparser.getValue("annotations", true);
962 af.loadJalviewDataFile(data, null, null, null);
963 // System.out.println("Added " + data);
965 "CMD [-annotations " + data + "] executed successfully!");
967 // set or clear the sortbytree flag.
968 if (aparser.contains("sortbytree"))
970 af.getViewport().setSortByTree(true);
971 if (af.getViewport().getSortByTree())
973 System.out.println("CMD [-sortbytree] executed successfully!");
976 if (aparser.contains("no-annotation"))
978 af.getViewport().setShowAnnotation(false);
979 if (!af.getViewport().isShowAnnotation())
981 System.out.println("CMD no-annotation executed successfully!");
984 if (aparser.contains("nosortbytree"))
986 af.getViewport().setSortByTree(false);
987 if (!af.getViewport().getSortByTree())
990 .println("CMD [-nosortbytree] executed successfully!");
993 data = aparser.getValue("tree", true);
999 "CMD [-tree " + data + "] executed successfully!");
1000 NewickFile nf = new NewickFile(data,
1001 AppletFormatAdapter.checkProtocol(data));
1003 .setCurrentTree(af.showNewickTree(nf, data).getTree());
1004 } catch (IOException ex)
1006 System.err.println("Couldn't add tree " + data);
1007 ex.printStackTrace(System.err);
1011 if (groovyscript != null)
1013 // Execute the groovy script after we've done all the rendering stuff
1014 // and before any images or figures are generated.
1015 System.out.println("Executing script " + groovyscript);
1016 executeGroovyScript(groovyscript, af);
1017 System.out.println("CMD groovy[" + groovyscript
1018 + "] executed successfully!");
1019 groovyscript = null;
1021 String imageName = "unnamed.png";
1022 while (aparser.getSize() > 1)
1026 String outputFormat = aparser.nextValue();
1027 file = aparser.nextValue();
1029 if (outputFormat.equalsIgnoreCase("png"))
1031 System.out.println("Creating PNG image: " + file);
1032 af.createPNG(new File(file));
1033 imageName = (new File(file)).getName();
1036 else if (outputFormat.equalsIgnoreCase("svg"))
1038 System.out.println("Creating SVG image: " + file);
1039 File imageFile = new File(file);
1040 imageName = imageFile.getName();
1041 af.createSVG(imageFile);
1044 else if (outputFormat.equalsIgnoreCase("html"))
1046 File imageFile = new File(file);
1047 imageName = imageFile.getName();
1048 HtmlSvgOutput htmlSVG = new HtmlSvgOutput(af.alignPanel);
1050 System.out.println("Creating HTML image: " + file);
1051 htmlSVG.exportHTML(file);
1054 else if (outputFormat.equalsIgnoreCase("biojsmsa"))
1058 System.err.println("The output html file must not be null");
1063 BioJsHTMLOutput.refreshVersionInfo(
1064 BioJsHTMLOutput.BJS_TEMPLATES_LOCAL_DIRECTORY);
1065 } catch (URISyntaxException e)
1067 e.printStackTrace();
1069 BioJsHTMLOutput bjs = new BioJsHTMLOutput(af.alignPanel);
1071 "Creating BioJS MSA Viwer HTML file: " + file);
1072 bjs.exportHTML(file);
1075 else if (outputFormat.equalsIgnoreCase("imgMap"))
1077 System.out.println("Creating image map: " + file);
1078 af.createImageMap(new File(file), imageName);
1081 else if (outputFormat.equalsIgnoreCase("eps"))
1083 File outputFile = new File(file);
1085 "Creating EPS file: " + outputFile.getAbsolutePath());
1086 af.createEPS(outputFile);
1090 FileFormatI outFormat = null;
1093 outFormat = FileFormats.getInstance().forName(outputFormat);
1094 } catch (Exception formatP)
1096 System.out.println("Couldn't parse " + outFormat
1097 + " as a valid Jalview format string.");
1099 if (outFormat != null)
1101 if (!outFormat.isWritable())
1104 "This version of Jalview does not support alignment export as "
1109 af.saveAlignment(file, outFormat);
1110 if (af.isSaveAlignmentSuccessful())
1112 System.out.println("Written alignment in "
1113 + outFormat.getName() + " format to " + file);
1117 System.out.println("Error writing file " + file + " in "
1118 + outFormat.getName() + " format!!");
1122 } catch (ImageOutputException ioexc)
1125 "Unexpected error whilst exporting image to " + file);
1126 ioexc.printStackTrace();
1131 while (aparser.getSize() > 0)
1133 System.out.println("Unknown arg: " + aparser.nextValue());
1138 AlignFrame startUpAlframe = null;
1139 // We'll only open the default file if the desktop is visible.
1141 // ////////////////////
1143 if (!Platform.isJS() && !headless && file == null
1144 && Cache.getDefault("SHOW_STARTUP_FILE", true)
1145 && !cmds.commandArgsProvided()
1146 && !bootstrapArgs.getBoolean(Arg.NOSTARTUPFILE))
1147 // don't open the startup file if command line args have been processed
1148 // (&& !Commands.commandArgsProvided())
1155 file = Cache.getDefault("STARTUP_FILE",
1156 Cache.getDefault("www.jalview.org", "https://www.jalview.org")
1157 + "/examples/exampleFile_2_7.jvp");
1158 if (file.equals("http://www.jalview.org/examples/exampleFile_2_3.jar")
1160 "http://www.jalview.org/examples/exampleFile_2_7.jar"))
1162 file.replace("http:", "https:");
1163 // hardwire upgrade of the startup file
1164 file.replace("_2_3", "_2_7");
1165 file.replace("2_7.jar", "2_7.jvp");
1166 // and remove the stale setting
1167 Cache.removeProperty("STARTUP_FILE");
1170 protocol = AppletFormatAdapter.checkProtocol(file);
1172 if (file.endsWith(".jar"))
1174 format = FileFormat.Jalview;
1180 format = new IdentifyFile().identify(file, protocol);
1181 } catch (FileFormatException e)
1187 startUpAlframe = fileLoader.LoadFileWaitTillLoaded(file, protocol,
1189 // don't ask to save when quitting if only the startup file has been
1191 Console.debug("Resetting up-to-date flag for startup file");
1192 startUpAlframe.getViewport().setSavedUpToDate(true);
1193 // extract groovy arguments before anything else.
1196 // Once all other stuff is done, execute any groovy scripts (in order)
1197 if (groovyscript != null)
1199 if (Cache.groovyJarsPresent())
1201 System.out.println("Executing script " + groovyscript);
1202 executeGroovyScript(groovyscript, startUpAlframe);
1207 "Sorry. Groovy Support is not available, so ignoring the provided groovy script "
1211 // and finally, turn off batch mode indicator - if the desktop still exists
1212 if (desktop != null)
1216 desktop.setProgressBar(null, progress);
1218 desktop.setInBatchMode(false);
1222 private static void setLookAndFeel()
1224 if (!Platform.isJS())
1231 // property laf = "crossplatform", "system", "gtk", "metal", "nimbus",
1233 // If not set (or chosen laf fails), use the normal SystemLaF and if on
1235 // try Quaqua/Vaqua.
1236 String lafProp = System.getProperty("laf");
1237 String lafSetting = Cache.getDefault("PREFERRED_LAF", null);
1238 String laf = "none";
1239 if (lafProp != null)
1243 else if (lafSetting != null)
1247 boolean lafSet = false;
1250 case "crossplatform":
1251 lafSet = setCrossPlatformLookAndFeel();
1254 Console.error("Could not set requested laf=" + laf);
1258 lafSet = setSystemLookAndFeel();
1261 Console.error("Could not set requested laf=" + laf);
1265 lafSet = setGtkLookAndFeel();
1268 Console.error("Could not set requested laf=" + laf);
1272 lafSet = setMetalLookAndFeel();
1275 Console.error("Could not set requested laf=" + laf);
1279 lafSet = setNimbusLookAndFeel();
1282 Console.error("Could not set requested laf=" + laf);
1286 lafSet = setFlatLookAndFeel();
1289 Console.error("Could not set requested laf=" + laf);
1293 lafSet = setMacLookAndFeel();
1296 Console.error("Could not set requested laf=" + laf);
1302 Console.error("Requested laf=" + laf + " not implemented");
1306 // Flatlaf default for everyone!
1307 lafSet = setFlatLookAndFeel();
1310 setSystemLookAndFeel();
1312 if (Platform.isLinux())
1314 setLinuxLookAndFeel();
1316 if (Platform.isMac())
1318 setMacLookAndFeel();
1324 private static boolean setCrossPlatformLookAndFeel()
1326 boolean set = false;
1329 UIManager.setLookAndFeel(
1330 UIManager.getCrossPlatformLookAndFeelClassName());
1332 } catch (Exception ex)
1334 Console.error("Unexpected Look and Feel Exception");
1335 Console.error(ex.getMessage());
1336 Console.debug(Cache.getStackTraceString(ex));
1341 private static boolean setSystemLookAndFeel()
1343 boolean set = false;
1346 UIManager.setLookAndFeel(UIManager.getSystemLookAndFeelClassName());
1348 } catch (Exception ex)
1350 Console.error("Unexpected Look and Feel Exception");
1351 Console.error(ex.getMessage());
1352 Console.debug(Cache.getStackTraceString(ex));
1357 private static boolean setSpecificLookAndFeel(String name,
1358 String className, boolean nameStartsWith)
1360 boolean set = false;
1363 for (LookAndFeelInfo info : UIManager.getInstalledLookAndFeels())
1365 if (info.getName() != null && nameStartsWith
1366 ? info.getName().toLowerCase(Locale.ROOT)
1367 .startsWith(name.toLowerCase(Locale.ROOT))
1368 : info.getName().toLowerCase(Locale.ROOT)
1369 .equals(name.toLowerCase(Locale.ROOT)))
1371 className = info.getClassName();
1375 UIManager.setLookAndFeel(className);
1377 } catch (Exception ex)
1379 Console.error("Unexpected Look and Feel Exception");
1380 Console.error(ex.getMessage());
1381 Console.debug(Cache.getStackTraceString(ex));
1386 private static boolean setGtkLookAndFeel()
1388 return setSpecificLookAndFeel("gtk",
1389 "com.sun.java.swing.plaf.gtk.GTKLookAndFeel", true);
1392 private static boolean setMetalLookAndFeel()
1394 return setSpecificLookAndFeel("metal",
1395 "javax.swing.plaf.metal.MetalLookAndFeel", false);
1398 private static boolean setNimbusLookAndFeel()
1400 return setSpecificLookAndFeel("nimbus",
1401 "javax.swing.plaf.nimbus.NimbusLookAndFeel", false);
1404 private static boolean setFlatLookAndFeel()
1406 boolean set = false;
1407 if (SystemInfo.isMacOS)
1411 UIManager.setLookAndFeel(
1412 "com.formdev.flatlaf.themes.FlatMacLightLaf");
1414 Console.debug("Using FlatMacLightLaf");
1415 } catch (ClassNotFoundException | InstantiationException
1416 | IllegalAccessException | UnsupportedLookAndFeelException e)
1418 Console.debug("Exception loading FlatLightLaf", e);
1420 System.setProperty("apple.laf.useScreenMenuBar", "true");
1421 System.setProperty("apple.awt.application.name",
1422 ChannelProperties.getProperty("app_name"));
1423 System.setProperty("apple.awt.application.appearance", "system");
1424 if (SystemInfo.isMacFullWindowContentSupported
1425 && Desktop.desktop != null)
1427 Console.debug("Setting transparent title bar");
1428 Desktop.desktop.getRootPane()
1429 .putClientProperty("apple.awt.fullWindowContent", true);
1430 Desktop.desktop.getRootPane()
1431 .putClientProperty("apple.awt.transparentTitleBar", true);
1432 Desktop.desktop.getRootPane()
1433 .putClientProperty("apple.awt.fullscreenable", true);
1435 SwingUtilities.invokeLater(() -> {
1436 FlatMacLightLaf.setup();
1438 Console.debug("Using FlatMacLightLaf");
1445 UIManager.setLookAndFeel("com.formdev.flatlaf.FlatLightLaf");
1447 Console.debug("Using FlatLightLaf");
1448 } catch (ClassNotFoundException | InstantiationException
1449 | IllegalAccessException | UnsupportedLookAndFeelException e)
1451 Console.debug("Exception loading FlatLightLaf", e);
1453 // Windows specific properties here
1454 SwingUtilities.invokeLater(() -> {
1455 FlatLightLaf.setup();
1457 Console.debug("Using FlatLightLaf");
1460 else if (SystemInfo.isLinux)
1464 UIManager.setLookAndFeel("com.formdev.flatlaf.FlatLightLaf");
1466 Console.debug("Using FlatLightLaf");
1467 } catch (ClassNotFoundException | InstantiationException
1468 | IllegalAccessException | UnsupportedLookAndFeelException e)
1470 Console.debug("Exception loading FlatLightLaf", e);
1472 // enable custom window decorations
1473 JFrame.setDefaultLookAndFeelDecorated(true);
1474 JDialog.setDefaultLookAndFeelDecorated(true);
1475 SwingUtilities.invokeLater(() -> {
1476 FlatLightLaf.setup();
1478 Console.debug("Using FlatLightLaf");
1486 UIManager.setLookAndFeel("com.formdev.flatlaf.FlatLightLaf");
1488 Console.debug("Using FlatLightLaf");
1489 } catch (ClassNotFoundException | InstantiationException
1490 | IllegalAccessException | UnsupportedLookAndFeelException e)
1492 Console.debug("Exception loading FlatLightLaf", e);
1498 UIManager.put("TabbedPane.tabType", "card");
1499 UIManager.put("TabbedPane.showTabSeparators", true);
1500 UIManager.put("TabbedPane.showContentSeparator", true);
1501 // UIManager.put("TabbedPane.tabSeparatorsFullHeight", true);
1502 UIManager.put("TabbedPane.tabsOverlapBorder", true);
1503 UIManager.put("TabbedPane.hasFullBorder", true);
1504 UIManager.put("TabbedPane.tabLayoutPolicy", "scroll");
1505 UIManager.put("TabbedPane.scrollButtonsPolicy", "asNeeded");
1506 UIManager.put("TabbedPane.smoothScrolling", true);
1507 UIManager.put("TabbedPane.tabWidthMode", "compact");
1508 UIManager.put("TabbedPane.selectedBackground", Color.white);
1509 UIManager.put("TabbedPane.background", new Color(236, 236, 236));
1510 UIManager.put("TabbedPane.hoverColor", Color.lightGray);
1513 Desktop.setLiveDragMode(Cache.getDefault("FLAT_LIVE_DRAG_MODE", true));
1517 private static boolean setMacLookAndFeel()
1519 boolean set = false;
1520 System.setProperty("com.apple.mrj.application.apple.menu.about.name",
1521 ChannelProperties.getProperty("app_name"));
1522 System.setProperty("apple.laf.useScreenMenuBar", "true");
1524 * broken native LAFs on (ARM?) macbooks
1525 set = setQuaquaLookAndFeel();
1526 if ((!set) || !UIManager.getLookAndFeel().getClass().toString()
1527 .toLowerCase(Locale.ROOT).contains("quaqua"))
1529 set = setVaquaLookAndFeel();
1532 set = setFlatLookAndFeel();
1536 private static boolean setLinuxLookAndFeel()
1538 boolean set = false;
1539 set = setFlatLookAndFeel();
1541 set = setMetalLookAndFeel();
1542 // avoid GtkLookAndFeel -- not good results especially on HiDPI
1544 set = setNimbusLookAndFeel();
1549 private static void showUsage()
1552 "Usage: jalview -open [FILE] [OUTPUT_FORMAT] [OUTPUT_FILE]\n\n"
1553 + "-nodisplay\tRun Jalview without User Interface.\n"
1554 + "-props FILE\tUse the given Jalview properties file instead of users default.\n"
1555 + "-colour COLOURSCHEME\tThe colourscheme to be applied to the alignment\n"
1556 + "-annotations FILE\tAdd precalculated annotations to the alignment.\n"
1557 + "-tree FILE\tLoad the given newick format tree file onto the alignment\n"
1558 + "-features FILE\tUse the given file to mark features on the alignment.\n"
1559 + "-fasta FILE\tCreate alignment file FILE in Fasta format.\n"
1560 + "-clustal FILE\tCreate alignment file FILE in Clustal format.\n"
1561 + "-pfam FILE\tCreate alignment file FILE in PFAM format.\n"
1562 + "-msf FILE\tCreate alignment file FILE in MSF format.\n"
1563 + "-pileup FILE\tCreate alignment file FILE in Pileup format\n"
1564 + "-pir FILE\tCreate alignment file FILE in PIR format.\n"
1565 + "-blc FILE\tCreate alignment file FILE in BLC format.\n"
1566 + "-json FILE\tCreate alignment file FILE in JSON format.\n"
1567 + "-jalview FILE\tCreate alignment file FILE in Jalview format.\n"
1568 + "-png FILE\tCreate PNG image FILE from alignment.\n"
1569 + "-svg FILE\tCreate SVG image FILE from alignment.\n"
1570 + "-html FILE\tCreate HTML file from alignment.\n"
1571 + "-biojsMSA FILE\tCreate BioJS MSA Viewer HTML file from alignment.\n"
1572 + "-imgMap FILE\tCreate HTML file FILE with image map of PNG image.\n"
1573 + "-eps FILE\tCreate EPS file FILE from alignment.\n"
1574 + "-questionnaire URL\tQueries the given URL for information about any Jalview user questionnaires.\n"
1575 + "-noquestionnaire\tTurn off questionnaire check.\n"
1576 + "-nonews\tTurn off check for Jalview news.\n"
1577 + "-nousagestats\tTurn off analytics tracking for this session.\n"
1578 + "-sortbytree OR -nosortbytree\tEnable or disable sorting of the given alignment by the given tree\n"
1580 // "-setprop PROPERTY=VALUE\tSet the given Jalview property,
1581 // after all other properties files have been read\n\t
1582 // (quote the 'PROPERTY=VALUE' pair to ensure spaces are
1583 // passed in correctly)"
1584 + "-jabaws URL\tSpecify URL for Jabaws services (e.g. for a local installation).\n"
1585 + "-fetchfrom nickname\tQuery nickname for features for the alignments and display them.\n"
1586 + "-groovy FILE\tExecute groovy script in FILE, after all other arguments have been processed (if FILE is the text 'STDIN' then the file will be read from STDIN)\n"
1587 + "-jvmmempc=PERCENT\tOnly available with standalone executable jar or jalview.bin.Launcher. Limit maximum heap size (memory) to PERCENT% of total physical memory detected. This defaults to 90 if total physical memory can be detected. See https://www.jalview.org/help/html/memory.html for more details.\n"
1588 + "-jvmmemmax=MAXMEMORY\tOnly available with standalone executable jar or jalview.bin.Launcher. Limit maximum heap size (memory) to MAXMEMORY. MAXMEMORY can be specified in bytes, kilobytes(k), megabytes(m), gigabytes(g) or if you're lucky enough, terabytes(t). This defaults to 32g if total physical memory can be detected, or to 8g if total physical memory cannot be detected. See https://www.jalview.org/help/html/memory.html for more details.\n"
1589 + "\n~Read documentation in Application or visit https://www.jalview.org for description of Features and Annotations file~\n\n");
1593 private static void startUsageStats(final Desktop desktop)
1596 * start a User Config prompt asking if we can log usage statistics.
1598 PromptUserConfig prompter = new PromptUserConfig(Desktop.desktop,
1600 MessageManager.getString("prompt.plausible_analytics_title"),
1601 MessageManager.getString("prompt.plausible_analytics"),
1607 Console.debug("Initialising analytics for usage stats.");
1608 Cache.initAnalytics();
1609 Console.debug("Tracking enabled.");
1616 Console.debug("Not enabling analytics.");
1619 desktop.addDialogThread(prompter);
1623 * Locate the given string as a file and pass it to the groovy interpreter.
1625 * @param groovyscript
1626 * the script to execute
1627 * @param jalviewContext
1628 * the Jalview Desktop object passed in to the groovy binding as the
1631 protected void executeGroovyScript(String groovyscript, AlignFrame af)
1634 * for scripts contained in files
1641 if (groovyscript.trim().equals("STDIN"))
1643 // read from stdin into a tempfile and execute it
1646 tfile = File.createTempFile("jalview", "groovy");
1647 PrintWriter outfile = new PrintWriter(
1648 new OutputStreamWriter(new FileOutputStream(tfile)));
1649 BufferedReader br = new BufferedReader(
1650 new InputStreamReader(System.in));
1652 while ((line = br.readLine()) != null)
1654 outfile.write(line + "\n");
1660 } catch (Exception ex)
1662 System.err.println("Failed to read from STDIN into tempfile "
1663 + ((tfile == null) ? "(tempfile wasn't created)"
1664 : tfile.toString()));
1665 ex.printStackTrace();
1670 sfile = tfile.toURI().toURL();
1671 } catch (Exception x)
1674 "Unexpected Malformed URL Exception for temporary file created from STDIN: "
1676 x.printStackTrace();
1684 sfile = new URI(groovyscript).toURL();
1685 } catch (Exception x)
1687 tfile = new File(groovyscript);
1688 if (!tfile.exists())
1690 System.err.println("File '" + groovyscript + "' does not exist.");
1693 if (!tfile.canRead())
1695 System.err.println("File '" + groovyscript + "' cannot be read.");
1698 if (tfile.length() < 1)
1700 System.err.println("File '" + groovyscript + "' is empty.");
1705 sfile = tfile.getAbsoluteFile().toURI().toURL();
1706 } catch (Exception ex)
1708 System.err.println("Failed to create a file URL for "
1709 + tfile.getAbsoluteFile());
1716 Map<String, java.lang.Object> vbinding = new HashMap<>();
1717 vbinding.put("Jalview", this);
1720 vbinding.put("currentAlFrame", af);
1722 Binding gbinding = new Binding(vbinding);
1723 GroovyScriptEngine gse = new GroovyScriptEngine(new URL[] { sfile });
1724 gse.run(sfile.toString(), gbinding);
1725 if ("STDIN".equals(groovyscript))
1727 // delete temp file that we made -
1728 // only if it was successfully executed
1731 } catch (Exception e)
1733 System.err.println("Exception Whilst trying to execute file " + sfile
1734 + " as a groovy script.");
1735 e.printStackTrace(System.err);
1740 public static boolean isHeadlessMode()
1742 String isheadless = System.getProperty("java.awt.headless");
1743 if (isheadless != null && isheadless.equalsIgnoreCase("true"))
1750 public AlignFrame[] getAlignFrames()
1752 return desktop == null ? new AlignFrame[] { getCurrentAlignFrame() }
1753 : Desktop.getAlignFrames();
1758 * jalview.bin.Jalview.quit() will just run the non-GUI shutdownHook and exit
1762 // System.exit will run the shutdownHook first
1763 Jalview.exit("Quitting now. Bye!", 0);
1766 public static AlignFrame getCurrentAlignFrame()
1768 return Jalview.currentAlignFrame;
1771 public static void setCurrentAlignFrame(AlignFrame currentAlignFrame)
1773 Jalview.currentAlignFrame = currentAlignFrame;
1776 protected Commands getCommands()
1781 public static void exit(String message, int exitcode)
1783 if (Console.log == null)
1785 // Don't start the logger just to exit!
1786 if (message != null)
1790 System.out.println(message);
1794 System.err.println(message);
1800 Console.debug("Using Jalview.exit");
1801 if (message != null)
1805 Console.info(message);
1809 Console.error(message);
1815 System.exit(exitcode);
1819 /******************************
1821 * TEST OUTPUT METHODS
1823 ******************************/
1825 * method for reporting string values parsed/processed during tests
1828 protected static void testoutput(ArgParser ap, Arg a, String s1,
1831 BootstrapArgs bsa = ap.getBootstrapArgs();
1832 if (!bsa.getBoolean(Arg.TESTOUTPUT))
1834 if (!((s1 == null && s2 == null) || (s1 != null && s1.equals(s2))))
1836 Console.debug("testoutput with unmatching values '" + s1 + "' and '"
1837 + s2 + "' for arg " + a.argString());
1840 boolean isset = a.hasOption(Opt.BOOTSTRAP) ? bsa.contains(a)
1844 Console.warn("Arg '" + a.getName() + "' not set at all");
1847 testoutput(true, a, s1, s2);
1851 * method for reporting string values parsed/processed during tests
1854 protected static void testoutput(BootstrapArgs bsa, Arg a, String s1,
1857 if (!bsa.getBoolean(Arg.TESTOUTPUT))
1859 if (!((s1 == null && s2 == null) || (s1 != null && s1.equals(s2))))
1861 Console.debug("testoutput with unmatching values '" + s1 + "' and '"
1862 + s2 + "' for arg " + a.argString());
1865 if (!a.hasOption(Opt.BOOTSTRAP))
1867 Console.error("Non-bootstrap Arg '" + a.getName()
1868 + "' given to testoutput(BootstrapArgs bsa, Arg a, String s1, String s2) with only BootstrapArgs");
1870 if (!bsa.contains(a))
1872 Console.warn("Arg '" + a.getName() + "' not set at all");
1875 testoutput(true, a, s1, s2);
1879 * report value set for string values parsed/processed during tests
1881 private static void testoutput(boolean yes, Arg a, String s1, String s2)
1883 if (yes && ((s1 == null && s2 == null)
1884 || (s1 != null && s1.equals(s2))))
1886 System.out.println("[TESTOUTPUT] arg " + a.argString() + "='" + s1
1892 * testoutput for boolean and unary values
1894 protected static void testoutput(ArgParser ap, Arg a)
1898 BootstrapArgs bsa = ap.getBootstrapArgs();
1901 if (!bsa.getBoolean(Arg.TESTOUTPUT))
1903 boolean val = a.hasOption(Opt.BOOTSTRAP) ? bsa.getBoolean(a)
1905 boolean isset = a.hasOption(Opt.BOOTSTRAP) ? bsa.contains(a)
1909 Console.warn("Arg '" + a.getName() + "' not set at all");
1915 protected static void testoutput(BootstrapArgs bsa, Arg a)
1917 if (!bsa.getBoolean(Arg.TESTOUTPUT))
1919 if (!a.hasOption(Opt.BOOTSTRAP))
1921 Console.warn("Non-bootstrap Arg '" + a.getName()
1922 + "' given to testoutput(BootstrapArgs bsa, Arg a) with only BootstrapArgs");
1925 if (!bsa.contains(a))
1927 Console.warn("Arg '" + a.getName() + "' not set at all");
1930 testoutput(bsa.getBoolean(a), a);
1933 private static void testoutput(boolean yes, Arg a)
1935 String message = null;
1936 if (a.hasOption(Opt.BOOLEAN))
1938 message = (yes ? a.argString() : a.negateArgString()) + " was set";
1940 else if (a.hasOption(Opt.UNARY))
1942 message = a.argString() + (yes ? " was set" : " was not set");
1944 System.out.println("[TESTOUTPUT] arg " + message);