feedkit: split the former maximumdirect.net/weatherd project in two.

feedkit now contains a reusable core, while weatherfeeder is a concrete implementation that includes weather-specific functions.

sources/registry.go

@@ -0,0 +1,49 @@
+package sources
+
+import (
+	"fmt"
+	"strings"
+
+	"gitea.maximumdirect.net/ejr/feedkit/config"
+)
+
+// Factory constructs a configured Source instance from config.
+//
+// This is how concrete daemons (weatherfeeder/newsfeeder/...) register their
+// domain-specific source drivers (Open-Meteo, NWS, RSS, etc.) while feedkit
+// remains domain-agnostic.
+type Factory func(cfg config.SourceConfig) (Source, error)
+
+type Registry struct {
+	byDriver map[string]Factory
+}
+
+func NewRegistry() *Registry {
+	return &Registry{byDriver: map[string]Factory{}}
+}
+
+// Register associates a driver name (e.g. "openmeteo_observation") with a factory.
+//
+// The driver string is the "lookup key" used by config.sources[].driver.
+func (r *Registry) Register(driver string, f Factory) {
+	driver = strings.TrimSpace(driver)
+	if driver == "" {
+		// Panic is appropriate here: registering an empty driver is always a programmer error,
+		// and it will lead to extremely confusing runtime behavior if allowed.
+		panic("sources.Registry.Register: driver cannot be empty")
+	}
+	if f == nil {
+		panic(fmt.Sprintf("sources.Registry.Register: factory cannot be nil (driver=%q)", driver))
+	}
+
+	r.byDriver[driver] = f
+}
+
+// Build constructs a Source from a SourceConfig by looking up cfg.Driver.
+func (r *Registry) Build(cfg config.SourceConfig) (Source, error) {
+	f, ok := r.byDriver[cfg.Driver]
+	if !ok {
+		return nil, fmt.Errorf("unknown source driver: %q", cfg.Driver)
+	}
+	return f(cfg)
+}

sources/source.go

@@ -0,0 +1,30 @@
+package sources
+
+import (
+	"context"
+
+	"gitea.maximumdirect.net/ejr/feedkit/event"
+)
+
+// Source is a configured polling job that emits 0..N events per poll.
+//
+// Source implementations live in domain modules (weatherfeeder/newsfeeder/...)
+// and are registered into a feedkit sources.Registry.
+//
+// feedkit infrastructure treats Source as opaque; it just calls Poll()
+// on the configured cadence and publishes the resulting events.
+type Source interface {
+	// Name is the configured source name (used for logs and included in emitted events).
+	Name() string
+
+	// Kind is the "primary kind" emitted by this source.
+	//
+	// This is mainly useful as a *safety check* (e.g. config says kind=forecast but
+	// driver emits observation). Some future sources may emit multiple kinds; if/when
+	// that happens, we can evolve this interface (e.g., make Kind optional, or remove it).
+	Kind() event.Kind
+
+	// Poll fetches from upstream and returns 0..N events.
+	// Implementations should honor ctx.Done() for network calls and other I/O.
+	Poll(ctx context.Context) ([]event.Event, error)
+}