Method parseModRef

cmd/dagger/shell_fs.go:275–317

parseModRef transforms user input into a full module reference that can be used with dag.ModuleSource().

(ctx context.Context, path string)

// parseModRef transforms user input into a full module reference that can be used with
// dag.ModuleSource().
func (h *shellCallHandler) parseModRef(ctx context.Context, path string) (rcfg *configuredModule, rerr error) {
	if h.Debug() {
		shellDebug(ctx, "parseModRef (before)", path)

		defer func() {
			shellDebug(ctx, "parseModRef (after)", path, rcfg)
		}()
	}

	h.mu.RLock()
	context := h.wd.Context
	h.mu.RUnlock()

	// If no module loaded, let API handle it
	if context == nil {
		return h.getModuleConfig(ctx, path)
	}

	// Let's see if it's a relative path within the current context first
	apath, err := h.contextAbsPath(path)
	if err != nil {
		return nil, err
	}
	ref := context.ModRef(apath)

	if _, ok := context.(localSourceContext); ok {
		// For local sources, there's no sense in requesting the API
		// if the resolved ref doesn't exist
		if _, err := os.Stat(ref); err != nil {
			ref = ""
		}
	}

	// best effort for use case of user providing a path within the current context
	if ref != "" {
		if cfg, _ := h.getModuleConfig(ctx, ref); cfg != nil {
			return cfg, nil
		}
	}

	// fallback to original path, which may be an absolute ref
	return h.getModuleConfig(ctx, path)
}

type configuredModule struct {
	Source  *dagger.ModuleSource