v0_test.go

package publiccode

import (
	"fmt"
	"path"
	"path/filepath"
	"slices"
	"testing"
)

func TestValidTestcasesV0_NoNetwork(t *testing.T) {
	checkValidFilesNoNetwork("testdata/v0/valid/no-network/*.yml", t)
}

func TestValidWithWarningTestcasesV0_NoNetwork(t *testing.T) {
	expected := map[string]error{
		"authorsFile.yml": ValidationResults{
			ValidationWarning{"", "legal.authorsFile", "This key is DEPRECATED and will be removed in the future. It's safe to drop it", 63, 3},
		},
	}

	dir := "testdata/v0/valid_with_warnings/no-network/"
	testFiles, _ := filepath.Glob(dir + "*yml")
	for _, file := range testFiles {
		baseName := path.Base(file)
		if expected[baseName] == nil {
			t.Errorf("No expected data for file %s", baseName)
		}
		t.Run(file, func(t *testing.T) {
			err := parseNoNetwork(file)
			checkParseErrors(t, err, testType{file, expected[baseName]})
		})
	}
	for file := range expected {
		if !slices.Contains(testFiles, dir+file) {
			t.Errorf("No expected file %s", dir+file)
		}
	}
}

func TestInvalidTestcasesV0_NoNetwork(t *testing.T) {
	expected := map[string]error{
		// logo
		"logo_missing_file.yml": ValidationResults{
			ValidationError{"", "logo", "no such file: " + cwd + "/testdata/v0/invalid/no-network/no_such_file.png", 18, 1},
		},
		"logo_invalid_png.yml": ValidationResults{
			ValidationError{"", "logo", "image: unknown format", 18, 1},
		},

		// landingURL
		"landingURL_invalid.yml": ValidationResults{
			// Just a syntax check here, no check for reachability as network is disabled
			ValidationError{"", "landingURL", "landingURL must be an HTTP URL", 8, 1},
			ValidationWarning{"", "dependsOn.open", "This key is DEPRECATED and will be removed in the future. It's safe to drop it", 102, 3},
			ValidationWarning{"", "usedBy", "This key is DEPRECATED and will be removed in the future. It's safe to drop it", 21, 1},
			ValidationWarning{"", "description.en.videos", "This key is DEPRECATED and will be removed in the future. Link videos from the documentation or the website instead", 62, 5},
		},

		// monochromeLogo
		"monochromeLogo_invalid_png.yml": ValidationResults{
			ValidationWarning{"", "monochromeLogo", "This key is DEPRECATED and will be removed in the future. Use 'logo' instead", 18, 1},
			ValidationError{"", "monochromeLogo", "image: unknown format", 18, 1},
		},

		// YAML 1.1 boolean aliases must be rejected
		"localisation_localisationReady_yaml11_yes.yml": ValidationResults{
			ValidationError{"", "localisation.localisationReady", "wrong type for this field", 51, 1},
			ValidationError{"", "localisation.localisationReady", "localisationReady is a required field", 51, 3},
			ValidationError{"", "localisation.availableLanguages", "availableLanguages is a required field", 52, 3},
		},
		"localisation_localisationReady_yaml11_no.yml": ValidationResults{
			ValidationError{"", "localisation.localisationReady", "wrong type for this field", 51, 1},
			ValidationError{"", "localisation.localisationReady", "localisationReady is a required field", 51, 3},
			ValidationError{"", "localisation.availableLanguages", "availableLanguages is a required field", 52, 3},
		},
		"localisation_localisationReady_yaml11_on.yml": ValidationResults{
			ValidationError{"", "localisation.localisationReady", "wrong type for this field", 51, 1},
			ValidationError{"", "localisation.localisationReady", "localisationReady is a required field", 51, 3},
			ValidationError{"", "localisation.availableLanguages", "availableLanguages is a required field", 52, 3},
		},
		"localisation_localisationReady_yaml11_off.yml": ValidationResults{
			ValidationError{"", "localisation.localisationReady", "wrong type for this field", 51, 1},
			ValidationError{"", "localisation.localisationReady", "localisationReady is a required field", 51, 3},
			ValidationError{"", "localisation.availableLanguages", "availableLanguages is a required field", 52, 3},
		},

		// supports
		"supports_unknown_alias.yml": ValidationResults{
			ValidationError{"", "supports[0].id", "id contains an unknown alias (see https://github.com/publiccodeyml/publiccode.yml/blob/main/docs/standard/aliases-list.rst)", 17, 5},
		},
	}

	dir := "testdata/v0/invalid/no-network/"
	testFiles, _ := filepath.Glob(dir + "*yml")
	for _, file := range testFiles {
		baseName := path.Base(file)
		if expected[baseName] == nil {
			t.Errorf("No expected data for file %s", baseName)
		}
		t.Run(file, func(t *testing.T) {
			err := parseNoNetwork(file)
			checkParseErrors(t, err, testType{file, expected[baseName]})
		})
	}
	for file := range expected {
		if !slices.Contains(testFiles, dir+file) {
			t.Errorf("No expected file %s", dir+file)
		}
	}

}

