types

package
v2.2.4 Latest Latest
Warning

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

 Go to latest Published: Sep 29, 2024 License: MIT Imports: 20 Imported by: 16

Documentation

Index

Constants

This section is empty.

Variables

View Source 
var (
	ErrSliceEmpty        = errors.New("slice is empty")
	ErrIndexOutOfBounds  = errors.New("index out of bounds")
	ErrInvalidSliceRange = errors.New("invalid slice range")
)

Define custom error types

Functions

func CorsMiddleware added in v2.0.1 

func CorsMiddleware(options *Cors, ctx *HttpContext, next func(error))

func MiddlewareWrapper 

func MiddlewareWrapper(options *Cors) func(*HttpContext, func(error))

Types

type Callable 

type Callable = func()

type CodeMessage 

type CodeMessage struct {
	Code    int    `json:"code" msgpack:"code"`
	Message string `json:"message,omitempty" msgpack:"message,omitempty"`
}

type Cors 

type Cors struct {
	// Supported types: string, []any, *regexp.Regexp, bool
	Origin any
	// Supported types: string, []string
	Methods any
	// Supported types: nil, string, []string
	AllowedHeaders any
	// Supported types: nil, string, []string
	Headers any
	// Supported types: string, []string
	ExposedHeaders       any
	MaxAge               string
	Credentials          bool
	PreflightContinue    bool
	OptionsSuccessStatus int
}

type ErrorMessage 

type ErrorMessage struct {
	*CodeMessage

	Req     *HttpContext   `json:"req,omitempty" msgpack:"req,omitempty"`
	Context map[string]any `json:"context,omitempty" msgpack:"context,omitempty"`
}

type HttpCompression 

type HttpCompression struct {
	Threshold int `json:"threshold,omitempty" msgpack:"threshold,omitempty"`
}

type HttpContext 

type HttpContext struct {
	events.EventEmitter

	Websocket    *WebSocketConn
	WebTransport *WebTransportConn

	Cleanup Callable

	ResponseHeaders *utils.ParameterBag
	// contains filtered or unexported fields
}

func NewHttpContext 

func NewHttpContext(w http.ResponseWriter, r *http.Request) *HttpContext

func (*HttpContext) Context 

func (c *HttpContext) Context() context.Context

func (*HttpContext) Done 

func (c *HttpContext) Done() <-chan Void

func (*HttpContext) Flush 

func (c *HttpContext) Flush()

func (*HttpContext) Get 

func (c *HttpContext) Get(key string, _default ...string) string

func (*HttpContext) GetHost 

func (c *HttpContext) GetHost() (string, error)

func (*HttpContext) GetMethod 

func (c *HttpContext) GetMethod() string

func (*HttpContext) GetPathInfo 

func (c *HttpContext) GetPathInfo() string

func (*HttpContext) GetStatusCode 

func (c *HttpContext) GetStatusCode() int

func (*HttpContext) Gets 

func (c *HttpContext) Gets(key string, _default ...[]string) []string

func (*HttpContext) Headers 

func (c *HttpContext) Headers() *utils.ParameterBag

func (*HttpContext) IsDone 

func (c *HttpContext) IsDone() bool

func (*HttpContext) Method 

func (c *HttpContext) Method() string

func (*HttpContext) Path 

func (c *HttpContext) Path() string

func (*HttpContext) Query 

func (c *HttpContext) Query() *utils.ParameterBag

func (*HttpContext) Request 

func (c *HttpContext) Request() *http.Request

func (*HttpContext) Response 

func (c *HttpContext) Response() http.ResponseWriter

func (*HttpContext) Secure 

func (c *HttpContext) Secure() bool

func (*HttpContext) SetStatusCode 

func (c *HttpContext) SetStatusCode(statusCode int)

func (*HttpContext) UserAgent 

func (c *HttpContext) UserAgent() string

func (*HttpContext) Write 

func (c *HttpContext) Write(wb []byte) (int, error)

type HttpServer 

type HttpServer struct {
	events.EventEmitter
	*ServeMux
	// contains filtered or unexported fields
}

func CreateServer deprecated 

func CreateServer(defaultHandler http.Handler) *HttpServer

Deprecated: this method will be removed in the next major release, please use NewWebServer instead.

func NewWebServer 

func NewWebServer(defaultHandler http.Handler) *HttpServer

func (*HttpServer) Close 

func (s *HttpServer) Close(fn func(error)) (err error)

func (*HttpServer) Listen 

func (s *HttpServer) Listen(addr string, fn Callable) *http.Server

