mirror of
https://github.com/jlengrand/github-api.git
synced 2026-03-11 00:11:25 +00:00
159 lines
6.5 KiB
HTML
159 lines
6.5 KiB
HTML
<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml" lang="en"><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/><link rel="stylesheet" href="../jacoco-resources/report.css" type="text/css"/><link rel="shortcut icon" href="../jacoco-resources/report.gif" type="image/gif"/><title>GHWorkflow.java</title><link rel="stylesheet" href="../jacoco-resources/prettify.css" type="text/css"/><script type="text/javascript" src="../jacoco-resources/prettify.js"></script></head><body onload="window['PR_TAB_WIDTH']=4;prettyPrint()"><div class="breadcrumb" id="breadcrumb"><span class="info"><a href="../jacoco-sessions.html" class="el_session">Sessions</a></span><a href="../index.html" class="el_report">GitHub API for Java</a> > <a href="index.source.html" class="el_package">org.kohsuke.github</a> > <span class="el_source">GHWorkflow.java</span></div><h1>GHWorkflow.java</h1><pre class="source lang-java linenums">package org.kohsuke.github;
|
|
|
|
import com.fasterxml.jackson.annotation.JsonIgnore;
|
|
import org.apache.commons.lang3.StringUtils;
|
|
|
|
import java.io.IOException;
|
|
import java.net.URL;
|
|
import java.util.Collections;
|
|
import java.util.Map;
|
|
import java.util.Objects;
|
|
|
|
/**
|
|
* A workflow.
|
|
*
|
|
* @author Guillaume Smet
|
|
* @see GHRepository#getWorkflow(long)
|
|
*/
|
|
<span class="fc" id="L18">public class GHWorkflow extends GHObject {</span>
|
|
|
|
// Not provided by the API.
|
|
@JsonIgnore
|
|
private GHRepository owner;
|
|
|
|
private String name;
|
|
private String path;
|
|
private String state;
|
|
|
|
private String htmlUrl;
|
|
private String badgeUrl;
|
|
|
|
/**
|
|
* The name of the workflow.
|
|
*
|
|
* @return the name
|
|
*/
|
|
public String getName() {
|
|
<span class="fc" id="L37"> return name;</span>
|
|
}
|
|
|
|
/**
|
|
* The path of the workflow e.g. .github/workflows/blank.yaml
|
|
*
|
|
* @return the path
|
|
*/
|
|
public String getPath() {
|
|
<span class="fc" id="L46"> return path;</span>
|
|
}
|
|
|
|
/**
|
|
* The state of the workflow.
|
|
*
|
|
* @return the state
|
|
*/
|
|
public String getState() {
|
|
<span class="fc" id="L55"> return state;</span>
|
|
}
|
|
|
|
@Override
|
|
public URL getHtmlUrl() throws IOException {
|
|
<span class="fc" id="L60"> return GitHubClient.parseURL(htmlUrl);</span>
|
|
}
|
|
|
|
/**
|
|
* Repository to which the workflow belongs.
|
|
*
|
|
* @return the repository
|
|
*/
|
|
public GHRepository getRepository() {
|
|
<span class="fc" id="L69"> return owner;</span>
|
|
}
|
|
|
|
/**
|
|
* The badge URL, like https://github.com/octo-org/octo-repo/workflows/CI/badge.svg
|
|
*
|
|
* @return the badge url
|
|
*/
|
|
public URL getBadgeUrl() {
|
|
<span class="fc" id="L78"> return GitHubClient.parseURL(badgeUrl);</span>
|
|
}
|
|
|
|
/**
|
|
* Disable the workflow.
|
|
*
|
|
* @throws IOException
|
|
* the io exception
|
|
*/
|
|
public void disable() throws IOException {
|
|
<span class="fc" id="L88"> root.createRequest().method("PUT").withUrlPath(getApiRoute(), "disable").fetchHttpStatusCode();</span>
|
|
<span class="fc" id="L89"> }</span>
|
|
|
|
/**
|
|
* Enable the workflow.
|
|
*
|
|
* @throws IOException
|
|
* the io exception
|
|
*/
|
|
public void enable() throws IOException {
|
|
<span class="fc" id="L98"> root.createRequest().method("PUT").withUrlPath(getApiRoute(), "enable").fetchHttpStatusCode();</span>
|
|
<span class="fc" id="L99"> }</span>
|
|
|
|
/**
|
|
* Create a workflow dispatch event which triggers a manual workflow run.
|
|
*
|
|
* @param ref
|
|
* the git reference for the workflow. The reference can be a branch or tag name.
|
|
* @throws IOException
|
|
* the io exception
|
|
*/
|
|
public void dispatch(String ref) throws IOException {
|
|
<span class="fc" id="L110"> dispatch(ref, Collections.emptyMap());</span>
|
|
<span class="fc" id="L111"> }</span>
|
|
|
|
/**
|
|
* Create a workflow dispatch event which triggers a manual workflow run.
|
|
*
|
|
* @param ref
|
|
* the git reference for the workflow. The reference can be a branch or tag name.
|
|
* @param inputs
|
|
* input keys and values configured in the workflow file. The maximum number of properties is 10. Any
|
|
* default properties configured in the workflow file will be used when inputs are omitted.
|
|
* @throws IOException
|
|
* the io exception
|
|
*/
|
|
public void dispatch(String ref, Map<String, Object> inputs) throws IOException {
|
|
<span class="fc" id="L125"> Requester requester = root.createRequest()</span>
|
|
<span class="fc" id="L126"> .method("POST")</span>
|
|
<span class="fc" id="L127"> .withUrlPath(getApiRoute(), "dispatches")</span>
|
|
<span class="fc" id="L128"> .with("ref", ref);</span>
|
|
|
|
<span class="fc bfc" id="L130" title="All 2 branches covered."> if (!inputs.isEmpty()) {</span>
|
|
<span class="fc" id="L131"> requester.with("inputs", inputs);</span>
|
|
}
|
|
|
|
<span class="fc" id="L134"> requester.fetchHttpStatusCode();</span>
|
|
<span class="fc" id="L135"> }</span>
|
|
|
|
private String getApiRoute() {
|
|
<span class="pc bpc" id="L138" title="1 of 2 branches missed."> if (owner == null) {</span>
|
|
// Workflow runs returned from search to do not have an owner. Attempt to use url.
|
|
<span class="nc" id="L140"> final URL url = Objects.requireNonNull(getUrl(), "Missing instance URL!");</span>
|
|
<span class="nc" id="L141"> return StringUtils.prependIfMissing(url.toString().replace(root.getApiUrl(), ""), "/");</span>
|
|
|
|
}
|
|
<span class="fc" id="L144"> return "/repos/" + owner.getOwnerName() + "/" + owner.getName() + "/actions/workflows/" + getId();</span>
|
|
}
|
|
|
|
GHWorkflow wrapUp(GHRepository owner) {
|
|
<span class="fc" id="L148"> this.owner = owner;</span>
|
|
<span class="fc" id="L149"> return wrapUp(owner.root);</span>
|
|
}
|
|
|
|
GHWorkflow wrapUp(GitHub root) {
|
|
<span class="fc" id="L153"> this.root = root;</span>
|
|
<span class="pc bpc" id="L154" title="1 of 2 branches missed."> if (owner != null)</span>
|
|
<span class="fc" id="L155"> owner.wrap(root);</span>
|
|
<span class="fc" id="L156"> return this;</span>
|
|
}
|
|
}
|
|
</pre><div class="footer"><span class="right">Created with <a href="http://www.jacoco.org/jacoco">JaCoCo</a> 0.8.7.202105040129</span></div></body></html> |