[performance] overhaul struct (+ result) caching library for simplicity, performance and multiple-result lookups (#2535)

* rewrite cache library as codeberg.org/gruf/go-structr, implement in gotosocial

* use actual go-structr release version (not just commit hash)

* revert go toolchain changes (damn you go for auto changing this)

* fix go mod woes

* ensure %w is used in calls to errs.Appendf()

* fix error checking

* fix possible panic

* remove unnecessary start/stop functions, move to main Cache{} struct, add note regarding which caches require start/stop

* fix copy-paste artifact... :innocent:

* fix all comment copy-paste artifacts

* remove dropID() function, now we can just use slices.DeleteFunc()

* use util.Deduplicate() instead of collate(), move collate to util

* move orderByIDs() to util package and "generify"

* add a util.DeleteIf() function, use this to delete entries on failed population

* use slices.DeleteFunc() instead of util.DeleteIf() (i had the logic mixed up in my head somehow lol)

* add note about how collate differs from deduplicate

1 files changed, 41 insertions, 0 deletions

diff --git a/vendor/codeberg.org/gruf/go-structr/debug.go b/vendor/codeberg.org/gruf/go-structr/debug.go
new file mode 100644
index 000000000..842f4cfe1
--- /dev/null
+++ b/vendor/codeberg.org/gruf/go-structr/debug.go
@@ -0,0 +1,41 @@
+package structr
+
+// String returns a useful debugging repr of result.
+// func (r *result[T]) String() string {
+// 	keysbuf := getBuf()
+// 	keysbuf.B = append(keysbuf.B, '[')
+// 	for i := range r.keys {
+// 		keysbuf.B = strconv.AppendQuote(keysbuf.B, r.keys[i].key)
+// 		keysbuf.B = append(keysbuf.B, ',')
+// 	}
+// 	if len(keysbuf.B) > 0 {
+// 		keysbuf.B = keysbuf.B[:len(keysbuf.B)-1]
+// 	}
+// 	keysbuf.B = append(keysbuf.B, ']')
+// 	str := fmt.Sprintf("{value=%v err=%v keys=%s}", r.value, r.err, keysbuf.B)
+// 	putBuf(keysbuf)
+// 	return str
+// }
+
+// String returns a useful debugging repr of index.
+// func (i *Index[T]) String() string {
+// 	databuf := getBuf()
+// 	for key, values := range i.data {
+// 		databuf.WriteString("key")
+// 		databuf.B = strconv.AppendQuote(databuf.B, key)
+// 		databuf.B = append(databuf.B, '=')
+// 		fmt.Fprintf(databuf, "%v", values)
+// 		databuf.B = append(databuf.B, ' ')
+// 	}
+// 	if len(i.data) > 0 {
+// 		databuf.B = databuf.B[:len(databuf.B)-1]
+// 	}
+// 	str := fmt.Sprintf("{name=%s data={%s}}", i.name, databuf.B)
+// 	putBuf(databuf)
+// 	return str
+// }
+
+// String returns a useful debugging repr of indexkey.
+// func (i *indexkey[T]) String() string {
+// 	return i.index.name + "[" + strconv.Quote(i.key) + "]"
+// }