spond

Spond

Description

• It is a compact library for standardized communication between the server (in Go) and web clients via JSON responses.
• Solves the problem of unified success/error structures for the API, custom response codes, minimalistic logging, and unified error handling.

Install

go get github.com/Aurivena/[email protected]

Opportunities

• A single JSON response format (success and error)
• Easy expansion of the list of status codes and messages
• Integration with Gin (or any other web framework)
• Built-in thread-safe logger (rotation, color output)
• Minimum dependencies, pure Go-style

Usage example

Work with API-output

import "spond"

sp := spond.NewSpond()
// Success output
sp.SendResponseSuccess(c, spond.Success, map[string]string{"foo": "bar"})
// Error
sp.SendResponseError(c, sp.BuildError(spond.BadRequest, "Error", "incorect data"))

Logger (rotation, color, thread-safe)

import "spond/log"

logger := log.NewLog("log/io.log", 50*1024*1024) // 50 МБ
defer logger.Close()

logger.Info("Test INFO %s", "hello")
logger.Error("Some error: %v", err)

Extension

Append new code output

import "spond/log"

sp := spond.NewSpond()
err := sp.AppendCode(7777, "Мой статус")
if err != nil {
    panic(err)
}

Project Structure

spond/
  ├── log/          # Minimalistic logger (rotation, color, thread-safe)
  ├── response/     # Response structs, status codes, Success/Error types
  └── spond.go      # Core API handler logic

Testing

go test ./...

Unit tests are available for all main features.