func TestInvalidTestcasesV0(t *testing.T) {
	expected := map[string]error{
		// publiccodeYmlVersion
		"publiccodeYmlVersion_missing.yml": ValidationResults{ValidationError{"", "publiccodeYmlVersion", "publiccodeYmlVersion is a required field", 0, 0}},
		"publiccodeYmlVersion_invalid.yml": ValidationResults{
			ValidationError{
				"",
				"publiccodeYmlVersion",
				"unsupported version: '1'. Supported versions: 0, 0.2, 0.2.0, 0.2.1, 0.2.2, 0.3, 0.3.0, 0.4, 0.4.0, 0.5.0, 0.5, 0.7.0, 0.7, 0.8.0, 0.8",
				0,
				0,
			},
		},
		"publiccodeYmlVersion_wrong_type.yml": ValidationResults{
			ValidationError{"", "publiccodeYmlVersion", "wrong type for this field", 2, 1},
		},

		// name
		"name_missing.yml": ValidationResults{ValidationError{"", "name", "name is a required field", 1, 1}},
		"name_nil.yml":     ValidationResults{ValidationError{"", "name", "name is a required field", 4, 1}},
		"name_wrong_type.yml": ValidationResults{
			ValidationError{"", "name", "wrong type for this field", 4, 1},
			ValidationError{"", "name", "name is a required field", 4, 1},
		},

		// applicationSuite
		"applicationSuite_wrong_type.yml": ValidationResults{ValidationError{"", "applicationSuite", "wrong type for this field", 4, 1}},

		// url
		"url_missing.yml": ValidationResults{ValidationError{"", "url", "url is a required field", 1, 1}},
		"url_wrong_type.yml": ValidationResults{
			ValidationError{"", "url", "wrong type for this field", 6, 1},
			ValidationError{"", "url", "url is a required field", 6, 1},
		},
		"url_invalid.yml": ValidationResults{
			ValidationError{"", "url", "url must be a valid URL", 6, 1},
			ValidationError{"", "url", "'foobar' not reachable: missing URL scheme", 6, 1},
			ValidationError{"", "url", "is not a valid code repository", 6, 1},
		},

		// landingURL
		"landingURL_wrong_type.yml": ValidationResults{
			ValidationError{"", "landingURL", "wrong type for this field", 8, 1},
			ValidationWarning{"", "dependsOn.open", "This key is DEPRECATED and will be removed in the future. It's safe to drop it", 98, 3},
			ValidationWarning{"", "usedBy", "This key is DEPRECATED and will be removed in the future. It's safe to drop it", 21, 1},
		},
		"landingURL_invalid.yml": ValidationResults{
			ValidationError{"", "landingURL", "landingURL must be an HTTP URL", 8, 1},
			ValidationError{"", "landingURL", "'???' not reachable: missing URL scheme", 8, 1},
			ValidationWarning{"", "dependsOn.open", "This key is DEPRECATED and will be removed in the future. It's safe to drop it", 102, 3},
			ValidationWarning{"", "usedBy", "This key is DEPRECATED and will be removed in the future. It's safe to drop it", 21, 1},
			ValidationWarning{"", "description.en.videos", "This key is DEPRECATED and will be removed in the future. Link videos from the documentation or the website instead", 62, 5},
		},

		// isBasedOn
		"isBasedOn_wrong_type.yml": ValidationResults{
			ValidationError{"", "isBasedOn.foobar", "wrong type for this field", 10, 1},
		},
		"isBasedOn_bad_url_array.yml": ValidationResults{
			ValidationError{"", "isBasedOn[1]", "isBasedOn[1] must be a valid URL", 11, 5},
		},
		"isBasedOn_bad_url_string.yml": ValidationResults{
			ValidationWarning{"", "isBasedOn", "The single string form is DEPRECATED and will be removed in the future. Use a one element array instead", 9, 1},
			ValidationError{"", "isBasedOn[0]", "isBasedOn[0] must be a valid URL", 9, 1},
		},

		// softwareVersion
		"softwareVersion_wrong_type.yml": ValidationResults{
			ValidationError{"", "softwareVersion", "wrong type for this field", 8, 1},
		},

		// releaseDate
		"releaseDate_empty.yml": ValidationResults{ValidationError{"", "releaseDate", "releaseDate must be a date with format 'YYYY-MM-DD'", 8, 1}},
		"releaseDate_wrong_type.yml": ValidationResults{
			ValidationError{"", "releaseDate", "wrong type for this field", 8, 1},
		},
		"releaseDate_invalid.yml": ValidationResults{
			ValidationError{"", "releaseDate", "releaseDate must be a date with format 'YYYY-MM-DD'", 8, 1},
		},
		"releaseDate_datetime.yml": ValidationResults{
			ValidationError{"", "releaseDate", "releaseDate must be a date with format 'YYYY-MM-DD'", 8, 1},
		},

		// logo
		"logo_wrong_type.yml": ValidationResults{
			ValidationError{"", "logo", "wrong type for this field", 18, 1},
		},
		"logo_unsupported_extension.yml": ValidationResults{
			ValidationError{"", "logo", "invalid file extension for: " + cwd + "/testdata/v0/invalid/logo.mpg", 18, 1},
		},
		"logo_missing_file.yml": ValidationResults{
			ValidationError{"", "logo", "no such file: " + cwd + "/testdata/v0/invalid/no_such_file.png", 18, 1},
		},
		"logo_absolute_path.yml": ValidationResults{
			ValidationError{"", "logo", "is an absolute path. Only relative paths or HTTP(s) URLs allowed", 18, 1},
		},
		"logo_file_scheme.yml": ValidationResults{
			ValidationError{"", "logo", "is a file:// URL. Only relative paths or HTTP(s) URLs allowed", 18, 1},
		},
		"logo_file_scheme2.yml": ValidationResults{
			ValidationError{"", "logo", "is a file:// URL. Only relative paths or HTTP(s) URLs allowed", 18, 1},
		},
		"logo_file_scheme3.yml": ValidationResults{
			ValidationError{"", "logo", "is a file:// URL. Only relative paths or HTTP(s) URLs allowed", 18, 1},
		},
		"logo_file_scheme_uppercase.yml": ValidationResults{
			ValidationError{"", "logo", "is a file:// URL. Only relative paths or HTTP(s) URLs allowed", 18, 1},
		},
		"logo_file_scheme_mixed_case.yml": ValidationResults{
			ValidationError{"", "logo", "is a file:// URL. Only relative paths or HTTP(s) URLs allowed", 18, 1},
		},
		"logo_ftp_scheme.yml": ValidationResults{
			ValidationError{"", "logo", "has an unsupported URL scheme 'ftp'. Only relative paths or HTTP(s) URLs allowed", 18, 1},
		},
		"logo_data_scheme.yml": ValidationResults{
			ValidationError{"", "logo", "has an unsupported URL scheme 'data'. Only relative paths or HTTP(s) URLs allowed", 18, 1},
		},
		// Local publiccode.yml and URL in logo: should look for the logo remotely
		"logo_missing_url.yml": ValidationResults{
			ValidationError{"", "logo", "downloading https://google.com/no_such_file.png: not found", 18, 1},
		},

		// monochromeLogo
		"monochromeLogo_wrong_type.yml": ValidationResults{
			ValidationError{"", "monochromeLogo", "wrong type for this field", 18, 1},
		},
		"monochromeLogo_unsupported_extension.yml": ValidationResults{
			ValidationWarning{"", "monochromeLogo", "This key is DEPRECATED and will be removed in the future. Use 'logo' instead", 18, 1},
			ValidationError{
				"",
				"monochromeLogo",
				"invalid file extension for: " + cwd + "/testdata/v0/invalid/monochromeLogo.mpg",
				18,
				1,
			},
		},
		"monochromeLogo_missing_file.yml": ValidationResults{
			ValidationWarning{"", "monochromeLogo", "This key is DEPRECATED and will be removed in the future. Use 'logo' instead", 18, 1},
			ValidationError{"", "monochromeLogo", "no such file: " + cwd + "/testdata/v0/invalid/no_such_file.png", 18, 1},
		},

		// organisation
		"organisation_wrong_uri.yml": ValidationResults{
			ValidationError{"", "organisation.uri", "uri is not a valid URI", 19, 3},
		},
		"organisation_wrong_type.yml": ValidationResults{
			ValidationError{"", "organisation[0]", "wrong type for this field", 18, 1},
		},
		"organisation_uri_missing.yml": ValidationResults{
			ValidationError{"", "organisation.uri", "uri is a required field", 18, 3},
		},
		"organisation_uri_wrong_italian_pa.yml": ValidationResults{
			ValidationError{"", "organisation.uri", "uri is not a valid URI", 20, 3},
		},
		"organisation_uri_wrong_italian_pa2.yml": ValidationResults{
			ValidationError{"", "organisation.uri", "uri must be a valid Italian Public Administration Code (iPA) with format 'urn:x-italian-pa:[codiceIPA]' (see https://github.com/publiccodeyml/italian-organizations-ipa-vocabulary)", 19, 3},
		},

		// inputTypes
		"inputTypes_invalid.yml": ValidationResults{
			ValidationError{"", "inputTypes[1]", "inputTypes[1] is not a valid MIME type", 16, 7},
			ValidationWarning{"", "inputTypes", "This key is DEPRECATED and will be removed in the future. It's safe to drop it", 14, 1},
		},
		"inputTypes_wrong_type.yml": ValidationResults{
			ValidationError{"", "inputTypes.foobar", "wrong type for this field", 15, 1},
		},

		// outputTypes
		"outputTypes_invalid.yml": ValidationResults{
			ValidationError{"", "outputTypes[1]", "outputTypes[1] is not a valid MIME type", 16, 7},
			ValidationWarning{"", "outputTypes", "This key is DEPRECATED and will be removed in the future. It's safe to drop it", 14, 1},
		},
		"outputTypes_wrong_type.yml": ValidationResults{
			ValidationError{"", "outputTypes.foobar", "wrong type for this field", 15, 1},
		},

		// platforms
		"platforms_missing.yml": ValidationResults{ValidationError{"", "platforms", "platforms must contain more than 0 items", 1, 1}},
		"platforms_wrong_type.yml": ValidationResults{
			ValidationError{"", "platforms", "wrong type for this field", 9, 1},
			ValidationError{"", "platforms", "platforms must contain more than 0 items", 9, 1},
		},

		// categories
		"categories_invalid.yml": ValidationResults{ValidationError{"", "categories[0]", "categories[0] must be a valid category (see https://github.com/publiccodeyml/publiccode.yml/blob/main/docs/standard/categories-list.rst)", 13, 5}},

		// usedBy
		"usedBy_wrong_type.yml": ValidationResults{
			ValidationError{"", "usedBy", "wrong type for this field", 14, 1},
		},

		// fundedBy
		"fundedBy_wrong_uri.yml": ValidationResults{
			ValidationError{"", "fundedBy[0].uri", "uri is not a valid URI", 19, 5},
		},
		"fundedBy_wrong_type.yml": ValidationResults{
			ValidationError{"", "fundedBy.name", "wrong type for this field", 18, 1},
		},
		"fundedBy_uri_missing.yml": ValidationResults{
			ValidationError{"", "fundedBy[0].uri", "uri is a required field", 18, 5},
		},
		"fundedBy_uri_wrong_italian_pa.yml": ValidationResults{
			ValidationError{"", "fundedBy[0].uri", "uri is not a valid URI", 20, 5},
		},
		"fundedBy_uri_wrong_italian_pa2.yml": ValidationResults{
			ValidationError{"", "fundedBy[0].uri", "uri must be a valid Italian Public Administration Code (iPA) with format 'urn:x-italian-pa:[codiceIPA]' (see https://github.com/publiccodeyml/italian-organizations-ipa-vocabulary)", 19, 5},
		},

		// roadmap
		"roadmap_invalid.yml": ValidationResults{
			ValidationError{"", "roadmap", "roadmap must be an HTTP URL", 4, 1},
			ValidationError{"", "roadmap", "'foobar' not reachable: missing URL scheme", 4, 1},
		},
		"roadmap_wrong_type.yml": ValidationResults{
			ValidationError{"", "roadmap", "wrong type for this field", 4, 1},
		},

		// developmentStatus
		"developmentStatus_missing.yml": ValidationResults{
			ValidationError{"", "developmentStatus", "developmentStatus is a required field", 1, 1},
		},
		"developmentStatus_invalid.yml": ValidationResults{
			ValidationError{"", "developmentStatus", "developmentStatus must be one of the following: \"concept\", \"development\", \"beta\", \"stable\" or \"obsolete\"", 16, 1},
		},
		"developmentStatus_wrong_type.yml": ValidationResults{
			ValidationError{"", "developmentStatus", "wrong type for this field", 16, 1},
			ValidationError{"", "developmentStatus", "developmentStatus is a required field", 16, 1},
		},

		// softwareType
		"softwareType_missing.yml": ValidationResults{
			ValidationError{"", "softwareType", "softwareType is a required field", 1, 1},
		},
		"softwareType_invalid.yml": ValidationResults{
			ValidationError{"", "softwareType", "softwareType must be one of the following: \"standalone/mobile\", \"standalone/iot\", \"standalone/desktop\", \"standalone/web\", \"standalone/backend\", \"standalone/other\", \"addon\", \"library\" or \"configurationFiles\"", 17, 1},
		},
		"softwareType_wrong_type.yml": ValidationResults{
			ValidationError{"", "softwareType", "wrong type for this field", 17, 1},
			ValidationError{"", "softwareType", "softwareType is a required field", 17, 1},
		},

		// intendedAudience
		// intendedAudience.*
		"intendedAudience_wrong_type.yml": ValidationResults{
			ValidationError{"", "intendedAudience", "wrong type for this field", 18, 1},
		},
		"intendedAudience_countries_invalid_country.yml": ValidationResults{
			ValidationError{"", "intendedAudience.countries[2]", "countries[2] must be a valid ISO 3166-1 alpha-2 two-letter country code", 22, 7},
		},
		"intendedAudience_countries_invalid_iso_3166_1_alpha_2.yml": ValidationResults{
			ValidationError{"", "intendedAudience.countries[2]", "countries[2] must be a valid ISO 3166-1 alpha-2 two-letter country code", 22, 7},
		},
		"intendedAudience_countries_wrong_type.yml": ValidationResults{
			ValidationError{"", "intendedAudience.countries", "wrong type for this field", 19, 1},
		},
		"intendedAudience_unsupportedCountries_invalid_country.yml": ValidationResults{
			ValidationError{"", "intendedAudience.unsupportedCountries[0]", "unsupportedCountries[0] must be a valid ISO 3166-1 alpha-2 two-letter country code", 20, 7},
			ValidationWarning{"", "intendedAudience.unsupportedCountries", "This key is DEPRECATED and will be removed in the future. Use 'intendedAudience.countries' to list the targeted countries instead", 18, 3},
		},
		"intendedAudience_unsupportedCountries_wrong_type.yml": ValidationResults{
			ValidationError{"", "intendedAudience.unsupportedCountries", "wrong type for this field", 19, 1},
		},
		"intendedAudience_scope_invalid_scope.yml": ValidationResults{
			ValidationError{"", "intendedAudience.scope[0]", "scope[0] must be a valid scope (see https://github.com/publiccodeyml/publiccode.yml/blob/main/docs/standard/scope-list.rst)", 20, 9},
		},
		"intendedAudience_scope_wrong_type.yml": ValidationResults{
			ValidationError{"", "intendedAudience.scope", "wrong type for this field", 19, 1},
		},

		// description
		// description.*
		"description_invalid_language.yml": ValidationResults{
			ValidationError{"", "description", "description must be a valid BCP 47 language", 18, 1},
		},
		"description_en_features_empty.yml": ValidationResults{
			ValidationError{"", "description.en.features", "features must contain more than 0 items", 39, 5},
		},
		"description_en_localisedName_wrong_type.yml": ValidationResults{
			ValidationError{"", "description.en.localisedName", "wrong type for this field", 21, 1},
			ValidationError{"", "description", "description must contain more than 0 items", 18, 1},
		},
		"description_en_genericName_too_long.yml": ValidationResults{
			ValidationError{"", "description.en.genericName", "genericName must be a maximum of 35 characters in length", 22, 5},
			ValidationWarning{"", "description.en.genericName", "This key is DEPRECATED and will be removed in the future. It's safe to drop it", 22, 5},
		},
		"description_en_shortDescription_missing.yml": ValidationResults{
			ValidationError{"", "description.en.shortDescription", "shortDescription is a required field", 20, 5},
		},
		"description_en_longDescription_missing.yml": ValidationResults{
			ValidationError{"", "description.en.longDescription", "longDescription is a required field", 20, 5},
		},
		"description_en_longDescription_too_long.yml": ValidationResults{
			ValidationError{"", "description.en.longDescription", "longDescription must be a maximum of 10000 characters in length", 27, 5},
		},
		"description_en_longDescription_too_short.yml": ValidationResults{
			ValidationError{"", "description.en.longDescription", "longDescription must be at least 150 characters in length", 27, 5},
		},
		"description_en_longDescription_too_short_grapheme_clusters.yml": ValidationResults{
			ValidationError{"", "description.en.longDescription", "longDescription must be at least 150 characters in length", 28, 5},
		},
		"description_en_documentation_invalid.yml": ValidationResults{
			ValidationError{"", "description.en.documentation", "documentation must be an HTTP URL", 25, 5},
			ValidationError{"", "description.en.documentation", "'not_a_url' not reachable: missing URL scheme", 25, 5},
		},
		"description_en_documentation_wrong_type.yml": ValidationResults{
			ValidationError{"", "description.en.documentation", "wrong type for this field", 25, 1},
			ValidationError{"", "description", "description must contain more than 0 items", 20, 1},
		},
		"description_en_apiDocumentation_invalid.yml": ValidationResults{
			ValidationError{"", "description.en.apiDocumentation", "apiDocumentation must be an HTTP URL", 41, 5},
			ValidationError{"", "description.en.apiDocumentation", "'abc' not reachable: missing URL scheme", 41, 5},
		},
		"description_en_apiDocumentation_wrong_type.yml": ValidationResults{
			ValidationError{"", "description.en.apiDocumentation", "wrong type for this field", 43, 1},
			ValidationError{"", "description", "description must contain more than 0 items", 20, 1},
		},
		"description_en_screenshots_missing_file.yml": ValidationResults{
			ValidationError{
				"",
				"description.en.screenshots[0]",
				"'no_such_file.png' is not an image: no such file: " + cwd + "/testdata/v0/invalid/no_such_file.png",
				42,
				9,
			},
		},
		"description_en_awards_wrong_type.yml": ValidationResults{
			ValidationError{"", "description.en.awards", "wrong type for this field", 40, 1},
			ValidationError{"", "description", "description must contain more than 0 items", 18, 1},
		},
		"description_en_videos_invalid.yml": ValidationResults{
			ValidationError{"", "description.en.videos[0]", "videos[0] must be an HTTP URL", 41, 9},
			ValidationError{"", "description.en.videos[1]", "videos[1] is a required field", 43, 8},
			ValidationError{"", "description.en.videos[2]", "videos[2] must be an HTTP URL", 45, 9},
			ValidationWarning{"", "description.en.videos", "This key is DEPRECATED and will be removed in the future. Link videos from the documentation or the website instead", 39, 5},
			ValidationError{"", "description.en.videos[0]", "'ABC' is not a valid video URL supporting oEmbed: invalid oEmbed link: ABC", 41, 9},
			ValidationError{"", "description.en.videos[2]", "'' is not a valid video URL supporting oEmbed: invalid oEmbed link: ", 45, 9},
		},
		"description_en_videos_invalid_oembed.yml": ValidationResults{
			ValidationWarning{"", "description.en.videos", "This key is DEPRECATED and will be removed in the future. Link videos from the documentation or the website instead", 39, 5},
			ValidationError{"", "description.en.videos[0]", "'https://google.com' is not a valid video URL supporting oEmbed: invalid oEmbed link: https://google.com", 41, 9},
		},

		// legal
		// legal.*
		"legal_missing.yml": ValidationResults{ValidationError{"", "legal.license", "license is a required field", 0, 0}},
		"legal_wrong_type.yml": ValidationResults{
			ValidationError{"", "legal", "wrong type for this field", 46, 1},
			ValidationError{"", "legal.license", "license is a required field", 46, 8},
		},
		"legal_license_missing.yml": ValidationResults{ValidationError{"", "legal.license", "license is a required field", 41, 3}},
		"legal_license_invalid.yml": ValidationResults{ValidationError{
			"",
			"legal.license", "license must be a valid license (see https://spdx.org/licenses)", 42, 3,
		}},
		"legal_authorsFile_missing_file.yml": ValidationResults{
			ValidationWarning{
				"",
				"legal.authorsFile",
				"This key is DEPRECATED and will be removed in the future. It's safe to drop it",
				42,
				3,
			},
			ValidationError{
				"",
				"legal.authorsFile",
				"'" + cwd + "/testdata/v0/invalid/no_such_authors_file.txt' does not exist: no such file: " + cwd + "/testdata/v0/invalid/no_such_authors_file.txt",
				42,
				3,
			},
		},
		"legal_authorsFile_file_scheme_uppercase.yml": ValidationResults{
			ValidationWarning{
				"",
				"legal.authorsFile",
				"This key is DEPRECATED and will be removed in the future. It's safe to drop it",
				42,
				3,
			},
			ValidationError{
				"",
				"legal.authorsFile",
				"is a file:// URL. Only relative paths or HTTP(s) URLs allowed",
				42,
				3,
			},
		},

		// maintenance
		// maintenance.*
		"maintenance_type_missing.yml": ValidationResults{
			ValidationError{"", "maintenance.type", "type is a required field", 47, 3},
		},
		"maintenance_type_invalid.yml": ValidationResults{
			ValidationError{"", "maintenance.type", "type must be one of the following: \"internal\", \"contract\", \"community\" or \"none\"", 45, 3},
		},
		"maintenance_contacts_missing_with_type_community.yml": ValidationResults{
			ValidationError{"", "maintenance.contacts", "contacts is a required field when \"type\" is \"community\"", 44, 3},
		},
		"maintenance_contacts_missing_with_type_internal.yml": ValidationResults{
			ValidationError{"", "maintenance.contacts", "contacts is a required field when \"type\" is \"internal\"", 44, 3},
		},
		"maintenance_contacts_name_missing.yml": ValidationResults{
			ValidationError{"", "maintenance.contacts[0].name", "name is a required field", 47, 7},
		},
		"maintenance_contacts_email_invalid.yml": ValidationResults{
			ValidationError{"", "maintenance.contacts[0].email", "email must be a valid email address", 49, 9},
		},
		"maintenance_contractors_missing_with_type_contract.yml": ValidationResults{
			ValidationError{"", "maintenance.contractors", "contractors is a required field when \"type\" is \"contract\"", 44, 3},
		},
		"maintenance_contractors_invalid_type.yml": ValidationResults{
			ValidationError{"", "maintenance.contractors", "wrong type for this field", 47, 1},
			ValidationError{"", "maintenance.type", "type is a required field", 44, 3},
		},
		"maintenance_contractors_name_missing.yml": ValidationResults{
			ValidationError{"", "maintenance.contractors[0].name", "name is a required field", 47, 7},
		},
		"maintenance_contractors_until_missing.yml": ValidationResults{
			ValidationError{"", "maintenance.contractors[0].until", "until is a required field", 47, 7},
		},
		"maintenance_contractors_until_invalid.yml": ValidationResults{
			ValidationError{"", "maintenance.contractors[0].until", "until must be a date with format 'YYYY-MM-DD'", 49, 7},
		},
		"maintenance_contractors_email_invalid.yml": ValidationResults{
			ValidationError{"", "maintenance.contractors[0].email", "email must be a valid email address", 50, 8},
		},
		"maintenance_contractors_website_invalid.yml": ValidationResults{
			ValidationError{"", "maintenance.contractors[0].website", "website must be an HTTP URL", 52, 7},
		},
		"maintenance_contractors_when_type_is_community.yml": ValidationResults{
			ValidationError{"", "maintenance.contractors", "contractors must not be present unless \"type\" is \"contract\"", 46, 3},
		},
		"maintenance_contractors_when_type_is_internal.yml": ValidationResults{
			ValidationError{"", "maintenance.contractors", "contractors must not be present unless \"type\" is \"contract\"", 46, 3},
		},
		"maintenance_contractors_when_type_is_none.yml": ValidationResults{
			ValidationError{"", "maintenance.contractors", "contractors must not be present unless \"type\" is \"contract\"", 46, 3},
		},

		// localisation
		"localisation_availableLanguages_missing.yml": ValidationResults{
			ValidationError{"", "localisation.availableLanguages", "availableLanguages is a required field", 50, 3},
		},
		"localisation_availableLanguages_empty.yml": ValidationResults{
			ValidationError{"", "localisation.availableLanguages", "availableLanguages must contain more than 0 items", 52, 3},
		},
		"localisation_availableLanguages_invalid.yml": ValidationResults{
			ValidationError{"", "localisation.availableLanguages[0]", "availableLanguages[0] must be a valid BCP 47 language", 53, 8},
		},
		"localisation_localisationReady_missing.yml": ValidationResults{
			ValidationError{"", "localisation.localisationReady", "localisationReady is a required field", 52, 3},
		},

		// dependsOn
		"dependsOn_open_name_wrong_type.yml": ValidationResults{
			ValidationError{"", "dependsOn.open[0]", "wrong type for this field", 56, 1},
		},
		"dependsOn_open_versionMin_wrong_type.yml": ValidationResults{
			ValidationError{"", "dependsOn.open[0].versionMin", "wrong type for this field", 57, 1},
		},
		"dependsOn_open_versionMax_wrong_type.yml": ValidationResults{
			ValidationError{"", "dependsOn.open[0].versionMax", "wrong type for this field", 57, 1},
		},
		"dependsOn_open_version_wrong_type.yml": ValidationResults{
			ValidationError{"", "dependsOn.open[0].version", "wrong type for this field", 57, 1},
		},
		"dependsOn_open_optional_wrong_type.yml": ValidationResults{
			ValidationError{"", "dependsOn.open[0].optional", "wrong type for this field", 57, 1},
		},

		// it.*
		"it_countryExtensionVersion_invalid.yml": ValidationResults{
			ValidationError{"", "IT.countryExtensionVersion", "countryExtensionVersion must be one of the following: \"0.2\" or \"1.0\"", 12, 3},
		},
		"it_riuso_codiceIPA_invalid.yml": ValidationResults{
			ValidationError{"", "IT.riuso.codiceIPA", "codiceIPA must be a valid Italian Public Administration Code (iPA) (see https://github.com/publiccodeyml/italian-organizations-ipa-vocabulary)", 55, 5},
		},
		"it_IT_duplicated.yml": ValidationResults{
			ValidationWarning{"", "dependsOn.open", "This key is DEPRECATED and will be removed in the future. It's safe to drop it", 85, 3},
			ValidationWarning{"", "usedBy", "This key is DEPRECATED and will be removed in the future. It's safe to drop it", 19, 1},
			ValidationWarning{"", "description.en.videos", "This key is DEPRECATED and will be removed in the future. Link videos from the documentation or the website instead", 60, 5},
			ValidationWarning{"", "it", "Lowercase country codes are DEPRECATED and will be removed in the future. Use 'IT' instead", 114, 1},
			ValidationError{"", "it", "'IT' key already present. Remove this key", 114, 1},
		},
		"it_wrong_case.yml": ValidationResults{
			ValidationError{"", "It", "unknown field \"It\"", 105, 1},
			ValidationWarning{"", "dependsOn.open", "This key is DEPRECATED and will be removed in the future. It's safe to drop it", 85, 3},
			ValidationWarning{"", "usedBy", "This key is DEPRECATED and will be removed in the future. It's safe to drop it", 19, 1},
			ValidationWarning{"", "description.en.videos", "This key is DEPRECATED and will be removed in the future. Link videos from the documentation or the website instead", 60, 5},
		},
		"description_en_gb_invalid_bcp47.yml": ValidationResults{
			ValidationError{"", "description", "description must be a valid BCP 47 language", 18, 1},
		},
		"localisation_availableLanguages_invalid_bcp47.yml": ValidationResults{
			ValidationError{"", "localisation.availableLanguages[0]", "availableLanguages[0] must be a valid BCP 47 language", 54, 8},
		},

		// misc
		"file_encoding.yml": ValidationResults{ValidationError{"", "", "Invalid UTF-8", 0, 0}},
		"invalid_yaml.yml":  ValidationResults{ValidationError{"", "", "value is not allowed in this context. map key-value is pre-defined", 38, 1}},
		"mostly_empty.yml": ValidationResults{
			ValidationError{"", "name", "name is a required field", 1, 1},
			ValidationError{"", "url", "url is a required field", 1, 1},
			ValidationError{"", "platforms", "platforms must contain more than 0 items", 1, 1},
			ValidationError{"", "developmentStatus", "developmentStatus is a required field", 1, 1},
			ValidationError{"", "softwareType", "softwareType is a required field", 1, 1},
			ValidationError{"", "description[en-US].shortDescription", "shortDescription is a required field", 3, 10},
			ValidationError{"", "description[en-US].longDescription", "longDescription is a required field", 3, 10},
			ValidationError{"", "legal.license", "license is a required field", 5, 8},
			ValidationError{"", "maintenance.type", "type is a required field", 6, 14},
			ValidationError{"", "localisation.localisationReady", "localisationReady is a required field", 4, 15},
			ValidationError{"", "localisation.availableLanguages", "availableLanguages is a required field", 4, 15},
		},
		"unknown_field.yml": ValidationResults{
			ValidationError{"", "foobar", "unknown field \"foobar\"", 10, 1},
		},
	}

	dir := "testdata/v0/invalid/"
	testFiles, _ := filepath.Glob(dir + "*yml")
	for _, file := range testFiles {
		baseName := path.Base(file)
		if expected[baseName] == nil {
			t.Errorf("No expected data for file %s", baseName)
		}
		t.Run(file, func(t *testing.T) {
			err := parse(file)
			checkParseErrors(t, err, testType{file, expected[baseName]})
		})
	}
	for file := range expected {
		if !slices.Contains(testFiles, dir+file) {
			t.Errorf("No expected file %s", dir+file)
		}
	}
}

