rex

package module
v1.0.6 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Dec 27, 2020 License: MIT Imports: 24 Imported by: 1

README

REX

GoDoc GoReport MIT

REX provides a query/mutation style API server in Golang, noREST.

Installing

go get -u github.com/ije/rex

Example

package main

import (
    "sync"
    "github.com/ije/rex"
)

var posts sync.Map

func main() {
    // GET http://localhost/*
    rex.Query("*", func(ctx *rex.Context) interface{} {
        return rex.HTML("<h1>Hello World</h1>")
    })

    // GET http://localhost/post?id=123
    rex.Query("post", func(ctx *rex.Context) interface{} {
        post, ok := posts.Load(ctx.Form.RequireInt("id"))
        if !ok {
            return rex.Error("post not found", 404)
        }
        return post
    })

    // POST http://localhost/add-post {"title": "Hello World"}
    rex.Mutation("add-post", func(ctx *rex.Context) interface{} {
        var id int
		posts.Range(func(k, v interface{}) bool {
			id++
			return true
		})
		post := map[string]interface{}{
			"id":    id + 1,
			"title": ctx.Form.Value("title"),
		}
        posts.Store(id, post)
        return post
    })

    // POST http://localhost/remove-post {"id": 123}
    rex.Mutation("remove-post", func(ctx *rex.Context) interface{} {
        posts.Delete(ctx.Form.RequireInt("id"))
        return nil
    })

    rex.Start(8080)
}

Documentation

Overview

Package rex provides a simple & light-weight REST server in golang

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func Content added in v1.0.0

func Content(name string, motime time.Time, r io.ReadSeeker) interface{}

Content replies to the request using the content in the provided ReadSeeker.

func File added in v1.0.0

func File(name string) interface{}

File replies to the request using the file content.

func Mutation added in v1.0.0

func Mutation(endpoint string, handles ...Handle)

Mutation adds a mutation api

func Query added in v1.0.0

func Query(endpoint string, handles ...Handle)

Query adds a query api

func Redirect added in v1.0.0

func Redirect(url string, status int) interface{}

Redirect replies to the request with a redirect to url, which may be a path relative to the request path.

func Render added in v1.0.0

func Render(template Template, data interface{}) interface{}

Render renders the template to the request.

func RenderHTML added in v1.0.0

func RenderHTML(html string, data interface{}) interface{}

RenderHTML renders the html to the request.

func Serve

func Serve(config ServerConfig) chan error

Serve serves a rex server.

func Start added in v0.9.0

func Start(port uint16) (err error)

Start starts a REX server.

func StartAutoTLS added in v0.9.0

func StartAutoTLS(port uint16, hosts ...string) (err error)

StartAutoTLS starts a REX server with autocert powered by Let's Encrypto SSL

func StartTLS added in v0.9.0

func StartTLS(port uint16, certFile string, keyFile string) (err error)

StartTLS starts a REX server with TLS.

func Static added in v0.5.0

func Static(root string, fallback string) interface{}

Static replies to the request with the contents of the file system rooted at root.

func Use added in v0.9.0

func Use(middlewares ...Handle)

Use appends middlewares to current APIS middleware stack.

Types

type ACLUser added in v0.8.1

type ACLUser interface {
	Permissions() []string
}

A ACLUser interface contains the Permissions method that returns the permission IDs

type APIHandler added in v1.0.0

type APIHandler struct {
	// Prefix to add prefix for each api path, like "v2"
	Prefix string
	// contains filtered or unexported fields
}

APIHandler is a query/mutation style API http Handler

func Default added in v0.13.4

func Default() *APIHandler

Default returns the default REST

func (*APIHandler) Mutation added in v1.0.0

func (a *APIHandler) Mutation(endpoint string, handles ...Handle)

Mutation adds a mutation api

func (*APIHandler) Query added in v1.0.0

func (a *APIHandler) Query(endpoint string, handles ...Handle)

Query adds a query api

func (*APIHandler) ServeHTTP added in v1.0.0

func (a *APIHandler) ServeHTTP(w http.ResponseWriter, r *http.Request)

ServeHTTP implements the http Handler.

func (*APIHandler) Use added in v1.0.0

func (a *APIHandler) Use(middlewares ...Handle)

Use appends middlewares to current APIS middleware stack.

type AutoTLSConfig added in v0.4.0

type AutoTLSConfig struct {
	AcceptTOS bool           `json:"acceptTOS"`
	Hosts     []string       `json:"hosts"`
	CacheDir  string         `json:"cacheDir"`
	Cache     autocert.Cache `json:"-"`
}

AutoTLSConfig contains options to support autocert by Let's Encrypto SSL.

type CORS

type CORS struct {
	AllowAllOrigins  bool
	AllowOrigins     []string
	AllowMethods     []string
	AllowHeaders     []string
	ExposeHeaders    []string
	AllowCredentials bool
	MaxAge           int // in seconds
}

CORS contains options to CORS.

type Context

type Context struct {
	W    http.ResponseWriter
	R    *http.Request
	Form *Form
	// contains filtered or unexported fields
}

A Context to handle http requests.

func (*Context) ACLUser added in v0.6.0

func (ctx *Context) ACLUser() ACLUser

ACLUser returns the acl user

func (*Context) AddHeader added in v0.1.5

func (ctx *Context) AddHeader(key string, value string)

AddHeader adds the key, value pair to the header of response writer.

func (*Context) BasicUser added in v0.4.0

func (ctx *Context) BasicUser() (string, string)

BasicUser returns the BasicAuth username and secret

func (*Context) Cookie

func (ctx *Context) Cookie(name string) (cookie *http.Cookie, err error)

Cookie returns the cookie by name.

func (*Context) DeleteHeader added in v0.14.0

func (ctx *Context) DeleteHeader(key string)

DeleteHeader deletes the values associated with key.

func (*Context) EnableCompression added in v1.0.2

func (ctx *Context) EnableCompression()

EnableCompression enables the compression method based on the Accept-Encoding header

func (*Context) RemoteIP

func (ctx *Context) RemoteIP() string

RemoteIP returns the remote client IP.

func (*Context) RemoveCookie

func (ctx *Context) RemoveCookie(cookie *http.Cookie)

RemoveCookie removes the cookie.

func (*Context) RemoveCookieByName added in v0.8.0

func (ctx *Context) RemoveCookieByName(name string)

RemoveCookieByName removes the cookie by name.

func (*Context) Session

func (ctx *Context) Session() *Session

Session returns the session if it is undefined then create a new one.

func (*Context) SetACLUser added in v0.9.2

func (ctx *Context) SetACLUser(user ACLUser)

SetACLUser sets the acl user

func (*Context) SetCookie

func (ctx *Context) SetCookie(cookie *http.Cookie)

SetCookie sets a cookie.

func (*Context) SetHeader added in v0.1.5

func (ctx *Context) SetHeader(key string, value string)

SetHeader sets the header of response writer entries associated with key to the single element value.

func (*Context) SetValue added in v1.0.0

func (ctx *Context) SetValue(key string, value interface{})

SetValue sets the value for a key.

func (*Context) Value added in v0.9.2

func (ctx *Context) Value(key string) (interface{}, bool)

Value returns the value stored in the values for a key, or nil if no value is present.

type Error added in v1.0.0

type Error struct {
	Status  int    `json:"status"`
	Message string `json:"message"`
}

Error defines the error with status.

type Form added in v0.11.0

type Form struct {
	R *http.Request
}

A Form to handle http form

func (*Form) File added in v0.11.0

func (form *Form) File(key string) (multipart.File, *multipart.FileHeader, error)

File returns the first file for the provided form key.

func (*Form) Float added in v0.11.1

func (form *Form) Float(key string) (float64, error)

Float returns the form value as float

func (*Form) Int added in v0.11.1

func (form *Form) Int(key string) (int64, error)

Int returns the form value as integer

func (*Form) IsNil added in v0.15.6

func (form *Form) IsNil(key string) bool

IsNil checks the value for the key whether is nil.

func (*Form) Require added in v0.11.0

func (form *Form) Require(key string) string

Require requires a value

func (*Form) RequireFloat added in v0.11.0

func (form *Form) RequireFloat(key string) float64

RequireFloat requires a value as float

func (*Form) RequireInt added in v0.11.0

func (form *Form) RequireInt(key string) int64

RequireInt requires a value as int

func (*Form) Value added in v0.11.0

func (form *Form) Value(key string) string

Value returns the first value for the named component of the POST, PATCH, or PUT request body, or returns the first value for the named component of the request url query.

type Handle added in v0.8.0

type Handle func(ctx *Context) interface{}

Handle defines the API handle

func ACL added in v0.5.1

func ACL(permissions ...string) Handle

ACL returns a ACL middleware.

func AccessLogger added in v0.13.2

func AccessLogger(logger Logger) Handle

AccessLogger returns a AccessLogger middleware to sets the access logger.

func BasicAuth added in v0.4.0

func BasicAuth(auth func(name string, secret string) (ok bool, err error)) Handle

BasicAuth returns a Basic HTTP Authorization middleware.

func BasicAuthWithRealm added in v0.8.0

func BasicAuthWithRealm(realm string, auth func(name string, secret string) (ok bool, err error)) Handle

BasicAuthWithRealm returns a Basic HTTP Authorization middleware with realm.

func Cors added in v0.13.2

func Cors(cors CORS) Handle

Cors returns a Cors middleware to handle cors.

func ErrorLogger added in v0.13.2

func ErrorLogger(logger Logger) Handle

ErrorLogger returns a ErrorLogger middleware to sets the error logger.

func Header(key string, value string) Handle

Header is REX middleware to set http header

func SIDStore added in v0.6.2

func SIDStore(sidStore session.SIDStore) Handle

SIDStore returns a SIDStore middleware to sets sid store for session.

func SessionPool added in v0.9.4

func SessionPool(pool session.Pool) Handle

SessionPool returns a SessionPool middleware to set the session pool.

type Logger added in v0.5.0

type Logger interface {
	Printf(format string, v ...interface{})
}

A Logger interface contains the Printf method.

type ServerConfig added in v0.12.5

type ServerConfig struct {
	Host           string    `json:"host"`
	Port           uint16    `json:"port"`
	TLS            TLSConfig `json:"tls"`
	ReadTimeout    uint32    `json:"readTimeout"`
	WriteTimeout   uint32    `json:"writeTimeout"`
	MaxHeaderBytes uint32    `json:"maxHeaderBytes"`
}

ServerConfig contains options to run the REX server.

type Session added in v0.5.1

type Session struct {
	session.Session
}

Session handles sessions for Context

func (*Session) Delete added in v0.5.1

func (s *Session) Delete(key string)

Delete removes a session value

func (*Session) Flush added in v0.5.1

func (s *Session) Flush()

Flush flushes all session values

func (*Session) Get added in v0.5.1

func (s *Session) Get(key string) []byte

Get returns a session value

func (*Session) Has added in v0.5.1

func (s *Session) Has(key string) bool

Has checks a value exists

func (*Session) SID added in v0.5.1

func (s *Session) SID() string

SID returns the sid

func (*Session) Set added in v0.5.1

func (s *Session) Set(key string, value []byte)

Set sets a session value

type TLSConfig added in v0.9.0

type TLSConfig struct {
	Port         uint16        `json:"port"`
	CertFile     string        `json:"certFile"`
	KeyFile      string        `json:"keyFile"`
	AutoTLS      AutoTLSConfig `json:"autotls"`
	AutoRedirect bool          `json:"autoRedirect"`
}

TLSConfig contains options to support https.

type Template added in v0.5.8

type Template interface {
	Execute(wr io.Writer, data interface{}) error
}

A Template interface contains the Execute method.

type TypedContent added in v1.0.5

type TypedContent struct {
	Status      int
	Content     []byte
	ContentType string
}

TypedContent replies to the request with a typed content,

func HTML added in v1.0.0

func HTML(content string, status ...int) *TypedContent

HTML replies to the request with a html content.

Directories

Path Synopsis
examples
static command
todos command

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL