Method JavaScriptProcessor

cli/mainfeatures.cpp:507–559

! * \brief Initializes JavaScript processing for the specified \a args. * \remarks * - Comes with its own QCoreApplication. Only for use within the CLI parts of the app! * - Exits the app on fatal errors. * - Logs status/problems directly in accordance with other parts of the CLI. */

 * - Logs status/problems directly in accordance with other parts of the CLI.
 */
JavaScriptProcessor::JavaScriptProcessor(const SetTagInfoArgs &args)
    : args(args)
    , argc(0)
    , app(argc, nullptr)
    , utility(new UtilityObject(&engine))
{
    // print status message
    const auto jsPath = args.jsArg.firstValue();
    if (!jsPath) {
        return;
    }
    if (!args.quietArg.isPresent()) {
        std::cout << TextAttribute::Bold << "Loading JavaScript file \"" << jsPath << "\" ..." << Phrases::EndFlush;
    }

    // print warnings later via the usual helper function for consistent formatting
    engine.setOutputWarningsToStandardError(false);
    QObject::connect(&engine, &QQmlEngine::warnings, &engine,
        [this, context = std::string("loading JavaScript")](const auto &warnings) { addWarnings(diag, context, warnings); });

    // assign utility object and load specified JavaScript file as module
    engine.globalObject().setProperty(QStringLiteral("utility"), engine.newQObject(utility));
    module = engine.importModule(QString::fromUtf8(jsPath));
    if (module.isError()) {
        std::cerr << Phrases::Error << "Unable to load the specified JavaScript file \"" << jsPath << "\":" << Phrases::End;
        std::cerr << "Uncaught exception at line " << module.property(QStringLiteral("lineNumber")).toInt() << ':' << ' '
                  << module.toString().toStdString() << '\n';
        std::exit(EXIT_FAILURE);
    }
    main = module.property(QStringLiteral("main"));
    if (!main.isCallable()) {
        std::cerr << Phrases::Error << "The specified JavaScript file \"" << jsPath << "\" does not export a main() function." << Phrases::End;
        std::exit(EXIT_FAILURE);
    }

    // assign settings specified via CLI argument
    auto settings = engine.newObject();
    if (args.jsSettingsArg.isPresent()) {
        for (const auto *const setting : args.jsSettingsArg.values()) {
            if (const auto *const value = std::strchr(setting, '=')) {
                settings.setProperty(
                    QString::fromUtf8(setting, static_cast<QString::size_type>(value - setting)), QJSValue(QString::fromUtf8(value + 1)));
            } else {
                settings.setProperty(QString::fromUtf8(setting), QJSValue());
            }
        }
    }
    engine.globalObject().setProperty(QStringLiteral("settings"), settings);

    // print warnings
    printDiagMessages(diag, "Diagnostic messages:", args.verboseArg.isPresent(), &args.pedanticArg);
    diag.clear();
}

/*!
 * \brief Calls the JavaScript's main() function for the specified \a mediaFileInfo populating \a diag.