phastos

Phastos — Go Development Kit

Phastos is a batteries-included Go framework for building production-ready HTTP APIs. It bundles routing (chi/fasthttp), SQL query builder, Redis caching with fallback and singleflight deduplication, OpenTelemetry + NewRelic monitoring, auto-generated OpenAPI 3.0.3 docs, cron scheduler, SSE events, file generators (PDF/CSV/Excel/QR), and multi-platform notifications (Slack/Telegram/FCM) — all wired with sensible defaults.

Installation

go get github.com/kodekoding/phastos/v2

Requires Go 1.26+.

Quick Start

A complete API in one main.go:

package main

import (
	"context"
	"net/http"

	"github.com/kodekoding/phastos/v2/go/api"
	"github.com/kodekoding/phastos/v2/go/cache"
	"github.com/kodekoding/phastos/v2/go/database"
)

type UserController struct {
	api.ControllerImpl
	DB    database.ISQL
	Cache *cache.Store
}

func (c *UserController) GetConfig() api.ControllerConfig {
	return api.ControllerConfig{
		Path: "/users",
		Routes: []api.Route{
			api.NewRoute(http.MethodGet, c.GetList, api.WithPath("/")),
		},
	}
}

func (c *UserController) GetList(req api.Request, ctx context.Context) *api.Response {
	db := c.DB
	cch := c.Cache

	type User struct { ID int `json:"id"`; Name string `json:"name"` }
	var users []User
	err := cch.Get(ctx, "users:list", &users, func(ctx context.Context) (any, int64, error) {
		db.Read(ctx, &database.QueryOpts{
			BaseQuery: "SELECT id, name FROM users ORDER BY name",
			Result:    &users,
			IsList:    true,
		})
		return users, 120, nil // cache for 2 minutes
	})
	if err != nil {
		return api.NewResponse().SetError(api.InternalServerError(err.Error(), "CACHE_ERROR"))
	}

	return api.NewResponse().SetData(users)
}

func main() {
	app := api.NewApp(
		api.WithAppPort(8080),
		api.WithAPITimeout(5),
		api.WithTimezone("Asia/Jakarta"),
		api.WithOpenAPI(),
	)
	app.Init()

	// Connect DB
	sql, _ := database.Connect()
	// Connect cache
	cch := cache.New(cache.WithAddress("localhost:6379"))

	// Add controller
	ctrl := &UserController{
		DB:    sql,
		Cache: cch,
	}
	app.AddController(ctrl)

	app.Start()
}

Key Features

Documentation

• API Framework — Creating apps, controllers, routes, groups, handlers, middleware, OpenAPI
• Database — Connection, Read/Write operations, query builder, transactions
• Cache — Redis operations, fallback pattern, singleflight, hash maps, streams
• Monitoring — OpenTelemetry, NewRelic, composite provider, spans, trace IDs
• Integrations — Cron, SSE, Notifications, Mail, Slack Socket
• Utilities — File generators, GCS storage, importer, auth middleware, helpers
• Configuration — Environment variables and Options reference

License

MIT