/*

 * Copyright (c) 2006, 2013, Oracle and/or its affiliates. All rights reserved.

 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.

 *

 * This code is free software; you can redistribute it and/or modify it

 * under the terms of the GNU General Public License version 2 only, as

 * published by the Free Software Foundation.  Oracle designates this

 * particular file as subject to the "Classpath" exception as provided

 * by Oracle in the LICENSE file that accompanied this code.

 *

 * This code is distributed in the hope that it will be useful, but WITHOUT

 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or

 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License

 * version 2 for more details (a copy is included in the LICENSE file that

 * accompanied this code).

 *

 * You should have received a copy of the GNU General Public License version

 * 2 along with this work; if not, write to the Free Software Foundation,

 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.

 *

 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA

 * or visit www.oracle.com if you need additional information or have any

 * questions.

 */

package com.sun.tools.javac.main;

import java.io.File;

import java.io.FileWriter;

import java.io.PrintWriter;

import java.util.Collections;

import java.util.EnumSet;

import java.util.LinkedHashMap;

import java.util.Map;

import java.util.Set;

import javax.lang.model.SourceVersion;

import com.sun.tools.doclint.DocLint;

import com.sun.tools.javac.code.Lint;

import com.sun.tools.javac.code.Source;

import com.sun.tools.javac.code.Type;

import com.sun.tools.javac.jvm.Target;

import com.sun.tools.javac.processing.JavacProcessingEnvironment;

import com.sun.tools.javac.util.Log;

import com.sun.tools.javac.util.Log.PrefixKind;

import com.sun.tools.javac.util.Log.WriterKind;

import com.sun.tools.javac.util.Options;

import static com.sun.tools.javac.main.Option.ChoiceKind.*;

import static com.sun.tools.javac.main.Option.OptionGroup.*;

import static com.sun.tools.javac.main.Option.OptionKind.*;

/**

 * Options for javac. The specific Option to handle a command-line option

 * is identified by searching the members of this enum in order, looking

 * the first {@link #matches match}. The action for an Option is performed

 * by calling {@link #process process}, and by providing a suitable

 * {@link OptionHelper} to provide access the compiler state.

 *

 * <p><b>This is NOT part of any supported API.

 * If you write code that depends on this, you do so at your own

 * risk.  This code and its internal interfaces are subject to change

 * or deletion without notice.</b></p>

 */

public enum Option {

    G("-g", "opt.g", STANDARD, BASIC),

    G_NONE("-g:none", "opt.g.none", STANDARD, BASIC) {

        @Override

        public boolean process(OptionHelper helper, String option) {

            helper.put("-g:", "none");

            return false;

        }

    },

    G_CUSTOM("-g:",  "opt.g.lines.vars.source",

            STANDARD, BASIC, ANYOF, "lines", "vars", "source"),

    XLINT("-Xlint", "opt.Xlint", EXTENDED, BASIC),

    XLINT_CUSTOM("-Xlint:", "opt.Xlint.suboptlist",

            EXTENDED,   BASIC, ANYOF, getXLintChoices()),

    XDOCLINT("-Xdoclint", "opt.Xdoclint", EXTENDED, BASIC),

    XDOCLINT_CUSTOM("-Xdoclint:", "opt.Xdoclint.subopts", "opt.Xdoclint.custom", EXTENDED, BASIC) {

        @Override

        public boolean matches(String option) {

            return DocLint.isValidOption(

                    option.replace(XDOCLINT_CUSTOM.text, DocLint.XMSGS_CUSTOM_PREFIX));

        }

        @Override

        public boolean process(OptionHelper helper, String option) {

            String prev = helper.get(XDOCLINT_CUSTOM);

            String next = (prev == null) ? option : (prev + " " + option);

            helper.put(XDOCLINT_CUSTOM.text, next);

            return false;

        }

    },

    // -nowarn is retained for command-line backward compatibility

    NOWARN("-nowarn", "opt.nowarn", STANDARD, BASIC) {

        @Override

        public boolean process(OptionHelper helper, String option) {

            helper.put("-Xlint:none", option);

            return false;

        }

    },

    VERBOSE("-verbose", "opt.verbose", STANDARD, BASIC),

    // -deprecation is retained for command-line backward compatibility

    DEPRECATION("-deprecation", "opt.deprecation", STANDARD, BASIC) {

        @Override

        public boolean process(OptionHelper helper, String option) {

            helper.put("-Xlint:deprecation", option);

            return false;

        }

    },

    CLASSPATH("-classpath", "opt.arg.path", "opt.classpath", STANDARD, FILEMANAGER),

