View Source Dagger.Client (dagger v0.8.7)

Query

Link to this section Summary

Functions

Constructs a cache volume for a given cache key.

Checks if the current Dagger Engine is compatible with an SDK's required version.

Loads a container from ID.

The default platform of the builder.

Load a directory by ID. No argument produces an empty directory.

Loads a file by ID.

Queries a git repository.

Queries the host environment.

Returns a file containing an http remote url content.

Creates a named sub-pipeline.

Load a project from ID.

Load a project command from ID.

Loads a secret from its ID.

Sets a secret given a user defined name to its plaintext and returns the secret. The plaintext value is limited to a size of 128000 bytes.

Loads a socket by its ID.

Link to this section Types

@type t() :: %Dagger.Client{client: term(), selection: term()}

Link to this section Functions

Link to this function

cache_volume(query, key)

View Source
@spec cache_volume(t(), Dagger.String.t()) :: Dagger.CacheVolume.t()

Constructs a cache volume for a given cache key.

required-arguments

Required Arguments

  • key - A string identifier to target this cache volume (e.g., "modules-cache").
Link to this function

check_version_compatibility(query, version)

View Source
@spec check_version_compatibility(t(), Dagger.String.t()) ::
  {:ok, Dagger.Boolean.t()} | {:error, term()}

Checks if the current Dagger Engine is compatible with an SDK's required version.

required-arguments

Required Arguments

  • version - The SDK's required version.
Link to this function

container(query, optional_args \\ [])

View Source
@spec container(
  t(),
  keyword()
) :: Dagger.Container.t()

Loads a container from ID.

Null ID returns an empty container (scratch). Optional platform argument initializes new containers to execute and publish as that platform. Platform defaults to that of the builder's host.

optional-arguments

Optional Arguments

  • id -
  • platform -
@spec default_platform(t()) :: {:ok, Dagger.Platform.t()} | {:error, term()}

The default platform of the builder.

Link to this function

directory(query, optional_args \\ [])

View Source
@spec directory(
  t(),
  keyword()
) :: Dagger.Directory.t()

Load a directory by ID. No argument produces an empty directory.

optional-arguments

Optional Arguments

  • id -
@spec file(t(), Dagger.FileID.t()) :: {:ok, Dagger.File.t() | nil} | {:error, term()}

Loads a file by ID.

required-arguments

Required Arguments

  • id -
Link to this function

git(query, url, optional_args \\ [])

View Source

Queries a git repository.

required-arguments

Required Arguments

optional-arguments

Optional Arguments

  • keep_git_dir - Set to true to keep .git directory.
  • experimental_service_host - A service which must be started before the repo is fetched.
@spec host(t()) :: Dagger.Host.t()

Queries the host environment.

Link to this function

http(query, url, optional_args \\ [])

View Source
@spec http(t(), Dagger.String.t(), keyword()) :: Dagger.File.t()

Returns a file containing an http remote url content.

required-arguments

Required Arguments

optional-arguments

Optional Arguments

  • experimental_service_host - A service which must be started before the URL is fetched.
Link to this function

pipeline(query, name, optional_args \\ [])

View Source
@spec pipeline(t(), Dagger.String.t(), keyword()) :: t()

Creates a named sub-pipeline.

required-arguments

Required Arguments

  • name - Pipeline name.

optional-arguments

Optional Arguments

  • description - Pipeline description.
  • labels - Pipeline labels.
Link to this function

project(query, optional_args \\ [])

View Source
@spec project(
  t(),
  keyword()
) :: Dagger.Project.t()

Load a project from ID.

optional-arguments

Optional Arguments

  • id -
Link to this function

project_command(query, optional_args \\ [])

View Source
@spec project_command(
  t(),
  keyword()
) :: Dagger.ProjectCommand.t()

Load a project command from ID.

optional-arguments

Optional Arguments

  • id -
@spec secret(t(), Dagger.SecretID.t()) :: Dagger.Secret.t()

Loads a secret from its ID.

required-arguments

Required Arguments

  • id -
Link to this function

set_secret(query, name, plaintext)

View Source
@spec set_secret(t(), Dagger.String.t(), Dagger.String.t()) :: Dagger.Secret.t()

Sets a secret given a user defined name to its plaintext and returns the secret. The plaintext value is limited to a size of 128000 bytes.

required-arguments

Required Arguments

  • name - The user defined name for this secret
  • plaintext - The plaintext of the secret
Link to this function

socket(query, optional_args \\ [])

View Source
@spec socket(
  t(),
  keyword()
) :: Dagger.Socket.t()

Loads a socket by its ID.

optional-arguments

Optional Arguments

  • id -