Class: Client
The root of the DAG.
Extends
BaseClient
Constructors
new Client()
new Client(
parent
?,_defaultPlatform
?,_version
?):Client
Constructor is used for internal usage only, do not create object from it.
Parameters
• parent?
• parent.ctx?: Context
• parent.queryTree?: QueryTree
[]
• _defaultPlatform?: Platform
• _version?: string
Returns
Overrides
BaseClient.constructor
Methods
blob()
blob(
digest
,size
,mediaType
,uncompressed
):Directory
Retrieves a content-addressed blob.
Parameters
• digest: string
Digest of the blob
• size: number
Size of the blob
• mediaType: string
Media type of the blob
• uncompressed: string
Digest of the uncompressed blob
Returns
builtinContainer()
builtinContainer(
digest
):Container
Retrieves a container builtin to the engine.
Parameters
• digest: string
Digest of the image manifest
Returns
cacheVolume()
cacheVolume(
key
):CacheVolume
Constructs a cache volume for a given cache key.
Parameters
• key: string
A string identifier to target this cache volume (e.g., "modules-cache").
Returns
container()
container(
opts
?):Container
Creates a scratch container.
Optional platform argument initializes new containers to execute and publish as that platform. Platform defaults to that of the builder's host.
Parameters
• opts?: ClientContainerOpts
Returns
currentFunctionCall()
currentFunctionCall():
FunctionCall
The FunctionCall context that the SDK caller is currently executing in.
If the caller is not currently executing in a function, this will return an error.
Returns
currentModule()
currentModule():
CurrentModule
The module currently being served in the session, if any.
Returns
currentTypeDefs()
currentTypeDefs():
Promise
<TypeDef
[]>
The TypeDef representations of the objects currently being served in the session.
Returns
Promise
<TypeDef
[]>
daggerEngine()
daggerEngine():
DaggerEngine
The Dagger engine container configuration and state
Returns
defaultPlatform()
defaultPlatform():
Promise
<Platform
>
The default platform of the engine.
Returns
Promise
<Platform
>
directory()
directory():
Directory
Creates an empty directory.
Returns
function_()
function_(
name
,returnType
):Function_
Creates a function.
Parameters
• name: string
Name of the function, in its original format from the implementation language.
• returnType: TypeDef
Return type of the function.
Returns
generatedCode()
generatedCode(
code
):GeneratedCode
Create a code generation result, given a directory containing the generated code.
Parameters
• code: Directory
Returns
getGQLClient()
getGQLClient():
GraphQLClient
Get the Raw GraphQL client.
Returns
GraphQLClient
git()
git(
url
,opts
?):GitRepository
Queries a Git repository.
Parameters
• url: string
URL of the git repository.
Can be formatted as https://{host}/{owner}/{repo}
, git@{host}:{owner}/{repo}
.
Suffix ".git" is optional.
• opts?: ClientGitOpts
Returns
host()
host():
Host
Queries the host environment.
Returns
http()
http(
url
,opts
?):File
Returns a file containing an http remote url content.
Parameters
• url: string
HTTP url to get the content from (e.g., "https://docs.dagger.io").
• opts?: ClientHttpOpts
Returns
loadCacheVolumeFromID()
loadCacheVolumeFromID(
id
):CacheVolume
Load a CacheVolume from its ID.
Parameters
• id: CacheVolumeID
Returns
loadContainerFromID()
loadContainerFromID(
id
):Container
Load a Container from its ID.
Parameters
• id: ContainerID
Returns
loadCurrentModuleFromID()
loadCurrentModuleFromID(
id
):CurrentModule
Load a CurrentModule from its ID.
Parameters
• id: CurrentModuleID
Returns
loadDaggerEngineCacheEntryFromID()
loadDaggerEngineCacheEntryFromID(
id
):DaggerEngineCacheEntry
Load a DaggerEngineCacheEntry from its ID.
Parameters
• id: DaggerEngineCacheEntryID
Returns
loadDaggerEngineCacheEntrySetFromID()
loadDaggerEngineCacheEntrySetFromID(
id
):DaggerEngineCacheEntrySet
Load a DaggerEngineCacheEntrySet from its ID.
Parameters
• id: DaggerEngineCacheEntrySetID
Returns
loadDaggerEngineCacheFromID()
loadDaggerEngineCacheFromID(
id
):DaggerEngineCache
Load a DaggerEngineCache from its ID.
Parameters
• id: DaggerEngineCacheID
Returns
loadDaggerEngineFromID()
loadDaggerEngineFromID(
id
):DaggerEngine
Load a DaggerEngine from its ID.
Parameters
• id: DaggerEngineID
Returns
loadDirectoryFromID()
loadDirectoryFromID(
id
):Directory
Load a Directory from its ID.
Parameters
• id: DirectoryID
Returns
loadEnumTypeDefFromID()
loadEnumTypeDefFromID(
id
):EnumTypeDef
Load a EnumTypeDef from its ID.
Parameters
• id: EnumTypeDefID
Returns
loadEnumValueTypeDefFromID()
loadEnumValueTypeDefFromID(
id
):EnumValueTypeDef
Load a EnumValueTypeDef from its ID.
Parameters
• id: EnumValueTypeDefID
Returns
loadEnvVariableFromID()
loadEnvVariableFromID(
id
):EnvVariable
Load a EnvVariable from its ID.
Parameters
• id: EnvVariableID
Returns
loadFieldTypeDefFromID()
loadFieldTypeDefFromID(
id
):FieldTypeDef
Load a FieldTypeDef from its ID.
Parameters
• id: FieldTypeDefID
Returns
loadFileFromID()
loadFileFromID(
id
):File
Load a File from its ID.
Parameters
• id: FileID
Returns
loadFunctionArgFromID()
loadFunctionArgFromID(
id
):FunctionArg
Load a FunctionArg from its ID.
Parameters
• id: FunctionArgID
Returns
loadFunctionCallArgValueFromID()
loadFunctionCallArgValueFromID(
id
):FunctionCallArgValue
Load a FunctionCallArgValue from its ID.
Parameters
• id: FunctionCallArgValueID
Returns
loadFunctionCallFromID()
loadFunctionCallFromID(
id
):FunctionCall
Load a FunctionCall from its ID.
Parameters
• id: FunctionCallID
Returns
loadFunctionFromID()
loadFunctionFromID(
id
):Function_
Load a Function from its ID.
Parameters
• id: FunctionID
Returns
loadGeneratedCodeFromID()
loadGeneratedCodeFromID(
id
):GeneratedCode
Load a GeneratedCode from its ID.
Parameters
• id: GeneratedCodeID
Returns
loadGitModuleSourceFromID()
loadGitModuleSourceFromID(
id
):GitModuleSource
Load a GitModuleSource from its ID.
Parameters
• id: GitModuleSourceID
Returns
loadGitRefFromID()
loadGitRefFromID(
id
):GitRef
Load a GitRef from its ID.
Parameters
• id: GitRefID
Returns
loadGitRepositoryFromID()
loadGitRepositoryFromID(
id
):GitRepository
Load a GitRepository from its ID.
Parameters
• id: GitRepositoryID
Returns
loadHostFromID()
loadHostFromID(
id
):Host
Load a Host from its ID.
Parameters
• id: HostID
Returns
loadInputTypeDefFromID()
loadInputTypeDefFromID(
id
):InputTypeDef
Load a InputTypeDef from its ID.
Parameters
• id: InputTypeDefID
Returns
loadInterfaceTypeDefFromID()
loadInterfaceTypeDefFromID(
id
):InterfaceTypeDef
Load a InterfaceTypeDef from its ID.
Parameters
• id: InterfaceTypeDefID
Returns
loadLabelFromID()
loadLabelFromID(
id
):Label
Load a Label from its ID.
Parameters
• id: LabelID
Returns
loadListTypeDefFromID()
loadListTypeDefFromID(
id
):ListTypeDef
Load a ListTypeDef from its ID.
Parameters
• id: ListTypeDefID
Returns
loadLocalModuleSourceFromID()
loadLocalModuleSourceFromID(
id
):LocalModuleSource
Load a LocalModuleSource from its ID.
Parameters
• id: LocalModuleSourceID
Returns
loadModuleDependencyFromID()
loadModuleDependencyFromID(
id
):ModuleDependency
Load a ModuleDependency from its ID.
Parameters
• id: ModuleDependencyID
Returns
loadModuleFromID()
loadModuleFromID(
id
):Module_
Load a Module from its ID.
Parameters
• id: ModuleID
Returns
loadModuleSourceFromID()
loadModuleSourceFromID(
id
):ModuleSource
Load a ModuleSource from its ID.