GitHub Action schema

[Logerfo]

Based on the official documentation.
Also, see #853 for the workflow schema.

[Logerfo]

I think this is good to go.

[madskristensen]

Thanks

[ssbarnea]

@Logerfo my expectation was that these schemas were programatelly produced so they could easily be updated.

For example I was hoping that python-version property to be evaluated as a string instead of allowing floats, which happen to work until one day ago, when 3.10 was released. Anyone trying to add just 3.10 without quotes will have the unpleasant surprise. Schema could help here but is not really clear where is this schema tracked.

[Logerfo]

@ssbarnea I've done this using my bare hands, but I can't find any property called python-version. Are you sure this is the schema you're having issues with?

[ssbarnea]

Hmm, good question. I think I was looking for Workflow schema instead, but that neither has the the python-version in it.

Somehow I have the impression that it may not even be possible to do it because that is usually used inside matrix:. Take a look at the example from https://docs.github.com/en/enterprise-server@3.1/actions/automating-builds-and-tests/building-and-testing-nodejs-or-python?langId=py

Even their example is misleading because these should be treated as string, if you happen to try to add a 3.10 to that list it will not work correctly. Ideally the schema should be able to require that python-version is either a string or a list of strings.

I know that JSON schema supports that but I am not sure how easy it would be to add this for the matrix object, which acts mostly like a free-form dictionary.

[Logerfo]

@ssbarnea the matrix property is so complex that the schema should match any object:

schemastore/src/schemas/json/github-workflow.json

Lines 1416 to 1426 in 5ea5335

	"matrix": {
	"$comment": "https://help.github.com/en/actions/automating-your-workflow-with-github-actions/workflow-syntax-for-github-actions#jobsjob_idstrategymatrix",
	"description": "A build matrix is a set of different configurations of the virtual environment. For example you might run a job against more than one supported version of a language, operating system, or tool. Each configuration is a copy of the job that runs and reports a status.\nYou can specify a matrix by supplying an array for the configuration options. For example, if the GitHub virtual environment supports Node.js versions 6, 8, and 10 you could specify an array of those versions in the matrix.\nWhen you define a matrix of operating systems, you must set the required runs-on keyword to the operating system of the current job, rather than hard-coding the operating system name. To access the operating system name, you can use the matrix.os context parameter to set runs-on. For more information, see https://help.github.com/en/articles/contexts-and-expression-syntax-for-github-actions.",
	"oneOf": [
	{
	"type": "object"
	},
	{
	"$ref": "#/definitions/expressionSyntax"
	}
	],

[ssbarnea]

It should not be too hard, I started working on a change at #1863