calista-components

Данный репозиторий является листингов компонентом операционной системы Calista. Он используется для работы менеджеров компонентов Calista.

В этом репозитории существует два файла - README.md, то есть этот файл, а также файл components.json, который описывает доступные компоненты, их версии, зависимости и ссылки на репозитории этих компонентов.

Формат файла components.json

{
  "version": "v1",
  "components": [
    {
      "id": "уникальный-идентификатор",
      "name": "Человекочитаемое название",
      "desc": "Описание",
      "repo": "ссылка на git-репозиторий",
      "latest": "тег-последней-версии",
      "requires": ["зависимости"],
      "tags": {
        "тег-версии": "короткий-хэш-коммита"
      }
    }
  ]
}

Описание ключей

• version - Версия спецификации описания файла components.json - обязательный
• components - Массив объектов описания компонентов (далее component) - обязательный
• component->id - Идентификатор компонента, без пробелов - обязательный
• component->name - Имя компонента - обязательный
• component->desc - Описание компонента - необязательный
• component->repo - Ссылка на git репозиторий - обязательный
• component->latest - Тег последней версии - обязательный
• component->requires - Массив идентификаторов зависимых компонентов с указанием версии в формате "имя компонента:версия" - необязательный
• component->tags - Объект указывающий на коммиты версий компонентов - обязательный
• component->tags->тег-версии - Короткий кеш коммита - обязательный для тега latest, остальные не обязательны

По необходимости ключи могут дополняться, но в данный момент я вижу что этих ключей хватит надолго