lchub

Documentation

Overview

Package lchub is an offline external-identity enricher: it links a Work to its Library of Congress bf:Hub (id.loc.gov/resources/hubs) by an exact creator+title+language access-point match, from a pre-downloaded index (LC publishes the hubs as a bulk download; no live API on the ingest path). The Hub URI is attached as an owl:sameAs outward link -- the minted `w…` id stays primary.

Matching reuses libcat's own clustering discipline (identity.WorkKey): normalized primary-creator + main-title + language. Language is the corroborating signal that keeps a bare title collision (two different works sharing an author and title) from linking. A Work with no usable access point (no title) is left unlinked, never guessed.

Index

• Constants
• func KeyFor(s ingest.WorkSummary) string
• type Enricher
  • func New(index map[string]string) *Enricher
  • func (e *Enricher) Enrich(ctx context.Context, works []ingest.WorkSummary) ([]ingest.Enrichment, error)
  • func (e *Enricher) Name() string

Constants

const Name = "lchub"

Name is the enricher's registry key and enrichment-graph name.

const Scheme = "lchub"

Scheme labels the emitted external identities.

Functions

func KeyFor

func KeyFor(s ingest.WorkSummary) string

KeyFor is the access-point clustering key a Work is matched by: its primary creator, main title and language, folded through identity.WorkKey. The dump reader keys the index by the SAME function so both sides compare on one form. Returns "" for a Work with no usable title (no access point to match on).

Types

type Enricher

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

Enricher matches Works against a WorkKey -> LC Hub URI index.

func New

func New(index map[string]string) *Enricher

New builds an Enricher over a WorkKey -> Hub URI index (the offline dump's product; the bulk-dump reader is a separate concern, so the matching stays testable without the real download).

func (*Enricher) Enrich

func (e *Enricher) Enrich(ctx context.Context, works []ingest.WorkSummary) ([]ingest.Enrichment, error)

Enrich implements ingest.Enricher: each Work with a title is keyed by its access point and, on an exact index hit, linked to its Hub with owl:sameAs. A title-less Work, or one whose key the index does not carry, is left untouched. Confidence is 1 -- an exact access-point match is not scored. Idempotent via RunEnrich.

func (*Enricher) Name

func (e *Enricher) Name() string

Name implements ingest.Enricher.