Documentation
¶
Overview ¶
package twirptest provides servers for use in tests and for testing the cleanliness of the generated output of protoc-gen-twirp.
Package twirptest is a generated protocol buffer package.
It is generated from these files:
service.proto
It has these top-level messages:
Hat Size
Package twirptest is a generated twirp stub package. This code was generated with github.com/twitchtv/twirp/protoc-gen-twirp v5.2.0.
It is generated from these files:
service.proto
Index ¶
- Constants
- func WriteError(resp http.ResponseWriter, err error)
- type HTTPClient
- type Haberdasher
- func ErroringHatmaker(err error) Haberdasher
- func HaberdasherFunc(f func(ctx context.Context, s *Size) (*Hat, error)) Haberdasher
- func NewHaberdasherJSONClient(addr string, client HTTPClient) Haberdasher
- func NewHaberdasherProtobufClient(addr string, client HTTPClient) Haberdasher
- func NilHatmaker() Haberdasher
- func NoopHatmaker() Haberdasher
- func PanickyHatmaker(msg string) Haberdasher
- func PickyHatmaker(want int32) Haberdasher
- func ServerAndClient(h Haberdasher, hooks *twirp.ServerHooks) (*httptest.Server, Haberdasher)
- func SlowHatmaker(dur time.Duration) Haberdasher
- func TwirpServerAndClient(hooks *twirp.ServerHooks) (*httptest.Server, Haberdasher)
- type Hat
- type Size
- type TwirpServer
Constants ¶
const HaberdasherPathPrefix = "/twirp/twirp.internal.twirptest.Haberdasher/"
HaberdasherPathPrefix is used for all URL paths on a twirp Haberdasher server. Requests are always: POST HaberdasherPathPrefix/method It can be used in an HTTP mux to route twirp requests along with non-twirp requests on other routes.
Variables ¶
This section is empty.
Functions ¶
func WriteError ¶
func WriteError(resp http.ResponseWriter, err error)
WriteError writes an HTTP response with a valid Twirp error format. If err is not a twirp.Error, it will get wrapped with twirp.InternalErrorWith(err)
Types ¶
type HTTPClient ¶
HTTPClient is the interface used by generated clients to send HTTP requests. It is fulfilled by *(net/http).Client, which is sufficient for most users. Users can provide their own implementation for special retry policies.
HTTPClient implementations should not follow redirects. Redirects are automatically disabled if *(net/http).Client is passed to client constructors. See the withoutRedirects function in this file for more details.
type Haberdasher ¶
type Haberdasher interface {
// MakeHat produces a hat of mysterious, randomly-selected color!
MakeHat(context.Context, *Size) (*Hat, error)
}
A Haberdasher makes hats for clients.
func HaberdasherFunc ¶
HaberdasherFunc is a convenience to convert a function into a Haberdasher service.
func NewHaberdasherJSONClient ¶
func NewHaberdasherJSONClient(addr string, client HTTPClient) Haberdasher
NewHaberdasherJSONClient creates a JSON client that implements the Haberdasher interface. It communicates using JSON and can be configured with a custom HTTPClient.
func NewHaberdasherProtobufClient ¶
func NewHaberdasherProtobufClient(addr string, client HTTPClient) Haberdasher
NewHaberdasherProtobufClient creates a Protobuf client that implements the Haberdasher interface. It communicates using Protobuf and can be configured with a custom HTTPClient.
func PickyHatmaker ¶
func PickyHatmaker(want int32) Haberdasher
Makes a hat, as long as its the size they like
func ServerAndClient ¶
func ServerAndClient(h Haberdasher, hooks *twirp.ServerHooks) (*httptest.Server, Haberdasher)
func SlowHatmaker ¶
func SlowHatmaker(dur time.Duration) Haberdasher
Makes a hat, but sure takes their time
func TwirpServerAndClient ¶
func TwirpServerAndClient(hooks *twirp.ServerHooks) (*httptest.Server, Haberdasher)
type Hat ¶
type Hat struct {
Size int32 `protobuf:"varint,1,opt,name=size" json:"size,omitempty"`
Color string `protobuf:"bytes,2,opt,name=color" json:"color,omitempty"`
Name string `protobuf:"bytes,3,opt,name=name" json:"name,omitempty"`
}
func (*Hat) Descriptor ¶
func (*Hat) ProtoMessage ¶
func (*Hat) ProtoMessage()
type Size ¶
type Size struct {
Inches int32 `protobuf:"varint,1,opt,name=inches" json:"inches,omitempty"`
}
func (*Size) Descriptor ¶
func (*Size) ProtoMessage ¶
func (*Size) ProtoMessage()
type TwirpServer ¶
type TwirpServer interface {
http.Handler
// ServiceDescriptor returns gzipped bytes describing the .proto file that
// this service was generated from. Once unzipped, the bytes can be
// unmarshalled as a
// github.com/golang/protobuf/protoc-gen-go/descriptor.FileDescriptorProto.
//
// The returned integer is the index of this particular service within that
// FileDescriptorProto's 'Service' slice of ServiceDescriptorProtos. This is a
// low-level field, expected to be used for reflection.
ServiceDescriptor() ([]byte, int)
// ProtocGenTwirpVersion is the semantic version string of the version of
// twirp used to generate this file.
ProtocGenTwirpVersion() string
}
TwirpServer is the interface generated server structs will support: they're HTTP handlers with additional methods for accessing metadata about the service. Those accessors are a low-level API for building reflection tools. Most people can think of TwirpServers as just http.Handlers.
func NewHaberdasherServer ¶
func NewHaberdasherServer(svc Haberdasher, hooks *twirp.ServerHooks) TwirpServer
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
Package gogo_compat is a generated protocol buffer package.
|
Package gogo_compat is a generated protocol buffer package. |
|
Package importable is a generated protocol buffer package.
|
Package importable is a generated protocol buffer package. |
|
Package importer is a generated protocol buffer package.
|
Package importer is a generated protocol buffer package. |
|
Package multiple is a generated protocol buffer package.
|
Package multiple is a generated protocol buffer package. |
|
Package no_package_name is a generated protocol buffer package.
|
Package no_package_name is a generated protocol buffer package. |
|
Package no_package_name_importer is a generated protocol buffer package.
|
Package no_package_name_importer is a generated protocol buffer package. |
|
Package proto is a generated protocol buffer package.
|
Package proto is a generated protocol buffer package. |