Method moduleSourceAsModule

core/schema/modulesource.go:2993–3190

(
	ctx context.Context,
	src dagql.ObjectResult[*core.ModuleSource],
	args struct {
		// This internal-only flag allows us to force SDK modules to enable default function
		// caching even when they are on older modules, which ensures they don't see a regression
		// right after function caching is enabled. It can be removed after SDKs have been updated
		// to latest engine versions.
		ForceDefaultFunctionCaching bool `internal:"true" default:"false"`

		// LegacyDefaultPath, when true, causes +defaultPath to resolve relative
		// to the workspace root instead of the module's own source directory.
		// Used for legacy toolchains loaded from dagger.json.
		LegacyDefaultPath bool `internal:"true" default:"false"`

		// LegacyArgCustomizationsJSON is a JSON-encoded []*modules.ModuleConfigArgument
		// carrying arg customizations from the workspace dagger.json.
		// Applied after type defs are populated so constructor arg metadata
		// (Ignore, DefaultPath, etc.) can be overridden before Install.
		LegacyArgCustomizationsJSON string `internal:"true" default:""`

		// LegacyNameOverride, when non-empty, overrides the module name.
		LegacyNameOverride string `internal:"true" default:""`

		// LegacyWorkspaceConfigJSON is a JSON-encoded map[string]any
		// carrying workspace config defaults from the workspace dagger.json.
		LegacyWorkspaceConfigJSON string `internal:"true" default:""`

		// LegacyDefaultsFromDotEnv, when true and workspace config is set,
		// also load .env defaults for args not found in WorkspaceConfig.
		LegacyDefaultsFromDotEnv bool `internal:"true" default:"false"`

		// DefaultPathContextSourceRef, when set, loads implementation code from
		// the receiver but resolves +defaultPath inputs from this source ref.
		DefaultPathContextSourceRef string `internal:"true" default:""`

		// DefaultPathContextSourcePin pins DefaultPathContextSourceRef when set.
		DefaultPathContextSourcePin string `internal:"true" default:""`
	},
)

	return inst.WithContentDigest(ctx, scopedDigest)
}
func (s *moduleSourceSchema) moduleSourceAsModule(
	ctx context.Context,
	src dagql.ObjectResult[*core.ModuleSource],
	args struct {
		// This internal-only flag allows us to force SDK modules to enable default function
		// caching even when they are on older modules, which ensures they don't see a regression
		// right after function caching is enabled. It can be removed after SDKs have been updated
		// to latest engine versions.
		ForceDefaultFunctionCaching bool `internal:"true" default:"false"`

		// LegacyDefaultPath, when true, causes +defaultPath to resolve relative
		// to the workspace root instead of the module's own source directory.
		// Used for legacy toolchains loaded from dagger.json.
		LegacyDefaultPath bool `internal:"true" default:"false"`

		// LegacyArgCustomizationsJSON is a JSON-encoded []*modules.ModuleConfigArgument
		// carrying arg customizations from the workspace dagger.json.
		// Applied after type defs are populated so constructor arg metadata
		// (Ignore, DefaultPath, etc.) can be overridden before Install.
		LegacyArgCustomizationsJSON string `internal:"true" default:""`

		// LegacyNameOverride, when non-empty, overrides the module name.
		LegacyNameOverride string `internal:"true" default:""`

		// LegacyWorkspaceConfigJSON is a JSON-encoded map[string]any
		// carrying workspace config defaults from the workspace dagger.json.
		LegacyWorkspaceConfigJSON string `internal:"true" default:""`

		// LegacyDefaultsFromDotEnv, when true and workspace config is set,
		// also load .env defaults for args not found in WorkspaceConfig.
		LegacyDefaultsFromDotEnv bool `internal:"true" default:"false"`

		// DefaultPathContextSourceRef, when set, loads implementation code from
		// the receiver but resolves +defaultPath inputs from this source ref.
		DefaultPathContextSourceRef string `internal:"true" default:""`

		// DefaultPathContextSourcePin pins DefaultPathContextSourceRef when set.
		DefaultPathContextSourcePin string `internal:"true" default:""`
	},
) (inst dagql.ObjectResult[*core.Module], err error) {
	dag, err := core.CurrentDagqlServer(ctx)
	if err != nil {
		return inst, fmt.Errorf("failed to get dag server: %w", err)
	}

	if src.Self().ModuleName == "" {
		return inst, fmt.Errorf("module name must be set")
	}

	// Check engine version compatibility
	engineVersion := src.Self().EngineVersion
	if !engine.CheckVersionCompatibility(engineVersion, engine.MinimumModuleVersion) {
		return inst, fmt.Errorf("module requires dagger %s, but support for that version has been removed", engineVersion)
	}
	if !engine.CheckMaxVersionCompatibility(engineVersion, engine.BaseVersion(engine.Version)) {
		return inst, fmt.Errorf("module requires dagger %s, but you have %s", engineVersion, engine.Version)
	}