func (*HttpServer) ListenHTTP3TLS 

func (s *HttpServer) ListenHTTP3TLS(addr string, certFile string, keyFile string, quicConfig *quic.Config, fn Callable) *http3.Server

func (*HttpServer) ListenTLS 

func (s *HttpServer) ListenTLS(addr string, certFile string, keyFile string, fn Callable) *http.Server

func (*HttpServer) ListenWebTransportTLS 

func (s *HttpServer) ListenWebTransportTLS(addr string, certFile string, keyFile string, quicConfig *quic.Config, fn Callable) *webtransport.Server

type Kv 

type Kv struct {
	Key   string
	Value string
}

type Map 

type Map[TKey comparable, TValue any] struct {
	// contains filtered or unexported fields
}

Map is like a Go map[any]any but is safe for concurrent use by multiple goroutines without additional locking or coordination. Loads, stores, and deletes run in amortized constant time.

The Map type is specialized. Most code should use a plain Go map instead, with separate locking or coordination, for better type safety and to make it easier to maintain other invariants along with the map content.

The Map type is optimized for two common use cases: (1) when the entry for a given key is only ever written once but read many times, as in caches that only grow, or (2) when multiple goroutines read, write, and overwrite entries for disjoint sets of keys. In these two cases, use of a Map may significantly reduce lock contention compared to a Go map paired with a separate Mutex or RWMutex.

The zero Map is empty and ready for use. A Map must not be copied after first use.

In the terminology of the Go memory model, Map arranges that a write operation “synchronizes before” any read operation that observes the effect of the write, where read and write operations are defined as follows. Load, LoadAndDelete, LoadOrStore, Swap, CompareAndSwap, and CompareAndDelete are read operations; Delete, LoadAndDelete, Store, and Swap are write operations; LoadOrStore is a write operation when it returns loaded set to false; CompareAndSwap is a write operation when it returns swapped set to true; and CompareAndDelete is a write operation when it returns deleted set to true.

func (*Map[TKey, TValue]) Clear added in v2.0.3 

func (m *Map[TKey, TValue]) Clear()

Clear deletes all the keys.

func (*Map[TKey, TValue]) CompareAndDelete 

func (m *Map[TKey, TValue]) CompareAndDelete(key TKey, old TValue) (deleted bool)

CompareAndDelete deletes the entry for key if its value is equal to old. The old value must be of a comparable type.

If there is no current value for key in the map, CompareAndDelete returns false (even if the old value is the nil interface value).

func (*Map[TKey, TValue]) CompareAndSwap 

func (m *Map[TKey, TValue]) CompareAndSwap(key TKey, old TValue, new TValue) bool

CompareAndSwap swaps the old and new values for key if the value stored in the map is equal to old. The old value must be of a comparable type.

func (*Map[TKey, TValue]) Delete 

func (m *Map[TKey, TValue]) Delete(key TKey)

Delete deletes the value for a key.

func (*Map[TKey, TValue]) Keys 

func (m *Map[TKey, TValue]) Keys() (keys []TKey)

func (*Map[TKey, TValue]) Len 

func (m *Map[TKey, TValue]) Len() (n int)

func (*Map[TKey, TValue]) Load 

func (m *Map[TKey, TValue]) Load(key TKey) (value TValue, ok bool)

Load returns the value stored in the map for a key, or nil if no value is present. The ok result indicates whether value was found in the map.

func (*Map[TKey, TValue]) LoadAndDelete 

func (m *Map[TKey, TValue]) LoadAndDelete(key TKey) (value TValue, loaded bool)

LoadAndDelete deletes the value for a key, returning the previous value if any. The loaded result reports whether the key was present.

func (*Map[TKey, TValue]) LoadOrStore 

func (m *Map[TKey, TValue]) LoadOrStore(key TKey, value TValue) (actual TValue, loaded bool)

LoadOrStore returns the existing value for the key if present. Otherwise, it stores and returns the given value. The loaded result is true if the value was loaded, false if stored.

func (*Map[TKey, TValue]) Range 

func (m *Map[TKey, TValue]) Range(f func(key TKey, value TValue) bool)

Range calls f sequentially for each key and value present in the map. If f returns false, range stops the iteration.

Range does not necessarily correspond to any consistent snapshot of the Map's contents: no key will be visited more than once, but if the value for any key is stored or deleted concurrently (including by f), Range may reflect any mapping for that key from any point during the Range call. Range does not block other methods on the receiver; even f itself may call any method on m.

Range may be O(N) with the number of elements in the map even if f returns false after a constant number of calls.

func (*Map[TKey, TValue]) Store 

func (m *Map[TKey, TValue]) Store(key TKey, value TValue)

Store sets the value for a key.

func (*Map[TKey, TValue]) Swap 

func (m *Map[TKey, TValue]) Swap(key TKey, value TValue) (previous TValue, loaded bool)

Swap swaps the value for a key and returns the previous value if any. The loaded result reports whether the key was present.

func (*Map[TKey, TValue]) Values 

func (m *Map[TKey, TValue]) Values() (values []TValue)

type PerMessageDeflate 

type PerMessageDeflate struct {
	Threshold int `json:"threshold,omitempty" msgpack:"threshold,omitempty"`
}

type ServeMux 

type ServeMux struct {
	DefaultHandler http.Handler // Default Handler
	// contains filtered or unexported fields
}

func NewServeMux 

func NewServeMux(defaultHandler http.Handler) *ServeMux

NewServeMux allocates and returns a new ServeMux.

func (*ServeMux) Handle 

func (mux *ServeMux) Handle(pattern string, handler http.Handler)

Handle registers the handler for the given pattern. If a handler already exists for pattern, Handle panics.

func (*ServeMux) HandleFunc 

func (mux *ServeMux) HandleFunc(pattern string, handler func(http.ResponseWriter, *http.Request))

HandleFunc registers the handler function for the given pattern.

func (*ServeMux) Handler 

func (mux *ServeMux) Handler(r *http.Request) (h http.Handler, pattern string)

Handler returns the handler to use for the given request, consulting r.Method, r.Host, and r.URL.Path. It always returns a non-nil handler. If the path is not in its canonical form, the handler will be an internally-generated handler that redirects to the canonical path. If the host contains a port, it is ignored when matching handlers.

The path and host are used unchanged for CONNECT requests.

Handler also returns the registered pattern that matches the request or, in the case of internally-generated redirects, the pattern that will match after following the redirect.

If there is no registered handler that applies to the request, Handler returns a “page not found” handler and an empty pattern.

func (*ServeMux) ServeHTTP 

func (mux *ServeMux) ServeHTTP(w http.ResponseWriter, r *http.Request)

ServeHTTP dispatches the request to the handler whose pattern most closely matches the request URL.

type Set 

type Set[KType comparable] struct {
	// contains filtered or unexported fields
}

func NewSet 

func NewSet[KType comparable](keys ...KType) *Set[KType]

NewSet creates a new Set and initializes it with the provided keys.

func (*Set[KType]) Add 

func (s *Set[KType]) Add(keys ...KType) bool

Add adds the provided keys to the set.

func (*Set[KType]) All 

func (s *Set[KType]) All() map[KType]Void

All returns a copy of the set's internal map.

func (*Set[KType]) Clear 

func (s *Set[KType]) Clear() bool

Clear removes all items from the set.

func (*Set[KType]) Delete 

func (s *Set[KType]) Delete(keys ...KType) bool

Delete removes the provided keys from the set.

func (*Set[KType]) Has 

func (s *Set[KType]) Has(key KType) bool

Has checks if the set contains the provided key.

func (*Set[KType]) Keys 

func (s *Set[KType]) Keys() []KType

Keys returns a slice containing all keys in the set.

func (*Set[KType]) Len 

func (s *Set[KType]) Len() int

Len returns the number of items in the set.

func (*Set[KType]) MarshalJSON added in v2.2.3 

func (s *Set[KType]) MarshalJSON() ([]byte, error)

MarshalJSON implements the json.Marshaler interface.

func (*Set[KType]) MarshalMsgpack added in v2.2.4 

func (s *Set[KType]) MarshalMsgpack() ([]byte, error)

MarshalMsgpack implements the msgpack.Marshaler interface.

func (*Set[KType]) UnmarshalJSON added in v2.2.3 

func (s *Set[KType]) UnmarshalJSON(data []byte) error

UnmarshalJSON implements the json.Unmarshaler interface.

func (*Set[KType]) UnmarshalMsgpack added in v2.2.4 

func (s *Set[KType]) UnmarshalMsgpack(data []byte) error

UnmarshalMsgpack implements the msgpack.Unmarshaler interface.

type Slice added in v2.1.0 

type Slice[T any] struct {
	// contains filtered or unexported fields
}

Slice is a generic type that holds elements of any type.

func NewSlice added in v2.1.0 

func NewSlice[T any](elements ...T) *Slice[T]

NewSlice creates and returns a new Slice.

func (*Slice[T]) All added in v2.1.0 

