feedmanager

package
v1.4.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 5, 2026 License: GPL-3.0 Imports: 11 Imported by: 0

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

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 (m *DBFeedManager) CreateFeedFetch(ctx context.Context, ff *dmfr.FeedFetch) error

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) GetFeed

func (m *DBFeedManager) GetFeed(ctx context.Context, feedID int) (*dmfr.Feed, error)

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 (m *DBFeedManager) SaveValidationReport(ctx context.Context, fvid int, result *validator.Result, reportStorage string) error

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.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL