Dagger
Search

wait-github-dagger-checks

This module has been generated via dagger init and serves as a reference to
basic module structure as you get started with Dagger.

Two functions have been pre-created. You can modify, delete, or add to them,
as needed. They demonstrate usage of arguments and return types using simple
echo and grep commands. The functions can be called from the dagger CLI or
from one of the SDKs.

The first line in this comment block is a short description line and the
rest is a long description with more detail on the module's purpose or usage,
if appropriate. All modules should have a short description.

Installation

dagger install github.com/typesafe-ai/daggerverse/wait-github-dagger-checks@360af19d67eafedf92edf337551b7e86f15ee86d

Entrypoint

Return Type
WaitGithubDaggerChecks !
Example
dagger -m github.com/typesafe-ai/daggerverse/wait-github-dagger-checks@360af19d67eafedf92edf337551b7e86f15ee86d call \
func (m *MyModule) Example() *dagger.WaitGithubDaggerChecks  {
	return dag.
			WaitGithubDaggerChecks()
}
@function
def example() -> dagger.WaitGithubDaggerChecks:
	return (
		dag.wait_github_dagger_checks()
	)
@func()
example(): WaitGithubDaggerChecks {
	return dag
		.waitGithubDaggerChecks()
}

Types

WaitGithubDaggerChecks 🔗

wait() 🔗

Wait until every expected check has a successful GitHub commit status on ref.

When checks is None, the expected set is enumerated via dag.current_workspace().checks(). When checks is provided, those names are used verbatim and auto-discovery is skipped. An empty checks list returns immediately.

Return Type
String !
Arguments
NameTypeDefault ValueDescription
repoString !-GitHub repo as 'owner/name'
refString !-Commit SHA to poll
tokenSecret !-GitHub token with read access
checks[String ! ] nullAn optional explicit list of check names to wait for.
pollIntervalInteger !3Seconds between GitHub polls
progressIntervalInteger !30Seconds between routine progress lines (terminal transitions are still printed live).
timeoutInteger !1800Total wall-clock budget, seconds
discoveryTimeoutInteger !300How long expected statuses may take to first appear, seconds
failFastBoolean !falseIf True, raise as soon as any check fails. If False (default), wait for every check to reach a terminal state and then raise at the end if any failed.
Example
dagger -m github.com/typesafe-ai/daggerverse/wait-github-dagger-checks@360af19d67eafedf92edf337551b7e86f15ee86d call \
 wait --repo string --ref string --token env:MYSECRET --poll-interval integer --progress-interval integer --timeout integer --discovery-timeout integer --fail-fast boolean
func (m *MyModule) Example(ctx context.Context, repo string, ref string, token *dagger.Secret, pollInterval int, progressInterval int, timeout int, discoveryTimeout int, failFast bool) string  {
	return dag.
			WaitGithubDaggerChecks().
			Wait(ctx, repo, ref, token, pollInterval, progressInterval, timeout, discoveryTimeout, failFast)
}
@function
async def example(repo: str, ref: str, token: dagger.Secret, poll_interval: int, progress_interval: int, timeout: int, discovery_timeout: int, fail_fast: bool) -> str:
	return await (
		dag.wait_github_dagger_checks()
		.wait(repo, ref, token, poll_interval, progress_interval, timeout, discovery_timeout, fail_fast)
	)
@func()
async example(repo: string, ref: string, token: Secret, pollInterval: number, progressInterval: number, timeout: number, discoveryTimeout: number, failFast: boolean): Promise<string> {
	return dag
		.waitGithubDaggerChecks()
		.wait(repo, ref, token, pollInterval, progressInterval, timeout, discoveryTimeout, failFast)
}