func (s *Slice[T]) All() []T

All returns a copy of all the elements in the slice.

func (*Slice[T]) AllAndClear added in v2.1.0 

func (s *Slice[T]) AllAndClear() []T

AllAndClear returns all the elements in the slice and clears the slice.

func (*Slice[T]) Clear added in v2.1.0 

func (s *Slice[T]) Clear()

Clear removes all the elements in the slice.

func (*Slice[T]) DoRead added in v2.1.0 

func (s *Slice[T]) DoRead(op func([]T))

DoRead allows a custom read-only operation on the slice with a read lock.

func (*Slice[T]) DoWrite added in v2.1.0 

func (s *Slice[T]) DoWrite(op func([]T) []T)

DoWrite allows a custom write operation on the slice with a write lock.

func (*Slice[T]) Filter added in v2.1.0 

func (s *Slice[T]) Filter(condition func(T) bool) (filtered []T)

Filter returns a new slice containing all elements that satisfy the provided function.

func (*Slice[T]) FindIndex added in v2.1.0 

func (s *Slice[T]) FindIndex(condition func(T) bool) int

FindIndex returns the index of the first element that satisfies the provided function. If no element satisfies the function, it returns -1.

func (*Slice[T]) Get added in v2.1.0 

func (s *Slice[T]) Get(index int) (element T, err error)

Get returns the element at the specified index, or an error if the index is out of bounds.

func (*Slice[T]) Len added in v2.1.0 

func (s *Slice[T]) Len() int

Len returns the number of elements in the slice.

func (*Slice[T]) Pop added in v2.1.0 

func (s *Slice[T]) Pop() (element T, err error)

Pop removes the last element from the slice and returns it, or an error if the slice is empty.

func (*Slice[T]) Push added in v2.1.0 

func (s *Slice[T]) Push(elements ...T) int

Push adds one or more elements to the end of the slice and returns the new length.

func (*Slice[T]) Range added in v2.1.0 

func (s *Slice[T]) Range(f func(T, int) bool, reverse ...bool)

Range executes the provided function once for each slice element.

func (*Slice[T]) RangeAndSplice added in v2.1.0 

func (s *Slice[T]) RangeAndSplice(f func(T, int) (bool, int, int, []T), reverse ...bool) ([]T, error)

RangeAndSplice executes a function on each slice element and performs splice operations based on the function's return values. reverse is an optional parameter; if provided and true, the iteration will be in reverse order.

func (*Slice[T]) Remove added in v2.1.0 

func (s *Slice[T]) Remove(condition func(T) bool)

Remove removes the first element in the slice that satisfies the conditional function.

func (*Slice[T]) RemoveAll added in v2.1.0 

func (s *Slice[T]) RemoveAll(condition func(T) bool)

RemoveAll removes elements from the slice that satisfy the provided condition function.

func (*Slice[T]) Replace added in v2.1.0 

func (s *Slice[T]) Replace(elements []T)

Replace replaces the slice elements with the given elements.

func (*Slice[T]) Set added in v2.1.0 

func (s *Slice[T]) Set(index int, element T) error

Set sets the element at the specified index, and returns an error if the index is out of bounds.

func (*Slice[T]) Shift added in v2.1.0 

func (s *Slice[T]) Shift() (element T, err error)

Shift removes the first element from the slice and returns it, or an error if the slice is empty.

func (*Slice[T]) Slice added in v2.1.0 

func (s *Slice[T]) Slice(start, end int) ([]T, error)

Slice returns a new slice containing the elements between start and end.

func (*Slice[T]) Splice added in v2.1.0 

func (s *Slice[T]) Splice(start, deleteCount int, insert ...T) ([]T, error)

Splice removes elements from the slice at the specified start index and inserts new elements at that position.

func (*Slice[T]) Unshift added in v2.1.0 

func (s *Slice[T]) Unshift(elements ...T) int

Unshift adds one or more elements to the beginning of the slice and returns the new length.

type Void 

type Void = struct{}
var (
	NULL Void
)

type WebSocketConn 

type WebSocketConn struct {
	events.EventEmitter
	*websocket.Conn
}

func (*WebSocketConn) Close added in v2.1.0 

func (t *WebSocketConn) Close() error

type WebTransportConn added in v2.2.1 

type WebTransportConn struct {
	events.EventEmitter
	*webtransport.Conn
}

func (*WebTransportConn) CloseWithError added in v2.2.1 

func (t *WebTransportConn) CloseWithError(code _webtransport.SessionErrorCode, msg string) error

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.