// Test v0 valid YAML testcases (testdata/v0/valid/).
func TestValidTestcasesV0(t *testing.T) {
	checkValidFiles("testdata/v0/valid/*.yml", t)
}

// Test v0 valid YAML testcases (testdata/v0/valid_with_warnings/).
func TestValidWithWarningsTestcasesV0(t *testing.T) {
	expected := map[string]error{
		"unicode_grapheme_clusters.yml": ValidationResults{
			ValidationWarning{"", "description.en.genericName", "This key is DEPRECATED and will be removed in the future. It's safe to drop it", 23, 5},
		},
		"maintenance_contacts_phone_not_e164.yml": ValidationResults{
			ValidationWarning{"", "maintenance.contacts[0].phone", "Phone numbers SHOULD use the E.164 format, e.g. '+3923113215112'", 46, 7},
		},
		"valid.minimal.v0.2.yml": ValidationResults{
			ValidationWarning{"", "publiccodeYmlVersion", "v0.2 is not the latest version, use '0'. Parsing this file as v0.8.", 1, 1},
		},
		"valid.minimal.v0.3.yml": ValidationResults{
			ValidationWarning{"", "publiccodeYmlVersion", "v0.3 is not the latest version, use '0'. Parsing this file as v0.8.", 1, 1},
		},
		"valid.minimal.v0.4.yml": ValidationResults{
			ValidationWarning{"", "publiccodeYmlVersion", "v0.4 is not the latest version, use '0'. Parsing this file as v0.8.", 1, 1},
		},
		"valid.minimal.v0.7.yml": ValidationResults{
			ValidationWarning{"", "publiccodeYmlVersion", "v0.7 is not the latest version, use '0'. Parsing this file as v0.8.", 1, 1},
		},
		"valid.mime_types.yml": ValidationResults{
			ValidationWarning{"", "inputTypes", "This key is DEPRECATED and will be removed in the future. It's safe to drop it", 48, 1},
			ValidationWarning{"", "outputTypes", "This key is DEPRECATED and will be removed in the future. It's safe to drop it", 50, 1},
		},
		"valid_with_it_conforme.yml": ValidationResults{
			ValidationWarning{"", "IT.conforme", "This key is DEPRECATED and will be removed in the future. It's safe to drop it", 103, 3},
		},
		"valid_with_country_specific_section_downcase.yml": ValidationResults{
			ValidationWarning{"", "it", "Lowercase country codes are DEPRECATED and will be removed in the future. Use 'IT' instead", 91, 1},
		},
		"valid_with_lowercase_countries.yml": ValidationResults{
			ValidationWarning{"", "intendedAudience.countries[0]", "Lowercase country codes are DEPRECATED. Use uppercase instead ('IT')", 27, 7},
			ValidationWarning{"", "intendedAudience.countries[1]", "Lowercase country codes are DEPRECATED. Use uppercase instead ('DE')", 28, 7},
			ValidationWarning{"", "intendedAudience.unsupportedCountries", "This key is DEPRECATED and will be removed in the future. Use 'intendedAudience.countries' to list the targeted countries instead", 29, 3},
			ValidationWarning{"", "intendedAudience.unsupportedCountries[0]", "Lowercase country codes are DEPRECATED. Use uppercase instead ('US')", 30, 7},
		},
		"valid_with_government_scope.yml": ValidationResults{
			ValidationWarning{"", "intendedAudience.scope[1]", "The 'government' scope is DEPRECATED and will be removed in the future. It's safe to drop it", 19, 7},
		},
		"valid_with_unsupportedCountries.yml": ValidationResults{
			ValidationWarning{"", "intendedAudience.unsupportedCountries", "This key is DEPRECATED and will be removed in the future. Use 'intendedAudience.countries' to list the targeted countries instead", 19, 3},
		},
		"valid_with_isBasedOn_string.yml": ValidationResults{
			ValidationWarning{"", "isBasedOn", "The single string form is DEPRECATED and will be removed in the future. Use a one element array instead", 6, 1},
		},
		"valid_with_legal_repoOwner.yml": ValidationResults{
			ValidationWarning{"", "legal.repoOwner", "This key is DEPRECATED and will be removed in the future. Use 'organisation.name' instead", 62, 3},
		},
		"valid_with_usedBy.yml": ValidationResults{
			ValidationWarning{"", "usedBy", "This key is DEPRECATED and will be removed in the future. It's safe to drop it", 12, 1},
		},
		"valid_with_dependsOn_open.yml": ValidationResults{
			ValidationWarning{"", "dependsOn.open", "This key is DEPRECATED and will be removed in the future. It's safe to drop it", 53, 3},
		},
		"valid_with_videos.yml": ValidationResults{
			ValidationWarning{"", "description.en-GB.videos", "This key is DEPRECATED and will be removed in the future. Link videos from the documentation or the website instead", 37, 5},
		},
		"valid_with_IT_riuso_codiceIPA.yml": ValidationResults{
			ValidationWarning{"", "IT.riuso.codiceIPA", "This key is DEPRECATED and will be removed in the future. Use 'organisation.uri' and set it to 'urn:x-italian-pa:pcm' instead", 103, 5},
		},
	}

	dir := "testdata/v0/valid_with_warnings/"
	testFiles, _ := filepath.Glob(dir + "*yml")
	for _, file := range testFiles {
		baseName := path.Base(file)
		if expected[baseName] == nil {
			t.Errorf("No expected data for file %s", baseName)
		}
		t.Run(file, func(t *testing.T) {
			err := parse(file)
			checkParseErrors(t, err, testType{file, expected[baseName]})
		})
	}
	for file := range expected {
		if !slices.Contains(testFiles, dir+file) {
			t.Errorf("No expected file %s", dir+file)
		}
	}
}

