988e901066
Añade campos params y output al frontmatter YAML de las 506 funciones del registry. Cada parámetro tiene descripción semántica (qué representa, unidades, rango típico) y cada función describe qué produce su output. Permite a agentes razonar sobre cadenas de composición (ej: prices → log_return → sharpe_ratio) sin leer código.
2.1 KiB
2.1 KiB
name, kind, lang, domain, version, purity, signature, description, tags, uses_functions, uses_types, returns, returns_optional, error_type, imports, params, output, tested, tests, test_file_path, file_path
| name | kind | lang | domain | version | purity | signature | description | tags | uses_functions | uses_types | returns | returns_optional | error_type | imports | params | output | tested | tests | test_file_path | file_path | |||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| cache_to_sqlite | function | go | infra | 1.0.0 | impure | func CacheToSQLite(dbPath, namespace string) (*SQLiteCache, error) | Cache key-value persistido en SQLite con TTL y lazy eviction. Valores almacenados como JSON bytes; el caller serializa y deserializa. Thread-safe con sync.Mutex. Soporta Get, Set, Delete, Clear y GetOrSet. |
|
false | error_go_core |
|
|
instancia thread-safe de SQLiteCache con metodos Get, Set, Delete, Clear, GetOrSet | true |
|
functions/infra/cache_to_sqlite_test.go | functions/infra/cache_to_sqlite.go |
Ejemplo
cache, err := infra.CacheToSQLite("my_cache.db", "default")
if err != nil {
log.Fatal(err)
}
defer cache.Close()
// Almacenar JSON bytes con TTL de 1 hora
payload, _ := json.Marshal(map[string]string{"result": "ok"})
cache.Set("key1", payload, time.Hour)
// Recuperar
if v, ok := cache.Get("key1"); ok {
var result map[string]string
json.Unmarshal(v, &result)
fmt.Println(result["result"]) // ok
}
// Factory pattern
val, err := cache.GetOrSet("expensive_key", func() ([]byte, error) {
return json.Marshal(computeExpensiveThing())
}, time.Hour)
// Helper para serializar directamente
cache.SetJSON("user:42", userStruct, 30*time.Minute)
Notas
Usa WAL mode para mejor concurrencia de lecturas. La eviction lazy elimina expirados en cada Get. El schema comparte la tabla cache con cache_to_sqlite_py_infra — ambas implementaciones son interoperables sobre el mismo archivo SQLite si usan namespaces distintos. Requiere github.com/mattn/go-sqlite3 (ya presente en el registry).