Defining a ProblemMatcher in VSCode tasks -- schema disagrees with docs?

Question

In VSCode I'm trying to create a ProblemMatcher to parse errors on a custom script of mine which I run (markdown file -> pandoc -> PDFs if you're interested).

The pretty good VSCode ProblemMatcher documentation has an example task which appears (to me) to run a command ("command": "gcc") and define a problem matcher ("problemMatcher": {...}).

When I try this for my tasks.json file with both, I get an 'the description can't be converted into a problem matcher' error, which isn't terribly helpful. I checked the tasks.json schema and it clearly says:

The problem matcher to be used if a global command is executed (e.g. no tasks are defined). A tasks.json file can either contain a global problemMatcher property or a tasks property but not both.

Is the schema wrong? In which case I'll raise an issue.

Or is my code wrong? In which case, please point me in the right direction. Code in full (minus comments):

{
  "version": "2.0.0",
  "tasks": [
    {
        "label": "md2pdf",
        "type": "shell",
        "command": "md2pdf",
        "group": {
            "kind": "build",
            "isDefault": true
        },
        "presentation": {
            "reveal": "always",
            "panel": "shared",
            "showReuseMessage": false
        },
        "problemMatcher": {
            "owner": "Markdown",
            "fileLocation": ["absolute", "/tmp/md2pdf.log"],
            "pattern": [
                {
                    // Regular expression to match filename (on earlier line than actual warnings)
                    "regexp": "^Converting:\\s+(.*)$",
                    "kind": "location", 
                    "file": 1
                },
                {
                    // Regular expression to match: "l.45 \msg_fatal:nn {fontspec} {cannot-use-pdftex}" with a preceding line giving "Converting <filename>:"
                    "regexp": "l.(\\d+)\\s(.*):(.*)$",
                    "line": 1,
                    "severity": 2,
                    "message": 3
                }
            ]
        }
    }]
}

JGC · Accepted Answer · 2020-07-19 21:27:40Z

10

I've since spent more time figuring this out, and have corresponded with VSCode team, which has led to improvements in the documentation.

The two changes needed to get something simple working were:

Need to have "command": "/full/path/to/executable" not just "executable name".
The "fileLocation" isn't about the location of the file to be matched, but about how to treat file paths mentioned in the task output. The file to be matched can't be specified, as it's implicitly the file or folder open in the editor at the time of the task. The setting wasn't important in my case.

answered Jul 19, 2020 at 21:27

JGC

6511 gold badge6 silver badges14 bronze badges

Sign up to request clarification or add additional context in comments.

Comments

Lucian Wischik · Accepted Answer · 2020-07-16 19:10:27Z

2

Just a hunch, but I bet your fileLocation is wrong. Try something like

"fileLocation": "absolute",

answered Jul 16, 2020 at 19:10

Lucian Wischik

2,3361 gold badge23 silver badges29 bronze badges

1 Comment

JGC Over a year ago

Thanks, @lucian-wischik, for the answer. This has prompted me to add my own answer, below.

Wayne Uroda · Accepted Answer · 2022-10-18 13:13:14Z

2

If you, like me, have come here due to the description can't be converted into a problem matcher, here is what I learned:

If your problem matcher says something like "base": "$gcc", then I assume you are using the Microsoft C/C++ plugin. If you are using some other base which is not listed on the official docs webpage (search Tasks in Visual Studio Code), then assume that it is probably supplied by a plugin.

So, this error could mean that you are missing a plugin. In my case I was trying to run this task remotely in WSL/Ubuntu using VS Code's awesome WSL integration. I installed the C/C++ plugin inside WSL and the error was fixed (go to the extension panel, click Install in WSL: <Distro name>).

answered Oct 18, 2022 at 13:13

Wayne Uroda

5,1056 gold badges32 silver badges35 bronze badges

1 Comment

TTimo Over a year ago

This will happen if you are using remote development over ssh as well. The C++ extension needs to be installed on the remote.

Collectives™ on Stack Overflow

Defining a ProblemMatcher in VSCode tasks -- schema disagrees with docs?

3 Answers 3

Comments

1 Comment

1 Comment

Your Answer

Hot Network Questions

Collectives™ on Stack Overflow

3 Answers 3

Comments

1 Comment

1 Comment

Your Answer

Sign up or log in

Post as a guest

Related