chore: move from tools/dsa

Moved the implementation of this hash table from `tools/dsa` #1.

doc_example_test.go

@@ -0,0 +1,32 @@
+// This example
+package cuckoo_test
+
+import (
+	"fmt"
+
+	"git.maximhutz.com/tools/go-cuckoo"
+)
+
+func Example_basic() {
+	table := cuckoo.NewTable[int, string]()
+
+	if err := table.Put(1, "Hello, World!"); err != nil {
+		fmt.Println("Put error:", err)
+	}
+
+	if item, err := table.Get(1); err != nil {
+		fmt.Println("Error:", err)
+	} else {
+		fmt.Println("Found 1:", item)
+	}
+
+	if item, err := table.Get(0); err != nil {
+		fmt.Println("Error:", err)
+	} else {
+		fmt.Println("Found 0:", item)
+	}
+
+	// Output:
+	// Found 1: Hello, World!
+	// Error: key '0' not found
+}