clerk @ 42ed6f19392789706708b1171eb08e16905f6b8e

package linter

import (

	"olexsmir.xyz/clerk/journal/ast"

	"olexsmir.xyz/clerk/journal/token"

)

// A Find represents a single lint finding.

type Find struct {

	Code     RuleID

	Severity Severity

	Message  string

	Span     token.Span

}

// Linter runs lint rules against a parsed journal.

type Linter struct {

	rules []Rule

}

// NewLinter creates a [Linter] with the given rules.

func NewLinter(rules []Rule) *Linter {

	return &Linter{rules: rules}

}

// Run runs all rules against the journal.

func (l *Linter) Run(j *ast.Journal) []Find {

	var finds []Find

	// single traversal

	for _, entry := range j.Entries {

		for _, rule := range l.rules {

			if ec, ok := rule.(EntryChecker); ok {

				finds = append(finds, ec.CheckEntry(entry)...)

			}

		}

	}

	// post-traversal

	for _, rule := range l.rules {

		if jc, ok := rule.(JournalChecker); ok {

			finds = append(finds, jc.CheckJournal(j)...)

		}

	}

	return finds

}

// Severity represents severity of the litning find.

type Severity int

const (

	SeverityError   Severity = 1

	SeverityWarning Severity = 2

	SeverityInfo    Severity = 3

	SeverityHint    Severity = 4

)

func (s Severity) String() string {

	switch s {

	case SeverityError:

		return "error"

	case SeverityWarning:

		return "warning"

	case SeverityInfo:

		return "info"

	case SeverityHint:

		return "hint"

	}

	panic("impossible severity state")

}