github.com/google/go-github/v50@v50.2.0/github/actions_workflow_jobs.go (about)

     1  // Copyright 2020 The go-github AUTHORS. All rights reserved.
     2  //
     3  // Use of this source code is governed by a BSD-style
     4  // license that can be found in the LICENSE file.
     5  
     6  package github
     7  
     8  import (
     9  	"context"
    10  	"fmt"
    11  	"net/http"
    12  	"net/url"
    13  )
    14  
    15  // TaskStep represents a single task step from a sequence of tasks of a job.
    16  type TaskStep struct {
    17  	Name        *string    `json:"name,omitempty"`
    18  	Status      *string    `json:"status,omitempty"`
    19  	Conclusion  *string    `json:"conclusion,omitempty"`
    20  	Number      *int64     `json:"number,omitempty"`
    21  	StartedAt   *Timestamp `json:"started_at,omitempty"`
    22  	CompletedAt *Timestamp `json:"completed_at,omitempty"`
    23  }
    24  
    25  // WorkflowJob represents a repository action workflow job.
    26  type WorkflowJob struct {
    27  	ID          *int64      `json:"id,omitempty"`
    28  	RunID       *int64      `json:"run_id,omitempty"`
    29  	RunURL      *string     `json:"run_url,omitempty"`
    30  	NodeID      *string     `json:"node_id,omitempty"`
    31  	HeadSHA     *string     `json:"head_sha,omitempty"`
    32  	URL         *string     `json:"url,omitempty"`
    33  	HTMLURL     *string     `json:"html_url,omitempty"`
    34  	Status      *string     `json:"status,omitempty"`
    35  	Conclusion  *string     `json:"conclusion,omitempty"`
    36  	CreatedAt   *Timestamp  `json:"created_at,omitempty"`
    37  	StartedAt   *Timestamp  `json:"started_at,omitempty"`
    38  	CompletedAt *Timestamp  `json:"completed_at,omitempty"`
    39  	Name        *string     `json:"name,omitempty"`
    40  	Steps       []*TaskStep `json:"steps,omitempty"`
    41  	CheckRunURL *string     `json:"check_run_url,omitempty"`
    42  	// Labels represents runner labels from the `runs-on:` key from a GitHub Actions workflow.
    43  	Labels          []string `json:"labels,omitempty"`
    44  	RunnerID        *int64   `json:"runner_id,omitempty"`
    45  	RunnerName      *string  `json:"runner_name,omitempty"`
    46  	RunnerGroupID   *int64   `json:"runner_group_id,omitempty"`
    47  	RunnerGroupName *string  `json:"runner_group_name,omitempty"`
    48  	RunAttempt      *int64   `json:"run_attempt,omitempty"`
    49  	WorkflowName    *string  `json:"workflow_name,omitempty"`
    50  }
    51  
    52  // Jobs represents a slice of repository action workflow job.
    53  type Jobs struct {
    54  	TotalCount *int           `json:"total_count,omitempty"`
    55  	Jobs       []*WorkflowJob `json:"jobs,omitempty"`
    56  }
    57  
    58  // ListWorkflowJobsOptions specifies optional parameters to ListWorkflowJobs.
    59  type ListWorkflowJobsOptions struct {
    60  	// Filter specifies how jobs should be filtered by their completed_at timestamp.
    61  	// Possible values are:
    62  	//     latest - Returns jobs from the most recent execution of the workflow run
    63  	//     all - Returns all jobs for a workflow run, including from old executions of the workflow run
    64  	//
    65  	// Default value is "latest".
    66  	Filter string `url:"filter,omitempty"`
    67  	ListOptions
    68  }
    69  
    70  // ListWorkflowJobs lists all jobs for a workflow run.
    71  //
    72  // GitHub API docs: https://docs.github.com/en/rest/actions/workflow-jobs#list-jobs-for-a-workflow-run
    73  func (s *ActionsService) ListWorkflowJobs(ctx context.Context, owner, repo string, runID int64, opts *ListWorkflowJobsOptions) (*Jobs, *Response, error) {
    74  	u := fmt.Sprintf("repos/%s/%s/actions/runs/%v/jobs", owner, repo, runID)
    75  	u, err := addOptions(u, opts)
    76  	if err != nil {
    77  		return nil, nil, err
    78  	}
    79  
    80  	req, err := s.client.NewRequest("GET", u, nil)
    81  	if err != nil {
    82  		return nil, nil, err
    83  	}
    84  
    85  	jobs := new(Jobs)
    86  	resp, err := s.client.Do(ctx, req, &jobs)
    87  	if err != nil {
    88  		return nil, resp, err
    89  	}
    90  
    91  	return jobs, resp, nil
    92  }
    93  
    94  // GetWorkflowJobByID gets a specific job in a workflow run by ID.
    95  //
    96  // GitHub API docs: https://docs.github.com/en/rest/actions/workflow-jobs#get-a-job-for-a-workflow-run
    97  func (s *ActionsService) GetWorkflowJobByID(ctx context.Context, owner, repo string, jobID int64) (*WorkflowJob, *Response, error) {
    98  	u := fmt.Sprintf("repos/%v/%v/actions/jobs/%v", owner, repo, jobID)
    99  
   100  	req, err := s.client.NewRequest("GET", u, nil)
   101  	if err != nil {
   102  		return nil, nil, err
   103  	}
   104  
   105  	job := new(WorkflowJob)
   106  	resp, err := s.client.Do(ctx, req, job)
   107  	if err != nil {
   108  		return nil, resp, err
   109  	}
   110  
   111  	return job, resp, nil
   112  }
   113  
   114  // GetWorkflowJobLogs gets a redirect URL to download a plain text file of logs for a workflow job.
   115  //
   116  // GitHub API docs: https://docs.github.com/en/rest/actions/workflow-jobs#download-job-logs-for-a-workflow-run
   117  func (s *ActionsService) GetWorkflowJobLogs(ctx context.Context, owner, repo string, jobID int64, followRedirects bool) (*url.URL, *Response, error) {
   118  	u := fmt.Sprintf("repos/%v/%v/actions/jobs/%v/logs", owner, repo, jobID)
   119  
   120  	resp, err := s.client.roundTripWithOptionalFollowRedirect(ctx, u, followRedirects)
   121  	if err != nil {
   122  		return nil, nil, err
   123  	}
   124  	defer resp.Body.Close()
   125  
   126  	if resp.StatusCode != http.StatusFound {
   127  		return nil, newResponse(resp), fmt.Errorf("unexpected status code: %s", resp.Status)
   128  	}
   129  
   130  	parsedURL, err := url.Parse(resp.Header.Get("Location"))
   131  	return parsedURL, newResponse(resp), err
   132  }