Classe AxeWatcherGitInfo

La AxeWatcherGitInfo classe contiene metadati Git espliciti per un test run di axe Watcher. Passa un'istanza a setGitInfo() su AxeWatcherOptions per bypassare il rilevamento automatico di Git.

Usa questa classe quando:

• I tuoi test vengono eseguiti in un repository separato dal repository sotto test
• Il binario Git non è disponibile nel tuo ambiente CI
• Il repository è un clone superficiale o si trova in uno stato di HEAD staccato

branch, commitSha, e url sono i campi gitful: una sessione inviata senza tutti e tre viene registrata come gitless e salvata, ma Axe Developer Hub passa alla visualizzazione della sessione gitless, dove il ramo e la cronologia dei commit delle sessioni precedenti non saranno visibili. Inviare una sessione successiva con tutti e tre i campi ripristina la vista gitful. Se sono presenti solo uno o due dei tre, Axe Watcher elimina tutti i campi gitful, registra la sessione come gitless e include un avviso nella risposta. I campi rimanenti sono opzionali. Vedi Fornire Metadati Git per esempi di utilizzo.

Costruttore

AxeWatcherGitInfo()

Crea una nuova istanza con tutti i campi non impostati.

AxeWatcherGitInfo gitInfo = new AxeWatcherGitInfo();

Metodi

setBranch(String branch)

Imposta il nome del branch Git. Necessario affinché il test run sia collegato a un branch e un commit nell'Axe Developer Hub.

Parametri:

• branch - Nome del branch, ad es. "main"

Restituisce:

• AxeWatcherGitInfo - L'istanza corrente per il concatenamento dei metodi

Esempio:

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

setTag(String tag)

Imposta il tag Git.

Parametri:

• tag - Nome del tag, ad es. "v1.2.3"

Restituisce:

• AxeWatcherGitInfo - L'istanza corrente per il concatenamento dei metodi

Esempio:

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

setDefaultBranch(String defaultBranch)

Imposta il branch predefinito del repository. Senza questo campo, l'Axe Developer Hub non può identificare quale branch è il predefinito, quindi i confronti tra feature-branch e branch predefinito non saranno disponibili.

Parametri:

• defaultBranch - Nome del branch predefinito, ad es. "main"

Restituisce:

• AxeWatcherGitInfo - L'istanza corrente per il concatenamento dei metodi

Esempio:

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

setCommitSha(String commitSha)

Imposta lo SHA del commit. Necessario affinché il test run sia collegato a un branch e un commit nell'Axe Developer Hub.

Parametri:

• commitSha - Hash del commit completo o abbreviato, ad es. "abc1234"

Restituisce:

• AxeWatcherGitInfo - L'istanza corrente per il concatenamento dei metodi

Esempio:

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

setCommitAuthor(String commitAuthor)

Imposta il nome visualizzato dell'autore del commit. Se omesso, l'autore apparirà come non disponibile in Axe Developer Hub.

Parametri:

• commitAuthor - Nome visualizzato dell'autore

Restituisce:

• AxeWatcherGitInfo - L'istanza corrente per il concatenamento dei metodi

Esempio:

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

setCommitEmail(String commitEmail)

Imposta l'indirizzo email dell'autore del commit.

Parametri:

• commitEmail - Indirizzo email dell'autore

Restituisce:

• AxeWatcherGitInfo - L'istanza corrente per il concatenamento dei metodi

Esempio:

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

setCommitMessage(String commitMessage)

Imposta il messaggio del commit completo. Se omesso, il messaggio del commit apparirà come non disponibile in Axe Developer Hub.

Parametri:

• commitMessage - Il messaggio completo del commit

Restituisce:

• AxeWatcherGitInfo - L'istanza corrente per il concatenamento dei metodi

Esempio:

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

setUrl(String url)

Imposta l'URL remoto del repository. Necessario per collegare l'esecuzione del test a un ramo e a un commit in Axe Developer Hub.

Parametri:

• url - URL remoto, ad es. "https://github.com/org/repo"

Restituisce:

• AxeWatcherGitInfo - L'istanza corrente per il concatenamento dei metodi

Esempio:

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

setIsDirty(boolean isDirty)

Imposta se il working tree ha modifiche non effettuate. Imposta su true se ci sono modifiche non effettuate, o false se il working tree è pulito. Se non chiami questo metodo, il working tree viene segnalato come pulito (false).

Parametri:

• isDirty - true se ci sono modifiche non effettuate

Restituisce:

• AxeWatcherGitInfo - L'istanza corrente per il concatenamento dei metodi

Esempio:

new AxeWatcherGitInfo().setIsDirty(true);

getBranch()

Restituisce: String - Il nome del ramo, o null se non impostato.

getTag()

Restituisce: String - Il tag, o null se non impostato.

getDefaultBranch()

Restituisce: String - Il nome del ramo predefinito, o null se non impostato.

getCommitSha()

Restituisce: String - Il commit SHA, o null se non impostato.

getCommitAuthor()

Restituisce: String - Il nome visualizzato dell'autore del commit, o null se non impostato.

getCommitEmail()

Restituisce: String - L'indirizzo email dell'autore del commit, o null se non impostato.

getCommitMessage()

Restituisce: String - Il messaggio del commit, o null se non impostato.

getUrl()

Restituisce: String - L'URL remoto del repository, oppure null se non impostato.

getIsDirty()

Restituisce: Boolean - true se è sporco, false se è pulito, oppure null se setIsDirty() non è mai stato chiamato.

Vedi anche

• AxeWatcherOptions
• AxeWatcher
• Fornire Metadati Git