CLI-Anything OpenRefine
Usa esta habilidad cuando una tarea necesite limpieza de datos en OpenRefine, transformaciones, historiales de operaciones reutilizables o exportación a CSV/TSV desde un flujo de trabajo automatizado de agente.
Prerrequisitos
Instala el paquete de conexión:
cd openrefine/agent-harness
python -m pip install -e .
Inicia OpenRefine antes de los comandos del backend:
openrefine -i 127.0.0.1 -p 3333
Configura un servidor personalizado con OPENREFINE_URL=http://127.0.0.1:3333 o pasa --base-url.
Reglas de Comandos para Agentes
- Prefiere
--jsonen cada comando de una sola ejecución. - Usa
--session <ruta>para mantener el estado aislado de la tarea. - Importa o abre un proyecto antes de los comandos de filas, aplicar, exportar, deshacer o rehacer.
- Los archivos JSON existentes de historial de operaciones de OpenRefine se pueden pasar directamente a
data apply. - Los archivos generados son JSON de operación de OpenRefine normales y datos CSV/TSV exportados.
Comandos Comunes
cli-anything-openrefine --json server ping
cli-anything-openrefine --json project list
cli-anything-openrefine --json --session run/session.json project import messy.csv --name cleanup
cli-anything-openrefine --json --session run/session.json data rows --limit 10
cli-anything-openrefine --json ops text-transform run/trim.json --column Name --expression 'value.trim()'
cli-anything-openrefine --json --session run/session.json data apply run/trim.json
cli-anything-openrefine --json --session run/session.json data export run/clean.csv --format csv
cli-anything-openrefine --json --session run/session.json session undo
cli-anything-openrefine --json --session run/session.json session redo
REPL
Ejecuta cli-anything-openrefine sin ningún subcomando para entrar al REPL.
Para recorridos de usuario automatizados, canaliza comandos REPL separados por nueva línea a través de stdin. Los flujos redirigidos usan automáticamente una ruta de entrada/salida solo ASCII mientras que las terminales interactivas conservan el banner Unicode, el historial de comandos y el es tilo:
printf 'help\nexit\n' | cli-anything-openrefine
Los payloads Unicode se renderizan como escapes de barra invertida ASCII reversibles cuando el REPL está redirigido, evitando que codificaciones heredadas de salida de Windows conviertan un comando exitoso en un recorrido fallido.
Los flujos de trabajo canalizados devuelven un código de salida distinto de cero al exit o EOF si algún comando
falló, permitiendo que CI detecte un recorrido de usuario no exitoso.
Manejo de Errores
Cuando se establece --json, las fallas de comando escriben un objeto JSON a stderr con ok: false.