xrefs

Documentation

Overview

Package xrefs defines the xrefs Service interface and some useful utility functions.

Index

• func AllEdges(ctx context.Context, es EdgesService, req *xpb.EdgesRequest) (*xpb.EdgesReply, error)
• func ConvertFilters(filters []string) []*regexp.Regexp
• func CrossReferences(ctx context.Context, xs NodesEdgesService, req *xpb.CrossReferencesRequest) (*xpb.CrossReferencesReply, error)
• func EdgesMap(edges []*xpb.EdgeSet) map[string]map[string][]string
• func MatchesAny(str string, patterns []*regexp.Regexp) bool
• func NodesMap(nodes []*xpb.NodeInfo) map[string]map[string][]byte
• func RegisterHTTPHandlers(ctx context.Context, xs Service, mux *http.ServeMux)
• type CrossReferencesService
• type DecorationsService
• type EdgesService
• type NodesEdgesService
• type NodesService
• type Normalizer
  • func NewNormalizer(text []byte) *Normalizer
  • func (n *Normalizer) ByteOffset(offset int32) *xpb.Location_Point
  • func (n *Normalizer) Location(loc *xpb.Location) (*xpb.Location, error)
  • func (n *Normalizer) Point(p *xpb.Location_Point) *xpb.Location_Point
• type Patcher
  • func NewPatcher(oldText, newText []byte) *Patcher
  • func (p *Patcher) Patch(spanStart, spanEnd int32) (newStart, newEnd int32, exists bool)
• type Service
  • func GRPC(c xpb.XRefServiceClient) Service
  • func WebClient(addr string) Service

Functions

func AllEdges

func AllEdges(ctx context.Context, es EdgesService, req *xpb.EdgesRequest) (*xpb.EdgesReply, error)

AllEdges returns all edges for a particular EdgesRequest. This means that the returned reply will not have a next page token. WARNING: the paging API exists for a reason; using this can lead to very large memory consumption depending on the request.

func ConvertFilters

func ConvertFilters(filters []string) []*regexp.Regexp

ConvertFilters converts each filter glob into an equivalent regexp.

func CrossReferences

func CrossReferences(ctx context.Context, xs NodesEdgesService, req *xpb.CrossReferencesRequest) (*xpb.CrossReferencesReply, error)

CrossReferences returns the cross-references for the given tickets using the given NodesEdgesService.

func EdgesMap

func EdgesMap(edges []*xpb.EdgeSet) map[string]map[string][]string

EdgesMap returns a map from each node ticket to a map of its outward edge kinds.

func MatchesAny

func MatchesAny(str string, patterns []*regexp.Regexp) bool

MatchesAny reports whether if str matches any of the patterns

func NodesMap

func NodesMap(nodes []*xpb.NodeInfo) map[string]map[string][]byte

NodesMap returns a map from each node ticket to a map of its facts.

func RegisterHTTPHandlers

func RegisterHTTPHandlers(ctx context.Context, xs Service, mux *http.ServeMux)

RegisterHTTPHandlers registers JSON HTTP handlers with mux using the given xrefs Service. The following methods with be exposed:

GET /nodes
  Request: JSON encoded xrefs.NodesRequest
  Response: JSON encoded xrefs.NodesResponse
GET /edges
  Request: JSON encoded xrefs.EdgesRequest
  Response: JSON encoded xrefs.EdgesResponse
GET /decorations
  Request: JSON encoded xrefs.DecorationsRequest
  Response: JSON encoded xrefs.DecorationsResponse
GET /xrefs
  Request: JSON encoded xrefs.CrossReferencesRequest
  Response: JSON encoded xrefs.CrossReferencesResponse

Note: /nodes, /edges, /decorations, and /xrefs will return their responses as serialized protobufs if the "proto" query parameter is set.

Types

type CrossReferencesService

type CrossReferencesService interface {
	// CrossReferences returns the global references of the given nodes.
	CrossReferences(context.Context, *xpb.CrossReferencesRequest) (*xpb.CrossReferencesReply, error)
}

CrossReferencesService provides fast access to cross-references in a Kythe graph.

type DecorationsService

type DecorationsService interface {
	// Decorations returns an index of the nodes and edges associated with a
	// particular file node.
	Decorations(context.Context, *xpb.DecorationsRequest) (*xpb.DecorationsReply, error)
}

DecorationsService provides fast access to file decorations in a Kythe graph.

type EdgesService

type EdgesService interface {
	// Edges returns a subset of the outbound edges for each of a set of requested
	// nodes.
	Edges(context.Context, *xpb.EdgesRequest) (*xpb.EdgesReply, error)
}

EdgesService provides fast access to edges in a Kythe graph.

type NodesEdgesService

type NodesEdgesService interface {
	NodesService
	EdgesService
}

NodesEdgesService provides fast access to nodes and edges in a Kythe graph.

type NodesService

type NodesService interface {
	// Nodes returns a subset of the facts for each of the requested nodes.
	Nodes(context.Context, *xpb.NodesRequest) (*xpb.NodesReply, error)
}

NodesService provides fast access to nodes in a Kythe graph.

type Normalizer

type Normalizer struct {
	// contains filtered or unexported fields
}

Normalizer fixes xref.Locations within a given source text so that each point has consistent byte_offset, line_number, and column_offset fields within the range of text's length and its line lengths.

func NewNormalizer

func NewNormalizer(text []byte) *Normalizer

NewNormalizer returns a Normalizer for Locations within text.

func (*Normalizer) ByteOffset

func (n *Normalizer) ByteOffset(offset int32) *xpb.Location_Point

ByteOffset returns a normalized point based on the given offset within the Normalizer's text. A normalized point has all of its fields set consistently and clamped within the range [0,len(text)).

func (*Normalizer) Location

func (n *Normalizer) Location(loc *xpb.Location) (*xpb.Location, error)

Location returns a normalized location within the Normalizer's text. Normalized FILE locations have no start/end points. Normalized SPAN locations have fully populated start/end points clamped in the range [0, len(text)).

func (*Normalizer) Point

func (n *Normalizer) Point(p *xpb.Location_Point) *xpb.Location_Point

Point returns a normalized point within the Normalizer's text. A normalized point has all of its fields set consistently and clamped within the range [0,len(text)).

type Patcher

type Patcher struct {
	// contains filtered or unexported fields
}

Patcher uses a computed diff between two texts to map spans from the original text to the new text.

func NewPatcher

func NewPatcher(oldText, newText []byte) *Patcher

NewPatcher returns a Patcher based on the diff between oldText and newText.

func (*Patcher) Patch

func (p *Patcher) Patch(spanStart, spanEnd int32) (newStart, newEnd int32, exists bool)

Patch returns the resulting span of mapping the given span from the Patcher's constructed oldText to its newText. If the span no longer exists in newText or is invalid, the returned bool will be false. As a convenience, if p==nil, the original span will be returned.

type Service

type Service interface {
	NodesEdgesService
	DecorationsService
	CrossReferencesService
}

Service provides access to a Kythe graph for fast access to cross-references.

func GRPC

func GRPC(c xpb.XRefServiceClient) Service

GRPC returns an xrefs Service backed by the given GRPC client and context.

func WebClient

func WebClient(addr string) Service

WebClient returns an xrefs Service based on a remote web server.