Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

github

package

Go to main page

Versions in this module

v1

v1.13.0

Sep 9, 2026

Changes in this version

type Client

+ func (c *Client) ListRunTimings(branch, event string, limit int) ([]RunTiming, error)

+ type RunTiming struct

+ Conclusion string

+ CreatedAt time.Time

+ HeadSHA string

+ ID int64

+ Name string

+ Status string

+ UpdatedAt time.Time

+ func (r RunTiming) IsComplete() bool

v1.12.0

Sep 3, 2026

v1.11.1

Sep 3, 2026

v1.11.0

Sep 2, 2026

v1.10.0

Sep 2, 2026

Changes in this version

type Client

+ func (c *Client) CancelRun(runID int64) error

+ func (c *Client) ListEnvironments() ([]string, error)

+ func (c *Client) RerunFailedJobs(runID int64) error

v1.9.0

Sep 1, 2026

Changes in this version

type Client

+ func (c *Client) PullRequestsInScope(scope PRScope) ([]PullRequest, error)

+ type PullRequest = forge.PullRequest

v1.8.0

Sep 1, 2026

v1.7.0

Sep 1, 2026

Changes in this version

type Client

+ func (c *Client) LatestRunsForPRs(scope PRScope, within time.Duration) ([]WorkflowRun, error)

+ type PRScope string

+ const PRScopeMine

+ const PRScopeReviewing

v1.6.0

Sep 1, 2026

Changes in this version

type Client

+ func (c *Client) LatestRunsOnBranch(branch string, within time.Duration) ([]WorkflowRun, error)

type WorkflowRun

+ Event string

+ Path string

v1.5.0

Sep 1, 2026

Changes in this version

type Job

+ CompletedAt time.Time

type Step

+ CompletedAt time.Time

+ StartedAt time.Time

v1.4.0

Sep 1, 2026

v1.3.1

Sep 1, 2026

v1.3.0

Sep 1, 2026

Changes in this version

type Client

+ func (c *Client) ListRuns(q RunQuery) ([]WorkflowRun, error)

+ type RunQuery struct

+ Branch string

+ Event string

+ Limit int

+ Status string

+ Workflow string

v1.2.2

Sep 1, 2026

v1.2.1

Sep 1, 2026

v1.2.0

Sep 1, 2026

v1.1.1

Aug 31, 2026

v1.1.0

Jul 30, 2026

v1.0.5

Jul 30, 2026

v1.0.4

Jul 26, 2026

v1.0.3

Jul 26, 2026

v1.0.2

Jul 5, 2026

v1.0.1

Jul 4, 2026

Changes in this version

+ var ErrInvalidRepositoryFormat = errors.New("invalid repository format (expected owner/repo)")

+ var ErrNoWorkflowRuns = errors.New("no workflow runs found")

v1.0.0

Jul 4, 2026

Changes in this version

+ const ConclusionCancelled

+ const ConclusionFailure

+ const ConclusionSkipped

+ const ConclusionSuccess

+ const StatusCompleted

+ const StatusInProgress

+ const StatusQueued

+ type Client struct

+ func NewClient(repoFullName string) (*Client, error)

+ func NewClientWithExecutor(repoFullName string, executor exec.CommandExecutor) (*Client, error)

+ func (c *Client) GetLatestRun(workflowName string) (*WorkflowRun, error)

+ func (c *Client) GetWorkflowRun(runID int64) (*WorkflowRun, error)

+ func (c *Client) GetWorkflowRunJobs(runID int64) ([]Job, error)

+ func (c *Client) Owner() string

+ func (c *Client) Repo() string

+ type Job struct

+ Conclusion string

+ ID int64

+ Name string

+ StartedAt time.Time

+ Status string

+ Steps []Step

+ type JobsResponse struct

+ Jobs []Job

+ TotalCount int

+ type RunsResponse struct

+ TotalCount int

+ WorkflowRuns []WorkflowRun

+ type Step struct

+ Conclusion string

+ Name string

+ Number int

+ Status string

+ type WorkflowRun struct

+ Conclusion string

+ CreatedAt time.Time

+ HTMLURL string

+ HeadBranch string

+ ID int64

+ Name string

+ Status string

+ UpdatedAt time.Time

+ func (r WorkflowRun) IsActive() bool

+ func (r WorkflowRun) IsSuccess() bool