Files
fn_registry/bash/functions/pipelines/init_cpp_app.md
T

2.8 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
init_cpp_app pipeline bash pipelines 0.1.0 impure init_cpp_app(name: string, [--project <p>] [--domain <d>] [--desc <s>] [--tags <csv>]) -> void Scaffolder estandar de apps C++ del registry. Genera main.cpp + CMakeLists.txt + app.md siguiendo el patron canonico (cfg.about/log/panels, sin app_menubar manual, dockspace via framework), registra la app en cpp/CMakeLists.txt, inicializa repo Gitea dataforge/<name> y ejecuta fn index.
cpp
imgui
scaffold
pipeline
bash
launcher
ensure_repo_synced_bash_infra
false error_go_core
name desc
name nombre de la app (snake_case). Sera el id en registry.db y el repo dataforge/<name>
name desc
--project proyecto bajo projects/ donde crear la app (opcional). Si se omite va a cpp/apps/<name>/
name desc
--domain dominio del registry (default: tools)
name desc
--desc descripcion breve (frontmatter description + cfg.about/cfg.title)
name desc
--tags tags CSV adicionales para el frontmatter (siempre se anade 'imgui')
estructura completa de la app + entry registrada en cpp/CMakeLists.txt + repo Gitea + fn index false
bash/functions/pipelines/init_cpp_app.sh

Ejemplo

# App suelta en cpp/apps/<name>/
fn run init_cpp_app my_tool --desc "Herramienta para X"

# App dentro de un proyecto
fn run init_cpp_app finance_panel --project budget --desc "Panel de finanzas" --tags "finance,dashboard"

Que genera

<dir>/
  main.cpp        # Plantilla canonica: panels[] + cfg.about + cfg.log + run_app(cfg, render)
  CMakeLists.txt  # add_imgui_app(<name> main.cpp)
  app.md          # Frontmatter completo (lang:cpp, framework:imgui, dir_path, repo_url)

Y ademas:

  • Registra add_subdirectory(apps/<name>) (o el bloque _DIR para projects) en cpp/CMakeLists.txt.
  • Crea repo Gitea dataforge/<name> con master + commit inicial via ensure_repo_synced_bash_infra (requiere GITEA_URL y GITEA_TOKEN).
  • Ejecuta fn index para registrar la app en registry.db.

Plantilla main.cpp

La plantilla cumple cpp/PATTERNS.md:

  • NO llama app_menubar manual (lo dibuja el framework).
  • NO llama DockSpaceOverViewport (auto_dockspace=true por defecto).
  • Declara panels[] con un panel "Main" toggleable.
  • Setea cfg.about (window About) y cfg.log (logger + ventana Logs).

Despues de crear

  1. Editar app.md y completar uses_functions cuando la app consuma funciones del registry.
  2. Anadir las funciones del registry al CMakeLists.txt como paths absolutos: ${CMAKE_SOURCE_DIR}/functions/<dom>/<func>.cpp.
  3. Build: cd cpp && cmake --build build --target <name> -j.