feedparse

Documentation

Overview

Package feedparse converts raw feed bytes (RSS, Atom, JSON Feed) into ready-to-store model.Entry values. It is a pure-function library with no I/O of its own — fetching is the caller's responsibility.

Index

• func EntryHash(rawURL, title string, publishedAt *int64) string
• type Result
  • func Parse(ctx context.Context, body []byte, sourceURL string) (*Result, error)

Functions

func EntryHash

func EntryHash(rawURL, title string, publishedAt *int64) string

EntryHash is the dedup key used by store.EntryRepo (unique per feed_id):

sha256( normalize(url) + "\n" + title + "\n" + publishedAtRFC3339 )

normalize(url) lowercases scheme+host but leaves path/query untouched, so that "HTTPS://Example.COM/Post" hashes the same as "https://example.com/Post" while "/Post" and "/POST" stay distinct. If publishedAt is nil, the time component is the empty string.

Types

type Result

type Result struct {
	Title       string
	SiteURL     string
	Description string
	Entries     []model.Entry
}

Result is what Parse returns for callers (the polling worker, OPML import, etc.). Entries have Hash, Title, URL, Author, Summary, PublishedAt set; the caller is responsible for filling FeedID, UserID, CreatedAt and inserting.

func Parse

func Parse(ctx context.Context, body []byte, sourceURL string) (*Result, error)

Parse parses RSS, Atom, or JSON Feed bytes. sourceURL is used to resolve relative entry links against the feed's origin.