catalog

package

v0.25.0 Latest Latest Go to latest Published: Oct 30, 2026 License: AGPL-3.0 Imports: 10 Imported by: 0

Details

Package catalog lists the sources Arnakoff syncs, how often, and the hosts they reach: the one list the sync and API processes are built from.

This section is empty.

View Source

var ErrOffline = errors.New("this process downloads nothing")

ErrOffline is returned by Offline.Get.

func Blacklists(opts Options, snaps listing.Snapshots) []app.Blacklist

Blacklists returns the blacklists opts turns on, each read from the snapshot of its source in snaps, for app.Registries.

func Hosts(opts Options) []string

Hosts returns, once each, the hosts the sources opts turns on reach, for the allowlist of the HTTP client New takes.

type Catalog struct {
	// contains filtered or unexported fields
}

Catalog is the list of the sources turned on, in a stable order.

func New(client Getter, opts Options) *Catalog

New returns the catalog of the sources opts turns on, downloading through client.

func (c *Catalog) Fetchers() []app.SourceFetcher

Fetchers returns the fetcher of each source, for app.NewSync.

func (c *Catalog) Plans() []app.Plan

Plans returns how often each source is synced, for app.NewScheduler.

type Getter interface {
	Get(ctx context.Context, rawURL string) ([]byte, error)
}

Getter fetches a URL; *httpclient.Client is one.

type Offline struct{}

Offline is the Getter of a process that only restores snapshots, such as the API: it refuses every download.

func (Offline) Get(context.Context, string) ([]byte, error)

Get returns ErrOffline.

type Options struct {
	// ACPR turns the ACPR blacklist on, once its reuse licence is obtained.
	ACPR bool
}

Options are the sources the configuration turns on beyond the default ones.