Exit codes

[patriksvensson]

Exit codes can be complex. I suggest introducing two new properties, code and isError, to better describe an exit code.

The code property would be a union type: integer | ExitCodeCriteria, where ExitCodeCriteria is an object containing two properties: greaterThan and lessThan. The value of lessThan must be greater than that of greaterThan.

The isError property would be a boolean indicating whether the exit code should be considered an error.

Example:

"exitCodes": [
    {
        "code": 0,
        "description": "Success"
    },
    {
        "code": 1,
        "description": "Successful but nothing was created"
    },
    {
        "code": {
            "greaterThan": 1,
            "lessThan": 256
        },
        "isError": true,
        "description": "An unspecified error"
    }
]

[reitzig]

The isError property would be a boolean indicating whether the exit code should be considered an error.

Doesn't this contradict POSIX / UNIX conventions? At least for scripting use, I expect the program to have succeeded if and only of exit code is zero.

[patriksvensson]

Windows is not always as straightforward as the POSIX conventions 😄

[reitzig]

Right. Oh dear. 😨

Either you're the first person ever to call POSIX conventions "straight forward", or the comparison scares me away from Windows even more. 🫣