8#include "katedocument.h"
9#include "katescriptdocument.h"
10#include "katescriptview.h"
12#include "ktexteditor_version.h"
13#include "scripttester_p.h"
17#include <QApplication>
18#include <QCommandLineOption>
19#include <QCommandLineParser>
20#include <QDirIterator>
24#include <QStandardPaths>
25#include <QVarLengthArray>
26#include <QtEnvironmentVariables>
34constexpr QStringView operator""_sv(
const char16_t *str,
size_t size)
noexcept
39using ScriptTester = KTextEditor::ScriptTester;
40using TextFormat = ScriptTester::DocumentTextFormat;
41using TestFormatOption = ScriptTester::TestFormatOption;
42using PatternType = ScriptTester::PatternType;
43using DebugOption = ScriptTester::DebugOption;
45constexpr inline ScriptTester::Format::TextReplacement defaultTextReplacement{
50constexpr inline ScriptTester::Placeholders defaultPlaceholder{
52 .selectionStart = u
'[',
54 .secondaryCursor = u
'\0',
55 .secondarySelectionStart = u
'\0',
56 .secondarySelectionEnd = u
'\0',
59constexpr inline ScriptTester::Placeholders defaultFallbackPlaceholders{
61 .selectionStart = u
'[',
63 .secondaryCursor = u
'┆',
64 .secondarySelectionStart = u
'❲',
65 .secondarySelectionEnd = u
'❳',
77struct ScriptTesterQuery {
78 ScriptTester::Format format{.debugOptions = DebugOption::WriteLocation | DebugOption::WriteFunction,
79 .testFormatOptions = TestFormatOption::None,
80 .documentTextFormat = TextFormat::ReplaceNewLineAndTabWithLiteral,
81 .documentTextFormatWithBlockSelection = TextFormat::ReplaceNewLineAndTabWithPlaceholder,
82 .textReplacement = defaultTextReplacement,
83 .fallbackPlaceholders = defaultFallbackPlaceholders,
86 .success = u
"\033[32m"_s,
87 .error = u
"\033[31m"_s,
88 .carret = u
"\033[31m"_s,
89 .debugMarker = u
"\033[31;1m"_s,
90 .debugMsg = u
"\033[31m"_s,
91 .testName = u
"\x1b[36m"_s,
92 .program = u
"\033[32m"_s,
93 .fileName = u
"\x1b[34m"_s,
94 .lineNumber = u
"\x1b[35m"_s,
95 .blockSelectionInfo = u
"\x1b[37m"_s,
96 .labelInfo = u
"\x1b[37m"_s,
97 .cursor = u
"\x1b[40;1;33m"_s,
98 .selection = u
"\x1b[40;1;33m"_s,
99 .secondaryCursor = u
"\x1b[40;33m"_s,
100 .secondarySelection = u
"\x1b[40;33m"_s,
101 .blockSelection = u
"\x1b[40;37m"_s,
102 .inSelection = u
"\x1b[4m"_s,
103 .virtualText = u
"\x1b[40;37m"_s,
104 .result = u
"\x1b[40m"_s,
105 .resultReplacement = u
"\x1b[40;36m"_s,
108 ScriptTester::Paths paths{
110 .libraries = {u
":/ktexteditor/script/libraries"_s},
116 ScriptTester::TestExecutionConfig executionConfig;
118 ScriptTester::DiffCommand diff;
134 DualMode dualMode = DualMode::Dual;
136 bool showPreamble =
false;
137 bool extendedDebug =
false;
138 bool restoreXdgDataDirs =
false;
150 static TrueColor fromRGB(
QStringView color,
bool isBg)
152 auto toHex = [](
QChar c) {
153 if (c <= u
'9' && c >= u
'0') {
154 return c.unicode() - u
'0';
156 if (c <= u
'f' && c >= u
'a') {
157 return c.unicode() - u
'a';
159 if (c <= u
'F' && c >= u
'A') {
160 return c.unicode() - u
'A';
171 if (color.
size() == 4) {
180 else if (color.
size() == 7) {
181 r = (toHex(color[1]) << 4) + toHex(color[2]);
182 g = (toHex(color[3]) << 4) + toHex(color[4]);
183 b = (toHex(color[5]) << 4) + toHex(color[6]);
191 auto *p = trueColor.ansi;
192 auto pushComponent = [&](
int color) {
194 *p++ =
"0123456789"[color / 100];
196 *p++ =
"0123456789"[color / 10];
197 }
else if (color > 9) {
198 *p++ =
"0123456789"[color / 10];
200 *p++ =
"0123456789"[color % 10];
207 trueColor.len = p - trueColor.ansi;
208 trueColor.isBg = isBg;
232 qsizetype totalLen = 0;
233 bool hasDefaultColor = !defaultColor.
isEmpty();
235 if (colors.isEmpty()) {
236 result = defaultColor;
244 for (
auto &color : colors) {
246 if (color[0] <= u
'9' && color[0] >= u
'0') {
248 for (
auto c : color) {
249 if (c > u
'9' && c < u
'0' && c != u
';') {
255 const bool isBg = color.startsWith(u
"bg=");
256 auto s = isBg ? color.sliced(3) : color;
257 const bool isBright = s.startsWith(u
"bright-");
258 s = isBright ? s.sliced(7) : s;
267 const auto trueColor = TrueColor::fromRGB(s, isBg);
268 if (!trueColor.len) {
272 totalLen += 5 + trueColor.len;
273 trueColors += trueColor;
276 }
else if (s == u
"black"_sv) {
277 color = SVs{u
"30"_sv, u
"40"_sv, u
"90"_sv, u
"100"_sv}[isBg + isBright * 2];
278 }
else if (s == u
"red"_sv) {
279 color = SVs{u
"31"_sv, u
"41"_sv, u
"91"_sv, u
"101"_sv}[isBg + isBright * 2];
280 }
else if (s == u
"green"_sv) {
281 color = SVs{u
"32"_sv, u
"42"_sv, u
"92"_sv, u
"102"_sv}[isBg + isBright * 2];
282 }
else if (s == u
"yellow"_sv) {
283 color = SVs{u
"33"_sv, u
"43"_sv, u
"93"_sv, u
"103"_sv}[isBg + isBright * 2];
284 }
else if (s == u
"blue"_sv) {
285 color = SVs{u
"34"_sv, u
"44"_sv, u
"94"_sv, u
"104"_sv}[isBg + isBright * 2];
286 }
else if (s == u
"magenta"_sv) {
287 color = SVs{u
"35"_sv, u
"45"_sv, u
"95"_sv, u
"105"_sv}[isBg + isBright * 2];
288 }
else if (s == u
"cyan"_sv) {
289 color = SVs{u
"36"_sv, u
"46"_sv, u
"96"_sv, u
"106"_sv}[isBg + isBright * 2];
290 }
else if (s == u
"white"_sv) {
291 color = SVs{u
"37"_sv, u
"47"_sv, u
"97"_sv, u
"107"_sv}[isBg + isBright * 2];
293 }
else if (!isBg && !isBright && s == u
"bold"_sv) {
295 }
else if (!isBg && !isBright && s == u
"dim"_sv) {
297 }
else if (!isBg && !isBright && s == u
"italic"_sv) {
299 }
else if (!isBg && !isBright && s == u
"underline"_sv) {
301 }
else if (!isBg && !isBright && s == u
"reverse"_sv) {
303 }
else if (!isBg && !isBright && s == u
"strike"_sv) {
305 }
else if (!isBg && !isBright && s == u
"doubly-underlined"_sv) {
307 }
else if (!isBg && !isBright && s == u
"overlined"_sv) {
316 totalLen += color.size() + 1;
319 if (hasDefaultColor) {
320 totalLen += defaultColor.
size() - 2;
325 if (!hasDefaultColor) {
326 result += u
"\x1b["_sv;
328 result += defaultColor;
329 result.
back() = u
';';
335 auto const *trueColorIt = trueColors.
constData();
336 for (
const auto &color : std::as_const(colors)) {
337 if (!color.isEmpty()) {
340 result += trueColorIt->isBg ? u
"48;2;"_sv : u
"38;2;"_sv;
341 result += trueColorIt->sv();
347 result.
back() = u
'm';
349 result = defaultColor;
357 auto tr = [&app](
char const *s) {
358 return app.
translate(
"KateScriptTester", s);
361 const auto translatedFolder = tr(
"folder");
362 const auto translatedOption = tr(
"option");
363 const auto translatedPattern = tr(
"pattern");
364 const auto translatedPlaceholder = tr(
"character");
365 const auto translatedColors = tr(
"colors");
368 parser.
addPositionalArgument(tr(
"file.js"), tr(
"Test files to run. If file.js represents a folder, this is equivalent to `path/*.js`."), tr(
"file.js..."));
373 {{u
"t"_s, u
"text"_s}, tr(
"Files are treated as javascript code rather than file names.")},
378 {{u
"e"_s, u
"max-error"_s}, tr(
"Maximum number of tests that can fail before stopping.")},
379 {u
"q"_s, tr(
"Alias of --max-error=1.")},
380 {{u
"E"_s, u
"expected-failure-as-failure"_s}, tr(
"functions xcmd() and xtest() will always fail.")},
385 {{u
"s"_s, u
"script"_s},
386 tr(
"Shorcut for --command=${script}/commands --command=${script}/indentation --library=${script}/library --file=${script}/files."),
388 {{u
"c"_s, u
"command"_s}, tr(
"Adds a search folder for loadScript()."), translatedFolder},
389 {{u
"l"_s, u
"library"_s}, tr(
"Adds a search folder for require() (KTextEditor JS API)."), translatedFolder},
390 {{u
"r"_s, u
"file"_s}, tr(
"Adds a search folder for read() (KTextEditor JS API)."), translatedFolder},
391 {{u
"m"_s, u
"module"_s}, tr(
"Adds a search folder for loadModule()."), translatedFolder},
392 {{u
"I"_s, u
"indent-data-test"_s}, tr(
"Set indentation base directory for indentFiles()."), translatedFolder},
397 {{u
"D"_s, u
"diff-path"_s}, tr(
"Path of diff command."), tr(
"path")},
398 {{u
"A"_s, u
"diff-arg"_s}, tr(
"Argument for diff command. Call this option several times to set multiple parameters."), translatedOption},
403 {{u
"d"_s, u
"debug"_s},
404 tr(
"Concerning the display of the debug() function. Can be used multiple times to change multiple options.\n"
405 "- location: displays the file and line number of the call (enabled by default)\n"
406 "- function: displays the name of the function that uses debug() (enabled by default)\n"
407 "- stacktrace: show the call stack after the debug message\n"
408 "- flush: debug messages are normally buffered and only displayed in case of error. This option removes buffering\n"
409 "- extended: debug() can take several parameters of various types such as Array or Object. This behavior is specific and should not be exploited "
411 "- no-location: inverse of location\n"
412 "- no-function: inverse of function\n"
413 "- no-stacktrace: inverse of stacktrace\n"
414 "- no-flush: inverse of flush\n"
415 "- all: enable all\n"
416 "- none: disable all"),
418 {{u
"H"_s, u
"hidden-name"_s}, tr(
"Do not display test names.")},
419 {{u
"p"_s, u
"parade"_s}, tr(
"Displays all tests run or skipped. By default, only error tests are displayed.")},
420 {{u
"V"_s, u
"verbose"_s}, tr(
"Displays input and ouput on each tests. By default, only error tests are displayed.")},
421 {{u
"f"_s, u
"format"_s},
422 tr(
"Defines the document text display format:\n"
423 "- raw: no transformation\n"
424 "- js: display in literal string in javascript format\n"
425 "- literal: replaces new lines and tabs with \\n and \\t (default)\n"
426 "- placeholder: replaces new lines and tabs with placeholders specified by --newline and --tab\n"
427 "- placeholder2: replaces tabs with the placeholder specified by --tab\n"),
429 {{u
"F"_s, u
"block-format"_s}, tr(
"Same as --format, but with block selection text."), translatedOption},
434 {{u
"k"_s, u
"filter"_s}, tr(
"Only runs tests whose name matches a regular expression."), translatedPattern},
435 {u
"K"_s, tr(
"Only runs tests whose name does not matches a regular expression."), translatedPattern},
441 tr(
"Character used to replace a tab in the test display with --format=placeholder. If 2 characters are given, the second corresponds the last "
442 "character replaced. --tab='->' with tabWith=4 gives '--->'."),
443 translatedPlaceholder},
444 {{u
"N"_s, u
"nl"_s, u
"newline"_s}, tr(
"Character used to replace a new line in the test display with --format=placeholder."), translatedPlaceholder},
445 {{u
"P"_s, u
"placeholders"_s},
446 tr(
"Characters used to represent cursors or selections when the test does not specify any, or when the same character represents more than one thing. "
449 "- selection start\n"
451 "- secondary cursor\n"
452 "- secondary selection start\n"
453 "- secondary selection end\n"
460 {{u
"b"_s, u
"dual"_s},
461 tr(
"Change DUAL_MODE and ALWAYS_DUAL_MODE constants behavior:\n"
462 "- noblock: never block selection (equivalent to setConfig({blockSelection=0}))\n"
463 "- block: always block selection (equivalent to setConfig({blockSelection=1}))\n"
464 "- always-dual: DUAL_MODE = ALWAYS_DUAL_MODE\n"
465 "- no-always-dual: ALWAYS_DUAL_MODE = DUAL_MODE\n"
466 "- dual: default behavior"),
469 {u
"B"_s, tr(
"Alias of --dual=noblock.")},
471 {u
"arg"_s, tr(
"Argument add to 'argv' variable in test scripts. Call this option several times to set multiple parameters."), tr(
"arg")},
474 tr(
"Uses a different preamble than the default. The result must be a function whose first parameter is the global environment, second is 'argv' array "
475 "and 'this' refers to the internal object.\n"
476 "The {CODE} substring will be replaced by the test code."),
479 {u
"print-preamble"_s, tr(
"Show preamble.")},
482 tr(
"To ensure that tests are not disrupted by system files, the XDG_DATA_DIRS environment variable is replaced by a non-existent folder.\n"
483 "Unfortunately, indentation files are not accessible with indentFiles(), nor are syntax files, according to the KSyntaxHighlighting compilation "
485 "This option cancels the value replacement.")},
487 {u
"X"_s, tr(
"force a value for XDG_DATA_DIRS and ignore -x."), tr(
"path")},
489 {{u
"S"_s, u
"set-variable"_s},
490 tr(
"Set document variables before running a test file. This is equivalent to `document.setVariable(key, value)` at the start of the file. Call this "
491 "option several times to set multiple parameters."),
497 {u
"no-color"_s, tr(
"No color on the output")},
499 {u
"color-reset"_s, tr(
"Sequence to reset color and style."), translatedColors},
500 {u
"color-success"_s, tr(
"Color for success."), translatedColors},
501 {u
"color-error"_s, tr(
"Color for error or exception."), translatedColors},
502 {u
"color-carret"_s, tr(
"Color for '^~~' under error position."), translatedColors},
503 {u
"color-debug-marker"_s, tr(
"Color for 'DEBUG:' and 'PRINT:' prefixes inserted with debug(), print() and printSep()."), translatedColors},
504 {u
"color-debug-message"_s, tr(
"Color for message with debug()."), translatedColors},
505 {u
"color-test-name"_s, tr(
"Color for name of the test."), translatedColors},
506 {u
"color-program"_s, tr(
"Color for program paramater in cmd() / test() and function name in stacktrace."), translatedColors},
507 {u
"color-file"_s, tr(
"Color for file name."), translatedColors},
508 {u
"color-line"_s, tr(
"Color for line number."), translatedColors},
509 {u
"color-block-selection-info"_s, tr(
"Color for [blockSelection=...] in a check."), translatedColors},
510 {u
"color-label-info"_s, tr(
"Color for 'input', 'output', 'result' label when it is displayed as information and not as an error."), translatedColors},
511 {u
"color-cursor"_s, tr(
"Color for cursor placeholder."), translatedColors},
512 {u
"color-selection"_s, tr(
"Color for selection placeholder."), translatedColors},
513 {u
"color-secondary-cursor"_s, tr(
"Color for secondary cursor placeholder."), translatedColors},
514 {u
"color-secondary-selection"_s, tr(
"Color for secondary selection placeholder."), translatedColors},
515 {u
"color-block-selection"_s, tr(
"Color for block selection placeholder."), translatedColors},
516 {u
"color-in-selection"_s, tr(
"Style added for text inside a selection."), translatedColors},
517 {u
"color-virtual-text"_s, tr(
"Color for virtual text placeholder."), translatedColors},
518 {u
"color-replacement"_s, tr(
"Color for text replaced by --format=placeholder."), translatedColors},
519 {u
"color-text-result"_s, tr(
"Color for text representing the inputs and outputs."), translatedColors},
521 tr(
"Color added to all colors used to display a result:\n"
523 "--color-selection\n"
524 "--color-secondary-cursor\n"
525 "--color-secondary-selection\n"
526 "--color-block-selection\n"
527 "--color-virtual-text\n"
528 "--color-replacement\n"
529 "--color-text-result."),
535struct CommandLineParseResult {
542 Status statusCode = Status::Ok;
546CommandLineParseResult parseCommandLine(
QCommandLineParser &parser, ScriptTesterQuery *query)
548 using Status = CommandLineParseResult::Status;
554 return {Status::Error, parser.
errorText()};
556 if (parser.
isSet(u
"v"_s))
557 return {Status::VersionRequested};
559 if (parser.
isSet(u
"h"_s))
560 return {Status::HelpRequested};
564 if (parser.
isSet(u
"q"_s)) {
565 query->executionConfig.maxError = 1;
567 if (parser.
isSet(u
"e"_s)) {
571 return {Status::Error, u
"--max-error: invalid number"_s};
574 query->executionConfig.xCheckAsFailure = parser.
isSet(u
"E"_s);
576 if (parser.
isSet(u
"s"_s)) {
582 const auto paths = parser.
values(u
"s"_s);
583 for (
const auto &path : paths) {
584 addPath(
query->paths.scripts, path + u
"/command"_sv);
585 addPath(
query->paths.scripts, path + u
"/indentation"_sv);
586 addPath(
query->paths.libraries, path + u
"/library"_sv);
587 addPath(
query->paths.files, path + u
"/files"_sv);
592 if (parser.
isSet(opt)) {
593 const auto paths = parser.
values(opt);
594 for (
const auto &path : paths) {
600 setPaths(
query->paths.scripts, u
"c"_s);
601 setPaths(
query->paths.libraries, u
"l"_s);
602 setPaths(
query->paths.files, u
"r"_s);
603 setPaths(
query->paths.modules, u
"m"_s);
604 query->paths.indentBaseDir = parser.
value(u
"I"_s);
606 if (parser.
isSet(u
"d"_s)) {
607 const auto value = parser.
value(u
"d"_s);
608 if (value == u
"location"_sv) {
609 query->format.debugOptions |= DebugOption::WriteLocation;
610 }
else if (value == u
"function"_sv) {
611 query->format.debugOptions |= DebugOption::WriteFunction;
612 }
else if (value == u
"stacktrace"_sv) {
613 query->format.debugOptions |= DebugOption::WriteStackTrace;
614 }
else if (value == u
"flush"_sv) {
615 query->format.debugOptions |= DebugOption::ForceFlush;
616 }
else if (value == u
"extended"_sv) {
617 query->extendedDebug =
true;
618 }
else if (value == u
"no-location"_sv) {
619 query->format.debugOptions.setFlag(DebugOption::WriteLocation,
false);
620 }
else if (value == u
"no-function"_sv) {
621 query->format.debugOptions.setFlag(DebugOption::WriteFunction,
false);
622 }
else if (value == u
"no-stacktrace"_sv) {
623 query->format.debugOptions.setFlag(DebugOption::WriteStackTrace,
false);
624 }
else if (value == u
"no-flush"_sv) {
625 query->format.debugOptions.setFlag(DebugOption::ForceFlush,
false);
626 }
else if (value == u
"no-extended"_sv) {
627 query->extendedDebug =
false;
628 }
else if (value == u
"all"_sv) {
629 query->extendedDebug =
true;
630 query->format.debugOptions = DebugOption::WriteLocation | DebugOption::WriteFunction | DebugOption::WriteStackTrace | DebugOption::ForceFlush;
631 }
else if (value == u
"none"_sv) {
632 query->extendedDebug =
false;
633 query->format.debugOptions = {};
635 return {Status::Error, u
"--debug: invalid value"_s};
639 if (parser.
isSet(u
"H"_s)) {
640 query->format.testFormatOptions |= TestFormatOption::HiddenTestName;
642 if (parser.
isSet(u
"p"_s)) {
643 query->format.testFormatOptions |= TestFormatOption::AlwaysWriteLocation;
645 if (parser.
isSet(u
"V"_s)) {
646 query->format.testFormatOptions |= TestFormatOption::AlwaysWriteInputOutput;
650 if (parser.
isSet(opt)) {
651 const auto value = parser.
value(opt);
652 if (value == u
"raw"_sv) {
653 textFormat = TextFormat::Raw;
654 }
else if (value == u
"js"_sv) {
655 textFormat = TextFormat::EscapeForDoubleQuote;
656 }
else if (value == u
"placeholder"_sv) {
657 textFormat = TextFormat::ReplaceNewLineAndTabWithPlaceholder;
658 }
else if (value == u
"placeholder2"_sv) {
659 textFormat = TextFormat::ReplaceTabWithPlaceholder;
660 }
else if (value == u
"literal"_sv) {
661 textFormat = TextFormat::ReplaceNewLineAndTabWithLiteral;
668 if (!setFormat(
query->format.documentTextFormat, u
"f"_s)) {
669 return {Status::Error, u
"--format: invalid value"_s};
671 if (!setFormat(
query->format.documentTextFormatWithBlockSelection, u
"F"_s)) {
672 return {Status::Error, u
"--block-format: invalid value"_s};
675 auto setPattern = [&parser, &
query](
QString opt, PatternType patternType) {
676 if (parser.
isSet(opt)) {
678 query->executionConfig.pattern.setPattern(parser.
value(opt));
679 if (!
query->executionConfig.pattern.isValid()) {
682 query->executionConfig.patternType = patternType;
687 if (!setPattern(u
"k"_s, PatternType::Include)) {
688 return {Status::Error, u
"-k: "_sv +
query->executionConfig.pattern.errorString()};
690 if (!setPattern(u
"K"_s, PatternType::Exclude)) {
691 return {Status::Error, u
"-K: "_sv +
query->executionConfig.pattern.errorString()};
694 if (parser.
isSet(u
"T"_s)) {
695 const auto tab = parser.
value(u
"T"_s);
696 if (tab.size() == 0) {
697 query->format.textReplacement.tab1 = defaultTextReplacement.tab1;
698 query->format.textReplacement.tab2 = defaultTextReplacement.tab2;
700 query->format.textReplacement.tab1 = tab[0];
701 query->format.textReplacement.tab2 = (tab.size() == 1) ?
query->format.textReplacement.tab1 : tab[1];
706 return str.
size() > i ? str[i] : c;
709 if (parser.
isSet(u
"N"_s)) {
710 const auto nl = parser.
value(u
"N"_s);
711 query->format.textReplacement.newLine = getChar(nl, 0,
query->format.textReplacement.newLine);
714 if (parser.
isSet(u
"P"_s)) {
715 const auto symbols = parser.
value(u
"P"_s);
716 auto &ph =
query->format.fallbackPlaceholders;
717 ph.cursor = getChar(symbols, 0, defaultFallbackPlaceholders.cursor);
718 ph.selectionStart = getChar(symbols, 1, defaultFallbackPlaceholders.selectionStart);
719 ph.selectionEnd = getChar(symbols, 2, defaultFallbackPlaceholders.selectionEnd);
720 ph.secondaryCursor = getChar(symbols, 3, defaultFallbackPlaceholders.secondaryCursor);
721 ph.secondarySelectionStart = getChar(symbols, 4, defaultFallbackPlaceholders.secondarySelectionStart);
722 ph.secondarySelectionEnd = getChar(symbols, 5, defaultFallbackPlaceholders.secondarySelectionEnd);
723 ph.virtualText = getChar(symbols, 6, defaultFallbackPlaceholders.virtualText);
726 if (parser.
isSet(u
"B"_s)) {
727 query->dualMode = DualMode::NoBlockSelection;
730 if (parser.
isSet(u
"b"_s)) {
731 const auto mode = parser.
value(u
"b"_s);
732 if (mode == u
"noblock"_sv) {
733 query->dualMode = DualMode::NoBlockSelection;
734 }
else if (mode == u
"block"_sv) {
735 query->dualMode = DualMode::BlockSelection;
736 }
else if (mode == u
"always-dual"_sv) {
737 query->dualMode = DualMode::DualIsAlwaysDual;
738 }
else if (mode == u
"no-always-dual"_sv) {
739 query->dualMode = DualMode::AlwaysDualIsDual;
740 }
else if (mode == u
"dual"_sv) {
741 query->dualMode = DualMode::Dual;
743 return {Status::Error, u
"--dual: invalid value"_s};
745 query->dualMode = DualMode::NoBlockSelection;
750 if (parser.
isSet(u
"preamble"_s)) {
751 query->preamble = parser.
value(u
"preamble"_s);
754 query->showPreamble = parser.
isSet(u
"print-preamble"_s);
756 if (parser.
isSet(u
"X"_s)) {
758 query->restoreXdgDataDirs =
true;
760 query->restoreXdgDataDirs = parser.
isSet(u
"x"_s);
763 if (parser.
isSet(u
"S"_s)) {
764 const auto variables = parser.
values(u
"S"_s);
767 for (
const auto &kv : variables) {
770 it->key = kv.sliced(0, pos);
771 it->value = kv.sliced(pos + 1);
779 query->diff.path = parser.
isSet(u
"D"_s) ? parser.
value(u
"D"_s) : u
"diff"_s;
781 const bool noColor = parser.
isSet(u
"no-color"_s);
783 if (parser.
isSet(u
"A"_s)) {
804 query->format.colors.blockSelectionInfo.
clear();
808 query->format.colors.secondarySelection.
clear();
813 query->format.colors.resultReplacement.
clear();
818 if (parser.
isSet(opt)) {
820 color = toANSIColor(parser.
value(opt), defaultResultColor, &ok);
829 setColor(
query->format.colors.reset, u
"color-reset"_s);
830 setColor(
query->format.colors.success, u
"color-success"_s);
831 setColor(
query->format.colors.error, u
"color-error"_s);
832 setColor(
query->format.colors.carret, u
"color-carret"_s);
833 setColor(
query->format.colors.debugMarker, u
"color-debug-marker"_s);
834 setColor(
query->format.colors.debugMsg, u
"color-debug-message"_s);
835 setColor(
query->format.colors.testName, u
"color-test-name"_s);
836 setColor(
query->format.colors.program, u
"color-program"_s);
837 setColor(
query->format.colors.fileName, u
"color-file"_s);
838 setColor(
query->format.colors.lineNumber, u
"color-line"_s);
839 setColor(
query->format.colors.labelInfo, u
"color-label-info"_s);
840 setColor(
query->format.colors.blockSelectionInfo, u
"color-block-selection-info"_s);
841 setColor(
query->format.colors.inSelection, u
"color-in-selection"_s);
843 if (!setColor(defaultResultColor, u
"color-result"_s)) {
844 defaultResultColor = u
"\x1b[40m"_s;
846 const bool hasDefault = defaultResultColor.
size();
848 if (!setColor(
query->format.colors.cursor, u
"color-cursor"_s) && hasDefault) {
849 query->format.colors.cursor = ansiBg % u
";1;33m"_sv;
851 if (!setColor(
query->format.colors.selection, u
"color-selection"_s) && hasDefault) {
852 query->format.colors.selection = ansiBg % u
";1;33m"_sv;
854 if (!setColor(
query->format.colors.secondaryCursor, u
"color-secondary-cursor"_s) && hasDefault) {
855 query->format.colors.secondaryCursor = ansiBg % u
";33m"_sv;
857 if (!setColor(
query->format.colors.secondarySelection, u
"color-secondary-selection"_s) && hasDefault) {
858 query->format.colors.secondarySelection = ansiBg % u
";33m"_sv;
860 if (!setColor(
query->format.colors.blockSelection, u
"color-block-selection"_s) && hasDefault) {
861 query->format.colors.blockSelection = ansiBg % u
";37m"_sv;
863 if (!setColor(
query->format.colors.virtualText, u
"color-virtual-text"_s) && hasDefault) {
864 query->format.colors.virtualText = ansiBg % u
";37m"_sv;
866 if (!setColor(
query->format.colors.result, u
"color-text-result"_s) && hasDefault) {
867 query->format.colors.result = defaultResultColor;
869 if (!setColor(
query->format.colors.resultReplacement, u
"color-replacement"_s) && hasDefault) {
870 query->format.colors.resultReplacement = ansiBg % u
";36m"_sv;
874 return {Status::Error, u
"--"_sv % optWithError % u
": invalid color"_sv};
883void addTextStyleProperties(
QJSValue &obj)
887 obj.
setProperty(u
"dsKeyword"_s, TextStyle::Keyword);
888 obj.
setProperty(u
"dsFunction"_s, TextStyle::Function);
889 obj.
setProperty(u
"dsVariable"_s, TextStyle::Variable);
890 obj.
setProperty(u
"dsControlFlow"_s, TextStyle::ControlFlow);
891 obj.
setProperty(u
"dsOperator"_s, TextStyle::Operator);
892 obj.
setProperty(u
"dsBuiltIn"_s, TextStyle::BuiltIn);
893 obj.
setProperty(u
"dsExtension"_s, TextStyle::Extension);
894 obj.
setProperty(u
"dsPreprocessor"_s, TextStyle::Preprocessor);
895 obj.
setProperty(u
"dsAttribute"_s, TextStyle::Attribute);
897 obj.
setProperty(u
"dsSpecialChar"_s, TextStyle::SpecialChar);
899 obj.
setProperty(u
"dsVerbatimString"_s, TextStyle::VerbatimString);
900 obj.
setProperty(u
"dsSpecialString"_s, TextStyle::SpecialString);
902 obj.
setProperty(u
"dsDataType"_s, TextStyle::DataType);
906 obj.
setProperty(u
"dsConstant"_s, TextStyle::Constant);
907 obj.
setProperty(u
"dsComment"_s, TextStyle::Comment);
908 obj.
setProperty(u
"dsDocumentation"_s, TextStyle::Documentation);
909 obj.
setProperty(u
"dsAnnotation"_s, TextStyle::Annotation);
910 obj.
setProperty(u
"dsCommentVar"_s, TextStyle::CommentVar);
911 obj.
setProperty(u
"dsRegionMarker"_s, TextStyle::RegionMarker);
912 obj.
setProperty(u
"dsInformation"_s, TextStyle::Information);
913 obj.
setProperty(u
"dsWarning"_s, TextStyle::Warning);
922static qsizetype timeNowInMs()
924 auto t = std::chrono::high_resolution_clock::now().time_since_epoch();
925 return std::chrono::duration_cast<std::chrono::milliseconds>(t).count();
928QtMessageHandler originalHandler =
nullptr;
934 if (originalHandler && context.category != std::string_view(
"kf.sonnet.core")) {
935 originalHandler(type, context, msg);
941int main(
int ac,
char **av)
943 ScriptTesterQuery
query;
944 query.xdgDataDirs = qgetenv(
"XDG_DATA_DIRS");
946 qputenv(
"QT_QPA_PLATFORM",
"offscreen");
951 qputenv(
"XDG_DATA_DIRS",
"/XDG_DATA_DIRS_unknown_folder");
953 originalHandler = qInstallMessageHandler(filterMessageOutput);
970 initCommandLineParser(app, parser);
972 using Status = CommandLineParseResult::Status;
973 CommandLineParseResult parseResult = parseCommandLine(parser, &query);
974 switch (parseResult.statusCode) {
977 std::fputs(
"No test file specified.\nUse -h / --help for more details.\n", stderr);
982 std::fputs(qPrintable(parseResult.errorString), stderr);
983 std::fputs(
"\nUse -h / --help for more details.\n", stderr);
985 case Status::VersionRequested:
988 case Status::HelpRequested:
989 std::fputs(qPrintable(parser.
helpText()), stdout);
992 Comma-separated list of values:
993 - color name: black, green, yellow, blue, magenta, cyan, white
994 - bright color name: bright-${color name}
995 - rgb: #fff or #ffffff (use trueColor sequence)
996 - background color: bg=${color name} or bg=bright-${color name} bg=${rgb}
997 - style: bold, dim, italic, underline, reverse, strike, doubly-underline, overlined
998 - ANSI sequence: number sequence with optional ';'
1009 auto jsInjectionStart1 =
1010 u
"(function(env, argv){"
1011 u
"const TestFramework = this.loadModule(':/ktexteditor/scripttester/testframework.js');"
1012 u
"const {REUSE_LAST_INPUT, REUSE_LAST_EXPECTED_OUTPUT} = TestFramework;"
1013 u
"const AS_INPUT = TestFramework.EXPECTED_OUTPUT_AS_INPUT;"
1014 u
"var {calleeWrapper, config, print, printSep, testCase, sequence, withInput, keys,"
1015 u
" indentFiles, test, xtest, eqvTrue, eqvFalse, eqTrue, eqFalse, error, errorMsg,"
1016 u
" errorType, hasError, eqv, is, eq, ne, lt, gt, le, ge, cmd, xcmd, type, xtype"
1017 u
" } = TestFramework;"
1018 u
"var c = TestFramework.sanitizeTag;"
1019 u
"var lazyfn = (fn, ...args) => new TestFramework.LazyFunc(fn, ...args);"
1021 u
"var lazyarg = (arg) => new TestFramework.LazyArg(arg);"
1022 u
"var arg = lazyarg;"
1023 u
"var loadScript = this.loadScript;"
1024 u
"var loadModule = this.loadModule;"
1025 u
"var paste = (str) => this.paste(str);"
1026 u
"env.editor = TestFramework.editor;"
1027 u
"var document = calleeWrapper('document', env.document);"
1028 u
"var editor = calleeWrapper('editor', env.editor);"
1029 u
"var view = calleeWrapper('view', env.view);"
1031 auto debugSetup =
query.extendedDebug ? u
"debug = testFramework.debug;"_sv : u
""_sv;
1033 auto dualModeSetup =
query.dualMode == DualMode::Dual
1034 ? u
"const DUAL_MODE = TestFramework.DUAL_MODE;"
1035 u
"const ALWAYS_DUAL_MODE = TestFramework.ALWAYS_DUAL_MODE;"_sv
1036 :
query.dualMode == DualMode::NoBlockSelection
1037 ? u
"const DUAL_MODE = 0;"
1038 u
"const ALWAYS_DUAL_MODE = 0;"_sv
1039 :
query.dualMode == DualMode::BlockSelection
1040 ? u
"const DUAL_MODE = 1;"
1041 u
"const ALWAYS_DUAL_MODE = 1;"_sv
1042 :
query.dualMode == DualMode::DualIsAlwaysDual
1043 ? u
"const DUAL_MODE = TestFramework.ALWAYS_DUAL_MODE;"
1044 u
"const ALWAYS_DUAL_MODE = TestFramework.ALWAYS_DUAL_MODE;"_sv
1046 : u
"const DUAL_MODE = TestFramework.DUAL_MODE;"
1047 u
"const ALWAYS_DUAL_MODE = TestFramework.DUAL_MODE;"_sv;
1049 auto jsInjectionStart2 =
1050 u
"var kbd = TestFramework.init(this, env, DUAL_MODE);"
1051 u
"try { void function(){"_sv;
1052 auto jsInjectionEnd =
1055 u
"if (e !== TestFramework.STOP_CASE_ERROR) {"
1063 const auto pattern = u
"{CODE}"_sv;
1065 auto pos = preamble.
indexOf(pattern);
1067 std::fputs(
"missing {CODE} with --preamble\n", stderr);
1070 jsInjectionStart1 = preamble.
sliced(0, pos);
1071 jsInjectionEnd = preamble.
sliced(pos + pattern.size());
1078 return jsInjectionStart1 % debugSetup % dualModeSetup % jsInjectionStart2 % u
'\n' % source % jsInjectionEnd;
1081 if (
query.showPreamble) {
1082 std::fputs(qPrintable(makeProgram(u
"{CODE}"_sv)), stdout);
1086 if (
query.restoreXdgDataDirs) {
1087 qputenv(
"XDG_DATA_DIRS",
query.xdgDataDirs);
1095 KTextEditor::ViewPrivate view(&doc,
nullptr);
1100 viewObj.setView(&view);
1103 docObj.setDocument(&doc);
1111 ScriptTester scriptTester(&output,
query.format,
query.paths,
query.executionConfig,
query.diff, defaultPlaceholder, &engine, &doc, &view);
1128 addTextStyleProperties(globalObject);
1132 scriptTester.require(u
"range.js"_s);
1136 "function i18n(text, ...arg) { return text; }\n"
1137 "function i18nc(context, text, ...arg) { return text; }\n"
1138 "function i18np(singular, plural, number, ...arg) { return number > 1 ? plural : singular; }\n"
1139 "function i18ncp(context, singular, plural, number, ...arg) { return number > 1 ? plural : singular; }\n"
1141 "var editor = undefined;"));
1148 for (quint32 i = 0; i <
query.argv.
size(); ++i) {
1152 const auto &colors =
query.format.colors;
1154 qsizetype delayInMs = 0;
1155 bool resetConfig =
false;
1156 auto runProgram = [&](
const QString &fileName,
const QString &source) {
1157 auto result = engine.
evaluate(makeProgram(source), fileName, 0);
1158 if (!result.isError()) {
1160 scriptTester.resetConfig();
1164 for (
const auto &variable : std::as_const(
query.variables)) {
1165 doc.setVariable(variable.key, variable.value);
1168 const auto start = timeNowInMs();
1169 result = result.callWithInstance(functions, {globalObject, jsArgv});
1170 delayInMs += timeNowInMs() -
start;
1171 if (!result.isError()) {
1176 scriptTester.incrementError();
1177 scriptTester.stream() << colors.error << result.toString() << colors.reset << u
'\n';
1178 scriptTester.writeException(result, u
"| "_sv);
1179 scriptTester.stream().flush();
1183 auto runJsFile = [&](
const QString &fileName) {
1189 scriptTester.incrementError();
1190 scriptTester.stream() << colors.fileName << fileName << colors.reset <<
": "_L1 << colors.error << file.
errorString() << colors.reset << u
'\n';
1191 scriptTester.stream().flush();
1196 runProgram(fileName, content);
1205 for (
const auto &fileName : fileNames) {
1207 runProgram(u
"file%1.js"_s.arg(&fileName -
fileNames.
data() + 1), fileName);
1208 }
else if (!
QFileInfo(fileName).isDir()) {
1209 runJsFile(fileName);
1212 while (it.hasNext() && !scriptTester.hasTooManyErrors()) {
1213 runJsFile(it.next());
1217 if (scriptTester.hasTooManyErrors()) {
1226 if (scriptTester.hasTooManyErrors()) {
1227 scriptTester.stream() << colors.error <<
"Too many error"_L1 << colors.reset << u
'\n';
1230 scriptTester.writeSummary();
1231 scriptTester.stream() <<
" Duration: "_L1 << delayInMs <<
"ms\n"_L1;
1232 scriptTester.stream().flush();
1234 return scriptTester.countError() ? 1 : 0;
Backend of KTextEditor::Document related public KTextEditor interfaces.
Thinish wrapping around KTextEditor::DocumentPrivate, exposing the methods we want exposed and adding...
Thinish wrapping around KTextEditor::ViewPrivate, exposing the methods we want exposed and adding som...
Q_SCRIPTABLE Q_NOREPLY void start()
KSERVICE_EXPORT KService::List query(FilterFunc filterFunc)
QString path(const QString &relativePath)
KEDUVOCDOCUMENT_EXPORT QStringList fileNames(const QString &language=QString())
QCommandLineOption addHelpOption()
bool addOptions(const QList< QCommandLineOption > &options)
void addPositionalArgument(const QString &name, const QString &description, const QString &syntax)
QCommandLineOption addVersionOption()
QString errorText() const const
QString helpText() const const
bool isSet(const QCommandLineOption &option) const const
bool parse(const QStringList &arguments)
QStringList positionalArguments() const const
void setApplicationDescription(const QString &description)
QString value(const QCommandLineOption &option) const const
QStringList values(const QCommandLineOption &option) const const
void setApplicationName(const QString &application)
void setApplicationVersion(const QString &version)
void setOrganizationDomain(const QString &orgDomain)
void setOrganizationName(const QString &orgName)
QString translate(const char *context, const char *sourceText, const char *disambiguation, int n)
bool exists() const const
bool open(FILE *fh, OpenMode mode, FileHandleFlags handleFlags)
void setFileName(const QString &name)
virtual void close() override
FileError error() const const
QString errorString() const const
QJSValue evaluate(const QString &program, const QString &fileName, int lineNumber, QStringList *exceptionStackTrace)
QJSValue globalObject() const const
QJSValue newArray(uint length)
QJSValue newQObject(QObject *object)
QJSValue property(const QString &name) const const
void setProperty(const QString &name, const QJSValue &value)
void append(QList< T > &&value)
const_pointer constData() const const
bool isEmpty() const const
void push_back(parameter_type value)
void resize(qsizetype size)
qsizetype size() const const
void setTestModeEnabled(bool testMode)
const QChar * constData() const const
bool isEmpty() const const
void reserve(qsizetype size)
qsizetype size() const const
int toInt(bool *ok, int base) const const
QByteArray toUtf8() const const
qsizetype indexOf(QChar c, qsizetype from, Qt::CaseSensitivity cs) const const
bool isEmpty() const const
qsizetype size() const const
QStringView sliced(qsizetype pos) const const
QList< QStringView > split(QChar sep, Qt::SplitBehavior behavior, Qt::CaseSensitivity cs) const const
const T * constData() const const