10.8 Git Internals (Por Dentro do Git) - Variáveis de Ambiente

Algumas partes do comportamento geral do Git enquanto programa de computador dependem das variáveis de ambiente.

GIT_EXEC_PATH determina onde o Git procura pelos seus subprogramas (como git-commit, git-diff, e outros). Você pode verificar a configuração atual rodando git --exec-path.

HOME não é usualmente considerada como customizável (muitas outras coisas dependem dela), mas é onde o Git procura pelo arquivo global de configurações. Se você quiser uma instalação do Git verdadeiramente portátil, completa com as configurações globais, você pode sobrescrever a HOME no perfil de shell do Git portátil.

PREFIX é similar, mas serve para as configurações de todo o sistema (system-wide). O Git procura por este arquivo no caminho $PREFIX/etc/gitconfig.

GIT_CONFIG_NOSYSTEM, se definido, desabilita o uso do arquivo de configurações de todo o sistema. Isto é útil se a configuração do seu sistema estiver interferindo com os seus comandos, mas você não tem o acesso para alterá-la ou removê-la.

GIT_PAGER controla o programa utilizado para exibir a saída de múltiplas páginas na linha de comando. Se isto não estiver definido, a PAGER será utilizada como alternativa (fallback).

GIT_EDITOR é o editor que o Git iniciará quando o usuário precisar editar algum texto (uma mensagem de commit, por exemplo). Se não for definido, o EDITOR será usado.

O Git utiliza várias variáveis de ambiente para determinar como ele irá se comunicar com o repositório atual.

GIT_DIR é a localização da pasta .git. Se isto não for especificado, o Git irá subir pela árvore de diretórios até atingir o ~ ou /, procurando por um diretório .git em cada passo.

GIT_CEILING_DIRECTORIES controla o comportamento de busca por um diretório .git. Se você acessar diretórios que demoram a carregar (tais como aqueles em drives de fita, ou através de uma conexão de rede lenta), você talvez queira que o Git pare de tentar mais cedo do que ele tentaria normalmente, especialmente se o Git for invocado ao carregar o prompt do seu shell.

GIT_WORK_TREE é a localização da raiz do diretório de trabalho de um repositório non-bare. Se --git-dir ou GIT_DIR for especificado, mas nenhum entre --work-tree, GIT_WORK_TREE ou core.worktree for especificado, o diretório de trabalho atual será considerado como o nível principal da sua árvore de trabalho.

GIT_INDEX_FILE é o caminho apontado para o arquivo de index (somente repositórios non-bare).

GIT_OBJECT_DIRECTORY pode ser utilizado para especificar a localização do diretório que usualmente reside em .git/objects.

GIT_ALTERNATE_OBJECT_DIRECTORIES é uma lista separada por dois-pontos (formatada como /dir/one:/dir/two:…) a qual diz ao Git onde ele deve procurar por objetos caso não os encontre no GIT_OBJECT_DIRECTORY. Se você por acaso tiver muitos projetos com arquivos grandes que contenham exatamente os mesmos conteúdos, esta variável poderá ser usada para evitar o armazenamento de muitas cópias deles.

Um “pathspec” refere-se à forma como você especifica caminhos para as coisas no Git, incluindo o uso de wildcards (caracteres curinga). Eles são utilizados no arquivo .gitignore, mas também na linha de comando (como em git add *.c).

GIT_GLOB_PATHSPECS e GIT_NOGLOB_PATHSPECS controlam o comportamento padrão dos curingas nos pathspecs. Se GIT_GLOB_PATHSPECS for definido como 1, os caracteres curinga agirão como curingas (o que é o padrão); se GIT_NOGLOB_PATHSPECS for definido como 1, os caracteres curinga apenas corresponderão a eles mesmos, o que significa que algo como *.c corresponderá apenas a um arquivo chamado “\*.c”, ao invés de qualquer arquivo cujo nome termine em .c. Você pode sobrescrever isso em casos individuais iniciando o pathspec com :(glob) ou :(literal), como em :(glob)\*.c.

GIT_LITERAL_PATHSPECS desabilita ambos os comportamentos acima; nenhum caractere curinga funcionará, e os prefixos de sobrescrita também serão desabilitados.

GIT_ICASE_PATHSPECS define todos os pathspecs para funcionarem de maneira insensível a maiúsculas e minúsculas (case-insensitive).

A criação final de um objeto commit no Git é normalmente feita por git-commit-tree, que utiliza essas variáveis de ambiente como sua fonte primária de informações, recorrendo aos valores de configuração somente se elas não estiverem presentes.

GIT_AUTHOR_NAME é o nome legível por humanos no campo “author” (autor).

GIT_AUTHOR_EMAIL é o e-mail para o campo “author”.

GIT_AUTHOR_DATE é a marcação de data/hora (timestamp) usada para o campo “author”.

GIT_COMMITTER_NAME define o nome legível para o campo “committer”.

GIT_COMMITTER_EMAIL é o endereço de e-mail para o campo “committer”.

GIT_COMMITTER_DATE é usado para a marcação de data/hora no campo “committer”.

