separate test-client into its own mod file

test client is only intended for local development and testing, not as a
go-installable, so remove it from the main go.mod hierarchy to reduce
dependencies for upstream consumers.

bump go.mod to min go to 1.13 (GO111MODULE where defaulted to auto)

update to v6 for the min go version bump

Author: dropwhile

.gitignore

@@ -0,0 +1 @@
+/test-client/test-client

CHANGELOG.md

@@ -1,8 +1,12 @@
 Changelog
 =========
 
-## head
-*   update dependency
+## 6.0.0 2025-09-07
+*   move test-client to its own go.mod file, so as to trim dependencies
+    for upstream consumers. test-client is intended for local testing
+    and/or develment and not necesarily installable via go-install.
+*   bump go.mod go version to 1.13, the version which GO111MODULE defaults to
+    auto.
 
 ## 5.1.0 2023-07-19
 *   Fix for tag format in substatter. (GH-55)

README.md

@@ -22,7 +22,7 @@ Some examples:
 import (
     "log"
 
-    "github.com/cactus/go-statsd-client/v5/statsd"
+    "github.com/cactus/go-statsd-client/v6/statsd"
 )
 
 func main() {
@@ -109,7 +109,7 @@ or interrupt existing integrations.
 import (
     "log"
 
-    "github.com/cactus/go-statsd-client/v5/statsd"
+    "github.com/cactus/go-statsd-client/v6/statsd"
 )
 
 func main() {

go.mod

@@ -1,8 +1,3 @@
-module github.com/cactus/go-statsd-client/v5
+module github.com/cactus/go-statsd-client/v6
 
-go 1.11
-
-require (
-	github.com/jessevdk/go-flags v1.6.1
-	golang.org/x/sys v0.30.0 // indirect
-)
+go 1.13

go.sum

@@ -1,7 +0,0 @@
-github.com/jessevdk/go-flags v1.6.1 h1:Cvu5U8UGrLay1rZfv/zP7iLpSHGUZ/Ou68T0iX1bBK4=
-github.com/jessevdk/go-flags v1.6.1/go.mod h1:Mk8T1hIAWpOiJiHa9rJASDK2UGWji0EuPGBnNLMooyc=
-golang.org/x/sys v0.21.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA=
-golang.org/x/sys v0.29.0 h1:TPYlXGxvx1MGTn2GiZDhnjPA9wZzZeGKHHmKhHYvgaU=
-golang.org/x/sys v0.29.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA=
-golang.org/x/sys v0.30.0 h1:QjkSwP/36a20jFYWkSue1YwXzLmsV5Gfq7Eiy72C1uc=
-golang.org/x/sys v0.30.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA=

statsd/statsdtest/recorder_test.go

@@ -7,7 +7,7 @@ import (
 	"testing"
 	"time"
 
-	"github.com/cactus/go-statsd-client/v5/statsd"
+	"github.com/cactus/go-statsd-client/v6/statsd"
 )
 
 func TestRecordingSenderIsSender(t *testing.T) {

test-client/go.mod

@@ -0,0 +1,9 @@
+module github.com/cactus/go-statsd-client/test-client/v6
+
+go 1.20
+
+require github.com/alecthomas/kong v1.12.1
+
+require github.com/cactus/go-statsd-client/v6 v6.0.0
+
+replace github.com/cactus/go-statsd-client/v6 => ../

test-client/go.sum

@@ -0,0 +1,5 @@
+github.com/alecthomas/assert/v2 v2.11.0 h1:2Q9r3ki8+JYXvGsDyBXwH3LcJ+WK5D0gc5E8vS6K3D0=
+github.com/alecthomas/kong v1.12.1 h1:iq6aMJDcFYP9uFrLdsiZQ2ZMmcshduyGv4Pek0MQPW0=
+github.com/alecthomas/kong v1.12.1/go.mod h1:p2vqieVMeTAnaC83txKtXe8FLke2X07aruPWXyMPQrU=
+github.com/alecthomas/repr v0.4.0 h1:GhI2A8MACjfegCPVq9f1FLvIBS+DrQ2KQBFZP1iFzXc=
+github.com/hexops/gotextdiff v1.0.3 h1:gitA9+qJrrTCsiCl7+kh75nPqQt1cx4ZkudSTLoUqJM=

test-client/main.go

@@ -10,37 +10,31 @@ import (
 	"os"
 	"time"
 
-	"github.com/cactus/go-statsd-client/v5/statsd"
-	flags "github.com/jessevdk/go-flags"
+	"github.com/alecthomas/kong"
+	"github.com/cactus/go-statsd-client/v6/statsd"
 )
 
 func main() {
-
 	// command line flags
 	var opts struct {
-		HostPort  string        `long:"host" default:"127.0.0.1:8125" description:"host:port of statsd server"`
-		Prefix    string        `long:"prefix" default:"test-client" description:"Statsd prefix"`
-		StatType  string        `long:"type" default:"count" description:"stat type to send. Can be one of: timing, count, gauge"`
-		StatValue int64         `long:"value" default:"1" description:"Value to send"`
-		Name      string        `short:"n" long:"name" default:"counter" description:"stat name"`
-		Rate      float32       `short:"r" long:"rate" default:"1.0" description:"sample rate"`
-		Volume    int           `short:"c" long:"count" default:"1000" description:"Number of stats to send. Volume."`
-		Nil       bool          `long:"nil" description:"Use nil client"`
-		Buffered  bool          `long:"buffered" description:"Use a buffered client"`
-		Duration  time.Duration `short:"d" long:"duration" default:"10s" description:"How long to spread the volume across. For each second of duration, volume/seconds events will be sent."`
+		HostPort  string        `name:"host" default:"127.0.0.1:8125" help:"host:port of statsd server"`
+		Prefix    string        `name:"prefix" default:"test-client" help:"Statsd prefix"`
+		StatType  string        `name:"type" enum:"timing,count,gauge" default:"count" help:"stat type to send. Can be one of: timing, count, gauge"`
+		StatValue int64         `name:"value" default:"1" help:"Value to send"`
+		Name      string        `name:"name" short:"n" default:"counter" help:"stat name"`
+		Rate      float32       `name:"rate" short:"r" default:"1.0" help:"sample rate"`
+		Volume    int           `name:"count" short:"c" default:"1000" help:"Number of stats to send. Volume."`
+		Nil       bool          `name:"nil" help:"Use nil client"`
+		Buffered  bool          `name:"buffered" help:"Use a buffered client"`
+		Duration  time.Duration `name:"duration" short:"d" default:"10s" help:"How long to spread the volume across. For each second of duration, volume/seconds events will be sent."`
 	}
 
 	// parse said flags
-	_, err := flags.Parse(&opts)
-	if err != nil {
-		if e, ok := err.(*flags.Error); ok {
-			if e.Type == flags.ErrHelp {
-				os.Exit(0)
-			}
-		}
-		fmt.Printf("Error: %+v\n", err)
-		os.Exit(1)
-	}
+	kong.Parse(&opts,
+		kong.Name("test-client"),
+		kong.UsageOnError(),
+	)
+	fmt.Printf("%+v\n", opts)
 
 	if opts.Nil && opts.Buffered {
 		fmt.Printf("Specifying both nil and buffered together is invalid\n")
@@ -64,6 +58,7 @@ func main() {
 	}
 
 	var client statsd.Statter = (*statsd.Client)(nil)
+	var err error
 	if !opts.Nil {
 		if opts.Buffered {
 			config.UseBuffered = true
@@ -96,6 +91,8 @@ func main() {
 		log.Fatal("Unsupported state type")
 	}
 
+	log.Printf("sending to %s\n", opts.HostPort)
+
 	pertick := opts.Volume / int(opts.Duration.Seconds()) / 10
 	// add some extra time, because the first tick takes a while
 	ender := time.After(opts.Duration + 100*time.Millisecond)