goreus

Repositori ini berisi kumpulan paket Go yang dapat digunakan untuk kebutuhan pembuatan aplikasi. Paket yang tersedia mencakup:

• pkg/cache — cache dalam-proses (concurrent-safe) dengan TTL dan LRU
• pkg/storage — driver penyimpanan (S3/R2/local/null) dengan dukungan streaming
• pkg/mail — pengirim email minimal (SMTP/SES/null) dengan pembangun MIME
• pkg/templates — manajer template dengan helpers, caching, dan metrik
• pkg/jsonull — tipe nullable generik untuk JSON dengan logika tiga-state

Setiap paket dirancang agar kecil, berfokus pada satu tujuan, dan mudah diintegrasikan.

Paket

• Cache: in-memory generic cache dengan TTL dan LRU
• Storage: driver penyimpanan pluggable (S3/R2/local/null) dengan dukungan streaming
• Mail: pengirim email (SMTP/SES/null) + pembangun MIME
• Templates: template HTML/plaintext dengan helpers dan metrik
• JsonNull: tipe nullable generik untuk JSON dengan logika tiga-state (not present, null, value)

Instalasi

Memerlukan Go 1.23+.

go get github.com/atfromhome/goreus@latest

Impor paket sesuai kebutuhan:

import (
  "github.com/atfromhome/goreus/pkg/cache"
  "github.com/atfromhome/goreus/pkg/storage"
  "github.com/atfromhome/goreus/pkg/mail"
  "github.com/atfromhome/goreus/pkg/templates"
  "github.com/atfromhome/goreus/pkg/jsonull"
)

Penggunaan Cepat

• Cache

c := cache.NewInMemoryCache[string, string](10_000, 5*time.Minute)
c.Set(context.Background(), "greeting", "hello")
v, ok := c.Get(context.Background(), "greeting")
_ = c.Close()
_ = v; _ = ok

• Storage

st, _ := storage.New(context.Background(), &storage.Config{Driver: "null"})
path, _ := st.Upload(context.Background(), "demo/hello.txt", []byte("hello"))
data, _ := st.Get(context.Background(), path)
_ = data

• Mail

m := mail.NewNullMailer()
_ = m.Send(context.Background(), &mail.Message{
  To:        []string{"user@example.com"},
  Subject:   "Halo",
  PlainText: "Hai di sana!",
})

• Templates

//go:embed all:templates
var tmplFS embed.FS

mgr, _ := templates.New(templates.Config{
  FS:           tmplFS,
  TemplatesDir: "templates",
})
tmpl, _ := mgr.LoadHTML("emails/welcome.html", "layouts/base.html")
out, _ := mgr.RenderHTML(tmpl, "welcome.html", map[string]any{"Name": "Alice"})
_ = out

• JsonNull

type User struct {
  Name  string                    `json:"name"`
  Email jsonull.JsonNull[string]  `json:"email,omitempty"`
}

// Field dengan nilai
json.Unmarshal([]byte(`{"name":"John","email":"john@example.com"}`), &user)
user.Email.IsSet() // true, user.Email.Value = "john@example.com"

// Field bernilai null
json.Unmarshal([]byte(`{"name":"Jane","email":null}`), &user)
user.Email.IsNull() // true

// Field tidak ada
json.Unmarshal([]byte(`{"name":"Bob"}`), &user)
user.Email.Present // false

Pengembangan

• Jalankan seluruh pengujian:

go test ./...