detector

type Category string

type DeviceDetector interface {
	// Detect attempts to gather metadata for devices. Returns an error if the detection fails.
	Detect() (*Metadata, error)
}

type Extractor[T any] interface {
	Extract(ctx context.Context, process Process) (T, error)
}

type Metadata struct {
	// Categories can be one or more ordered Category entries that a detector matched. For example, a Tomcat detector
	// would match both JVM and Tomcat.
	Categories []Category `json:"categories"`
	// Name is the identifier of the resource.
	Name string `json:"name,omitempty"`
	// Attributes can be used to supply additional optional information.
	Attributes map[string]string `json:"attributes,omitempty"`
	// TelemetryPort is the port for the resource that exposes telemetry.
	TelemetryPort int `json:"telemetry_port,omitempty"`
	// Status is the current status of telemetry availability for the resource.
	Status Status `json:"status"`
}

type MetadataSlice []*Metadata

type NameExtractor = Extractor[string]

type NameFilter interface {
	ShouldInclude(name string) bool
}

type OpenFilesStat = process.OpenFilesStat

type PortExtractor = Extractor[int]

type Process interface {
	// PID returns the process ID.
	PID() int32
	// ExeWithContext returns the executable path of the process.
	ExeWithContext(ctx context.Context) (string, error)
	// CwdWithContext returns the current working directory of the process.
	CwdWithContext(ctx context.Context) (string, error)
	// CmdlineSliceWithContext returns the command line arguments of the process as a slice. Includes the executable
	// in the first entry.
	CmdlineSliceWithContext(ctx context.Context) ([]string, error)
	// EnvironWithContext returns the environment variables of the process. Each entry follows a <NAME>=<VALUE> pattern.
	EnvironWithContext(ctx context.Context) ([]string, error)
	// CreateTimeWithContext returns the creation time of the process in milliseconds.
	CreateTimeWithContext(ctx context.Context) (int64, error)
	// OpenFilesWithContext returns the open file descriptors of the process.
	OpenFilesWithContext(context.Context) ([]OpenFilesStat, error)
}

type ProcessDetector interface {
	// Detect attempts to gather metadata for a given process. Returns an error if the detection fails.
	Detect(ctx context.Context, process Process) (*Metadata, error)
}

type ProcessFilter interface {
	ShouldInclude(ctx context.Context, process Process) bool
}

type Status string