Pular para o conteúdo
jsonW Paper GitHub

Escrita e histórico

Gravação viva e publicação atômica

O arquivo .jsw só anexa: um processo pode ler enquanto outro grava, sem ver bloco pela metade. Nos SDKs, o arquivo só aparece inteiro no fechar().

· jsonW 1.3.11

O problema

Quem lê um arquivo enquanto outro programa grava pode pegar uma linha cortada. E um programa que cai no meio da gravação pode deixar um arquivo pela metade no lugar do bom.

Como o jsonW resolve

Cada bloco do .jsw se sustenta sozinho, com marcador, CRC32C e hash. Por isso o formato permite ler em fluxo enquanto outro processo grava, como um tail -f que nunca vê um bloco pela metade. Na escrita pelos SDKs, o arquivo só é publicado no fechar(); quem sai por erro chama abandonar(), e o destino fica como estava.

const { Escritor } = require("@wortictecnologia/jsonw");
const e = new Escritor("eventos.jsw", "id:i64,tipo:dic,quando:tempo");
e.gravar({ id: 1, tipo: "entrada", quando: "2026-11-13T09:00:00Z" });
e.fechar();

Gravação pelo SDK de Node (npm @wortictecnologia/jsonw). O arquivo eventos.jsw só passa a existir, inteiro, no fechar().

Onde está

A publicação atômica está nos 10 SDKs. A leitura durante a gravação existe no núcleo, mas, na versão 1.3.11, não tem comando no wjsw nem função na ABI pública.

Leia a seção completa no paper →