git

Uma Ferramenta Sumor Cloud.
Documentação Adicional

Uma biblioteca de versão git, empacotando facilmente versão e gerando pacote específico com env.

Instalação

npm i @sumor/git --save

Pré-requisitos

Versão Node.JS

Requer Node.JS versão 18.x ou superior

Requerir Módulo ES do Node.JS

Como este pacote é escrito em módulo ES, por favor altere o código a seguir no seu arquivo package.json:

{
  "type": "module"
}

Uso

import git from '@sumor/git'
const config = {
  // url e credenciais do git
  url: '<url do git>', // obrigatório
  token: '<token do git>', // obrigatório, se o nome de usuário e senha não forem fornecidos
  username: '<nome de usuário do git>', // obrigatório, se o token não for fornecido
  password: '<senha do git>' // obrigatório, se o token não for fornecido
}
const repositório = await git(config, caminho)

const commit1 = await repositório.currentCommit() // obter commit atual

const commit2 = await repositório.checkout('<commit alvo>') // pode ser um branch, uma tag ou um commit

// se você instalou o Github Desktop, você pode usar o comando abaixo para abri-lo no Github Desktop
await repositório.github()

Criar novo repositório local

Quando você passa nulo como config, ele criará um novo repositório no caminho local.

await git(null, caminho1)

// uso para repositório local
const repositório = await git({ url: caminho1 }, caminho2)