// Test publiccode.yml remote files for key errors.
func TestDecodeValueErrorsRemote(t *testing.T) {
	testRemoteFiles := []testType{
		// Pinned to a commit: fetching from main means a testdata change
		// breaks this test in every PR until the change itself lands.
		{"https://raw.githubusercontent.com/italia/publiccode-parser-go/389af926bcb5bcb723b56d8e390585f2d0f2c7e8/testdata/v0/valid_with_warnings/valid_with_lowercase_countries.yml", ValidationResults{
			ValidationWarning{"", "isBasedOn", "The single string form is DEPRECATED and will be removed in the future. Use a one element array instead", 7, 1},
			ValidationWarning{"", "intendedAudience.countries[0]", "Lowercase country codes are DEPRECATED. Use uppercase instead ('IT')", 31, 7},
			ValidationWarning{"", "intendedAudience.countries[1]", "Lowercase country codes are DEPRECATED. Use uppercase instead ('DE')", 32, 7},
			ValidationWarning{"", "intendedAudience.unsupportedCountries", "This key is DEPRECATED and will be removed in the future. Use 'intendedAudience.countries' to list the targeted countries instead", 33, 3},
			ValidationWarning{"", "intendedAudience.unsupportedCountries[0]", "Lowercase country codes are DEPRECATED. Use uppercase instead ('US')", 34, 7},
			ValidationWarning{"", "maintenance.contacts[0].phone", "Phone numbers SHOULD use the E.164 format, e.g. '+3923113215112'", 83, 7},
			ValidationWarning{"", "maintenance.contacts[1].phone", "Phone numbers SHOULD use the E.164 format, e.g. '+3923113215112'", 87, 7},
			ValidationWarning{"", "maintenance.contacts[2].phone", "Phone numbers SHOULD use the E.164 format, e.g. '+3923113215112'", 91, 7},
			ValidationWarning{"", "dependsOn.open", "This key is DEPRECATED and will be removed in the future. It's safe to drop it", 102, 3},
			ValidationWarning{"", "usedBy", "This key is DEPRECATED and will be removed in the future. It's safe to drop it", 18, 1},
			ValidationWarning{"", "description.en.videos", "This key is DEPRECATED and will be removed in the future. Link videos from the documentation or the website instead", 62, 5},
		}},
	}

	parser, err := NewDefaultParser()
	if err != nil {
		t.Errorf("Can't create parser: %v", err)
	}

	for _, test := range testRemoteFiles {
		t.Run(fmt.Sprintf("%v", test.err), func(t *testing.T) {
			var err error

			_, err = parser.Parse(test.file)

			checkParseErrors(t, err, test)
		})
	}
}