    CP("-cp", "opt.arg.path", "opt.classpath", STANDARD, FILEMANAGER) {

        @Override

        public boolean process(OptionHelper helper, String option, String arg) {

            return super.process(helper, "-classpath", arg);

        }

    },

    SOURCEPATH("-sourcepath", "opt.arg.path", "opt.sourcepath", STANDARD, FILEMANAGER),

    BOOTCLASSPATH("-bootclasspath", "opt.arg.path", "opt.bootclasspath", STANDARD, FILEMANAGER) {

        @Override

        public boolean process(OptionHelper helper, String option, String arg) {

            helper.remove("-Xbootclasspath/p:");

            helper.remove("-Xbootclasspath/a:");

            return super.process(helper, option, arg);

        }

    },

    XBOOTCLASSPATH_PREPEND("-Xbootclasspath/p:", "opt.arg.path", "opt.Xbootclasspath.p", EXTENDED, FILEMANAGER),

    XBOOTCLASSPATH_APPEND("-Xbootclasspath/a:", "opt.arg.path", "opt.Xbootclasspath.a", EXTENDED, FILEMANAGER),

    XBOOTCLASSPATH("-Xbootclasspath:", "opt.arg.path", "opt.bootclasspath", EXTENDED, FILEMANAGER) {

        @Override

        public boolean process(OptionHelper helper, String option, String arg) {

            helper.remove("-Xbootclasspath/p:");

            helper.remove("-Xbootclasspath/a:");

            return super.process(helper, "-bootclasspath", arg);

        }

    },

    EXTDIRS("-extdirs", "opt.arg.dirs", "opt.extdirs", STANDARD, FILEMANAGER),

    DJAVA_EXT_DIRS("-Djava.ext.dirs=", "opt.arg.dirs", "opt.extdirs", EXTENDED, FILEMANAGER) {

        @Override

        public boolean process(OptionHelper helper, String option, String arg) {

            return super.process(helper, "-extdirs", arg);

        }

    },

    ENDORSEDDIRS("-endorseddirs", "opt.arg.dirs", "opt.endorseddirs", STANDARD, FILEMANAGER),

    DJAVA_ENDORSED_DIRS("-Djava.endorsed.dirs=", "opt.arg.dirs", "opt.endorseddirs", EXTENDED, FILEMANAGER) {

        @Override

        public boolean process(OptionHelper helper, String option, String arg) {

            return super.process(helper, "-endorseddirs", arg);

        }

    },

    PROC("-proc:", "opt.proc.none.only", STANDARD, BASIC,  ONEOF, "none", "only"),

    PROCESSOR("-processor", "opt.arg.class.list", "opt.processor", STANDARD, BASIC),

    PROCESSORPATH("-processorpath", "opt.arg.path", "opt.processorpath", STANDARD, FILEMANAGER),

    PARAMETERS("-parameters","opt.parameters", STANDARD, BASIC),

    D("-d", "opt.arg.directory", "opt.d", STANDARD, FILEMANAGER),

    S("-s", "opt.arg.directory", "opt.sourceDest", STANDARD, FILEMANAGER),

    H("-h", "opt.arg.directory", "opt.headerDest", STANDARD, FILEMANAGER),

    IMPLICIT("-implicit:", "opt.implicit", STANDARD, BASIC, ONEOF, "none", "class"),

    ENCODING("-encoding", "opt.arg.encoding", "opt.encoding", STANDARD, FILEMANAGER) {

        @Override

        public boolean process(OptionHelper helper, String option, String operand) {

            return super.process(helper, option, operand);

        }

    },

    SOURCE("-source", "opt.arg.release", "opt.source", STANDARD, BASIC) {

        @Override

        public boolean process(OptionHelper helper, String option, String operand) {

            Source source = Source.lookup(operand);

            if (source == null) {

                helper.error("err.invalid.source", operand);

                return true;

            }

            return super.process(helper, option, operand);

        }

    },

    TARGET("-target", "opt.arg.release", "opt.target", STANDARD, BASIC) {

        @Override

        public boolean process(OptionHelper helper, String option, String operand) {

            Target target = Target.lookup(operand);

            if (target == null) {

                helper.error("err.invalid.target", operand);

                return true;

            }

            return super.process(helper, option, operand);

        }

    },

    VERSION("-version", "opt.version", STANDARD, INFO) {

        @Override

        public boolean process(OptionHelper helper, String option) {

            Log log = helper.getLog();

            String ownName = helper.getOwnName();

            log.printLines(PrefixKind.JAVAC, "version", ownName,  JavaCompiler.version());

            return super.process(helper, option);

        }

    },

