schema/red_cog.schema.json
{
"$id": "https://raw.githubusercontent.com/Cog-Creators/Red-DiscordBot/V3/develop/schema/red_cog.schema.json",
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "Red-DiscordBot Сog metadata file",
"type": "object",
"properties": {
"author": {
"type": "array",
"description": "List of names of authors of the cog",
"items": {
"type": "string"
}
},
"description": {
"type": "string",
"description": "A long description of the cog or repo. For cogs, this is displayed when a user executes [p]cog info."
},
"install_msg": {
"type": "string",
"description": "The message that gets displayed when a cog is installed or a repo is added"
},
"short": {
"type": "string",
"description": "A short description of the cog or repo. For cogs, this info is displayed when a user executes [p]cog list"
},
"end_user_data_statement": {
"type": "string",
"description": "A statement explaining what end user data the cog is storing. This is displayed when a user executes [p]cog info. If the statement has changed since last update, user will be informed during the update."
},
"min_bot_version": {
"type": "string",
"description": "Min version number of Red in the format MAJOR.MINOR.MICRO",
"pattern": "^(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)((a|b|rc)(0|[1-9][0-9]*))?(\\.post(0|[1-9][0-9]*))?(\\.dev(0|[1-9][0-9]*))?$"
},
"max_bot_version": {
"type": "string",
"description": "Max version number of Red in the format MAJOR.MINOR.MICRO, if min_bot_version is newer than max_bot_version, max_bot_version will be ignored",
"pattern": "^(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)\\.(0|[1-9][0-9]*)((a|b|rc)(0|[1-9][0-9]*))?(\\.post(0|[1-9][0-9]*))?(\\.dev(0|[1-9][0-9]*))?$"
},
"min_python_version": {
"type": "array",
"description": "Min version number of Python in the format [MAJOR, MINOR, PATCH]",
"minItems": 3,
"maxItems": 3,
"items": {
"type": "integer"
}
},
"hidden": {
"type": "boolean",
"description": "Determines if a cog is visible in the cog list for a repo."
},
"disabled": {
"type": "boolean",
"description": "Determines if a cog is available for install."
},
"required_cogs": {
"type": "object",
"description": "A dict of required cogs that this cog depends on in the format {cog_name : repo_url}. Downloader will not deal with this functionality but it may be useful for other cogs.",
"$ref": "#/definitions/required_cog"
},
"requirements": {
"type": "array",
"description": "List of required libraries that are passed to pip on cog install.",
"items": {
"type": "string"
}
},
"tags": {
"type": "array",
"description": "A list of strings that are related to the functionality of the cog. Used to aid in searching.",
"uniqueItems": true,
"items": {
"type": "string"
}
},
"type": {
"type": "string",
"description": "Optional, defaults to COG. Must be either COG or SHARED_LIBRARY. If SHARED_LIBRARY then hidden will be True.",
"enum": [
"COG",
"SHARED_LIBRARY"
]
}
},
"definitions": {
"required_cog": {
"type": "object",
"patternProperties": {
".+": {
"type": "string",
"format": "uri"
}
},
"additionalProperties": false
}
}
}