Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security Policy
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

common

package

Go to main page

Versions in this module

v1

v1.0.1

May 6, 2022

v1.0.0

Apr 22, 2022

Changes in this version

+ const StreamChannelSize

type API

+ func (api *API) Context() context.Context

+ func (api *API) StreamResponse(w http.ResponseWriter, next StreamIterator, errCh chan error)

type Config

+ APIErrorFunc func(err error, status int) error

+ type StreamIterator func() (interface{}, bool, error)

v1.0.0-rc5

Apr 11, 2022

v1.0.0-rc4

Apr 7, 2022

v1.0.0-rc3

Mar 28, 2022

v1.0.0-rc2

Mar 25, 2022

v1.0.0-rc1

Mar 24, 2022

v0

v0.14.5

Feb 16, 2022

v0.14.5-rc1

Feb 2, 2022

v0.14.4

Jan 11, 2022

v0.14.3

Jan 3, 2022

v0.14.2

Dec 9, 2021

Changes in this version

+ const SetStatusAutomatically

+ var ErrHTTPEndpointNotEnabled = errors.New("the HTTP endpoint is not enabled")

+ var ErrNoEndpointsEnabled = errors.New("neither the libp2p nor the HTTP endpoints are enabled")

+ type API struct

+ func NewAPI(ctx context.Context, cfg *Config, routes func(*rpc.Client) []Route) (*API, error)

+ func NewAPIWithHost(ctx context.Context, cfg *Config, h host.Host, ...) (*API, error)

+ func (api *API) HTTPAddresses() ([]string, error)

+ func (api *API) Headers() map[string][]string

+ func (api *API) Host() host.Host

+ func (api *API) ParseCidOrFail(w http.ResponseWriter, r *http.Request) *types.Pin

+ func (api *API) ParsePidOrFail(w http.ResponseWriter, r *http.Request) peer.ID

+ func (api *API) ParsePinPathOrFail(w http.ResponseWriter, r *http.Request) *types.PinPath

+ func (api *API) SendResponse(w http.ResponseWriter, status int, err error, resp interface{})

+ func (api *API) SetClient(c *rpc.Client)

+ func (api *API) SetHeaders(w http.ResponseWriter)

+ func (api *API) SetKeepAlivesEnabled(b bool)

+ func (api *API) Shutdown(ctx context.Context) error

+ type Config struct

+ BasicAuthCredentials map[string]string

+ CORSAllowCredentials bool

+ CORSAllowedHeaders []string

+ CORSAllowedMethods []string

+ CORSAllowedOrigins []string

+ CORSExposedHeaders []string

+ CORSMaxAge time.Duration

+ ConfigKey string

+ DefaultFunc func(*Config) error

+ EnvConfigKey string

+ HTTPListenAddr []ma.Multiaddr

+ HTTPLogFile string

+ Headers map[string][]string

+ ID peer.ID

+ IdleTimeout time.Duration

+ Libp2pListenAddr []ma.Multiaddr

+ Logger *logging.ZapEventLogger

+ MaxHeaderBytes int

+ PathSSLCertFile string

+ PathSSLKeyFile string

+ PrivateKey crypto.PrivKey

+ ReadHeaderTimeout time.Duration

+ ReadTimeout time.Duration

+ RequestLogger *logging.ZapEventLogger

+ TLS *tls.Config

+ Tracing bool

+ WriteTimeout time.Duration

+ func (cfg *Config) ApplyEnvVars() error

+ func (cfg *Config) CorsOptions() *cors.Options

+ func (cfg *Config) GetHTTPLogPath() string

+ func (cfg *Config) LoadJSON(raw []byte) error

+ func (cfg *Config) LogWriter() (io.Writer, error)

+ func (cfg *Config) ToDisplayJSON() ([]byte, error)

+ func (cfg *Config) ToJSON() (raw []byte, err error)

+ func (cfg *Config) Validate() error

+ type Route struct

+ HandlerFunc http.HandlerFunc

+ Method string

+ Name string

+ Pattern string

v0.14.2-rc1

Dec 1, 2021