Added unit tests, documentation and function descriptions across the board. Increased cyclop complexity threshold to 15 which is a bit more sane than 10 and excluded _test.go files from linters.

internal/mock/findATender/store.go

@@ -34,6 +34,10 @@ type Store struct {
 	openPos map[string]int
 }
 
+// OpenStore loads the releases stored at path, creating the file and its
+// directory if needed, and opens it for appending. Lines that can't be read
+// are skipped, releases are put back in date order if needed, and a record
+// left incomplete by a crash is ended so new ones start on a fresh line.
 func OpenStore(path string) (*Store, error) {
 	s := &Store{latest: map[string]int{}, lastNum: map[int]int{}, openPos: map[string]int{}}
 	if err := os.MkdirAll(filepath.Dir(path), 0o750); err != nil {
@@ -115,6 +119,9 @@ func openForAppend(path string) (*os.File, error) {
 	return f, nil
 }
 
+// index records release r, at position i, in the lookups: the ocid's latest
+// release, whether its procedure is still open (an award closes it), and the
+// highest notice number used each year.
 func (s *Store) index(i int, r ocds.Release) {
 	s.latest[r.OCID] = i
 	if len(r.Tag) > 0 && r.Tag[0] == "award" {
@@ -132,6 +139,7 @@ func (s *Store) index(i int, r ocds.Release) {
 	}
 }
 
+// closeProcedure removes ocid from the open procedures, if it is there.
 func (s *Store) closeProcedure(ocid string) {
 	pos, ok := s.openPos[ocid]
 	if !ok {
@@ -151,6 +159,7 @@ func (s *Store) Append(r ocds.Release) error { return s.append(r, true) }
 // Used for bulk catch-up, where a sync per record would be very slow.
 func (s *Store) AppendNoSync(r ocds.Release) error { return s.append(r, false) }
 
+// Sync flushes appended releases to disk. Call it after AppendNoSync.
 func (s *Store) Sync() error {
 	s.mu.Lock()
 	defer s.mu.Unlock()
@@ -204,6 +213,8 @@ func (s *Store) Page(from, upper time.Time, start, limit int) ([]ocds.Release, i
 	return out, i, more
 }
 
+// Last returns the date of the newest release, or false if the store is
+// empty.
 func (s *Store) Last() (time.Time, bool) {
 	s.mu.RLock()
 	defer s.mu.RUnlock()