Classe AxeWatcherGitInfo

A classe AxeWatcherGitInfo contém metadados Git explícitos para uma execução de teste do Axe Watcher. Passe uma instância para setGitInfo() em AxeWatcherOptions para evitar a detecção automática do Git.

Use esta classe quando:

• Seus testes são executados em um repositório separado do repositório em teste
• O binário do Git não está disponível em seu ambiente de CI
• O repositório é um clone superficial ou está em um estado de HEAD destacado

branch, commitSha e url são os campos gitful. Se o projeto ainda não estiver vinculado a uma forma de dados, uma sessão submetida sem todos os três é registrada como Gitless, e o projeto é bloqueado para Gitless daqui em diante. Uma vez que um projeto está bloqueado no Git, uma sessão faltando qualquer um dos três é rejeitada na ingestão: os resultados não são salvos. Veja Execução Rejeitada: Forma de Dados ou Repositório Não Coincide com o Projeto para a mensagem de rejeição e como resolvê-la. Os campos restantes são opcionais.

Veja Fornecendo Metadados do Git para exemplos de uso. Um clone superficial ou estado de HEAD destacado, mencionado acima como uma razão para usar esta classe, também é uma causa comum da rejeição: veja Execução Rejeitada: Formato de Dados ou Repositório Não Corresponde ao Projeto.

Construtor

AxeWatcherGitInfo()

Cria uma nova instância com todos os campos não definidos.

AxeWatcherGitInfo gitInfo = new AxeWatcherGitInfo();

Métodos

setBranch(String branch)

Define o nome do branch do Git. Necessário para que a execução do teste seja vinculada a um branch e commit no Axe Developer Hub.

Parâmetros:

• branch - Nome do branch, por exemplo, "main"

Retorna:

• AxeWatcherGitInfo - A instância atual para encadeamento de métodos

Exemplo:

new AxeWatcherGitInfo().setBranch(System.getenv("GIT_BRANCH"));

setCommitAuthor(String commitAuthor)

Define o nome de exibição do autor do commit. Se omitido, o autor aparecerá como indisponível no Axe Developer Hub.

Parâmetros:

• commitAuthor - Nome de exibição do autor

Retorna:

• AxeWatcherGitInfo - A instância atual para encadeamento de métodos

Exemplo:

new AxeWatcherGitInfo().setCommitAuthor(System.getenv("GIT_AUTHOR_NAME"));

setCommitEmail(String commitEmail)

Define o endereço de e-mail do autor do commit.

Parâmetros:

• commitEmail - Endereço de e-mail do autor

Retorna:

• AxeWatcherGitInfo - A instância atual para encadeamento de métodos

Exemplo:

new AxeWatcherGitInfo().setCommitEmail(System.getenv("GIT_AUTHOR_EMAIL"));

setCommitMessage(String commitMessage)

Define a mensagem completa do commit. Se omitida, a mensagem do commit aparecerá como indisponível no Axe Developer Hub.

Parâmetros:

• commitMessage - A mensagem completa do commit

Retorna:

• AxeWatcherGitInfo - A instância atual para encadeamento de métodos

Exemplo:

new AxeWatcherGitInfo().setCommitMessage(System.getenv("GIT_COMMIT_MESSAGE"));

setCommitSha(String commitSha)

Define o SHA do commit. Necessário para que a execução do teste seja vinculada a um branch e commit no Axe Developer Hub.

Parâmetros:

• commitSha - Hash do commit completo ou abreviado, por exemplo, "abc1234"

Retorna:

• AxeWatcherGitInfo - A instância atual para encadeamento de métodos

Exemplo:

new AxeWatcherGitInfo().setCommitSha(System.getenv("GIT_COMMIT"));

setDefaultBranch(String defaultBranch)

Define o branch padrão do repositório. Sem este campo, o Axe Developer Hub não pode identificar qual branch é o padrão, então comparações de branch de funcionalidades em relação ao branch padrão não estarão disponíveis.

Parâmetros:

• defaultBranch - Nome do branch padrão, por exemplo, "main"

Retorna:

• AxeWatcherGitInfo - A instância atual para encadeamento de métodos

Exemplo:

new AxeWatcherGitInfo().setDefaultBranch("main");

setIsDirty(boolean isDirty)

Define se a árvore de trabalho tem alterações não commitadas. Defina como true se houver alterações não commitadas, ou false se a árvore de trabalho estiver limpa. Se você não chamar este método, a árvore de trabalho será relatada como limpa (false).

Parâmetros:

• isDirty - true se houver alterações não commitadas

Retorna:

• AxeWatcherGitInfo - A instância atual para encadeamento de métodos

Exemplo:

new AxeWatcherGitInfo().setIsDirty(true);

setTag(String tag)

Define a tag do Git.

Parâmetros:

• tag - Nome da tag, por exemplo, "v1.2.3"

Retorna:

• AxeWatcherGitInfo - A instância atual para encadeamento de métodos

Exemplo:

new AxeWatcherGitInfo().setTag(System.getenv("GIT_TAG"));

setUrl(String url)

Define a URL remota do repositório. Necessário para que a execução do teste esteja vinculada a um branch e commit no Axe Developer Hub.

Parâmetros:

• url - URL remoto, por exemplo, "https://github.com/org/repo"

Retorna:

• AxeWatcherGitInfo - A instância atual para encadeamento de métodos

Exemplo:

new AxeWatcherGitInfo().setUrl("https://github.com/org/repo");

getBranch()

Retorna: String - O nome do branch, ou null se não definido.

getCommitAuthor()

Retorna: String - O nome de exibição do autor do commit, ou null se não definido.

getCommitEmail()

Retorna: String - O endereço de e-mail do autor do commit, ou null se não definido.

getCommitMessage()

Retorna: String - A mensagem do commit, ou null se não definida.

getCommitSha()

Retorna: String - O SHA do commit, ou null se não definido.

getDefaultBranch()

Retorna: String - O nome do branch padrão, ou null se não definido.

getIsDirty()

Retorna: Boolean - true se estiver sujo, false se estiver limpo, ou null se setIsDirty() nunca foi chamado.

getTag()

Retorna: String - A tag, ou null se não definida.

getUrl()

Retorna: String - O URL remoto do repositório, ou null se não definido.

Veja também

• AxeWatcherOptions
• AxeWatcher
• Fornecendo Metadados do Git