A collection of useful Go packages and mini-libraries for building web applications and services.
A simple assertion library for testing.
import "github.com/josuebrunel/gopkg/assert"
func TestSomething(t *testing.T) {
assert.Eq(t, 1, 1)
}
Reusable UI components built with templ. Includes basic elements like buttons, inputs, forms, and layouts.
A helper package for managing multiple errors, useful for form validation or aggregating errors.
import "github.com/josuebrunel/gopkg/errorsmap"
func validate() error {
errs := errorsmap.New()
errs["username"] = errors.New("invalid username")
if errs.Nil() {
return nil
}
return errs
}
Helper functions for rendering templ components with Echo, managing context, CSRF tokens, and reverse routing.
import "github.com/josuebrunel/gopkg/etr"
func Handler(c echo.Context) error {
return etr.Render(c, http.StatusOK, MyComponent(), data)
}
A wrapper around the PocketBase API, providing a convenient client for interacting with collections, records, and authentication.
import "github.com/josuebrunel/gopkg/pbc"
client := pbc.New("http://127.0.0.1:8090")
resp, err := client.RecordList("posts")
A utility to parse and handle authentication errors, specifically designed for parsing JSON error responses embedded in error strings (e.g., from Supabase or similar services).
Toast notification helpers for Echo applications. Supports setting notifications via Cookies or HTMX HX-Trigger headers.
import "github.com/josuebrunel/gopkg/toast"
func Handler(c echo.Context) error {
toast.NotifySuccess(c, "Operation successful!")
return c.String(http.StatusOK, "OK")
}
A lightweight library for populating struct fields from environment variables.
See xenv/README.md for full documentation.
A wrapper around log/slog that provides structured logging with automatic source file and line number annotation.
import "github.com/josuebrunel/gopkg/xlog"
xlog.Info("Something happened", "key", "value")
Session management middleware and helpers for Echo, backed by alexedwards/scs. Handles user session storage and retrieval.
// Setup middleware
e.Use(xsession.LoadAndSave(sessionManager))
// Get user from context
user := xsession.GetUser(ctx)