Dagger Python SDK

A client package for running Dagger pipelines.

Tip

New to Dagger? Learn how it works and start using it.

Reference

• Connection
  • connection()
  • Connection
  • Config
• Client
  • BuildArg
    • BuildArg.name
    • BuildArg.value
  • CacheSharingMode
    • CacheSharingMode.LOCKED
    • CacheSharingMode.PRIVATE
    • CacheSharingMode.SHARED
  • CacheVolume
    • CacheVolume.id()
  • CacheVolumeID
  • Client
    • Client.blob()
    • Client.builtin_container()
    • Client.cache_volume()
    • Client.container()
    • Client.current_function_call()
    • Client.current_module()
    • Client.current_type_defs()
    • Client.dagger_engine()
    • Client.default_platform()
    • Client.directory()
    • Client.function()
    • Client.generated_code()
    • Client.git()
    • Client.host()
    • Client.http()
    • Client.load_cache_volume_from_id()
    • Client.load_container_from_id()
    • Client.load_current_module_from_id()
    • Client.load_dagger_engine_cache_entry_from_id()
    • Client.load_dagger_engine_cache_entry_set_from_id()
    • Client.load_dagger_engine_cache_from_id()
    • Client.load_dagger_engine_from_id()
    • Client.load_directory_from_id()
    • Client.load_enum_type_def_from_id()
    • Client.load_enum_value_type_def_from_id()
    • Client.load_env_variable_from_id()
    • Client.load_field_type_def_from_id()
    • Client.load_file_from_id()
    • Client.load_function_arg_from_id()
    • Client.load_function_call_arg_value_from_id()
    • Client.load_function_call_from_id()
    • Client.load_function_from_id()
    • Client.load_generated_code_from_id()
    • Client.load_git_module_source_from_id()
    • Client.load_git_ref_from_id()
    • Client.load_git_repository_from_id()
    • Client.load_host_from_id()
    • Client.load_input_type_def_from_id()
    • Client.load_interface_type_def_from_id()
    • Client.load_label_from_id()
    • Client.load_list_type_def_from_id()
    • Client.load_local_module_source_from_id()
    • Client.load_module_dependency_from_id()
    • Client.load_module_from_id()
    • Client.load_module_source_from_id()
    • Client.load_module_source_view_from_id()
    • Client.load_object_type_def_from_id()
    • Client.load_port_from_id()
    • Client.load_scalar_type_def_from_id()
    • Client.load_secret_from_id()
    • Client.load_service_from_id()
    • Client.load_socket_from_id()
    • Client.load_terminal_from_id()
    • Client.load_type_def_from_id()
    • Client.module()
    • Client.module_dependency()
    • Client.module_source()
    • Client.pipeline()
    • Client.secret()
    • Client.set_secret()
    • Client.type_def()
    • Client.version()
    • Client.with_()
  • Container
    • Container.as_service()
    • Container.as_tarball()
    • Container.build()
    • Container.default_args()
    • Container.directory()
    • Container.entrypoint()
    • Container.env_variable()
    • Container.env_variables()
    • Container.experimental_with_all_gp_us()
    • Container.experimental_with_gpu()
    • Container.export()
    • Container.exposed_ports()
    • Container.file()
    • Container.from_()
    • Container.id()
    • Container.image_ref()
    • Container.import_()
    • Container.label()
    • Container.labels()
    • Container.mounts()
    • Container.pipeline()
    • Container.platform()
    • Container.publish()
    • Container.rootfs()
    • Container.stderr()
    • Container.stdout()
    • Container.sync()
    • Container.terminal()
    • Container.user()
    • Container.with_()
    • Container.with_default_args()
    • Container.with_default_terminal_cmd()
    • Container.with_directory()
    • Container.with_entrypoint()
    • Container.with_env_variable()
    • Container.with_exec()
    • Container.with_exposed_port()
    • Container.with_file()
    • Container.with_files()
    • Container.with_focus()
    • Container.with_label()
    • Container.with_mounted_cache()
    • Container.with_mounted_directory()
    • Container.with_mounted_file()
    • Container.with_mounted_secret()
    • Container.with_mounted_temp()
    • Container.with_new_file()
    • Container.with_registry_auth()
    • Container.with_rootfs()
    • Container.with_secret_variable()
    • Container.with_service_binding()
    • Container.with_unix_socket()
    • Container.with_user()
    • Container.with_workdir()
    • Container.without_default_args()
    • Container.without_directory()
    • Container.without_entrypoint()
    • Container.without_env_variable()
    • Container.without_exposed_port()
    • Container.without_file()
    • Container.without_focus()
    • Container.without_label()
    • Container.without_mount()
    • Container.without_registry_auth()
    • Container.without_secret_variable()
    • Container.without_unix_socket()
    • Container.without_user()
    • Container.without_workdir()
    • Container.workdir()
  • ContainerID
  • CurrentModule
    • CurrentModule.id()
    • CurrentModule.name()
    • CurrentModule.source()
    • CurrentModule.workdir()
    • CurrentModule.workdir_file()
  • CurrentModuleID
  • DaggerEngine
    • DaggerEngine.id()
    • DaggerEngine.local_cache()
  • DaggerEngineCache
    • DaggerEngineCache.entry_set()
    • DaggerEngineCache.id()
    • DaggerEngineCache.keep_bytes()
    • DaggerEngineCache.prune()
  • DaggerEngineCacheEntry
    • DaggerEngineCacheEntry.actively_used()
    • DaggerEngineCacheEntry.created_time_unix_nano()
    • DaggerEngineCacheEntry.description()
    • DaggerEngineCacheEntry.disk_space_bytes()
    • DaggerEngineCacheEntry.id()
    • DaggerEngineCacheEntry.most_recent_use_time_unix_nano()
  • DaggerEngineCacheEntryID
  • DaggerEngineCacheEntrySet
    • DaggerEngineCacheEntrySet.disk_space_bytes()
    • DaggerEngineCacheEntrySet.entries()
    • DaggerEngineCacheEntrySet.entry_count()
    • DaggerEngineCacheEntrySet.id()
  • DaggerEngineCacheEntrySetID
  • DaggerEngineCacheID
  • DaggerEngineID
  • Directory
    • Directory.as_module()
    • Directory.diff()
    • Directory.directory()
    • Directory.docker_build()
    • Directory.entries()
    • Directory.export()
    • Directory.file()
    • Directory.glob()
    • Directory.id()
    • Directory.pipeline()
    • Directory.sync()
    • Directory.terminal()
    • Directory.with_()
    • Directory.with_directory()
    • Directory.with_file()
    • Directory.with_files()
    • Directory.with_new_directory()
    • Directory.with_new_file()
    • Directory.with_timestamps()
    • Directory.without_directory()
    • Directory.without_file()
  • DirectoryID
  • EnumTypeDef
    • EnumTypeDef.description()
    • EnumTypeDef.id()
    • EnumTypeDef.name()
    • EnumTypeDef.source_module_name()
    • EnumTypeDef.values()
  • EnumTypeDefID
  • EnumValueTypeDef
    • EnumValueTypeDef.description()
    • EnumValueTypeDef.id()
    • EnumValueTypeDef.name()
  • EnumValueTypeDefID
  • EnvVariable
    • EnvVariable.id()
    • EnvVariable.name()
    • EnvVariable.value()
  • EnvVariableID
  • FieldTypeDef
    • FieldTypeDef.description()
    • FieldTypeDef.id()
    • FieldTypeDef.name()
    • FieldTypeDef.type_def()
  • FieldTypeDefID
  • File
    • File.contents()
    • File.digest()
    • File.export()
    • File.id()
    • File.name()
    • File.size()
    • File.sync()
    • File.with_()
    • File.with_name()
    • File.with_timestamps()
  • FileID
  • Function
    • Function.args()
    • Function.description()
    • Function.id()
    • Function.name()
    • Function.return_type()
    • Function.with_()
    • Function.with_arg()
    • Function.with_description()
  • FunctionArg
    • FunctionArg.default_path()
    • FunctionArg.default_value()
    • FunctionArg.description()
    • FunctionArg.id()
    • FunctionArg.ignore()
    • FunctionArg.name()
    • FunctionArg.type_def()
  • FunctionArgID
  • FunctionCall
    • FunctionCall.id()
    • FunctionCall.input_args()
    • FunctionCall.name()
    • FunctionCall.parent()
    • FunctionCall.parent_name()
    • FunctionCall.return_value()
  • FunctionCallArgValue
    • FunctionCallArgValue.id()
    • FunctionCallArgValue.name()
    • FunctionCallArgValue.value()
  • FunctionCallArgValueID
  • FunctionCallID
  • FunctionID
  • GeneratedCode
    • GeneratedCode.code()
    • GeneratedCode.id()
    • GeneratedCode.vcs_generated_paths()
    • GeneratedCode.vcs_ignored_paths()
    • GeneratedCode.with_()
    • GeneratedCode.with_vcs_generated_paths()
    • GeneratedCode.with_vcs_ignored_paths()
  • GeneratedCodeID
  • GitModuleSource
    • GitModuleSource.clone_ref()
    • GitModuleSource.clone_url()
    • GitModuleSource.commit()
    • GitModuleSource.context_directory()
    • GitModuleSource.html_repo_url()
    • GitModuleSource.html_url()
    • GitModuleSource.id()
    • GitModuleSource.root()
    • GitModuleSource.root_subpath()
    • GitModuleSource.version()
  • GitModuleSourceID
  • GitRef
    • GitRef.commit()
    • GitRef.id()
    • GitRef.tree()
  • GitRefID
  • GitRepository
    • GitRepository.branch()
    • GitRepository.commit()
    • GitRepository.head()
    • GitRepository.id()
    • GitRepository.ref()
    • GitRepository.tag()
    • GitRepository.tags()
    • GitRepository.with_()
    • GitRepository.with_auth_header()
    • GitRepository.with_auth_token()
  • GitRepositoryID
  • Host
    • Host.directory()
    • Host.file()
    • Host.id()
    • Host.service()
    • Host.set_secret_file()
    • Host.tunnel()
    • Host.unix_socket()
  • HostID
  • ImageLayerCompression
    • ImageLayerCompression.EStarGZ
    • ImageLayerCompression.Gzip
    • ImageLayerCompression.Uncompressed
    • ImageLayerCompression.Zstd
  • ImageMediaTypes
    • ImageMediaTypes.DockerMediaTypes
    • ImageMediaTypes.OCIMediaTypes
  • InputTypeDef
    • InputTypeDef.fields()
    • InputTypeDef.id()
    • InputTypeDef.name()
  • InputTypeDefID
  • InterfaceTypeDef
    • InterfaceTypeDef.description()
    • InterfaceTypeDef.functions()
    • InterfaceTypeDef.id()
    • InterfaceTypeDef.name()
    • InterfaceTypeDef.source_module_name()
  • InterfaceTypeDefID
  • JSON
  • Label
    • Label.id()
    • Label.name()
    • Label.value()
  • LabelID
  • ListTypeDef
    • ListTypeDef.element_type_def()
    • ListTypeDef.id()
  • ListTypeDefID
  • LocalModuleSource
    • LocalModuleSource.context_directory()
    • LocalModuleSource.id()
    • LocalModuleSource.rel_host_path()
    • LocalModuleSource.root_subpath()
  • LocalModuleSourceID
  • Module
    • Module.dependencies()
    • Module.dependency_config()
    • Module.description()
    • Module.enums()
    • Module.generated_context_diff()
    • Module.generated_context_directory()
    • Module.id()
    • Module.initialize()
    • Module.interfaces()
    • Module.name()
    • Module.objects()
    • Module.runtime()
    • Module.sdk()
    • Module.serve()
    • Module.source()
    • Module.with_()
    • Module.with_description()
    • Module.with_enum()
    • Module.with_interface()
    • Module.with_object()
    • Module.with_source()
  • ModuleDependency
    • ModuleDependency.id()
    • ModuleDependency.name()
    • ModuleDependency.source()
  • ModuleDependencyID
  • ModuleID
  • ModuleSource
    • ModuleSource.as_git_source()
    • ModuleSource.as_local_source()
    • ModuleSource.as_module()
    • ModuleSource.as_string()
    • ModuleSource.config_exists()
    • ModuleSource.context_directory()
    • ModuleSource.dependencies()
    • ModuleSource.directory()
    • ModuleSource.id()
    • ModuleSource.kind()
    • ModuleSource.module_name()
    • ModuleSource.module_original_name()
    • ModuleSource.resolve_context_path_from_caller()
    • ModuleSource.resolve_dependency()
    • ModuleSource.resolve_directory_from_caller()
    • ModuleSource.resolve_from_caller()
    • ModuleSource.source_root_subpath()
    • ModuleSource.source_subpath()
    • ModuleSource.view()
    • ModuleSource.views()
    • ModuleSource.with_()
    • ModuleSource.with_context_directory()
    • ModuleSource.with_dependencies()
    • ModuleSource.with_init()
    • ModuleSource.with_name()
    • ModuleSource.with_sdk()
    • ModuleSource.with_source_subpath()
    • ModuleSource.with_view()
  • ModuleSourceID
  • ModuleSourceKind
    • ModuleSourceKind.GIT_SOURCE
    • ModuleSourceKind.LOCAL_SOURCE
  • ModuleSourceView
    • ModuleSourceView.id()
    • ModuleSourceView.name()
    • ModuleSourceView.patterns()
  • ModuleSourceViewID
  • NetworkProtocol
    • NetworkProtocol.TCP
    • NetworkProtocol.UDP
  • ObjectTypeDef
    • ObjectTypeDef.constructor()
    • ObjectTypeDef.description()
    • ObjectTypeDef.fields()
    • ObjectTypeDef.functions()
    • ObjectTypeDef.id()
    • ObjectTypeDef.name()
    • ObjectTypeDef.source_module_name()
  • ObjectTypeDefID
  • PipelineLabel
    • PipelineLabel.name
    • PipelineLabel.value
  • Platform
  • Port
    • Port.description()
    • Port.experimental_skip_healthcheck()
    • Port.id()
    • Port.port()
    • Port.protocol()
  • PortForward
    • PortForward.backend
    • PortForward.frontend
    • PortForward.protocol
  • PortID
  • ScalarTypeDef
    • ScalarTypeDef.description()
    • ScalarTypeDef.id()
    • ScalarTypeDef.name()
    • ScalarTypeDef.source_module_name()
  • ScalarTypeDefID
  • Secret
    • Secret.id()
    • Secret.name()
    • Secret.plaintext()
  • SecretID
  • Service
    • Service.endpoint()
    • Service.hostname()
    • Service.id()
    • Service.ports()
    • Service.start()
    • Service.stop()
    • Service.up()
  • ServiceID
  • Socket
    • Socket.id()
  • SocketID
  • Terminal
    • Terminal.id()
    • Terminal.sync()
  • TerminalID
  • TypeDef
    • TypeDef.as_enum()
    • TypeDef.as_input()
    • TypeDef.as_interface()
    • TypeDef.as_list()
    • TypeDef.as_object()
    • TypeDef.as_scalar()
    • TypeDef.id()
    • TypeDef.kind()
    • TypeDef.optional()
    • TypeDef.with_()
    • TypeDef.with_constructor()
    • TypeDef.with_enum()
    • TypeDef.with_enum_value()
    • TypeDef.with_field()
    • TypeDef.with_function()
    • TypeDef.with_interface()
    • TypeDef.with_kind()
    • TypeDef.with_list_of()
    • TypeDef.with_object()
    • TypeDef.with_optional()
    • TypeDef.with_scalar()
  • TypeDefID
  • TypeDefKind
    • TypeDefKind.BOOLEAN_KIND
    • TypeDefKind.ENUM_KIND
    • TypeDefKind.INPUT_KIND
    • TypeDefKind.INTEGER_KIND
    • TypeDefKind.INTERFACE_KIND
    • TypeDefKind.LIST_KIND
    • TypeDefKind.OBJECT_KIND
    • TypeDefKind.SCALAR_KIND
    • TypeDefKind.STRING_KIND
    • TypeDefKind.VOID_KIND
  • Void
• Exceptions
  • DaggerError
  • Client execution
    • QueryError
      • QueryError.debug_query()
    • ExecError
      • ExecError.command
      • ExecError.message
      • ExecError.exit_code
      • ExecError.stdout
      • ExecError.stderr
      • ExecError.__str__()
  • Client connection
    • ClientError
    • ClientConnectionError
    • TransportError
    • ExecuteTimeoutError
    • InvalidQueryError
  • Engine provisioning
    • ProvisionError
    • DownloadError
    • SessionError
  • Warnings
    • VersionMismatch
• Module
  • object_type()
  • field()
  • function()
  • enum_type()
  • DefaultPath
  • Ignore
  • Enum
  • Name
  • Doc

Project links

• PyPI Project

• Conda Package

• Documentation

• Source code

• Release Notes

Indices and tables

• Index

• Module Index

• Search Page