Module

jinks/watch

src/jinks/watch.pooka

A portable watcher that asks whether the words changed, not merely their timestamp. Two matching observations debounce a save. Publication stays serial; an edit made during a build is noticed on the next observation.

API reference

class

State

src/jinks/watch.pooka:21
class State(
  root: String,
  server: server.Running,
  observed: List(#(String, BitArray)),
  pending: Option(List(#(String, BitArray))),
  revision: Int,
  problem: String,
  selected: request.Request
)
field

root

src/jinks/watch.pooka:22
root: String
INFERREDString
field

server

src/jinks/watch.pooka:23
server: server.Running
field

observed

src/jinks/watch.pooka:24
observed: List(#(String, BitArray))
INFERREDList(#(String, BitArray))
field

pending

src/jinks/watch.pooka:25
pending: Option(List(#(String, BitArray)))
INFERREDOption(List(#(String, BitArray)))
field

revision

src/jinks/watch.pooka:26
revision: Int
INFERREDInt
field

problem

src/jinks/watch.pooka:27
problem: String
INFERREDString
field

selected

src/jinks/watch.pooka:28
selected: request.Request
constructor

new

src/jinks/watch.pooka:22
INFERREDfn(String, jinks/server.Running, List(#(String, BitArray)), Option(List(#(String, BitArray))), Int, String, jinks/request.Request) -> jinks/watch.State
function

snapshot

src/jinks/watch.pooka:37
snapshot(root: String) -> Result(List(#(String, BitArray)), String)
INFERREDfn(String) -> Result(List(#(String, BitArray)), String)

Ignore output, staging, manifests and caches by enumerating only inputs. Hashing detects same-length edits even when filesystem times are unchanged.

function

snapshot_selected

src/jinks/watch.pooka:41
snapshot_selected(selected: request.Request) -> Result(
  List(#(String, BitArray)),
  String
)
INFERREDfn(jinks/request.Request) -> Result(List(#(String, BitArray)), String)
function

start

src/jinks/watch.pooka:74
start(root: String, host: String, port: Int, live: Bool) -> Result(
  State,
  String
)
INFERREDfn(String, String, Int, Bool) -> Result(jinks/watch.State, String)
function

start_selected

src/jinks/watch.pooka:81
start_selected(selected: request.Request, host: String, port: Int, live: Bool) -> Result(
  State,
  String
)
INFERREDfn(jinks/request.Request, String, Int, Bool) -> Result(jinks/watch.State, String)
function

tick

src/jinks/watch.pooka:99
tick(state: State) -> Result(State, String)
INFERREDfn(jinks/watch.State) -> Result(jinks/watch.State, String)

Tick is exposed separately from sleeping so saves, failures and recovery can be regression-tested without a timing race or an infinite CLI process.

function

css_only

src/jinks/watch.pooka:137
css_only(before: List(#(String, BitArray)), after: List(#(String, BitArray))) -> Bool
INFERREDfn(List(#(String, BitArray)), List(#(String, BitArray))) -> Bool

Only edits to existing CSS assets can be swapped without reloading HTML. Added, removed or renamed files may change generated links, so rebuilds containing those changes retain the conservative full-page reload.

function

rebuild

src/jinks/watch.pooka:155
rebuild(state: State, current: List(#(String, BitArray))) -> Result(
  State,
  String
)
INFERREDfn(jinks/watch.State, List(#(String, BitArray))) -> Result(jinks/watch.State, String)
function

failed

src/jinks/watch.pooka:181
failed(state: State, current: List(#(String, BitArray)), problem: String) -> Result(
  State,
  String
)
INFERREDfn(jinks/watch.State, List(#(String, BitArray)), String) -> Result(jinks/watch.State, String)
function

run

src/jinks/watch.pooka:199
run(root: String, host: String, port: Int, live: Bool) -> Result(String, String)
INFERREDfn(String, String, Int, Bool) -> Result(String, String)
function

run_selected

src/jinks/watch.pooka:203
run_selected(selected: request.Request, host: String, port: Int, live: Bool) -> Result(
  String,
  String
)
INFERREDfn(jinks/request.Request, String, Int, Bool) -> Result(String, String)
function

wait

src/jinks/watch.pooka:222
wait(state: State) -> Result(String, String)
INFERREDfn(jinks/watch.State) -> Result(String, String)