{ "$schema": "http://json-schema.org/draft-07/schema#", "$id": "https://hydrilla.koszko.org/package_source-1.schema.json", "title": "Package source", "description": "Definition of a Hydrilla source package", "type": "object", "required": [ "source_schema_version", "source_name", "copyright", "upstream_url", "definitions" ], "properties": { "source_schema_version": { "description": "Which version of Hydrilla source package schema this definition conforms to", "type": "array", "minItems": 1, "items": [{ "const": 1 }], "additionalItems": { "type": "integer", "minimum": 0 }, "minItems": 1 }, "source_name": { "description": "Unique identifier of this source package", "type": "string", "pattern": "^[-0-9a-z.]+$" }, "copyright": { "description": "Which files from the source package indicate its license terms and should be included in the distribution packages", "type": "array", "items": { "$ref": "#/definitions/file_ref" } }, "upstream_url": { "description": "Where this software/work initially comes from", "type": "string" }, "comment": { "$ref": "#/definitions/comment" }, "definitions": { "description": "Definitions of site resources and pattern->payload mappings", "type": "array", "items": { "allOf": [{ "description": "Item definition (fields common to both resources and mappings)", "type": "object", "required": [ "type", "identifier", "long_name", "uuid", "version", "description" ], "properties": { "type": { "description": "What kind of item is being defined (resource or mapping)", "enum": ["resource", "mapping"] }, "identifier": { "$ref": "#/definitions/item_identifier" }, "long_name": { "description": "User-friendly alternative to an identifier", "type": "string" }, "uuid": { "description": "UUIDv4 of this item (shared with other versions of this item, otherwise unique)", "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$" }, "version": { "description": "Item's version number", "type": "array", "minItems": 1, "items": { "type": "integer", "minimum": 0 }, "contains": { "type": "integer", "minimum": 1 }, "minItems": 1 }, "description": { "description": "Item's description", "type": "string" }, "comment": { "$ref": "#/definitions/comment" } } }, { "anyOf": [{ "$ref": "#/definitions/resource_definition" }, { "$ref": "#/definitions/mapping_definition" }] }] } }, "additional_files": { "description": "Files which should be included in the source archive produced by Hydrilla builder in addition to script and copyright files", "type": "array", "items": { "$ref": "#/definitions/file_ref" }, "default": [] }, "reuse_generate_spdx_report": { "description": "Should report.spdx be automatically generated for the package using REUSE tool", "type": "boolean", "default": false } }, "definitions": { "comment": { "description": "An optional comment", "type": "string" }, "file_ref": { "type": "object", "required": ["file"], "properties": { "file": { "description": "Filename relative to source package main directory; separator is '/'", "type": "string", "pattern": "^[^/]" } } }, "item_identifier": { "description": "Identifier of an item (shared with other versions of the item, otherwise unique)", "type": "string", "pattern": "^[-0-9a-z]+$" }, "resource_definition": { "description": "Resource definition (fields specific to resource)", "type": "object", "required": [ "type", "revision" ], "properties": { "type": { "description": "Identify this item as a resource", "const": "resource" }, "revision": { "description": "Which revision of a packaging of given version of an upstream resource is this", "type": "integer", "minimum": 1 }, "scripts": { "description": "Which files from the source package are scripts to be included in the resource", "type": "array", "items":{ "$ref": "#/definitions/file_ref" }, "default": [] }, "dependencies": { "description": "What other resources this one depends on", "type": "array", "items": { "$ref": "#/definitions/item_identifier" }, "default": [] } } }, "mapping_definition": { "description": "Mapping definition (fields specific to mapping)", "type": "object", "required": ["type"], "properties": { "type": { "description": "Identify this item as a mapping", "const": "mapping" }, "payloads": { "description": "Which payloads are to be applied to which URLs", "additionalProperties": { "description": "Which payload applies to URLs matching given pattern", "type": "object", "required": ["identifier"], "properties": { "identifier": { "$ref": "#/definitions/item_identifier" } } }, "default": {}, "examples": [{ "https://hydrillabugs.koszko.org/***": { "identifier": "helloapple" }, "https://*.koszko.org/***": { "identifier": "hello-potato" } }] } } } } }