sample

package

v0.6.0 Latest Latest Go to latest Published: Sep 25, 2026 License: Apache-2.0 Imports: 13 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/block/spectre

Links

Open Source Insights

Documentation ¶

Overview ¶

Package sample provides a deterministic Connect service for ingress experiments.

Index ¶

type Server
- func NewServer(connectHandler http.Handler, log *slog.Logger) *Server
- func (s *Server) Serve(ctx context.Context, listener net.Listener) error
- func (s *Server) ServeHTTP(writer http.ResponseWriter, request *http.Request)
type Service
- func New(data []byte) (*Service, error)
- func (s *Service) GetUser(ctx context.Context, request *connect.Request[samplepb.GetUserRequest]) (*connect.Response[samplepb.GetUserResponse], error)
- func (s *Service) ListUsers(ctx context.Context, request *connect.Request[samplepb.ListUsersRequest]) (*connect.Response[samplepb.ListUsersResponse], error)

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

This section is empty.

Types ¶

type Server ¶ added in v0.3.0

type Server struct {
	// contains filtered or unexported fields
}

Server serves sample Connect requests and HTTP health checks on one listener.

func NewServer ¶ added in v0.3.0

func NewServer(connectHandler http.Handler, log *slog.Logger) *Server

NewServer constructs a sample server around a configured Connect handler.

func (*Server) Serve ¶ added in v0.3.0

func (s *Server) Serve(ctx context.Context, listener net.Listener) error

Serve accepts sample traffic until the context is cancelled or the server fails.

func (*Server) ServeHTTP ¶ added in v0.3.0

func (s *Server) ServeHTTP(writer http.ResponseWriter, request *http.Request)

ServeHTTP serves sample Connect requests and health checks.

type Service ¶

type Service struct {
	// contains filtered or unexported fields
}

Service serves a read-only snapshot loaded from ProtoJSON.

func New ¶

func New(data []byte) (*Service, error)

New loads sample users from a ProtoJSON ListUsersResponse.

func (*Service) GetUser ¶

func (s *Service) GetUser(ctx context.Context, request *connect.Request[samplepb.GetUserRequest]) (*connect.Response[samplepb.GetUserResponse], error)

GetUser returns one sample user, or InvalidArgument or NotFound for an invalid ID.

func (*Service) ListUsers ¶

func (s *Service) ListUsers(ctx context.Context, request *connect.Request[samplepb.ListUsersRequest]) (*connect.Response[samplepb.ListUsersResponse], error)

ListUsers filters by IDs and optional role, preserving fixture order and its fixed timestamp.

Source Files ¶

View all Source files

Directories ¶

Path	Synopsis
pb
samplepbconnect

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL