refactor(lazyClientConn): Use synctest friendly once func

Author: MarcoPolo

Diff for: lazyClient.go

@@ -3,7 +3,6 @@ package multistream
 import (
 	"fmt"
 	"io"
-	"sync"
 )
 
 // NewMSSelect returns a new Multistream which is able to perform
@@ -12,6 +11,9 @@ func NewMSSelect[T StringLike](c io.ReadWriteCloser, proto T) LazyConn {
 	return &lazyClientConn[T]{
 		protos: []T{ProtocolID, proto},
 		con:    c,
+
+		rhandshakeOnce: newOnceFunc(),
+		whandshakeOnce: newOnceFunc(),
 	}
 }
 
@@ -25,6 +27,34 @@ func NewMultistream[T StringLike](c io.ReadWriteCloser, proto T) LazyConn {
 	}
 }
 
+// onceFunc is a sync.Once that can be used by synctest.
+// For the Multistream, it is a bit better than sync.Once because it doesn't
+// spin when acquiring the lock.
+type onceFunc struct {
+	sem chan struct{}
+}
+
+func newOnceFunc() *onceFunc {
+	o := onceFunc{
+		sem: make(chan struct{}, 1),
+	}
+	o.sem <- struct{}{}
+	return &o
+}
+
+func (o *onceFunc) Do(f func()) {
+	// We only ever pull a single value from the channel. But we want to block
+	// Do until the first call to Do has completed. The first call will close
+	// the channel, so by checking if it's closed we know we don't need to do
+	// anything.
+	_, ok := <-o.sem
+	if !ok {
+		return
+	}
+	defer close(o.sem)
+	f()
+}
+
 // lazyClientConn is a ReadWriteCloser adapter that lazily negotiates a protocol
 // using multistream-select on first use.
 //
@@ -33,11 +63,11 @@ func NewMultistream[T StringLike](c io.ReadWriteCloser, proto T) LazyConn {
 // See: https://github.com/multiformats/go-multistream/issues/20
 type lazyClientConn[T StringLike] struct {
 	// Used to ensure we only trigger the write half of the handshake once.
-	rhandshakeOnce sync.Once
+	rhandshakeOnce *onceFunc
 	rerr           error
 
 	// Used to ensure we only trigger the read half of the handshake once.
-	whandshakeOnce sync.Once
+	whandshakeOnce *onceFunc
 	werr           error
 
 	// The sequence of protocols to negotiate.

Diff for: multistream_test.go

@@ -9,6 +9,7 @@ import (
 	"net"
 	"sort"
 	"strings"
+	"sync"
 	"sync/atomic"
 	"testing"
 	"time"
@@ -938,3 +939,27 @@ func TestComparableErrors(t *testing.T) {
 		t.Fatalf("Should be read as ErrNotSupported")
 	}
 }
+
+func TestOnceFunc(t *testing.T) {
+	o := newOnceFunc()
+	start := make(chan struct{})
+	var runCount int
+	var wg sync.WaitGroup
+	const workers = 3
+	wg.Add(workers)
+	for range workers {
+		go func() {
+			defer wg.Done()
+			<-start
+			o.Do(func() { runCount++ })
+			if runCount != 1 {
+				t.Errorf("Do returned before func was run")
+			}
+		}()
+	}
+	close(start)
+	wg.Wait()
+	if runCount != 1 {
+		t.Fatalf("should have run only once")
+	}
+}