Lembre entre execuções: estado

O que é o estado

O estado de um script é só dele: outro script nunca o vê. Dentro de um flow, todos os passos leem e gravam o estado do flow, então eles compartilham o mesmo armazenamento — um passo pode deixar um valor para um passo seguinte, ou para a próxima execução do flow. As execuções iniciadas no editor usam o mesmo estado das execuções agendadas, por API e por evento: um teste que move um cursor move de verdade.

1from waiso import state2 3def main():4    n = state.incr("runs")5    last = state.get("last_note", "none yet")6    state.set("last_note", f"run {n}")7    return {"run": n, "previous": last}

Seu primeiro script com estado

1. 1
   Salve o script

   Crie counter com o código abaixo. O estado pertence a um item salvo: código que nunca foi salvo não tem estado, e a chamada falha com state_unavailable.

   from waiso import state

   def main():

   n = state.incr("runs") # atomic: two runs at once never lose a count

   last = state.get("last_note", "none yet")

   state.set("last_note", f"run {n}")

   return {"run": n, "previous": last}
2. 2
   Rode duas vezes

   Clique em Executar. A primeira saída é {"run": 1, "previous": "none yet"}; rode de novo e ela fica {"run": 2, "previous": "run 1"}.

   OciosoRun
3. 3
   Abra a aba Estado

   Escolha Estado na barra lateral: runs vale 2 e last_note vale "run 2", cada um com a execução que gravou. Mudanças recentes lista as gravações como Somou e Definiu.

from waiso import state

def main():
    n = state.incr("runs")          # atomic: two runs at once never lose a count
    last = state.get("last_note", "none yet")
    state.set("last_note", f"run {n}")
    return {"run": n, "previous": last}

{
  "run": 2,
  "previous": "run 1"
}

As chamadas

Em Python use waiso.state (ou from waiso import state). Em TypeScript e JavaScript importe state de waiso; toda chamada devolve uma promise. O C tem waiso_state_*, que devolve WAISO_OK ou um código negativo, com os valores em texto JSON; o C++ tem waiso::state, que lança WaisoError.

Mudando um valor que duas execuções podem tocar

Um get seguido de set perde uma gravação quando duas execuções se sobrepõem: as duas leem a mesma lista e cada uma grava a sua versão. O incr resolve para números; para o resto, o update envolve a sua mudança num compare-and-set e tenta de novo.

from waiso import state

def main(numbers: list = [1, 2, 3, 4, 5]):
    seen = state.get("seen", [])
    fresh = [n for n in numbers if n not in seen]
    # update() re-reads and retries if another run changed "seen" meanwhile
    state.update("seen", lambda s: s + [n for n in fresh if n not in s], default=[])
    return {"new": fresh}

A aba Estado

No editor de script, Estado é uma aba lateral; na página de um flow é uma das abas da direita; a página de operação do script também mostra. Ela lista cada chave com o valor e quem gravou por último (execução … ou por uma pessoa), e quanto do espaço está em uso. Adicionar chave e Editar valor aceitam qualquer JSON (texto precisa de aspas), Apagar chave remove uma, e Zerar apaga todas as chaves depois de uma confirmação — a próxima execução começa dos valores padrão. Mudanças recentes mostra as 50 últimas gravações como Definiu, Somou, Apagou ou Zerou.

Limites e códigos de erro

• Cada script ou flow guarda no máximo 1 MB e 1.000 chaves; uma chave tem de 1 a 200 caracteres, sem quebras de linha.
• O registro de mudanças guarda as 50 últimas gravações; os valores não são copiados para ele.
• Excluir o script ou flow exclui o estado dele.