libFiber

package
v0.28.1 Latest Latest
Warning

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

Go to latest
Published: Aug 11, 2026 License: MIT Imports: 13 Imported by: 0

Documentation

Overview

Package libFiber provides a Fiber web framework adapter for requestCore.

Index

Constants

View Source
const FiberCtxKey = "fiber.Ctx"

FiberCtxKey is the user-value key used to store the Fiber context in fasthttp.

Variables

This section is empty.

Functions

func AddSpanAttribute added in v0.18.0

func AddSpanAttribute(c *fiber.Ctx, key, value string)

AddSpanAttribute adds an attribute to the current span in Fiber context

func AddSpanAttributes added in v0.18.0

func AddSpanAttributes(c *fiber.Ctx, attrs map[string]string)

AddSpanAttributes adds multiple attributes to the current span

func AddSpanEvent added in v0.18.0

func AddSpanEvent(c *fiber.Ctx, name string, attrs map[string]string)

AddSpanEvent adds an event to the current span

func CustomTracingMiddleware added in v0.18.0

func CustomTracingMiddleware(_ *libTracing.TracingManager) fiber.Handler

CustomTracingMiddleware creates a custom Fiber middleware with more control

func ErrorHandler

func ErrorHandler(path, title string, handler ContextInitiator) fiber.ErrorHandler

ErrorHandler returns a Fiber error handler that maps errors to appropriate HTTP responses.

func ExtendMap

func ExtendMap(mp map[string]string) map[string][]string

ExtendMap converts a map[string]string to a map[string][]string for header compatibility.

func Fiber

func Fiber(handler any) func(c *fiber.Ctx) error

Fiber wraps a handler function into a Fiber handler that stores the context and invokes the handler.

func GetSpanFromContext added in v0.18.0

func GetSpanFromContext(c *fiber.Ctx) trace.Span

GetSpanFromContext gets the span from Fiber context

func RecordSpanError added in v0.18.0

func RecordSpanError(c *fiber.Ctx, err error, attrs map[string]string)

RecordSpanError records an error in the current span

func TracingMiddleware added in v0.18.0

func TracingMiddleware() fiber.Handler

TracingMiddleware creates Fiber middleware for OpenTelemetry tracing using official otelfiber

Types

type ContextInitiator added in v0.7.2

type ContextInitiator interface {
	InitContext(c *fiber.Ctx) webFramework.WebFramework
	Respond(int, int, string, any, bool, webFramework.WebFramework)
}

ContextInitiator defines the interface for initializing a web framework context and responding in Fiber.

type FiberParser

type FiberParser struct {
	Ctx *fiber.Ctx
}

FiberParser implements the webFramework.RequestParser interface for Fiber.

func InitContext

func InitContext(c *fiber.Ctx) FiberParser

InitContext creates a FiberParser from the given Fiber context.

func (FiberParser) Abort added in v0.7.0

func (c FiberParser) Abort() error

Abort stops the middleware chain by sending the current response status.

func (FiberParser) AddCustomAttributes added in v0.13.2

func (c FiberParser) AddCustomAttributes(attr slog.Attr)

AddCustomAttributes adds a custom slog attribute to the Fiber context.

func (FiberParser) AddSpanAttribute added in v0.18.0

func (c FiberParser) AddSpanAttribute(key, value string)

AddSpanAttribute adds a single string attribute to the current tracing span.

func (FiberParser) AddSpanAttributes added in v0.18.0

func (c FiberParser) AddSpanAttributes(attrs map[string]string)

AddSpanAttributes adds multiple string attributes to the current tracing span.

func (FiberParser) AddSpanEvent added in v0.18.0

func (c FiberParser) AddSpanEvent(name string, attrs map[string]string)

AddSpanEvent adds an event with attributes to the current tracing span.

func (FiberParser) CheckURLParam added in v0.28.1

func (c FiberParser) CheckURLParam(name string) (string, bool)

CheckURLParam returns a URL path parameter by name and whether it exists.

func (FiberParser) FileAttachment added in v0.10.4

func (c FiberParser) FileAttachment(path, fileName string)

FileAttachment sends a file as an HTTP attachment with the given filename.

func (FiberParser) FormValue added in v0.10.1

func (c FiberParser) FormValue(name string) string

FormValue returns the form value for the given field name.

func (FiberParser) GetArgs

func (c FiberParser) GetArgs(args ...any) map[string]string

GetArgs returns a map of common request arguments including user, app, action, and path.