EMAIL é o endereço de e-mail de alternativa (fallback) caso o valor da configuração user.email não esteja definido. Se isto não estiver definido, o Git recorre aos nomes de usuário do sistema e do host.

O Git usa a biblioteca curl para realizar operações de rede via HTTP, então GIT_CURL_VERBOSE diz ao Git para emitir todas as mensagens geradas por essa biblioteca. Isso é parecido com a execução de curl -v na linha de comando.

GIT_SSL_NO_VERIFY diz ao Git para não verificar os certificados SSL. Isto pode às vezes ser necessário se você estiver usando um certificado auto-assinado (self-signed) para hospedar repositórios Git via HTTPS, ou se você estiver no meio da configuração de um servidor Git mas ainda não instalou um certificado completo.

Se a taxa de dados de uma operação HTTP for menor do que GIT_HTTP_LOW_SPEED_LIMIT bytes por segundo por mais do que GIT_HTTP_LOW_SPEED_TIME segundos, o Git irá abortar aquela operação. Esses valores sobrescrevem os valores das configurações de http.lowSpeedLimit e http.lowSpeedTime.

GIT_HTTP_USER_AGENT define a string user-agent utilizada pelo Git ao se comunicar via HTTP. O padrão é um valor parecido com git/2.0.0.

GIT_DIFF_OPTS é um nome um pouco inadequado (misnomer). Os únicos valores válidos são -u<n> ou --unified=<n>, os quais controlam o número de linhas de contexto mostradas em um comando git diff.

GIT_EXTERNAL_DIFF é usado para sobrescrever o valor de configuração diff.external. Se ele for definido, o Git invocará este programa quando um git diff for invocado.

GIT_DIFF_PATH_COUNTER e GIT_DIFF_PATH_TOTAL são úteis por dentro do programa especificado por GIT_EXTERNAL_DIFF ou diff.external. O primeiro representa qual arquivo numa série está sofrendo o diff (começando por 1), e o último (latter) é o número total de arquivos no lote (batch).

GIT_MERGE_VERBOSITY controla a saída para a estratégia de merge do tipo recursive. Os valores aceitáveis são como a seguir:

O valor padrão é 2.

Quer realmente saber o que o Git está fazendo? O Git possui um conjunto bastante completo de logs de rastreio (traces) embutido, e a única coisa de que você precisa é ligá-lo. Os possíveis valores para essas variáveis são listados a seguir:

GIT_TRACE controla os rastros (traces) gerais, que não se encaixam em nenhuma categoria específica. Isto inclui a expansão de aliases, e também a delegação para outros subprogramas.

GIT_TRACE_PACK_ACCESS controla o rastreio das formas de acesso aos packfiles. O primeiro campo é o packfile sendo acessado, o segundo é o offset por dentro daquele arquivo:

GIT_TRACE_PACKET habilita rastreios a nível de pacotes (packet-level tracing) para operações de rede.

GIT_TRACE_PERFORMANCE controla o registro de dados relacionados à performance. A saída exibirá quanto tempo em duração demorará a cada invocação específica feita para o git.

GIT_TRACE_SETUP mostra as informações a respeito do que o Git está descobrindo em base no repositório e sobre o ambiente com que ele está interagindo.

GIT_SSH, se for especificado, é o programa que será invocado no lugar de ssh quando o Git tentar se conectar em um host SSH. Ele é invocado de forma parecida a $GIT_SSH [username@]host [-p <port>] <command>. Note que isto não constitui a forma mais fácil para se customizar o jeito que o ssh é invocado; ele não suportará parâmetros extras de linha de comando. Para que possa suportar parâmetros extras na linha de comando, você pode usar o GIT_SSH_COMMAND, ou criar um script de wrapper (wrapper script) e definir GIT_SSH de modo que aponte a ele, ou usar o arquivo ~/.ssh/config.

GIT_SSH_COMMAND define o comando SSH que é utilizado quando o Git tentar se conectar a um host SSH. O comando é interpretado pelo próprio shell, e argumentos extras de linha de comando podem ser utilizados com ssh, tal como com GIT_SSH_COMMAND="ssh -i ~/.ssh/my_key" git clone git@example.com:my/repo.

GIT_ASKPASS substitui o valor de configuração core.askpass. Esse programa é invocado sempre que o Git precisa solicitar credenciais ao usuário; ele recebe um prompt de texto como argumento de linha de comando e deve retornar a resposta em stdout (consulte Armazenamento de Credenciais para saber mais sobre esse subsistema).

GIT_NAMESPACE controla o acesso a refs com namespace e equivale à flag --namespace. Isso é útil principalmente no lado do servidor, onde talvez você queira armazenar vários forks de um único repositório em um só repositório, mantendo apenas as refs separadas.

GIT_FLUSH pode ser usada para forçar o Git a usar E/S sem buffer ao escrever incrementalmente em stdout. O valor 1 faz o Git descarregar o buffer com mais frequência; o valor 0 faz com que toda a saída seja armazenada em buffer. O valor padrão (quando essa variável não está definida) seleciona um esquema de buffering adequado de acordo com a atividade e o modo de saída.

GIT_REFLOG_ACTION permite especificar o texto descritivo gravado no reflog. Eis um exemplo: