router

Documentation

Index

• func LoadTemplateFunctions(engine *gin.Engine)
• func LoadTemplates(engine *gin.Engine) error
• type Router
  • func New(ctx context.Context) (*Router, error)
  • func (r *Router) AttachGlobalMiddleware(handlers ...gin.HandlerFunc) gin.IRoutes
  • func (r *Router) AttachGroup(relativePath string, handlers ...gin.HandlerFunc) *gin.RouterGroup
  • func (r *Router) AttachHandler(method string, path string, handler gin.HandlerFunc)
  • func (r *Router) AttachNoRouteHandler(handler gin.HandlerFunc)
  • func (r *Router) Start()
  • func (r *Router) Stop(ctx context.Context) error

Functions

func LoadTemplateFunctions

func LoadTemplateFunctions(engine *gin.Engine)

func LoadTemplates

func LoadTemplates(engine *gin.Engine) error

LoadTemplates loads html templates for use by the given engine

Types

type Router

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

Router provides the HTTP REST interface for GoToSocial, using gin.

func New

func New(ctx context.Context) (*Router, error)

New returns a new Router, which wraps an http server and gin handler engine.

The router's Attach functions should be used *before* the router is Started.

When the router's work is finished, Stop should be called on it to close connections gracefully.

The provided context will be used as the base context for all requests passing through the underlying http.Server, so this should be a long-running context.

func (*Router) AttachGlobalMiddleware

func (r *Router) AttachGlobalMiddleware(handlers ...gin.HandlerFunc) gin.IRoutes

func (*Router) AttachGroup

func (r *Router) AttachGroup(relativePath string, handlers ...gin.HandlerFunc) *gin.RouterGroup

func (*Router) AttachHandler

func (r *Router) AttachHandler(method string, path string, handler gin.HandlerFunc)

func (*Router) AttachNoRouteHandler

func (r *Router) AttachNoRouteHandler(handler gin.HandlerFunc)

func (*Router) Start

func (r *Router) Start()

Start starts the router nicely.

It will serve two handlers if letsencrypt is enabled, and only the web/API handler if letsencrypt is not enabled.

func (*Router) Stop

func (r *Router) Stop(ctx context.Context) error

Stop shuts down the router nicely