// Test that files in fields with relative paths or URLs (ie. logo, screenshots, etc.)
// are checked and expanded correctly
func TestRelativePathsOrURLs(t *testing.T) {
	testRemoteFiles := []testType{
		// Remote publiccode.yml and relative path in screenshots:
		// should look for the screenshot remotely relative to this URL
		{"https://raw.githubusercontent.com/italia/publiccode-parser-go/2a1f25a36e0f2ab2d71efb67db8b66ff00573fbe/testdata/v0/invalid/description_en_screenshots_missing_file.yml", ValidationResults{
			ValidationError{"", "description.en.screenshots[0]", "'no_such_file.png' is not an image: HTTP GET failed for https://raw.githubusercontent.com/italia/publiccode-parser-go/2a1f25a36e0f2ab2d71efb67db8b66ff00573fbe/testdata/v0/invalid/no_such_file.png: not found", 42, 9},
		}},

		// Local publiccode.yml and relative path in screenshot:
		// should look for the logo relative to this path in the filesystem
		{"testdata/v0/invalid/description_en_screenshots_missing_file.yml", ValidationResults{
			ValidationError{"", "description.en.screenshots[0]", "'no_such_file.png' is not an image: no such file: " + cwd + "/testdata/v0/invalid/no_such_file.png", 42, 9},
		}},

		// Remote publiccode.yml and URL in logo:
		// should look for the logo remotely
		{"https://raw.githubusercontent.com/italia/publiccode-parser-go/2a1f25a36e0f2ab2d71efb67db8b66ff00573fbe/testdata/v0/invalid/logo_missing_url.yml", ValidationResults{
			ValidationError{"", "logo", "downloading https://google.com/no_such_file.png: not found", 18, 1},
		}},

		// Local publiccode.yml and URL in logo:
		// should look for the logo remotely
		//
		// (already tested in TestInvalidTestcasesV0)
		// "testdata/v0/invalid/logo_missing_url.yml", ValidationResults{
		//	ValidationError{"logo", "downloading https://google.com/no_such_file.png: not found", 18, 1},
		//}},
	}

	parser, err := NewDefaultParser()
	if err != nil {
		t.Errorf("Can't create parser: %v", err)
	}

	for _, test := range testRemoteFiles {
		t.Run(fmt.Sprintf("%v", test.err), func(t *testing.T) {
			var err error

			_, err = parser.Parse(test.file)

			checkParseErrors(t, err, test)
		})
	}
}

