Go

Реестр пакетов Go на GitVerse предназначен для хранения, управления и распространения Go-пакетов.

Требования к zip-архиву

В составе архива должен быть каталог с именем в формате модуль@версия или модуль@версия-timestamp-commit hash, например pkg-example1@v1.0.0 или pkg-example1@v2.1.0-20230520120000-8a3d2e1f7b11.

C требованиями к zip-архиву пакета go можно ознакомиться на странице https://go.dev/ref/mod#zip-files (opens in a new tab).

Пояснения:

  1. модуль должен быть именем модуля Go, который обычно соответствует имени репозитория или основной директории модуля;
  2. версия должна быть согласована с семантическим версионированием;
  3. timestamp должен содержать информацию о времени сборки архива;
  4. commit hash представляет собой хэш коммита из репозитория.

Рекомендации:

  1. оптимизация: для уменьшения размера архива рекомендуется удалять все ненужные файлы, такие как файлы тестов, временные файлы и файлы конфигурации;
  2. ясность: используйте понятные и описательные имена каталогов и файлов, чтобы облегчить понимание структуры пакета;
  3. согласованность: придерживайтесь единого стиля именования для всех каталогов и файлов в пакете.

Пример правильной структуры:

go-package/
├── main.go
├── internal/
│   ├── utils.go
│   └── server.go
└── cmd/
    └── app/
        └── main.go

Публикация пакета

  1. Создайте токен.

  2. Для публикации выполните команду, заменив в ней соответствующие поля на ваши:

    curl --user ваш_username:ваш_токен \
         --upload-file путь/к/файлу.zip \
         https://gitverse.ru/api/packages/ваш_username/go/upload

    Пример:

    curl --user author2:73630ec71155c3014bcc50ca5b63e8cc8440ed8f --upload-file calculator-v1.0.0.zip https://gitverse.ru/api/packages/author2/go/upload
  3. В профиле пользователя на вкладке Пакеты добавится новый пакет.

    Пример:

    Добавлен новый пакет Go

Установка пакета

Порядок установки описан на странице пакета.

Пример:

Порядок установки Go пакета на странице пакета