Documentation
¶
Overview ¶
Package feedmanager defines the bookkeeping the import and fetch flows need beyond the Copier's entity writes (adapters.Writer): feed-version dedup/creation, the feed_version_gtfs_import lifecycle, and activation.
It is deliberately domain-shaped, not SQL-shaped — no Sqrl/Get/Select leaks through, and entity writes stay on adapters.Writer.
Index ¶
- type DBFeedManager
- func (m *DBFeedManager) ActivateFeedVersion(ctx context.Context, fvid int) error
- func (m *DBFeedManager) CreateFeedFetch(ctx context.Context, ff *dmfr.FeedFetch) error
- func (m *DBFeedManager) CreateFeedVersion(ctx context.Context, fv *dmfr.FeedVersion) (int, error)
- func (m *DBFeedManager) CreateFeedVersionImport(ctx context.Context, fvi *dmfr.FeedVersionImport) (int, error)
- func (m *DBFeedManager) EntityWriter(fvid int) adapters.Writer
- func (m *DBFeedManager) GetFeed(ctx context.Context, feedID int) (*dmfr.Feed, error)
- func (m *DBFeedManager) GetFeedVersion(ctx context.Context, fvid int) (*dmfr.FeedVersion, error)
- func (m *DBFeedManager) GetFeedVersionBySHA1(ctx context.Context, sha1, sha1dir string) (*dmfr.FeedVersion, error)
- func (m *DBFeedManager) GetFeedVersionImport(ctx context.Context, fvid int) (*dmfr.FeedVersionImport, error)
- func (m *DBFeedManager) OpenReader(ctx context.Context, fv *dmfr.FeedVersion, storage string) (adapters.Reader, error)
- func (m *DBFeedManager) SaveValidationReport(ctx context.Context, fvid int, result *validator.Result, reportStorage string) error
- func (m *DBFeedManager) UpdateFeedVersionImport(ctx context.Context, fvi *dmfr.FeedVersionImport) error
- func (m *DBFeedManager) WithTx(ctx context.Context, fn func(context.Context, FeedManager) error) error
- func (m *DBFeedManager) WriteFeedVersionStats(ctx context.Context, fvid int, fvstats stats.FeedVersionStats) error
- type FeedManager
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type DBFeedManager ¶
type DBFeedManager struct {
// contains filtered or unexported fields
}
DBFeedManager implements FeedManager over a tldb.Adapter — Postgres in production, sqlite in tests. Each method is a transcription of the direct adapter call it replaces in the import (and fetch) flow, so it is behavior-identical to those call sites.
func NewDBFeedManager ¶
func NewDBFeedManager(adapter tldb.Adapter) *DBFeedManager
NewDBFeedManager wraps a tldb.Adapter.
func (*DBFeedManager) ActivateFeedVersion ¶
func (m *DBFeedManager) ActivateFeedVersion(ctx context.Context, fvid int) error
func (*DBFeedManager) CreateFeedFetch ¶
func (*DBFeedManager) CreateFeedVersion ¶
func (m *DBFeedManager) CreateFeedVersion(ctx context.Context, fv *dmfr.FeedVersion) (int, error)
func (*DBFeedManager) CreateFeedVersionImport ¶
func (m *DBFeedManager) CreateFeedVersionImport(ctx context.Context, fvi *dmfr.FeedVersionImport) (int, error)
func (*DBFeedManager) EntityWriter ¶
func (m *DBFeedManager) EntityWriter(fvid int) adapters.Writer
func (*DBFeedManager) GetFeedVersion ¶
func (m *DBFeedManager) GetFeedVersion(ctx context.Context, fvid int) (*dmfr.FeedVersion, error)
func (*DBFeedManager) GetFeedVersionBySHA1 ¶
func (m *DBFeedManager) GetFeedVersionBySHA1(ctx context.Context, sha1, sha1dir string) (*dmfr.FeedVersion, error)
func (*DBFeedManager) GetFeedVersionImport ¶
func (m *DBFeedManager) GetFeedVersionImport(ctx context.Context, fvid int) (*dmfr.FeedVersionImport, error)
func (*DBFeedManager) OpenReader ¶
func (m *DBFeedManager) OpenReader(ctx context.Context, fv *dmfr.FeedVersion, storage string) (adapters.Reader, error)
func (*DBFeedManager) SaveValidationReport ¶
func (*DBFeedManager) UpdateFeedVersionImport ¶
func (m *DBFeedManager) UpdateFeedVersionImport(ctx context.Context, fvi *dmfr.FeedVersionImport) error
func (*DBFeedManager) WithTx ¶
func (m *DBFeedManager) WithTx(ctx context.Context, fn func(context.Context, FeedManager) error) error
func (*DBFeedManager) WriteFeedVersionStats ¶
func (m *DBFeedManager) WriteFeedVersionStats(ctx context.Context, fvid int, fvstats stats.FeedVersionStats) error
type FeedManager ¶
type FeedManager interface {
GetFeedVersion(ctx context.Context, fvid int) (*dmfr.FeedVersion, error)
// Returns (nil, nil) when no import exists yet — absence is not an error.
GetFeedVersionImport(ctx context.Context, fvid int) (*dmfr.FeedVersionImport, error)
// Inserts the import record and sets its new id on fvi.
CreateFeedVersionImport(ctx context.Context, fvi *dmfr.FeedVersionImport) (int, error)
// Writes back an existing import record's result counts / success / log.
UpdateFeedVersionImport(ctx context.Context, fvi *dmfr.FeedVersionImport) error
// Marks the feed version active.
ActivateFeedVersion(ctx context.Context, fvid int) error
// Returns the feed by id — identity + authorization.
GetFeed(ctx context.Context, feedID int) (*dmfr.Feed, error)
// Finds a feed version by content hash for fetch dedup; (nil, nil) when none
// matches.
GetFeedVersionBySHA1(ctx context.Context, sha1, sha1dir string) (*dmfr.FeedVersion, error)
// Creates a feed version and sets its new id on fv.
CreateFeedVersion(ctx context.Context, fv *dmfr.FeedVersion) (int, error)
// Records a fetch attempt (response metadata, success).
CreateFeedFetch(ctx context.Context, ff *dmfr.FeedFetch) error
// Persists the computed feed-version stats (service levels/window, file infos,
// onestop ids).
WriteFeedVersionStats(ctx context.Context, fvid int, fvstats stats.FeedVersionStats) error
// Persists a validation report.
SaveValidationReport(ctx context.Context, fvid int, result *validator.Result, reportStorage string) error
// The sink the Copier writes a feed version's GTFS entities to.
EntityWriter(fvid int) adapters.Writer
// The Copier's source for a feed version's GTFS data, returned unopened.
OpenReader(ctx context.Context, fv *dmfr.FeedVersion, storage string) (adapters.Reader, error)
// Runs fn in a single transaction; a nested WithTx joins the open one rather
// than starting another, so the whole import commits or rolls back together.
WithTx(ctx context.Context, fn func(ctx context.Context, tx FeedManager) error) error
}
FeedManager is the metadata-bookkeeping surface for the import and fetch flows. Mutating methods run inside WithTx when they must commit atomically with the Copier's entity writes.