mirror of
https://github.com/zap-proto/zip.git
synced 2026-10-19 15:38:57 +00:00
App, Group, Operation. A group is a prefix and what holds under it, an operation
is one typed route declared there, and the verb methods are generic methods —
which Go 1.27 allows on a concrete type and still refuses on an interface. So In
and Out come from the handler and the caller writes no type arguments:
users := app.Group("/v1/users")
users.Post("/", api.Create)
mint := users.Group("/mint").With(middleware.Mint(gate))
mint.Post("/deposit", api.Deposit)
A Group is a CLOSED HANDLE: two unexported fields, and no method that hands back
the app, the parent or the fiber underneath. A subsystem given the group at its
own prefix cannot reach above it, so confinement is a property of the type
instead of a rule something has to police — which is what a host needs in order
to hand out a bounded surface and know what comes back.
That is bought by giving up the router interface, deliberately. Router and
OpTarget are gone, and with them the ability to implement a route table outside
this package: a decorator is no longer a router, a gate is middleware on a group,
and a bound is a path. The five package-level verb functions go the same way —
a registration is a method on the thing it registers into.
Raw carries what is not a typed operation: a stream, an upgrade, a probe, a
foreign subtree. It names its method, and it is the longer spelling because
opting out of the typed model is the exception and should read like one.
Co-authored-by: Hanzo Dev <[email protected]>
41 lines
1.3 KiB
Go
41 lines
1.3 KiB
Go
package zip
|
|
|
|
import (
|
|
"context"
|
|
"io"
|
|
"net/http/httptest"
|
|
"strings"
|
|
"testing"
|
|
)
|
|
|
|
// A service that must reach another on this caller's behalf needs the credential
|
|
// the caller presented. CallerOf deliberately does not carry it, so this is the
|
|
// one way to read it — and it must answer honestly when there is no request.
|
|
func TestHeaderReadsTheRequestAndSaysNothingWhenThereIsNone(t *testing.T) {
|
|
app := New(Config{AppName: "svc", DisableStartupMessage: true})
|
|
type none struct{}
|
|
type out struct {
|
|
Auth string `json:"auth"`
|
|
}
|
|
app.Get("/v1/echo", func(ctx context.Context, _ *none) (*out, error) {
|
|
return &out{Auth: Header(ctx, "Authorization")}, nil
|
|
}, WithOperationID("echo"))
|
|
if err := app.Build(); err != nil {
|
|
t.Fatalf("Build: %v", err)
|
|
}
|
|
req := httptest.NewRequest("GET", "/v1/echo", nil)
|
|
req.Header.Set("Authorization", "Bearer abc")
|
|
resp, err := app.Fiber().Test(req)
|
|
if err != nil {
|
|
t.Fatalf("GET: %v", err)
|
|
}
|
|
defer func() { _ = resp.Body.Close() }()
|
|
body, _ := io.ReadAll(resp.Body)
|
|
if !strings.Contains(string(body), "Bearer abc") {
|
|
t.Fatalf("the request header did not reach the handler: %s", body)
|
|
}
|
|
if got := Header(context.Background(), "Authorization"); got != "" {
|
|
t.Errorf("a context with no request behind it answered %q, want empty", got)
|
|
}
|
|
}
|