Method Reparse

runtime/parser/parser.go:254–287

Reparse re-parses the indicated file paths, updating the Parser's state. If rill.yaml has previously errored, or if rill.yaml is included in paths, it will reload the entire project. If a previous call to Reparse has returned an error, the Parser may not be accessed or called again.

(ctx context.Context, paths []string)

// If rill.yaml has previously errored, or if rill.yaml is included in paths, it will reload the entire project.
// If a previous call to Reparse has returned an error, the Parser may not be accessed or called again.
func (p *Parser) Reparse(ctx context.Context, paths []string) (*Diff, error) {
	var changedRillYAML bool
	for _, path := range paths {
		if !pathIsRillYAML(path) {
			continue
		}
		oldRillYAML := p.RillYAML
		err := p.parseRillYAML(ctx, path)
		if err == nil {
			// Watcher sends multiple events for a single edit. We want to only restart the controller when rill.yaml actually changes.
			// So we check the new rill.yaml contents against the contents stored in parser state.
			changedRillYAML = !reflect.DeepEqual(oldRillYAML, p.RillYAML)
		} else {
			// any error including parse error means rill.yaml changed
			changedRillYAML = true
		}
		break
	}

	if changedRillYAML {
		err := p.reload(ctx)
		if err != nil {
			return nil, err
		}
		return &Diff{Reloaded: true}, nil
	}

	// If rill.yaml previously errored, we're not going to reparse anything until it's changed, at which point we'll reload the entire project.
	if p.RillYAML == nil {
		return &Diff{Skipped: true}, nil
	}

	return p.reparseExceptRillYAML(ctx, paths)
}

// IsSkippable returns true if the path will be skipped by Reparse.
// It's useful for callers to avoid triggering a reparse when they know the path is not relevant.