egutierrez
958189227d
Auditoria del issue 0044: anota en notes: el contexto de consumo de
huerfanos que no pueden registrarse en uses_functions porque sus
consumidores no son funciones del registry:
- consumido por cpp/framework/app_base.cpp (framework no indexado)
- consumido por cpp/apps/{shaders_lab,chart_demo,text_editor_smoke}/main.cpp
- scaffolding/demo en primitives_gallery
31 huerfanas anotadas. Las que quedan en uses_functions=[] tras esto
son hojas legitimas (no llaman a nada) o realmente sin uso (lista
DEAD reportada en el issue 0044).
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
66 lines
2.9 KiB
Markdown
66 lines
2.9 KiB
Markdown
---
|
|
name: shaderlab_db
|
|
kind: function
|
|
lang: cpp
|
|
domain: gfx
|
|
version: "1.0.0"
|
|
purity: impure
|
|
signature: "bool shaderlab_db_save_generator(GeneratorRecord& gen, std::string* err); std::vector<GeneratorRecord> shaderlab_db_list_generators(); bool shaderlab_db_get_generator(const std::string& id, GeneratorRecord& out); bool shaderlab_db_delete_generator(const std::string& id);"
|
|
description: "CRUD persistente para generators custom de shaders_lab via sqlite3. Guarda el GLSL original, el body traducido para el DAG, los DagControl y los param_defaults en una BD local (shaders_lab.db). Soporta open(:memory:) para tests."
|
|
tags: [sqlite, shaders, glsl, dag, gfx, persistence, crud, shaders_lab]
|
|
uses_functions: []
|
|
uses_types:
|
|
- dag_types_cpp_gfx
|
|
returns: []
|
|
returns_optional: false
|
|
error_type: "error_go_core"
|
|
imports: [sqlite3, string, vector, chrono, ctime, iomanip, sstream]
|
|
tested: true
|
|
tests:
|
|
- "open in-memory + list empty"
|
|
- "save + get roundtrip preserva controls/params/defaults"
|
|
- "list ordenado por label"
|
|
- "update preserva created_at y bumps updated_at"
|
|
- "delete devuelve true solo si existia"
|
|
test_file_path: "cpp/functions/gfx/shaderlab_db.cpp"
|
|
file_path: "cpp/functions/gfx/shaderlab_db.cpp"
|
|
params:
|
|
- name: gen
|
|
desc: "Registro del generator. Debe llevar id (snake_case), label, source_glsl original, body_glsl traducido, param_count y los param_defaults/controls coherentes."
|
|
- name: id
|
|
desc: "ID snake_case del generator (clave primaria de la tabla)."
|
|
- name: out
|
|
desc: "Registro de salida en get; queda relleno solo si la funcion devuelve true."
|
|
- name: err
|
|
desc: "Mensaje de error opcional si save falla (constraint, schema, IO)."
|
|
output: "Persistencia en la tabla generators de shaders_lab.db. Las listas vienen ordenadas por label."
|
|
notes: "consumido por cpp/apps/shaders_lab/main.cpp"
|
|
---
|
|
|
|
## Schema
|
|
|
|
```sql
|
|
CREATE TABLE generators (
|
|
id TEXT PRIMARY KEY,
|
|
label TEXT NOT NULL,
|
|
description TEXT NOT NULL DEFAULT '',
|
|
source_glsl TEXT NOT NULL,
|
|
body_glsl TEXT NOT NULL,
|
|
param_count INTEGER NOT NULL,
|
|
param_defaults TEXT NOT NULL, -- CSV de floats
|
|
param_names TEXT NOT NULL, -- LF-separated strings
|
|
controls TEXT NOT NULL, -- LF-separated, fields '|': kind|label|p0|p1|p2|min|max|step
|
|
tags TEXT NOT NULL DEFAULT '',
|
|
created_at TEXT NOT NULL,
|
|
updated_at TEXT NOT NULL
|
|
);
|
|
```
|
|
|
|
## Notas
|
|
|
|
- Formato de serializacion custom (no JSON): CSV para floats, LF para strings, `|` para fields de control. Sin escape de separadores; los labels no deben contener `\n` ni `|`.
|
|
- `shaderlab_db_open` es idempotente: re-abrir con el mismo path es no-op.
|
|
- `:memory:` como path crea una BD temporal en memoria (usado en tests).
|
|
- `save_generator` hace upsert (`ON CONFLICT DO UPDATE`). Setea `created_at` solo si esta vacio.
|
|
- Tests inline activables con `-DSHADERLAB_DB_TEST` y linkando sqlite3 (amalgamation o `-lsqlite3`).
|