httplink

Documentation

Index

• func ExtractURLPaths(text string) []string
• type HTTPCallSite
• type HTTPLink
• type HTTPLinkerConfig
• type Linker
  • func New(s *store.Store, project string) *Linker
  • func (l *Linker) AddCallSites(sites []HTTPCallSite)
  • func (l *Linker) Run() ([]HTTPLink, error)
  • func (l *Linker) SetConfig(cfg *LinkerConfig)
• type LinkerConfig
  • func DefaultConfig() *LinkerConfig
  • func LoadConfig(dir string) *LinkerConfig
  • func (c *LinkerConfig) AllExcludePaths() []string
  • func (c *LinkerConfig) EffectiveFuzzyMatching() bool
  • func (c *LinkerConfig) EffectiveMinConfidence() float64
• type RouteHandler

Functions

func ExtractURLPaths

func ExtractURLPaths(text string) []string

ExtractURLPaths finds URL path segments from text (exported for use by pipeline).

Types

type HTTPCallSite

type HTTPCallSite struct {
	Path                string
	Method              string // best-effort: "GET", "POST", etc. or "" if unknown
	SourceName          string
	SourceQualifiedName string
	SourceLabel         string // "Function", "Method", or "Module"
	IsAsync             bool   // true when source uses async dispatch keywords
}

HTTPCallSite represents a discovered HTTP call site.

type HTTPLink

type HTTPLink struct {
	CallerQN    string
	CallerLabel string
	HandlerQN   string
	URLPath     string
	EdgeType    string // "HTTP_CALLS" or "ASYNC_CALLS"
}

HTTPLink represents a matched HTTP call from caller to handler.

type HTTPLinkerConfig

type HTTPLinkerConfig struct {
	// ExcludePaths are route paths to exclude from HTTP_CALLS matching.
	// These are added to (not replacing) the built-in defaultExcludePaths.
	ExcludePaths []string `yaml:"exclude_paths"`

	// MinConfidence is the minimum confidence score for creating HTTP_CALLS edges.
	// Default: 0.25 (includes speculative matches).
	MinConfidence *float64 `yaml:"min_confidence"`

	// FuzzyMatching enables/disables fuzzy URL matching.
	// Default: true.
	FuzzyMatching *bool `yaml:"fuzzy_matching"`
}

HTTPLinkerConfig holds HTTP linker-specific settings.

type Linker

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

Linker discovers cross-service HTTP calls and creates HTTP_CALLS edges.

func New

func New(s *store.Store, project string) *Linker

New creates a new HTTP Linker.

func (*Linker) AddCallSites

func (l *Linker) AddCallSites(sites []HTTPCallSite)

AddCallSites allows the pipeline to inject additional call sites from infra files.

func (*Linker) Run

func (l *Linker) Run() ([]HTTPLink, error)

Run executes the HTTP linking pass.

func (*Linker) SetConfig

func (l *Linker) SetConfig(cfg *LinkerConfig)

SetConfig sets the linker configuration. If cfg is nil, defaults are used.

type LinkerConfig

type LinkerConfig struct {
	HTTPLinker HTTPLinkerConfig `yaml:"http_linker"`
}

LinkerConfig holds user-overridable HTTP linker settings. Loaded from .cgrconfig in the project root.

func DefaultConfig

func DefaultConfig() *LinkerConfig

DefaultConfig returns the default linker configuration.

func LoadConfig

func LoadConfig(dir string) *LinkerConfig

LoadConfig reads .cgrconfig from the given directory. Returns default config if the file doesn't exist.

func (*LinkerConfig) AllExcludePaths

func (c *LinkerConfig) AllExcludePaths() []string

AllExcludePaths returns the combined list of default + user-configured exclude paths.

func (*LinkerConfig) EffectiveFuzzyMatching

func (c *LinkerConfig) EffectiveFuzzyMatching() bool

EffectiveFuzzyMatching returns the configured fuzzy matching setting, or the default (true) if not set.

func (*LinkerConfig) EffectiveMinConfidence

func (c *LinkerConfig) EffectiveMinConfidence() float64

EffectiveMinConfidence returns the configured minimum confidence, or the default (0.25) if not set.

type RouteHandler

type RouteHandler struct {
	Path              string
	Method            string
	FunctionName      string
	QualifiedName     string
	HandlerRef        string // resolved handler function reference (e.g. "h.CreateOrder")
	ResolvedHandlerQN string // set by createRegistrationCallEdges — actual handler QN
	Protocol          string // "ws", "sse", or "" (standard HTTP)
}

RouteHandler represents a discovered HTTP route handler.