Module senders 

Who someone is to you (docs/porch.md, “Who may reach you, and when”): a message’s sender (“Their mail”), and a contact’s card (“Their list”), where they stand and why, and their own choice set or taken back. The lists and their order are sioul_core::porch’s, the states sioul_core::reach’s.

Functions

addresses 🔒

A JSON array of addresses, or one address.

by_id 🔒

What decided, as the window reads it: “address”, “number”, “card”, “category”, “domain”, “prefix”, “let-in”, “book”, “default”.

card 🔒

The card with this file or UID, from every address book.

person_json 🔒

A contact’s list, for its card (“Their list”; key: its file or UID): {who (one of the five states), from (what decided), choice (the card’s own list, “” when none), said (a sentence), own [lines: an address or a number of theirs with a list of its own, which comes before the card’s], choices [{value, label}]: “As their categories say” and the four lists}. “null” for a card no address book holds.

said 🔒

The sentence saying who decided: “Safe, as the category Friends says.”, “Neutral: in your address book, on no list.”, “A stranger: in none of your address books, on no list.”

set_person 🔒

A contact’s list, for all their addresses and numbers (key: the card’s file or UID): their card on one list (“safe”, “neutral”, “restricted”, “blocked”), or (“”) on none, their categories deciding; the own entries of their addresses and numbers taken out. Returns the status line.

set_standing_of 🔒

“Their mail” for every address given: on one list (“safe”, “neutral”, “restricted”, “blocked”) and out of the others, or (“”) out of every list, their card, its categories, else their domain, deciding. Returns the status line.

standing_json 🔒

Where a sender stands, and why, for “Their mail” (addresses: theirs, a JSON array, or one; or a caller’s number, tel:…, judged as calls judge it): {standing (one of the five states), from (what decided), name (the card, category or pattern that decided), own (their first address or number has its own entry), choice (that entry’s list, “” when none), said (a sentence), choices [{value, label}]: “As their categories say” and the four lists with their mail’s times}.

unblock 🔒

An address, a number or a pattern unblocked: out of the blocked list, written neutral when a card, a category or a domain would still block it. Returns the status line.