feat(surf): AssembleRouter builds the router and handler once; the router stops the MCP endpoint it mounted (quick-261118-lbt)
- surf.AssembleRouter returns the router and the compiled handler from one build, so an mcp.enabled app is not built twice; Assemble keeps its signature and is implemented on top of it - serve uses AssembleRouter with a deferred Router.Close - pier.Pier.Close stops the session reaper and the Redis warm-up; the router that mounted the endpoint owns it - ExampleAssembleRouter, routing/testing docs and the surf/pier READMEs
This commit is contained in:
@@ -27,7 +27,9 @@ In an application with local plugins in a `go.work` workspace, run the tests of
|
||||
|
||||
## Unit tests without a database
|
||||
|
||||
Most plugin code runs without a database. Build a container with `backpack.New`, call your plugin's Register and Boot, and assert on what it published. Drive HTTP handlers with `net/http/httptest`: `surf.Assemble` builds the same handler `serve` uses, so a test can send requests to your routes without listening on a port. Call console commands in-process with `bonfire.Call`.
|
||||
Most plugin code runs without a database. Build a container with `backpack.New`, call your plugin's Register and Boot, and assert on what it published. Drive HTTP handlers with `net/http/httptest`: `surf.AssembleRouter` builds the same handler `serve` uses, together with its route table and admin prefix from one build, so a test can send requests to your routes without listening on a port; `defer r.Close()` on the returned router so its rate-limit store stops. Call console commands in-process with `bonfire.Call`.
|
||||
|
||||
Full-boot tests may call `t.Parallel()`: `party.Activate` gives each application its own plugin instances, so two applications booted in one test binary do not share plugin state, provided your plugin keeps its per-application state on its struct and not in package variables. Column-encryption keys are the exception: they are process-wide, and the last `lagoon.PublishEncryptionKeys` wins.
|
||||
|
||||
## Database tests
|
||||
|
||||
|
||||
@@ -255,6 +255,32 @@ do("POST", "/api/blog/posts/7/comments", true)
|
||||
// POST /api/blog/posts/7/comments 429 {"message":"Too Many Attempts."}
|
||||
```
|
||||
|
||||
A test that needs the route table as well as the handler uses `surf.AssembleRouter`, which builds once and returns both. Building twice would fail with the MCP module enabled, because it publishes its endpoint once per application. The test owns the router and closes it with `surf.Router.Close`, which stops the router's in-process rate-limit store (and the MCP endpoint's background work); `surf.Assemble` drops the router, so its store is never stopped:
|
||||
|
||||
```go src=modules/surf/example_test.go#ExampleAssembleRouter
|
||||
app := backpack.New(nil)
|
||||
plugin := &BlogPlugin{}
|
||||
if err := plugin.Register(app); err != nil { // the runtime calls Register
|
||||
fmt.Println(err)
|
||||
return
|
||||
}
|
||||
// One build: the route table and the handler share one router.
|
||||
r, h, err := surf.AssembleRouter(app, []party.Plugin{plugin})
|
||||
if err != nil {
|
||||
fmt.Println(err)
|
||||
return
|
||||
}
|
||||
defer r.Close() // stops the router's in-process rate-limit store
|
||||
fmt.Println(len(r.Routes()), "routes")
|
||||
|
||||
rec := httptest.NewRecorder()
|
||||
h.ServeHTTP(rec, httptest.NewRequest("GET", "/api/blog/posts/7", nil))
|
||||
fmt.Println(rec.Code, strings.TrimSpace(rec.Body.String()))
|
||||
// Output:
|
||||
// 4 routes
|
||||
// 200 {"id":7}
|
||||
```
|
||||
|
||||
`route:list` builds the router the way `serve` does, without opening the database or listening, and prints every route with its plugin and middleware:
|
||||
|
||||
```sh
|
||||
|
||||
Reference in New Issue
Block a user