Проставление метки переиспользования репозитория#

Показатель переиспользования — комплексная метрика, суммирующая результаты по нескольким критериям. Показатель переиспользования отображается в общем списке репозиториев и на странице самого репозитория.

Возможность проставления метки доступна пользователю с правами Рементор CodeHub. После проведения настройки конфигурационного файла (добавления/включения функциональности переиспользования репозитория) администратор инсталляции создает токен с параметром scope: codehub и назначает права рементора выбранным пользователям. Пользователь, обладающий таким токеном, может вызывать запросы, связанные с проставлением метки переиспользования. На ролевую модель назначение токена не влияет.

Назначение прав происходит одним из следующих способов:

• через скрипт командной строки:

  gitea admin user generate-access-token --username <name> --token-name <token_name> --scopes codehub
  

• через вызов API:

  POST /api/v1/users/{username}/tokens
  

  где body:

  {
    "name": "codehub",
    "scopes": ["codehub"]
  }
  

Для удаления прав рементора необходимо вызвать следующий API:

DELETE  /api/v1/users/{username}/tokens/{token}

Назначение репозиторию показателя переиспользования#

Пользователь, которому назначены права рементора, может проставлять и удалять метку InSourceHub, используя методы API:

1. Проставление метки:

   POST /api/v2/projects/repos/marks/codehub
   

   где body:

   {
     tenant_key: "string"
     repo_key: "string"
     project_key: "string"
   }
   

2. Удаление метки:

   DELETE /api/v2/projects/repos/marks/codehub
   

   где body:

   {
     tenant_key: "string"
     repo_key: "string"
     project_key: "string"
   }