From 015e0bbd0f43adbd3f220888c9ffac71a176486d Mon Sep 17 00:00:00 2001 From: tgiachi Date: Mon, 9 Nov 2026 14:46:35 +0100 Subject: [PATCH] feat(store): SQLite store for lists and members - Add schema with lists and members tables - Add CreateList, FindList, AddMember, IsMember, Members - Normalize addresses to lowercase --- go.mod | 14 ++++ go.sum | 50 ++++++++++++++ internal/store/store.go | 130 +++++++++++++++++++++++++++++++++++ internal/store/store_test.go | 65 ++++++++++++++++++ 4 files changed, 259 insertions(+) create mode 100644 go.sum create mode 100644 internal/store/store.go create mode 100644 internal/store/store_test.go diff --git a/go.mod b/go.mod index 8ab8343..a0b004f 100644 --- a/go.mod +++ b/go.mod @@ -1,3 +1,17 @@ module codeberg.org/squidd/parsimony go 1.27.1 + +require modernc.org/sqlite v1.62.0 + +require ( + github.com/dustin/go-humanize v1.1.0 // indirect + github.com/google/uuid v1.6.0 // indirect + github.com/mattn/go-isatty v0.0.24 // indirect + github.com/ncruces/go-strftime v1.1.0 // indirect + github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec // indirect + golang.org/x/sys v0.49.0 // indirect + modernc.org/libc v1.80.1 // indirect + modernc.org/mathutil v1.7.1 // indirect + modernc.org/memory v1.12.1 // indirect +) diff --git a/go.sum b/go.sum new file mode 100644 index 0000000..9f88b65 --- /dev/null +++ b/go.sum @@ -0,0 +1,50 @@ +github.com/dustin/go-humanize v1.1.0 h1:dbKTrvD0klcbBV/h4AWJdMuZogJACoMlvWIWZ5b2xWg= +github.com/dustin/go-humanize v1.1.0/go.mod h1:hc1CvRkJMsgxqjmjMQF3QNRAZBwY8AXBAzKYoSX9sFI= +github.com/google/pprof v0.0.0-20261016150608-1facf8f91b50 h1:PlNWJRxu5APSV0pWqfIsZ0qt9OOGHSWfZQ4zvx+WgWs= +github.com/google/pprof v0.0.0-20261016150608-1facf8f91b50/go.mod h1:yUo1AMMpsPIDFGuwDK8nLcf8+vvAd5l2O6JDZ6hpwrM= +github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0= +github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo= +github.com/hashicorp/golang-lru/v2 v2.0.7 h1:a+bsQ5rvGLjzHuww6tVxozPZFVghXaHOwFs4luLUK2k= +github.com/hashicorp/golang-lru/v2 v2.0.7/go.mod h1:QeFd9opnmA6QUJc5vARoKUSoFhyfM2/ZepoAG6RGpeM= +github.com/mattn/go-isatty v0.0.24 h1:tGZZoVgT/KiqK1c8ocVLeDS8BSWMRd47J3Lbz7vsReI= +github.com/mattn/go-isatty v0.0.24/go.mod h1:nMCL3Zebbrt45jsMDgnfIwz6ydEQApk5oEI3HqDio6A= +github.com/ncruces/go-strftime v1.1.0 h1:vtPmPWMkb539RGV9WpWT9EwJGvrOCKvMNI4obWL47Hk= +github.com/ncruces/go-strftime v1.1.0/go.mod h1:yVaq7iwCN09vHRrKBrrflXT0M9tTMG2KmZ9Fj7xeG/g= +github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec h1:W09IVJc94icq4NjY3clb7Lk8O1qJ8BdBEF8z0ibU0rE= +github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec/go.mod h1:qqbHyh8v60DhA7CoWK5oRCqLrMHRGoxYCSS9EjAz6Eo= +golang.org/x/mod v0.42.0 h1:ICeL3t2L30ljSPHHxDnR4fqVcBt/zR2zJAb9juavmQg= +golang.org/x/mod v0.42.0/go.mod h1:u5fzIrRInkL8MaO1cbRkUHT64v303YIT5KEqpNr7jRs= +golang.org/x/sync v0.24.0 h1:iqiDrGoDgyuvAKrhLQthUEzU/R378N78gXbBjxed7oA= +golang.org/x/sync v0.24.0/go.mod h1:sUUOizhqBxiL6pEWpqNLUiaJn1ShEbZ6BBqskPbjZm0= +golang.org/x/sys v0.49.0 h1:XbzkgYJHdqh/8m2Uu0W/dQv8nktxx4BFHp1M0gROTXA= +golang.org/x/sys v0.49.0/go.mod h1:hNLxWAXmnKAxqDtdwIYC4bM9oQPEecfsnNMuSxOs3og= +golang.org/x/tools v0.52.0 h1:ryxg4U63oaUYk7uOLTF37n43f4qgtGvqV4Ioit1BaEs= +golang.org/x/tools v0.52.0/go.mod h1:ItcP5UNaVGG+Yc4eIYmaFLNJ4soEopkx5Y2d4lcEurs= +modernc.org/cc/v4 v4.30.6-0.20261101114202-1b9d1a076f6b h1:WE5SLOURcNd8s6uPR/n4WV4weQxxYKi5OpEZkfNVvdE= +modernc.org/cc/v4 v4.30.6-0.20261101114202-1b9d1a076f6b/go.mod h1:OnovgIhbbMXMu1aISnJ0wvVD1KnW+cAUJkIrAWh+kVI= +modernc.org/ccgo/v4 v4.38.1 h1:wdxJVBuFT8JufZnnQyS6Bbz3NOWhViD0xJOGR96Bpd4= +modernc.org/ccgo/v4 v4.38.1/go.mod h1:kOpEkJRbFwBvjUWwn4j1j9B7iFHbl1+orhgTMCDkDBk= +modernc.org/fileutil v1.4.0 h1:j6ZzNTftVS054gi281TyLjHPp6CPHr2KCxEXjEbD6SM= +modernc.org/fileutil v1.4.0/go.mod h1:EqdKFDxiByqxLk8ozOxObDSfcVOv/54xDs/DUHdvCUU= +modernc.org/gc/v2 v2.6.5 h1:nyqdV8q46KvTpZlsw66kWqwXRHdjIlJOhG6kxiV/9xI= +modernc.org/gc/v2 v2.6.5/go.mod h1:YgIahr1ypgfe7chRuJi2gD7DBQiKSLMPgBQe9oIiito= +modernc.org/gc/v3 v3.2.0 h1:/Y3LGDMQaoYf55PebP1qsZ5FDGgAZyG1RYKEHeQzh1o= +modernc.org/gc/v3 v3.2.0/go.mod h1:HFK/6AGESC7Ex+EZJhJ2Gni6cTaYpSMmU/cT9RmlfYY= +modernc.org/goabi0 v0.2.0 h1:HvEowk7LxcPd0eq6mVOAEMai46V+i7Jrj13t4AzuNks= +modernc.org/goabi0 v0.2.0/go.mod h1:CEFRnnJhKvWT1c1JTI3Avm+tgOWbkOu5oPA8eH8LnMI= +modernc.org/libc v1.80.1 h1:ejn7HtTV3GknNKbklqWQ1nvUrfX8mTxs1D+xp/JQwy4= +modernc.org/libc v1.80.1/go.mod h1:pvo25Rs3OJEbDqhUV9jdEGevxeLJrJeDmNid/AcQV1g= +modernc.org/mathutil v1.7.1 h1:GCZVGXdaN8gTqB1Mf/usp1Y/hSqgI2vAGGP4jZMCxOU= +modernc.org/mathutil v1.7.1/go.mod h1:4p5IwJITfppl0G4sUEDtCr4DthTaT47/N3aT6MhfgJg= +modernc.org/memory v1.12.1 h1:nFMiWrpStgZczNl6XI9GnIk/rWhYIyHGUaR04pGbp9g= +modernc.org/memory v1.12.1/go.mod h1:/JP4VbVC+K5sU2wZi9bHoq2MAkCnrt2r98UGeSK7Mjw= +modernc.org/opt v0.2.0 h1:tGyef5ApycA7FSEOMraay9SaTk5zmbx7Tu+cJs4QKZg= +modernc.org/opt v0.2.0/go.mod h1:03fq9lsNfvkYSfxrfUhZCWPk1lm4cq4N+Bh//bEtgns= +modernc.org/sortutil v1.2.1 h1:+xyoGf15mM3NMlPDnFqrteY07klSFxLElE2PVuWIJ7w= +modernc.org/sortutil v1.2.1/go.mod h1:7ZI3a3REbai7gzCLcotuw9AC4VZVpYMjDzETGsSMqJE= +modernc.org/sqlite v1.62.0 h1:gMaCjSM1qpl+iOjiWhR1LYP3zqrYDI+5GYLGt6veP2g= +modernc.org/sqlite v1.62.0/go.mod h1:Jzjh1mt4s0HuQ0KvtB1LIuHiGRmU2D5pgj8dUhW7/SE= +modernc.org/strutil v1.2.1 h1:UneZBkQA+DX2Rp35KcM69cSsNES9ly8mQWD71HKlOA0= +modernc.org/strutil v1.2.1/go.mod h1:EHkiggD70koQxjVdSBM3JKM7k6L0FbGE5eymy9i3B9A= +modernc.org/token v1.1.0 h1:Xl7Ap9dKaEs5kLoOQeQmPWevfnk/DM5qcLcYlA8ys6Y= +modernc.org/token v1.1.0/go.mod h1:UGzOrNV1mAFSEB63lOFHIpNRUVMvYTc6yu1SMY/XTDM= diff --git a/internal/store/store.go b/internal/store/store.go new file mode 100644 index 0000000..3884cd4 --- /dev/null +++ b/internal/store/store.go @@ -0,0 +1,130 @@ +// Package store persists lists and members in SQLite. +package store + +import ( + "database/sql" + "errors" + "fmt" + "strings" + + _ "modernc.org/sqlite" +) + +// ErrNotFound is returned when a list or member does not exist. +var ErrNotFound = errors.New("not found") + +// List is a mailing list. +type List struct { + ID int64 + Name string // local part, lowercase + Domain string // lowercase + Title string +} + +// Address returns the list posting address. +func (l List) Address() string { return l.Name + "@" + l.Domain } + +// Member is a list subscriber. +type Member struct { + Address string // lowercase + DisplayName string +} + +// Store wraps the SQLite database. +type Store struct{ db *sql.DB } + +const schema = ` +CREATE TABLE IF NOT EXISTS lists ( + id INTEGER PRIMARY KEY AUTOINCREMENT, + name TEXT NOT NULL, + domain TEXT NOT NULL, + title TEXT NOT NULL DEFAULT '', + UNIQUE(name, domain) +); +CREATE TABLE IF NOT EXISTS members ( + list_id INTEGER NOT NULL REFERENCES lists(id) ON DELETE CASCADE, + address TEXT NOT NULL, + display_name TEXT NOT NULL DEFAULT '', + PRIMARY KEY(list_id, address) +);` + +// Open opens (and migrates) the database at path. Use ":memory:" for tests. +func Open(path string) (*Store, error) { + db, err := sql.Open("sqlite", path) + if err != nil { + return nil, err + } + // An in-memory database is per-connection: keep a single one. + db.SetMaxOpenConns(1) + if _, err := db.Exec("PRAGMA foreign_keys=ON; PRAGMA journal_mode=WAL;"); err != nil { + db.Close() + return nil, err + } + if _, err := db.Exec(schema); err != nil { + db.Close() + return nil, fmt.Errorf("migrate: %w", err) + } + return &Store{db: db}, nil +} + +// Close closes the database. +func (s *Store) Close() error { return s.db.Close() } + +// CreateList adds a new list. +func (s *Store) CreateList(name, domain, title string) (List, error) { + l := List{Name: strings.ToLower(name), Domain: strings.ToLower(domain), Title: title} + res, err := s.db.Exec(`INSERT INTO lists(name, domain, title) VALUES(?,?,?)`, l.Name, l.Domain, l.Title) + if err != nil { + return List{}, err + } + l.ID, _ = res.LastInsertId() + return l, nil +} + +// FindList resolves a posting address like "dev@example.org". +func (s *Store) FindList(addr string) (List, error) { + name, domain, ok := strings.Cut(strings.ToLower(strings.TrimSpace(addr)), "@") + if !ok { + return List{}, ErrNotFound + } + var l List + err := s.db.QueryRow(`SELECT id, name, domain, title FROM lists WHERE name=? AND domain=?`, name, domain). + Scan(&l.ID, &l.Name, &l.Domain, &l.Title) + if errors.Is(err, sql.ErrNoRows) { + return List{}, ErrNotFound + } + return l, err +} + +// AddMember subscribes an address to a list (idempotent). +func (s *Store) AddMember(listID int64, addr, displayName string) error { + _, err := s.db.Exec(`INSERT OR REPLACE INTO members(list_id, address, display_name) VALUES(?,?,?)`, + listID, strings.ToLower(strings.TrimSpace(addr)), displayName) + return err +} + +// IsMember reports whether addr is subscribed to the list. +func (s *Store) IsMember(listID int64, addr string) (bool, error) { + var n int + err := s.db.QueryRow(`SELECT COUNT(*) FROM members WHERE list_id=? AND address=?`, + listID, strings.ToLower(strings.TrimSpace(addr))).Scan(&n) + return n > 0, err +} + +// Members returns all subscribers of a list. +func (s *Store) Members(listID int64) ([]Member, error) { + rows, err := s.db.Query(`SELECT address, display_name FROM members WHERE list_id=? ORDER BY address`, listID) + if err != nil { + return nil, err + } + defer rows.Close() + var out []Member + for rows.Next() { + var m Member + if err := rows.Scan(&m.Address, &m.DisplayName); err != nil { + return nil, err + } + out = append(out, m) + } + return out, rows.Err() +} diff --git a/internal/store/store_test.go b/internal/store/store_test.go new file mode 100644 index 0000000..afecaf1 --- /dev/null +++ b/internal/store/store_test.go @@ -0,0 +1,65 @@ +package store + +import ( + "errors" + "testing" +) + +func newTestStore(t *testing.T) *Store { + t.Helper() + s, err := Open(":memory:") + if err != nil { + t.Fatalf("open: %v", err) + } + t.Cleanup(func() { s.Close() }) + return s +} + +func TestCreateAndFindList(t *testing.T) { + s := newTestStore(t) + if _, err := s.CreateList("dev", "example.org", "Dev list"); err != nil { + t.Fatalf("create: %v", err) + } + l, err := s.FindList("dev@example.org") + if err != nil { + t.Fatalf("find: %v", err) + } + if l.Name != "dev" || l.Domain != "example.org" || l.Title != "Dev list" { + t.Fatalf("unexpected list: %+v", l) + } +} + +func TestFindListUnknown(t *testing.T) { + s := newTestStore(t) + if _, err := s.FindList("nope@example.org"); !errors.Is(err, ErrNotFound) { + t.Fatalf("want ErrNotFound, got %v", err) + } +} + +func TestFindListCaseInsensitive(t *testing.T) { + s := newTestStore(t) + s.CreateList("dev", "example.org", "Dev") + if _, err := s.FindList("DEV@Example.ORG"); err != nil { + t.Fatalf("find: %v", err) + } +} + +func TestMembers(t *testing.T) { + s := newTestStore(t) + l, _ := s.CreateList("dev", "example.org", "Dev") + if err := s.AddMember(l.ID, "Alice@Example.com", "Alice"); err != nil { + t.Fatalf("add: %v", err) + } + ok, err := s.IsMember(l.ID, "alice@example.com") + if err != nil || !ok { + t.Fatalf("want member, got %v %v", ok, err) + } + ok, _ = s.IsMember(l.ID, "bob@example.com") + if ok { + t.Fatal("bob should not be a member") + } + ms, err := s.Members(l.ID) + if err != nil || len(ms) != 1 || ms[0].Address != "alice@example.com" { + t.Fatalf("members: %+v %v", ms, err) + } +}