Method SDKForModule

core/sdk/loader.go:41–81

SDKForModule loads an SDK module based on the given SDK configuration. If it's a builtin SDK, it will load it from the engine container. Otherwise, it will load it from the given source either from a URL or from a local path.

(
	ctx context.Context,
	query *core.Query,
	sdk *core.SDKConfig,
	parentSrc *core.ModuleSource,
)

// Otherwise, it will load it from the given source either from a URL
// or from a local path.
func (l *Loader) SDKForModule(
	ctx context.Context,
	query *core.Query,
	sdk *core.SDKConfig,
	parentSrc *core.ModuleSource,
) (_ core.SDK, rerr error) {
	if sdk == nil {
		return nil, errMissingSDKRef
	}

	ctx, span := core.Tracer(ctx).Start(ctx, fmt.Sprintf("load SDK: %s", sdk.Source))
	defer telemetry.EndWithCause(span, &rerr)

	builtinSDK, builtinErr := l.namedSDK(ctx, query, sdk)
	if builtinErr == nil {
		return builtinSDK, nil
	} else if !errors.Is(builtinErr, errUnknownBuiltinSDK) {
		return nil, builtinErr
	}

	extSDK, extErr := l.externalSDKForModule(ctx, query, sdk, parentSrc)
	if extErr == nil {
		return extSDK, nil
	}

	stdio := telemetry.SpanStdio(ctx, "dagger.io/core/sdk")
	fmt.Fprintf(stdio.Stderr, "Could not load SDK %q.\n", sdk.Source)
	fmt.Fprintln(stdio.Stderr)
	fmt.Fprintln(stdio.Stderr, "Errors:")
	fmt.Fprintln(stdio.Stderr, "-", builtinErr)
	fmt.Fprintln(stdio.Stderr, "-", extErr)
	fmt.Fprintln(stdio.Stderr)
	fmt.Fprintln(stdio.Stderr, "The available SDKs are:")
	for _, sdk := range validInbuiltSDKs {
		fmt.Fprintln(stdio.Stderr, "-", sdk)
	}
	fmt.Fprintln(stdio.Stderr, "- any git module ref, e.g. github.com/dagger/dagger/sdk/elixir@main")
	fmt.Fprintln(stdio.Stderr, "- any local module path, e.g. ./my-sdk")

	return nil, fmt.Errorf("invalid SDK: %q", sdk.Source)
}

// Load an SDK module from an external source (not builtin to the engine).
//