// Test that files in fields with relative paths or URLs (ie. logo, screenshots, etc.)
// are checked and expanded correctly when DisableNetwork is true
func TestRelativePathsOrURLsNoNetworkRemoteChecks(t *testing.T) {
	testRemoteFiles := []string{
		// Remote publiccode.yml and relative path in screenshots:
		// should look for the screenshot remotely relative to this URL,
		// but DisableNetwork is true, so no check is performed.
		"https://raw.githubusercontent.com/italia/publiccode-parser-go/2a1f25a36e0f2ab2d71efb67db8b66ff00573fbe/testdata/v0/invalid/description_en_screenshots_missing_file.yml",

		// Remote publiccode.yml and URL in logo:
		// should look for the logo remotely but DisableNetwork is true, so no check is performed.
		"https://raw.githubusercontent.com/italia/publiccode-parser-go/2a1f25a36e0f2ab2d71efb67db8b66ff00573fbe/testdata/v0/invalid/logo_missing_url.yml",

		// Local publiccode.yml and URL in logo:
		// should look for the logo remotely but DisableNetwork is true, so no check is performed.
		"testdata/v0/invalid/logo_missing_url.yml",
	}

	for _, file := range testRemoteFiles {
		t.Run(file, func(t *testing.T) {
			if err := parseNoNetwork(file); err != nil {
				t.Errorf("[%s] validation failed for valid file: %T - %s\n", file, err, err)
			}
		})
	}
}

