Module favicon 

A site’s own icon, for the list of sites (docs/sites.md, “The list”): asked of the site itself, never of an icon service that would learn which sites you keep. Its page is read for the icon it names (<link rel="icon">, the larger the better), else /favicon.ico; the icon is kept in the cache folder, by host, and asked again after a week.

Constants

AGENT 🔒

FRESH

Asked again after this long.

LARGEST 🔒

Larger than this is no icon.

Functions

agent 🔒

HTTPS only, redirects included: a page cannot send Sioul to a plain address, where anyone on the network sees which sites you keep, nor to a device of your network (a router’s page has no certificate to show).

attribute 🔒

One attribute of a tag’s text: rel="icon", href='/i.png', sizes=32x32.

cached

Where a site’s icon is kept: <dir>/<host>.<png|ico|svg|…>, if it is.

download 🔒

fetch

The icon of the site at url, asked of the site and kept in dir; its file.

join 🔒

href read from the page at base.

kind_of 🔒

What an icon’s bytes are, by their first bytes: its file extension; None for no image.

named_icons 🔒

The icons a page names, best first: by declared size (up to 256), PNG first; SVG last, as some draw nothing outside a browser.

page 🔒

The page’s address after its redirects, and its HTML (its first 2 MB).

safe 🔒

stale

Whether the icon kept for host is missing or older than a week.