Archivos spec de PyGWalker

Una spec de PyGWalker almacena el estado de gráficos. Usa spec_path para archivos locales que PyGWalker deba cargar o guardar, y usa spec para JSON en línea, IDs de configuración o specs remotas.

import pygwalker as pyg
 
walker = pyg.walk(
    df,
    spec_path="./gw_config.json",
    computation="browser",
)

spec_path vs spec

Para ejemplos nuevos con archivos locales, prefiere spec_path. Hace explícita la persistencia en archivo y evita ambigüedad con JSON en línea o specs remotas.

Guarda y reutiliza el estado de gráficos

Usa el modo spec de lectura-escritura cuando el adaptador exponga guardado.

import pygwalker as pyg
 
walker = pyg.Walker(
    df,
    spec_path="./gw_config.json",
    spec_io_mode="rw",
    computation="kernel",
)
 
walker.show()

Streamlit y Gradio también admiten spec_io_mode:

from pygwalker.api.streamlit import StreamlitRenderer
 
renderer = StreamlitRenderer(
    df,
    spec_path="./gw_config.json",
    spec_io_mode="rw",
    computation="kernel",
)
renderer.explorer()

Renderiza gráficos guardados

Usa render cuando quieras gráficos guardados sin el explorador completo.

import pygwalker as pyg
 
pyg.render(df, spec_path="./gw_config.json", computation="browser")

Usa to_render_html para una exportación estática del renderer.

from pygwalker.api.html import to_render_html
 
html = to_render_html(df, spec_path="./gw_config.json", computation="browser")

Migra specs antiguas

pygwalker.spec.migrate actualiza una spec guardada de PyGWalker o Graphic Walker a la forma de esquema actual.

import json
import pygwalker as pyg
 
migrated = pyg.spec.migrate("./old_gw_config.json")
 
with open("./gw_config.json", "w", encoding="utf-8") as f:
    json.dump(migrated, f, ensure_ascii=False, indent=2)

Firma:

pygwalker.spec.migrate(spec, *, version=None) -> dict

spec puede ser:

Si una cadena parece JSON inválido o la ruta de archivo no existe, migrate genera ValueError.

Errores comunes

Guías relacionadas

• Índice de API
• API para notebooks
• Streamlit
• Exportaciones HTML
• Modos de computación