twirp: Index | Files

package x

import ""

Package x is a generated twirp stub package. This code was generated with v5.10.1.

It is generated from these files:



Package Files

x.pb.go x.twirp.go


const Svc1PathPrefix = "/twirp/twirp.internal.twirptest.importmapping.x.Svc1/"

Svc1PathPrefix is used for all URL paths on a twirp Svc1 server. Requests are always: POST Svc1PathPrefix/method It can be used in an HTTP mux to route twirp requests along with non-twirp requests on other routes.

func WriteError Uses

func WriteError(resp http.ResponseWriter, err error)

WriteError writes an HTTP response with a valid Twirp error format (code, msg, meta). Useful outside of the Twirp server (e.g. http middleware), but does not trigger hooks. If err is not a twirp.Error, it will get wrapped with twirp.InternalErrorWith(err)

type HTTPClient Uses

type HTTPClient interface {
    Do(req *http.Request) (*http.Response, error)

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 Svc1 Uses

type Svc1 interface {
    Send(context.Context, *twirp_internal_twirptest_importmapping_y.MsgY) (*twirp_internal_twirptest_importmapping_y.MsgY, error)

func NewSvc1JSONClient Uses

func NewSvc1JSONClient(addr string, client HTTPClient, opts ...twirp.ClientOption) Svc1

NewSvc1JSONClient creates a JSON client that implements the Svc1 interface. It communicates using JSON and can be configured with a custom HTTPClient.

func NewSvc1ProtobufClient Uses

func NewSvc1ProtobufClient(addr string, client HTTPClient, opts ...twirp.ClientOption) Svc1

NewSvc1ProtobufClient creates a Protobuf client that implements the Svc1 interface. It communicates using Protobuf and can be configured with a custom HTTPClient.

type TwirpServer Uses

type TwirpServer interface {
    // ServiceDescriptor returns gzipped bytes describing the .proto file that
    // this service was generated from. Once unzipped, the bytes can be
    // unmarshalled as a
    // 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
    // PathPrefix returns the HTTP URL path prefix for all methods handled by this
    // service. This can be used with an HTTP mux to route twirp requests
    // alongside non-twirp requests on one HTTP listener.
    PathPrefix() 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 NewSvc1Server Uses

func NewSvc1Server(svc Svc1, hooks *twirp.ServerHooks) TwirpServer

Package x imports 16 packages (graph). Updated 2020-02-11. Refresh now. Tools for package owners.