feat: init_jupyter_analysis v1.1.0 — soporte --project, --desc, --tags
Nueva funcion write_analysis_md_bash_infra genera analysis.md con frontmatter.
El pipeline ahora acepta --project para crear analisis directamente en
projects/{proyecto}/analysis/{nombre}/, valida que el proyecto exista,
genera analysis.md con dir_path correcto y ejecuta fn index al final.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
+16
-6
@@ -252,16 +252,26 @@ analysis/
|
||||
|
||||
### Crear un analisis nuevo
|
||||
|
||||
```bash
|
||||
# Basico
|
||||
fn run init_jupyter_analysis finanzas
|
||||
Un solo comando deja todo listo: carpetas, venv, paquetes, launcher, MCP, kernel startup, `analysis.md` con frontmatter y, si va en un proyecto, `fn index` final.
|
||||
|
||||
# Con paquetes extra
|
||||
```bash
|
||||
# Analisis suelto (analysis/{nombre}/)
|
||||
fn run init_jupyter_analysis finanzas
|
||||
fn run init_jupyter_analysis ml scikit-learn torch
|
||||
fn run init_jupyter_analysis duckdb polars duckdb
|
||||
|
||||
# Analisis dentro de un proyecto (projects/{proyecto}/analysis/{nombre}/)
|
||||
fn run init_jupyter_analysis --project aurgi sale_prices --desc "Comprobacion precios"
|
||||
fn run init_jupyter_analysis --project fn_monitoring coverage polars --tags "monitoring,coverage"
|
||||
```
|
||||
|
||||
El pipeline `init_jupyter_analysis_bash_pipelines` compone 8 funciones atomicas del registry.
|
||||
Flags del pipeline:
|
||||
- `--project <nombre>` — crea el analisis dentro de `projects/{nombre}/analysis/` y ejecuta `fn index` al final. El proyecto debe existir (`projects/{nombre}/project.md`).
|
||||
- `--desc "..."` — descripcion que se escribe en el frontmatter de `analysis.md`.
|
||||
- `--tags "a,b,c"` — tags CSV que se escriben en el frontmatter.
|
||||
|
||||
**NUNCA** uses `mv` para mover un analisis de `analysis/` a `projects/{proyecto}/analysis/` despues de crearlo. Al mover, el `.venv/bin/activate` queda con el path antiguo hardcodeado y el launcher falla con `ERROR: jupyter-collaboration no esta instalado`. Si esto pasa: `rm -rf .venv && uv sync` dentro del directorio nuevo. La forma correcta es siempre crear con `--project` desde el inicio.
|
||||
|
||||
El pipeline `init_jupyter_analysis_bash_pipelines` (v1.1.0) compone 9 funciones atomicas del registry.
|
||||
|
||||
### Usar un analisis
|
||||
|
||||
|
||||
@@ -53,17 +53,15 @@ mkdir -p ~/vaults/{vault_name}/{raw,processed,exports}
|
||||
ln -s ~/vaults/{vault_name} projects/{nombre}/vaults/{vault_name}
|
||||
# Crear vault.yaml con la entrada
|
||||
|
||||
# 4. Crear analysis dentro del proyecto
|
||||
fn run init_jupyter_analysis {nombre_analysis} [paquetes...]
|
||||
mv analysis/{nombre_analysis} projects/{nombre}/analysis/
|
||||
# Crear analysis.md con dir_path correcto
|
||||
# Regenerar launcher y kernel startup:
|
||||
source bash/functions/infra/write_jupyter_launcher.sh && write_jupyter_launcher projects/{nombre}/analysis/{tema}
|
||||
source bash/functions/infra/write_jupyter_registry_kernel.sh && write_jupyter_registry_kernel projects/{nombre}/analysis/{tema}
|
||||
# 4. Crear analysis dentro del proyecto (un solo comando; ya indexa)
|
||||
fn run init_jupyter_analysis --project {nombre} {nombre_analysis} --desc "..." [paquetes...]
|
||||
|
||||
# 5. Indexar
|
||||
fn index
|
||||
# 5. Verificar
|
||||
fn show {nombre} # verifica el project y sus componentes
|
||||
|
||||
# NUNCA: crear el analisis en analysis/ y luego mv al proyecto.
|
||||
# Al mover se rompe el .venv (paths hardcodeados en activate).
|
||||
# Si ya te paso: cd projects/{nombre}/analysis/{tema} && rm -rf .venv && uv sync
|
||||
```
|
||||
|
||||
### Consultas utiles
|
||||
|
||||
Reference in New Issue
Block a user