// Test that files in fields with relative paths or URLs (ie. logo, screenshots, etc.)
// are checked and expanded correctly when DisableNetwork is true
func TestRelativePathsOrURLsNoNetwork(t *testing.T) {
	testFiles := []testType{
		// Local publiccode.yml and relative path in screenshot:
		// should look for the logo relative to this path in the filesystem.
		// DisableNetwork doesn't affect this so the check *IS* performed.
		{"testdata/v0/invalid/description_en_screenshots_missing_file.yml", ValidationResults{
			ValidationError{"", "description.en.screenshots[0]", "'no_such_file.png' is not an image: no such file: " + cwd + "/testdata/v0/invalid/no_such_file.png", 42, 9},
		}},
	}

	parser, err := NewParser(ParserConfig{DisableNetwork: true})
	if err != nil {
		t.Errorf("Can't create parser: %v", err)
	}

	for _, test := range testFiles {
		t.Run(fmt.Sprintf("%v", test.err), func(t *testing.T) {
			var err error

			_, err = parser.Parse(test.file)

			checkParseErrors(t, err, test)
		})
	}
}

func TestUrlMissingWithoutPath(t *testing.T) {
	expected := map[string]error{
		"url_missing.yml": ValidationResults{
			ValidationError{"", "url", "url is a required field", 1, 1},
		},
	}

	parser, err := NewDefaultParser()
	if err != nil {
		t.Errorf("Can't create parser: %v", err)
	}

	testFiles, _ := filepath.Glob("testdata/v0/invalid/url_missing.yml")
	for _, file := range testFiles {
		baseName := path.Base(file)
		if expected[baseName] == nil {
			t.Errorf("No expected data for file %s", baseName)
		}
		t.Run(file, func(t *testing.T) {
			_, err := parser.Parse(file)

			checkParseErrors(t, err, testType{file, expected[baseName]})
		})
	}
}