From 79eeb90079e417f0a9d040c1de8f3278c628810f Mon Sep 17 00:00:00 2001
From: xegineering <me@xegineering.eu>
Date: Thu, 31 Oct 2024 22:10:36 +0100
Subject: Change module name and restructure content

The repository names for soundbox are named as below:

- app: soundbox-app
- Go library module: soundbox-go
- Device: soundbox

The Go module names were:

- app: xengineering.eu/soundbox/app
- Go library module: xengineering.eu/soundbox

This does not make clear which module is related to which repository
since the names are different. Thus it should be changed to:

- app: xengineering.eu/soundbox-app
- Go library module: xengineering.eu/soundbox-go

The import statement for the library is then:

    import "xengineering.eu/soundbox-go/soundbox"

This is a bit longer but it keeps the property that the library is
referenced inside the code by the simple name `soundbox`.
---
 soundbox/stream_test.go | 38 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 38 insertions(+)
 create mode 100644 soundbox/stream_test.go

(limited to 'soundbox/stream_test.go')

diff --git a/soundbox/stream_test.go b/soundbox/stream_test.go
new file mode 100644
index 0000000..41907ad
--- /dev/null
+++ b/soundbox/stream_test.go
@@ -0,0 +1,38 @@
+package soundbox_test
+
+import (
+	"context"
+	"log"
+	"net"
+	"time"
+
+	"xengineering.eu/soundbox-go/soundbox"
+)
+
+func ExampleStreamURLContext() {
+	ctx, cancel := context.WithCancel(context.Background())
+
+	// all soundboxes are referenced by their MAC address
+	soundboxes := []net.HardwareAddr{
+		{0x00, 0x00, 0x5E, 0x00, 0x53, 0x01},
+		{0x00, 0x00, 0x5E, 0x00, 0x53, 0x02},
+		{0x00, 0x00, 0x5E, 0x00, 0x53, 0x03},
+	}
+
+	// currently only web radio is supported
+	url := "https://example.org/radio.mp3"
+
+	// start streaming
+	go func() {
+		err := soundbox.StreamURLContext(ctx, url, soundboxes)
+		if err != nil {
+			log.Fatal(err)
+		}
+	}()
+
+	// let it play for some time
+	time.Sleep(time.Minute)
+
+	// stop it
+	cancel()
+}
-- 
cgit v1.2.3-70-g09d2