@sumor/git

Git

Инструмент Sumor Cloud.
Больше документации

Библиотека версий git, легко упаковывает версии и генерирует конкретный пакет с окружением.

Версия NPM Загрузки NPM CI GitHub Тест GitHub Покрытие GitHub Аудит GitHub

Установка

npm i @sumor/git --save

Предварительные требования

Версия Node.JS

Требуется версия Node.JS 18.x или выше.

Требуется ES-модуль Node.JS

Поскольку этот пакет написан на ES-модуле,
пожалуйста, измените следующий код в вашем файле package.json:

{
  "type": "module"
}

Использование

import git from '@sumor/git'
const config = {
  // git url and credentials
  url: '<git url>', // обязательно
  token: '<git token>', // обязательно, если имя пользователя и пароль не предоставлены
  username: '<git username>', // обязательно, если токен не предоставлен
  password: '<git password>' // обязательно, если токен не предоставлен
}
const repository = await git(config, path)

const commit1 = await repository.currentCommit() // получить текущий коммит
const commitTime1 = await repository.currentCommitTime() // получить текущее время коммита, в миллисекундах

await repository.checkout('<целевой коммит>') // может быть веткой, тегом или коммитом
const commit2 = await repository.currentCommit() // получить текущий коммит

// если установлен Github Desktop, вы можете использовать следующую команду для открытия в нем в Github Desktop
await repository.github()

Создание нового локального репозитория

Когда вы передаете null как конфиг, это создаст новый репозиторий в локальном пути.

await git(null, path1)

// использование для локального репозитория
const repository = await git({ url: path1 }, path2)