Git
Português (Brasil) ▾ Topics ▾ Latest version ▾ git-sh-setup last updated in 2.43.0

NOME

git-sh-setup - Código de configuração do shell script comum ao Git

RESUMO

. "$(git --exec-path)/git-sh-setup"

DESCRIÇÃO

Esse não é um comando que o usuário final gostaria de executar. Nunca. Esta documentação destina-se às pessoas que estão estudando os scripts do Porcelain-ish e/ou que estão escrevendo novos scripts.

O scriptlet git sh-setup foi projetado para ser originado (usando .) através dos outros scripts shell para configurar algumas variáveis apontando para os diretórios normais do Git e algumas funções auxiliares do shell.

Antes de fazer o "sourcing", o seu script deve configurar algumas variáveis; USAGE (e LONG_USAGE, se houver) é usado para definir a mensagem fornecida pela função shell usage(). SUBDIRECTORY_OK pode ser definido se o script puder ser executado num subdiretório da árvore de trabalho (alguns comandos não o fazem).

O scriptlet define o GIT_DIR e as variáveis shell GIT_OBJECT_DIRECTORY, porém não as exporta no ambiente.

FUNÇÕES

die

encerra após emitir a mensagem de erro informada no fluxo de erros predefinido.

usage

encerre com a mensagem do consumo.

set_reflog_action

Define o ambiente GIT_REFLOG_ACTION como uma determinada cadeia de caracteres (normalmente o nome do programa), a menos que já esteja definido. Sempre que o script que atualiza refs executa um comando git, uma entrada no reflog é criada usando o valor dessa string para deixar o registro de qual comando atualizou a ref.

git_editor

executa um editor selecionado pelo usuário (GIT_EDITOR, core.editor, VISUAL ou EDITOR) em um determinado arquivo, mas com erro caso nenhum editor seja definido e o terminal for burro.

is_bare_repository

gera true ou false no fluxo da saída padrão para indicar caso o repositório seja um repositório simples (ou seja, sem uma associação a qualquer árvore de trabalho).

cd_to_toplevel

executa o chdir no nível mais alto da árvore de trabalho.

require_work_tree

verifica se o diretório atual está dentro da árvore de trabalho do repositório, ou de outra forma, encerre.

require_work_tree_exists

verifica se a árvore de trabalho associada ao repositório existe e, caso contrário, encerra. Geralmente é feito antes de invocar cd_to_toplevel, o que é impossível de ser feito se não houver uma árvore de trabalho.

require_clean_work_tree <ação> [<dica>]

verifica se a árvore de trabalho e o índice associados ao repositório não têm alterações não confirmadas nos arquivos rastreados. Caso contrário, ele emite uma mensagem de erro no formato Cannot <ação>: <motivo>. <dica>, e encerra. Exemplo:

require_clean_work_tree rebase "Faça o commit ou armazene-os."
get_author_ident_from_commit

gera o código para uso com o eval para definir as variáveis GIT_AUTHOR_NAME, GIT_AUTHOR_EMAIL e GIT_AUTHOR_DATE para um determinado commit.

create_virtual_base

modifica o primeiro arquivo para que apenas as linhas em comum com o segundo arquivo permaneçam. Caso haja um material comum insuficiente, o primeiro arquivo será deixado vazio. O resultado é adequado como uma entrada da base virtual para mesclagem de três vias.

GIT

Parte do conjunto git[1]

scroll-to-top