grep-reader

A deny rule by default: it refuses a definition lookup with a context flag (grep -A40 'func X'), which uses grep to read the body, and names what to run instead.

What it catches

A definition lookup with a context flag (grep -A40 'func X'), which uses grep to read the body.

Why

A context count guesses at a declaration's length: too short cuts the body off and costs another call, too long spends lines on whatever follows. magus refs X --definition --source prints the declaration whole, numbered and checked against the index. Where the index cannot vouch for the name, the deny serves sed -n <first>,<last>p <file> instead, the declaration's own lines from a parse of the file the search reads (a named file or glob, or under a directory the files the index last saw name it). The single-file allowance symbol-search gives grep -n 'func X' f.go does not apply: with -A, -B or -C the search is the read. A deny resting on the index advises instead while the graph describes another tree, as graph-stale; one parsed from a named file does not. It fires only when every alternative is a definition lookup (func X, func (r *T) X, type X, type X struct) and a declaration of each name is found; a search for uses, a case-insensitive one, or one with any text alternative is left to the search rules. A pipe after it is named as not reproduced.

Default and override

By default this rule takes the decision deny. A workspace sets it by name, in its root magusfile, to deny, advise or off:

magus\guard.builtins({"grep-reader": "advise"})

A loosening takes effect once it is committed; a tightening applies at once.

Seeing it

A verdict names its rule in brackets, which is how you got here:

deny [grep-reader]: ...

A workspace that sets this rule to advise sees advise [grep-reader]: ... instead.

magus describe rule grep-reader prints the same entry at a terminal, and magus describe rules lists every rule this workspace enforces.

See also

• All rules - what this workspace enforces, deny first
• The guard - how a verdict is reached and wired
• Setting a built-in rule - how a workspace changes this default