miller/pkg/input/record_reader_yaml.go
John Kerl 91eaff1341
Lint round 5+6: staticcheck and errcheck to zero (#2130)
* refine the plan

* Fix all staticcheck lint findings (uncapped)

golangci-lint's default max-same-issues=3 was hiding most of the backlog:
the true pre-fix count was 69 staticcheck findings, not 34. This fixes all
of them, driving staticcheck to zero:

- ST1023/QF1011 (37): omit explicit types inferred from the RHS
- S1009/S1031 (15): drop redundant nil checks before len()/range
- SA9003 (9): remove comment-only empty branches, keeping the comments
- QF1007 (3): merge conditional assignment into declaration
- QF1006 (3): lift break conditions into loop conditions
- QF1001 (3): apply De Morgan's law / name the negated predicate

Also updates plans/lintfixes.md with the cap discovery and the corrected
errcheck picture (1202 uncapped, ~949 of them fmt.Fprint*).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* Drive errcheck to zero: config for bulk categories, propagate real errors

Adds .golangci.yml with errcheck exclude-functions for fmt.Fprint* (usage
printers), (*bufio.Writer).Write/WriteString (sticky errors, surfaced at the
now-checked final Flush), and (*strings.Builder).WriteString; pins
max-issues-per-linter/max-same-issues to 0 so CI reports true counts.

Real error paths now propagate instead of being dropped:
- Finalize{Reader,Writer}Options in join/put/filter/split/tee and the
  repl/script entry points: 'mlr join -i badformat' now errors instead of
  silently using wrong separators
- final output-stream Flush in pkg/stream: write failure no longer exits 0
- DSL emit/print/dump redirect writes, matching their sibling branches
- CSV writer WriteCSVRecordMaybeColorized, close-time Flush in file output
  handlers, ENV[...] Setenv, REPL record-write and redirect-close errors
- termcvt write-side Close before rename (had "TODO: check return status")

The rest are deliberate ignores, marked with _ = and a comment where the
reason isn't obvious: unset-of-missing-path no-ops, read-side closes,
mid-stream FlushOnEveryRecord, init-time strftime registrations, in-memory
usage-capture pipes, and regtest-harness env/temp-file teardown.

golangci-lint now reports 0 issues on ./cmd/mlr ./pkg/... with all caps off.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
2026-07-03 11:42:08 -04:00

153 lines
3.8 KiB
Go

package input
import (
"fmt"
"io"
"gopkg.in/yaml.v3"
"github.com/johnkerl/miller/v6/pkg/cli"
"github.com/johnkerl/miller/v6/pkg/lib"
"github.com/johnkerl/miller/v6/pkg/mlrval"
"github.com/johnkerl/miller/v6/pkg/types"
)
type RecordReaderYAML struct {
readerOptions *cli.TReaderOptions
recordsPerBatch int64
}
func NewRecordReaderYAML(
readerOptions *cli.TReaderOptions,
recordsPerBatch int64,
) (*RecordReaderYAML, error) {
return &RecordReaderYAML{
readerOptions: readerOptions,
recordsPerBatch: recordsPerBatch,
}, nil
}
func (reader *RecordReaderYAML) Read(
filenames []string,
context types.Context,
readerChannel chan<- []*types.RecordAndContext,
errorChannel chan error,
downstreamDoneChannel <-chan bool,
) {
if filenames != nil {
if len(filenames) == 0 {
handle, err := lib.OpenStdin(
reader.readerOptions.Prepipe,
reader.readerOptions.PrepipeIsRaw,
reader.readerOptions.FileInputEncoding,
)
if err != nil {
errorChannel <- err
} else {
reader.processHandle(handle, "(stdin)", &context, readerChannel, errorChannel, downstreamDoneChannel)
}
} else {
for _, filename := range filenames {
handle, err := lib.OpenFileForRead(
filename,
reader.readerOptions.Prepipe,
reader.readerOptions.PrepipeIsRaw,
reader.readerOptions.FileInputEncoding,
)
if err != nil {
errorChannel <- err
} else {
reader.processHandle(handle, filename, &context, readerChannel, errorChannel, downstreamDoneChannel)
_ = handle.Close()
}
}
}
}
readerChannel <- types.NewEndOfStreamMarkerList(&context)
}
func (reader *RecordReaderYAML) processHandle(
handle io.Reader,
filename string,
context *types.Context,
readerChannel chan<- []*types.RecordAndContext,
errorChannel chan error,
downstreamDoneChannel <-chan bool,
) {
context.UpdateForStartOfFile(filename)
recordsPerBatch := reader.recordsPerBatch
decoder := yaml.NewDecoder(handle)
recordsAndContexts := make([]*types.RecordAndContext, 0, recordsPerBatch)
i := int64(0)
for {
i++
if i%recordsPerBatch == 0 {
select {
case <-downstreamDoneChannel:
goto flush
default:
}
}
mlrval, eof, err := mlrval.MlrvalDecodeFromYAML(decoder)
if eof {
break
}
if err != nil {
errorChannel <- err
return
}
if mlrval.IsMap() {
record := mlrval.GetMap()
if record == nil {
errorChannel <- fmt.Errorf("internal coding error in YAML record-reader")
return
}
context.UpdateForInputRecord()
recordsAndContexts = append(recordsAndContexts, types.NewRecordAndContext(record, context))
if int64(len(recordsAndContexts)) >= recordsPerBatch {
readerChannel <- recordsAndContexts
recordsAndContexts = make([]*types.RecordAndContext, 0, recordsPerBatch)
}
} else if mlrval.IsArray() {
records := mlrval.GetArray()
if records == nil {
errorChannel <- fmt.Errorf("internal coding error in YAML record-reader")
return
}
for _, mv := range records {
if !mv.IsMap() {
errorChannel <- fmt.Errorf(
"valid but unmillerable YAML: expected map (object); got %s",
mv.GetTypeName(),
)
return
}
record := mv.GetMap()
if record == nil {
errorChannel <- fmt.Errorf("internal coding error in YAML record-reader")
return
}
context.UpdateForInputRecord()
recordsAndContexts = append(recordsAndContexts, types.NewRecordAndContext(record, context))
if int64(len(recordsAndContexts)) >= recordsPerBatch {
readerChannel <- recordsAndContexts
recordsAndContexts = make([]*types.RecordAndContext, 0, recordsPerBatch)
}
}
} else {
errorChannel <- fmt.Errorf(
"valid but unmillerable YAML: expected map (object); got %s",
mlrval.GetTypeName(),
)
return
}
}
flush:
if len(recordsAndContexts) > 0 {
readerChannel <- recordsAndContexts
}
}