dutils

README

dutils

Description

Deirrorz Utilities(dutils) is a lightweight Go utility library with commonly used helpers and wrappers for building web services. It includes tools for handling environment variables, JSON responses, JWT tokens, password hashing, and more.

Features

• cfg: Strongly typed config structs with fluent .With... chaining
• crypto: Secure password hashing and comparison with bcrypt
• env: Load .env files and manage environment-specific behavior
• http: Helpers for Go 1.22+ r.PathValue, query parsing, etc.
• jwt: Full JWT token generation, validation, and cookie integration
• logger: Simple slog-based structured logging setup
• json: Standardized JSON response and error writers
• db: Wrapper for sql.DB with extended funcs

Packages

cfg

Typed config structs that can be loaded from environment variables and modified via fluent .With... chaining.

Supported configs:

• cfg.BlobConfig
• cfg.PaymentConfig
• cfg.DBConfig
• cfg.JWTConfig
• cfg.KVConfig
• cfg.MailerConfig
• cfg.OAuthConfig

import "github.com/Deirror/dutils/cfg"

cfg, err := cfg.LoadEnvMailerConfig()
// .With... pattern to override specific fields
cfg.WithHost("smtp.newhost.com").WithPort("465")

env

Helpers for loading environment variables safely.

import "github.com/Deirror/dutils/env"

_ = env.InitEnv(".env") // Load only if not in production
mode, _ := env.GetMode() // "dev" or "prod"

val, err := env.GetEnv("DATABASE_URL")

crypto

Secure password hashing and verification.

import "github.com/Deirror/dutils/crypto"

hash, err := crypto.HashPassword("password123")
err = crypto.ComparePassword(hash, "password123")

http

Simplified helpers for parsing Go 1.22+ path and query values.

import "github.com/Deirror/dutils/http"

id, err := http.QueryInt(r, "id")         // ?id=10 → int
slug := http.PathValue(r, "slug")         // /blog/{slug}

jwt

JWT handling with token signing, validation, and cookie management.

import "github.com/Deirror/dutils/jwt"

jwtHandler := jwt.NewJWT(jwtCfg)

token, err := jwtHandler.GenerateToken("user@example.com")

jwtHandler.SetCookie(w, token)

email, err := jwtHandler.ValidateJWT(tokenFromRequest)

jwt.SetJWTCookie(w, token)  // raw cookie helper
jwt.ClearJWTCookie(w)       // clear cookie

logger

Minimal structured logger using Go's standard slog.

import "github.com/Deirror/dutils/logger"

log := logger.Init("dev") // or "prod"
log.Info("app started", "version", "v1.0.0")

json

Helpers for reading and writing structured JSON in handlers and services.

import "github.com/Deirror/dutils/json"

• Response Writers

err := json.WriteJSON(w, http.StatusOK, myData) // Marshal and write JSON
err := json.SendErrorJSON(w, http.StatusBadRequest, "invalid input") // {"error": "..."}

• Request Parsers

var data MyStruct
err := json.ParseJSONInto(r.Body, &data)

data, err := json.ParseJSON[MyStruct](r.Body) // Generics-based shortcut

• Encoder (manual streams)

err := json.EncodeJSON(w, myStruct) // Stream JSON to any io.Writer

db

A wrapper struct for sql.DB, which has Close and Ping funcs.

db, err := Connect(cfg.Driver, cfg.DSN) // Uses db config
if err != nil {
    return nil, err
}

// Sets parameters to connection pool
db.SetMaxOpenConns(int(cfg.PoolSize))
db.SetMaxIdleConns(int(cfg.MaxIdle))
db.SetConnMaxLifetime(cfg.MaxLifetime)

Installation

go get github.com/Deirror/dutils@latest

Or use a specific version:

go get github.com/Deirror/dutils@v0.1.0

Usage

You can import only the packages you need:

import (
    "github.com/Deirror/dutils/env"
    "github.com/Deirror/dutils/jwt"
)

Contributing

Contributions are welcome 🤝! Please open an issue or pull request