tenet

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

type BaseFile interface {
	// contains filtered or unexported methods
}

type BaseReview interface {

	// Starts the review. This should be called in a goroutine before sending
	// files to the review.
	StartReview()

	// Closes a review
	Close()

	// Send files to a review.
	SendFile(*api.File)

	// Call this when you've finished sending all the files to review.
	EndReview()

	// File currently being reviewed.
	File() File

	// A chan of issues found in the review.
	Issues() chan *Issue

	// TODO(waigani) move this Tenet interface as it is useful for tenet authors.
	// A temporary working directory that the review can use.
	TMPDIR() (dirpath string, err error)
	// contains filtered or unexported methods
}

type BaseTenet interface {
	Init()
	NewReview() *review
	Info() *Info
	MixinConfigOptions(opts []*api.Option) error
	SendError(error)
	Errors() chan error
	// contains filtered or unexported methods
}

type CommentContext int

type File interface {

	// Returns the source code a line i.
	Line(i int) []byte

	// Returns all source code for this file.
	Lines() [][]byte

	// Returns the ast.File node of this file.
	AST() *ast.File

	// The name of the file currently being reviewed.
	Filename() string

	// Returns the FileSet this file is a member of.
	Fset() *token.FileSet
}

type Info struct {
	Name        string
	Usage       string
	Description string
	Language    string
	SearchTags  []string

	Options []*option
	Version string
	// contains filtered or unexported fields
}

type Issue struct {
	Name      string                 // Name is the the name of the checker that added the issue
	Position  *issueRange            // position in source file
	Comment   string                 // The rendered comment for this issue.
	CommVars  map[string]interface{} // key/value pairs for use in comment template variables e.g. {{.somevarname}}
	CtxBefore string                 // source lines before the problem line(s)
	LineText  string                 // the source line(s)
	CtxAfter  string                 // source lines after the problem line(s)
	Link      string                 // (optional) the link to the style guide for the problem
	NewCode   bool                   // When checking a diff, this indicates if the issue was found in existing or new code.
	Err       error                  // Any err encounted while building the issue.
	Metrics   map[string]interface{} // Any metrics that this issue was raised with
	Tags      []string               // Any tags this issue was raised with.

	// TODO(matt, waigani) Implement this. Possibly use github.com/waigani/diffparser and github.com/waigani/astnode.
	// The idea is:
	// - issue.DiffFix() returns a diff patch to fix the issue.
	// - run Lingo with --fix. If issue.CanFix, Lingo prompts the user to keep/discard the patch.
	// - Lingo assembles patchs into one diff and, depending on flags, either applies the patch or just saves the diff to file.
	Patch string // A diff patch resolving the issue.
	// contains filtered or unexported fields
}

type RaiseIssueOption func(*Issue)

type RegisterIssueOption func(*Issue)

type Review interface {

	// RaiseLineIssue sends the named issue (issueName) to lingo, along with
	// the start and end lines of the issue and metadata from opts.
	RaiseLineIssue(issueName string, start, end int, opts ...RaiseIssueOption) Review

	// RaiseNodeIssue sends the named issue (issueName) to lingo, along with metadata from n and opts.
	RaiseNodeIssue(issueName string, n ast.Node, opts ...RaiseIssueOption) Review

	// File is the current file being reviewed.
	File() File

	// The current smell will no longer be called at all.
	SmellDone()

	// The current smell will no longer be called for the current file.
	SmellDoneWithFile()

	// The current file will not be smelt by this tenet again. This should
	// only be used if it is not logical to keep looking. If you just want to
	// limit the number of times an issue is raised, use comment contexts. e.g.
	// tenet.FirstFile
	FileDone()
}

type Tenet interface {

	// Returns information on the tenet.
	Info() *Info

	// Sets information about the tenet used by the lingo client.
	SetInfo(Info) Tenet

	// Register a metric which can be added to a raised issue.
	RegisterMetric(key string) func(interface{}) RaiseIssueOption

	// Register a tag which can be added to a raised issue
	RegisterTag(tag string) RaiseIssueOption

	// Registers an issue that this tenet can raise. The string returned is
	// the the name of the issue which is used as the first argument to
	// Review.RaiseNodeIssue or Review.RaiseLineIssue
	RegisterIssue(issueName string, opts ...RegisterIssueOption) string

	// Returns the value of the option.
	RegisterOption(name, value, usage string) *string

	// SmellNode will smell every node that matches the type in smellNodeFunc.
	SmellNode(f smellNodeFunc) Tenet

	// SmellLine will smell every line of every file.
	SmellLine(f smellLineFunc) Tenet
}