func (FiberParser) GetBody

func (c FiberParser) GetBody(target any) error

GetBody parses the request body into the target struct.

func (FiberParser) GetContext added in v0.22.0

func (c FiberParser) GetContext() context.Context

GetContext returns the context from the Fiber context

func (FiberParser) GetHTTPHeader added in v0.28.1

func (c FiberParser) GetHTTPHeader() http.Header

GetHTTPHeader returns the full HTTP header map from the Fiber request.

func (FiberParser) GetHeader

func (c FiberParser) GetHeader(target webFramework.HeaderInterface) error

GetHeader parses request headers into the target struct.

func (FiberParser) GetHeaderValue

func (c FiberParser) GetHeaderValue(name string) string

GetHeaderValue returns a single request header value by name.

func (FiberParser) GetLocal

func (c FiberParser) GetLocal(name string) any

GetLocal returns a value stored in Fiber locals by name.

func (FiberParser) GetLocalString

func (c FiberParser) GetLocalString(name string) string

GetLocalString returns a string value stored in Fiber locals by name.

func (FiberParser) GetMethod

func (c FiberParser) GetMethod() string

GetMethod returns the HTTP method of the Fiber request.

func (FiberParser) GetPath

func (c FiberParser) GetPath() string

GetPath returns the original URL path of the Fiber request.

func (FiberParser) GetRawURLQuery added in v0.28.1

func (c FiberParser) GetRawURLQuery() string

GetRawURLQuery returns the raw query string from the Fiber request.

func (FiberParser) GetTraceContext added in v0.18.0

func (c FiberParser) GetTraceContext() trace.SpanContext

GetTraceContext returns the trace span context from the Fiber user context.

func (FiberParser) GetURI added in v0.28.1

func (c FiberParser) GetURI(target any) error

GetURI parses URL path parameters into the target struct.

func (FiberParser) GetURLParam added in v0.28.1

func (c FiberParser) GetURLParam(name string) string

GetURLParam returns a single URL path parameter by name.

func (FiberParser) GetURLParams added in v0.28.1

func (c FiberParser) GetURLParams() map[string]string

GetURLParams returns all URL path parameters as a map.

func (FiberParser) GetURLQuery added in v0.28.1

func (c FiberParser) GetURLQuery(target any) error

GetURLQuery parses URL query parameters into the target struct.

func (FiberParser) Next added in v0.7.0

func (c FiberParser) Next() error

Next advances to the next middleware in the Fiber chain.

func (FiberParser) ParseCommand

func (c FiberParser) ParseCommand(command, title string, request webFramework.RecordData, parser webFramework.FieldParser) string

ParseCommand parses a DML command template using local values and the provided request data.

func (FiberParser) RecordSpanError added in v0.18.0

func (c FiberParser) RecordSpanError(err error, attrs map[string]string)

RecordSpanError records an error with attributes on the current tracing span.

func (FiberParser) SaveFile added in v0.10.1

func (c FiberParser) SaveFile(
	formTagName, path string,
) error

SaveFile saves an uploaded file from the given form tag to the specified path.

func (FiberParser) SendJSONRespBody added in v0.7.0

func (c FiberParser) SendJSONRespBody(status int, resp any) error

SendJSONRespBody writes a JSON response with the given HTTP status code.

func (FiberParser) SetContext added in v0.22.0

func (c FiberParser) SetContext(ctx context.Context)

SetContext updates the context in the Fiber context

func (FiberParser) SetLocal

func (c FiberParser) SetLocal(name string, value any)

SetLocal stores a value in Fiber locals by name.

func (FiberParser) SetReqHeader added in v0.7.5

func (c FiberParser) SetReqHeader(name string, value string)

SetReqHeader sets a request header value by name.

func (FiberParser) SetRespHeader added in v0.10.28

func (c FiberParser) SetRespHeader(name string, value string)

SetRespHeader sets a response header value by name.

func (FiberParser) SetTraceContext added in v0.18.0

func (c FiberParser) SetTraceContext(_ trace.SpanContext)

SetTraceContext sets the trace span context (no-op for Fiber).

func (FiberParser) StartSpan added in v0.18.0

func (c FiberParser) StartSpan(_ string, _ ...trace.SpanStartOption) (context.Context, trace.Span)

StartSpan starts a new tracing span from the Fiber user context.

Directories

Path Synopsis
Package logger provides Fiber middleware logging integration.
Package logger provides Fiber middleware logging integration.

Jump to

Keyboard shortcuts

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