// Copyright 2018 The Go Authors. All rights reserved. // Use of this source code is governed by a BSD-style // license that can be found in the LICENSE file. package lsp import ( "bytes" "context" "fmt" "go/ast" "go/token" "net/url" "regexp" "strconv" "strings" "sync" "golang.org/x/mod/modfile" "golang.org/x/tools/internal/event" "golang.org/x/tools/internal/lsp/debug/tag" "golang.org/x/tools/internal/lsp/protocol" "golang.org/x/tools/internal/lsp/source" "golang.org/x/tools/internal/span" ) func (s *Server) documentLink(ctx context.Context, params *protocol.DocumentLinkParams) (links []protocol.DocumentLink, err error) { snapshot, fh, ok, err := s.beginFileRequest(params.TextDocument.URI, source.UnknownKind) if !ok { return nil, err } switch fh.Identity().Kind { case source.Mod: links, err = modLinks(ctx, snapshot, fh) case source.Go: links, err = goLinks(ctx, snapshot.View(), fh) } // Don't return errors for document links. if err != nil { event.Error(ctx, "failed to compute document links", err, tag.URI.Of(fh.Identity().URI)) return nil, nil } return links, nil } func modLinks(ctx context.Context, snapshot source.Snapshot, fh source.FileHandle) ([]protocol.DocumentLink, error) { view := snapshot.View() file, m, err := snapshot.ModHandle(ctx, fh).Parse(ctx) if err != nil { return nil, err } var links []protocol.DocumentLink for _, req := range file.Require { dep := []byte(req.Mod.Path) s, e := req.Syntax.Start.Byte, req.Syntax.End.Byte i := bytes.Index(m.Content[s:e], dep) if i == -1 { continue } // Shift the start position to the location of the // dependency within the require statement. start, end := token.Pos(s+i), token.Pos(s+i+len(dep)) target := fmt.Sprintf("https://%s/mod/%s", view.Options().LinkTarget, req.Mod.String()) l, err := toProtocolLink(view, m, target, start, end, source.Mod) if err != nil { return nil, err } links = append(links, l) } // TODO(ridersofrohan): handle links for replace and exclude directives. if syntax := file.Syntax; syntax == nil { return links, nil } // Get all the links that are contained in the comments of the file. for _, expr := range file.Syntax.Stmt { comments := expr.Comment() if comments == nil { continue } for _, section := range [][]modfile.Comment{comments.Before, comments.Suffix, comments.After} { for _, comment := range section { l, err := findLinksInString(ctx, view, comment.Token, token.Pos(comment.Start.Byte), m, source.Mod) if err != nil { return nil, err } links = append(links, l...) } } } return links, nil } func goLinks(ctx context.Context, view source.View, fh source.FileHandle) ([]protocol.DocumentLink, error) { phs, err := view.Snapshot().PackageHandles(ctx, fh) if err != nil { return nil, err } ph, err := source.WidestPackageHandle(phs) if err != nil { return nil, err } file, _, m, _, err := view.Session().Cache().ParseGoHandle(fh, source.ParseFull).Parse(ctx) if err != nil { return nil, err } var imports []*ast.ImportSpec var str []*ast.BasicLit ast.Inspect(file, func(node ast.Node) bool { switch n := node.(type) { case *ast.ImportSpec: imports = append(imports, n) return false case *ast.BasicLit: // Look for links in string literals. if n.Kind == token.STRING { str = append(str, n) } return false } return true }) var links []protocol.DocumentLink for _, imp := range imports { // For import specs, provide a link to a documentation website, like https://pkg.go.dev. target, err := strconv.Unquote(imp.Path.Value) if err != nil { continue } if mod, version, ok := moduleAtVersion(ctx, target, ph); ok && strings.ToLower(view.Options().LinkTarget) == "pkg.go.dev" { target = strings.Replace(target, mod, mod+"@"+version, 1) } // Account for the quotation marks in the positions. start := imp.Path.Pos() + 1 end := imp.Path.End() - 1 target = fmt.Sprintf("https://%s/%s", view.Options().LinkTarget, target) l, err := toProtocolLink(view, m, target, start, end, source.Go) if err != nil { return nil, err } links = append(links, l) } for _, s := range str { l, err := findLinksInString(ctx, view, s.Value, s.Pos(), m, source.Go) if err != nil { return nil, err } links = append(links, l...) } for _, commentGroup := range file.Comments { for _, comment := range commentGroup.List { l, err := findLinksInString(ctx, view, comment.Text, comment.Pos(), m, source.Go) if err != nil { return nil, err } links = append(links, l...) } } return links, nil } func moduleAtVersion(ctx context.Context, target string, ph source.PackageHandle) (string, string, bool) { pkg, err := ph.Check(ctx) if err != nil { return "", "", false } impPkg, err := pkg.GetImport(target) if err != nil { return "", "", false } if impPkg.Module() == nil { return "", "", false } version, modpath := impPkg.Module().Version, impPkg.Module().Path if modpath == "" || version == "" { return "", "", false } return modpath, version, true } func findLinksInString(ctx context.Context, view source.View, src string, pos token.Pos, m *protocol.ColumnMapper, fileKind source.FileKind) ([]protocol.DocumentLink, error) { var links []protocol.DocumentLink for _, index := range view.Options().URLRegexp.FindAllIndex([]byte(src), -1) { start, end := index[0], index[1] startPos := token.Pos(int(pos) + start) endPos := token.Pos(int(pos) + end) link := src[start:end] linkURL, err := url.Parse(link) // Fallback: Linkify IP addresses as suggested in golang/go#18824. if err != nil { linkURL, err = url.Parse("//" + link) // Not all potential links will be valid, so don't return this error. if err != nil { continue } } // If the URL has no scheme, use https. if linkURL.Scheme == "" { linkURL.Scheme = "https" } l, err := toProtocolLink(view, m, linkURL.String(), startPos, endPos, fileKind) if err != nil { return nil, err } links = append(links, l) } // Handle golang/go#1234-style links. r := getIssueRegexp() for _, index := range r.FindAllIndex([]byte(src), -1) { start, end := index[0], index[1] startPos := token.Pos(int(pos) + start) endPos := token.Pos(int(pos) + end) matches := r.FindStringSubmatch(src) if len(matches) < 4 { continue } org, repo, number := matches[1], matches[2], matches[3] target := fmt.Sprintf("https://github.com/%s/%s/issues/%s", org, repo, number) l, err := toProtocolLink(view, m, target, startPos, endPos, fileKind) if err != nil { return nil, err } links = append(links, l) } return links, nil } func getIssueRegexp() *regexp.Regexp { once.Do(func() { issueRegexp = regexp.MustCompile(`(\w+)/([\w-]+)#([0-9]+)`) }) return issueRegexp } var ( once sync.Once issueRegexp *regexp.Regexp ) func toProtocolLink(view source.View, m *protocol.ColumnMapper, target string, start, end token.Pos, fileKind source.FileKind) (protocol.DocumentLink, error) { var rng protocol.Range switch fileKind { case source.Go: spn, err := span.NewRange(view.Session().Cache().FileSet(), start, end).Span() if err != nil { return protocol.DocumentLink{}, err } rng, err = m.Range(spn) if err != nil { return protocol.DocumentLink{}, err } case source.Mod: s, e := int(start), int(end) line, col, err := m.Converter.ToPosition(s) if err != nil { return protocol.DocumentLink{}, err } start := span.NewPoint(line, col, s) line, col, err = m.Converter.ToPosition(e) if err != nil { return protocol.DocumentLink{}, err } end := span.NewPoint(line, col, e) rng, err = m.Range(span.New(m.URI, start, end)) if err != nil { return protocol.DocumentLink{}, err } } return protocol.DocumentLink{ Range: rng, Target: target, }, nil }