    FULLVERSION("-fullversion", null, HIDDEN, INFO) {

        @Override

        public boolean process(OptionHelper helper, String option) {

            Log log = helper.getLog();

            String ownName = helper.getOwnName();

            log.printLines(PrefixKind.JAVAC, "fullVersion", ownName,  JavaCompiler.fullVersion());

            return super.process(helper, option);

        }

    },

    DIAGS("-XDdiags=", null, HIDDEN, INFO) {

        @Override

        public boolean process(OptionHelper helper, String option) {

            option = option.substring(option.indexOf('=') + 1);

            String diagsOption = option.contains("%") ?

                "-XDdiagsFormat=" :

                "-XDdiags=";

            diagsOption += option;

            if (XD.matches(diagsOption))

                return XD.process(helper, diagsOption);

            else

                return false;

        }

    },

    HELP("-help", "opt.help", STANDARD, INFO) {

        @Override

        public boolean process(OptionHelper helper, String option) {

            Log log = helper.getLog();

            String ownName = helper.getOwnName();

            log.printLines(PrefixKind.JAVAC, "msg.usage.header", ownName);

            for (Option o: getJavaCompilerOptions()) {

                o.help(log, OptionKind.STANDARD);

            }

            log.printNewline();

            return super.process(helper, option);

        }

    },

    A("-A", "opt.arg.key.equals.value", "opt.A", STANDARD, BASIC, true) {

        @Override

        public boolean matches(String arg) {

            return arg.startsWith("-A");

        }

        @Override

        public boolean hasArg() {

            return false;

        }

        // Mapping for processor options created in

        // JavacProcessingEnvironment

        @Override

        public boolean process(OptionHelper helper, String option) {

            int argLength = option.length();

            if (argLength == 2) {

                helper.error("err.empty.A.argument");

                return true;

            }

            int sepIndex = option.indexOf('=');

            String key = option.substring(2, (sepIndex != -1 ? sepIndex : argLength) );

            if (!JavacProcessingEnvironment.isValidOptionName(key)) {

                helper.error("err.invalid.A.key", option);

                return true;

            }

            return process(helper, option, option);

        }

    },

    X("-X", "opt.X", STANDARD, INFO) {

        @Override

        public boolean process(OptionHelper helper, String option) {

            Log log = helper.getLog();

            for (Option o: getJavaCompilerOptions()) {

                o.help(log, OptionKind.EXTENDED);

            }

            log.printNewline();

            log.printLines(PrefixKind.JAVAC, "msg.usage.nonstandard.footer");

            return super.process(helper, option);

        }

    },

    // This option exists only for the purpose of documenting itself.

    // It's actually implemented by the launcher.

    J("-J", "opt.arg.flag", "opt.J", STANDARD, INFO, true) {

        @Override

        public boolean process(OptionHelper helper, String option) {

            throw new AssertionError

                ("the -J flag should be caught by the launcher.");

        }

    },

    MOREINFO("-moreinfo", null, HIDDEN, BASIC) {

        @Override

        public boolean process(OptionHelper helper, String option) {

            Type.moreInfo = true;

            return super.process(helper, option);

        }

    },

    // treat warnings as errors

    WERROR("-Werror", "opt.Werror", STANDARD, BASIC),

    // prompt after each error

    // new Option("-prompt",                                        "opt.prompt"),

    PROMPT("-prompt", null, HIDDEN, BASIC),

    // dump stack on error

    DOE("-doe", null, HIDDEN, BASIC),

    // output source after type erasure

    PRINTSOURCE("-printsource", null, HIDDEN, BASIC),

    // display warnings for generic unchecked operations

    WARNUNCHECKED("-warnunchecked", null, HIDDEN, BASIC) {

        @Override

        public boolean process(OptionHelper helper, String option) {

            helper.put("-Xlint:unchecked", option);

            return false;

        }

    },

    XMAXERRS("-Xmaxerrs", "opt.arg.number", "opt.maxerrs", EXTENDED, BASIC),

    XMAXWARNS("-Xmaxwarns", "opt.arg.number", "opt.maxwarns", EXTENDED, BASIC),

    XSTDOUT("-Xstdout", "opt.arg.file", "opt.Xstdout", EXTENDED, INFO) {

        @Override

        public boolean process(OptionHelper helper, String option, String arg) {

            try {

                Log log = helper.getLog();

                // TODO: this file should be closed at the end of compilation

                log.setWriters(new PrintWriter(new FileWriter(arg), true));

            } catch (java.io.IOException e) {

                helper.error("err.error.writing.file", arg, e);

                return true;

            }

            return super.process(helper, option, arg);

        }

    },

