Getting started

Install #

Install Agentica 0.31.0 or later (the changelog has the version each release needs). Bond is a package: pin a release by its tag in the agentica.toml of your project.

agentica add bond https://github.com/agentica-lang/bond --tag 0.13.0

This writes the dependency in agentica.toml and agentica.lock, and puts the files of Bond in deps/bond/. Writing the dependency by hand, and then running agentica install, does the same:

[dependencies]
bond = { git = "https://github.com/agentica-lang/bond", tag = "0.13.0" }

Import it from your program with pkg/bond/bond.

A first app #

An app starts with Bond.app(). Each Bond.get, Bond.post and so on takes the app, a path pattern and a handler, and gives the app back, so they chain with |>. A handler is a function that takes a Conn and gives ok(conn) with the answer in it.

The app does not hold your state. A handler that needs a store gets it from a closure: write it as a block, as show does below.

import Bond from "pkg/bond/bond"

struct Store
  names: ATS[String, String]
end

def show(store: Store, conn: Bond.Conn) -> Result[Bond.Conn]
  id = try Bond.param(conn, "id")
  case store.names.get(id)
    ok(name) -> return ok(Bond.text(conn, 200, name))
    error(_) -> return ok(Bond.halt(conn, 404, "no such name"))
  end
end

def main() -> Void
  store = Store(names: ATS.new())
  store.names.put("1", "Ada")
  app = (
    Bond.app()
    |> Bond.before(&Bond.log_request)
    |> Bond.get("/names/:id") do |conn| show(store, conn) end
  )
  Bond.run(app, "127.0.0.1", 4567).unwrap!
end

Run it #

Save the program as app.agc and run it (Bond.run returns when the server closes):

agentica app.agc
curl http://127.0.0.1:4567/names/1

The full todo list program is examples/todos.agc. To try an app without a socket, see Testing.