pyrin

README

pyrin

REST API Framework

Goals

• API Server (Using Echo)
• Schema Validation
• Generate Spec File
• API Client Generation
  • Golang
  • Typescript
• API Docs Generation

Documentation

Index

• Constants
• type ApiHandler
• type ApiHandlerFunc
• type Body
• type Context
• type Group
• type Handler
• type NormalHandler
• type NormalHandlerFunc
• type Route
• type RouteGroup
  • func NewRouteGroup(prefix string) *RouteGroup
  • func (r *RouteGroup) Register(handlers ...Handler)
• type Router
• type Server
  • func NewServer(config *ServerConfig) *Server
  • func (s *Server) Group(prefix string, m ...echo.MiddlewareFunc) *ServerGroup
  • func (s *Server) Start(addr string) error
• type ServerConfig
• type ServerGroup
  • func (g *ServerGroup) Register(handlers ...Handler)
• type ServerRouter
  • func (r *ServerRouter) Group(prefix string) Group

Constants

const ErrTypeUnknownError api.ErrorType = "UNKNOWN_ERROR"

Types

type ApiHandler

type ApiHandler struct {
	Name        string
	Method      string
	Path        string
	DataType    any
	BodyType    Body
	RequireForm bool
	Errors      []api.ErrorType
	Middlewares []echo.MiddlewareFunc
	HandlerFunc ApiHandlerFunc
}

type ApiHandlerFunc

type ApiHandlerFunc func(c Context) (any, error)

type Body

type Body interface {
	validate.Validatable
}

type Context

type Context interface {
	Request() *http.Request
	Response() http.ResponseWriter
	Param(name string) string
}

type Group

type Group interface {
	Register(handlers ...Handler)
}

type Handler

type Handler interface {
	// contains filtered or unexported methods
}

type NormalHandler

type NormalHandler struct {
	Method      string
	Path        string
	Middlewares []echo.MiddlewareFunc
	HandlerFunc NormalHandlerFunc
}

type NormalHandlerFunc

type NormalHandlerFunc func(c Context) error

type Route

type Route struct {
	Name        string
	Path        string
	Method      string
	ErrorTypes  []api.ErrorType
	Data        any
	Body        any
	RequireForm bool
}

type RouteGroup

type RouteGroup struct {
	Prefix string
	Routes []Route
}

func NewRouteGroup

func NewRouteGroup(prefix string) *RouteGroup

func (*RouteGroup) Register

func (r *RouteGroup) Register(handlers ...Handler)

type Router

type Router interface {
	Group(prefix string) Group
}

type Server

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

func NewServer

func NewServer(config *ServerConfig) *Server

func (*Server) Group

func (s *Server) Group(prefix string, m ...echo.MiddlewareFunc) *ServerGroup

func (*Server) Start

func (s *Server) Start(addr string) error

type ServerConfig

type ServerConfig struct {
	RegisterHandlers func(router Router)
	LogName          string
}

type ServerGroup

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

func (*ServerGroup) Register

func (g *ServerGroup) Register(handlers ...Handler)

type ServerRouter

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

func (*ServerRouter) Group

func (r *ServerRouter) Group(prefix string) Group