    XPRINT("-Xprint", "opt.print", EXTENDED, BASIC),

    XPRINTROUNDS("-XprintRounds", "opt.printRounds", EXTENDED, BASIC),

    XPRINTPROCESSORINFO("-XprintProcessorInfo", "opt.printProcessorInfo", EXTENDED, BASIC),

    XPREFER("-Xprefer:", "opt.prefer", EXTENDED, BASIC, ONEOF, "source", "newer"),

    XPKGINFO("-Xpkginfo:", "opt.pkginfo", EXTENDED, BASIC, ONEOF, "always", "legacy", "nonempty"),

    /* -O is a no-op, accepted for backward compatibility. */

    O("-O", null, HIDDEN, BASIC),

    /* -Xjcov produces tables to support the code coverage tool jcov. */

    XJCOV("-Xjcov", null, HIDDEN, BASIC),

    PLUGIN("-Xplugin:", "opt.arg.plugin", "opt.plugin", EXTENDED, BASIC) {

        @Override

        public boolean process(OptionHelper helper, String option) {

            String p = option.substring(option.indexOf(':') + 1);

            String prev = helper.get(PLUGIN);

            helper.put(PLUGIN.text, (prev == null) ? p : prev + '\0' + p.trim());

            return false;

        }

    },

    /* This is a back door to the compiler's option table.

     * -XDx=y sets the option x to the value y.

     * -XDx sets the option x to the value x.

     */

    XD("-XD", null, HIDDEN, BASIC) {

        @Override

        public boolean matches(String s) {

            return s.startsWith(text);

        }

        @Override

        public boolean process(OptionHelper helper, String option) {

            option = option.substring(text.length());

            int eq = option.indexOf('=');

            String key = (eq < 0) ? option : option.substring(0, eq);

            String value = (eq < 0) ? option : option.substring(eq+1);

            helper.put(key, value);

            return false;

        }

    },

    // This option exists only for the purpose of documenting itself.

    // It's actually implemented by the CommandLine class.

    AT("@", "opt.arg.file", "opt.AT", STANDARD, INFO, true) {

        @Override

        public boolean process(OptionHelper helper, String option) {

            throw new AssertionError("the @ flag should be caught by CommandLine.");

        }

    },

    /*

     * TODO: With apt, the matches method accepts anything if

     * -XclassAsDecls is used; code elsewhere does the lookup to

     * see if the class name is both legal and found.

     *

     * In apt, the process method adds the candidate class file

     * name to a separate list.

     */

    SOURCEFILE("sourcefile", null, HIDDEN, INFO) {

        @Override

        public boolean matches(String s) {

            return s.endsWith(".java")  // Java source file

                || SourceVersion.isName(s);   // Legal type name

        }

        @Override

        public boolean process(OptionHelper helper, String option) {

            if (option.endsWith(".java") ) {

                File f = new File(option);

                if (!f.exists()) {

                    helper.error("err.file.not.found", f);

                    return true;

                }

                if (!f.isFile()) {

                    helper.error("err.file.not.file", f);

                    return true;

                }

                helper.addFile(f);

            } else {

                helper.addClassName(option);

            }

            return false;

        }

    };

    /** The kind of an Option. This is used by the -help and -X options. */

    public enum OptionKind {

        /** A standard option, documented by -help. */

        STANDARD,

        /** An extended option, documented by -X. */

        EXTENDED,

        /** A hidden option, not documented. */

        HIDDEN,

    }

    /** The group for an Option. This determines the situations in which the

     *  option is applicable. */

    enum OptionGroup {

        /** A basic option, available for use on the command line or via the

         *  Compiler API. */

        BASIC,

        /** An option for javac's standard JavaFileManager. Other file managers

         *  may or may not support these options. */

        FILEMANAGER,

        /** A command-line option that requests information, such as -help. */

        INFO,

        /** A command-line "option" representing a file or class name. */

        OPERAND

    }

    /** The kind of choice for "choice" options. */

    enum ChoiceKind {

        /** The expected value is exactly one of the set of choices. */

        ONEOF,

        /** The expected value is one of more of the set of choices. */

        ANYOF

    }

    public final String text;

    final OptionKind kind;

    final OptionGroup group;

    /** Documentation key for arguments.

     */

    final String argsNameKey;

    /** Documentation key for description.

     */

    final String descrKey;

    /** Suffix option (-foo=bar or -foo:bar)

     */