Module pim 

Contacts and calendars behind the window.

What you change is written to the folders on disk at once, then the account’s sync sends it, right away when the server answers, later when it does not: nothing waits on the network. Each contacts-and-calendars account syncs in the background every fifteen minutes, and at once after a change here. Deleting waits ten seconds with “Undo”, as in the mail.

Structs

CalendarChoice 🔒

EventView 🔒

InvitationView 🔒

PimState 🔒

What the contacts and agenda pages show: their search and their stretch of days.

Constants

DAV_PAUSE 🔒

Between two syncs of an account’s contacts and calendars, unless something changed here.

Functions

account_of 🔒

The account a contact or event file belongs to, from its folder.

add_account 🔒

Adds a contacts-and-calendars account: finds where they are, tests the password, keeps it in the keyring, and starts syncing. On a thread.

add_google_account 🔒

Adds a Google account, or signs one in again (again: its id): Google’s page opens in your browser, Sioul waits for its answer here (Cancel stops the wait), finds the calendars and contacts, and syncs them. On a thread.

add_sender 🔒

A sender becomes a contact, in the first address book.

answer 🔒

Answers an invitation: “accepted”, “tentative” or “declined”. Accepted or maybe, the event goes into your first calendar; then your answer goes to the organizer, from the account the invitation came to. “add” only adds it (an event published, not asked); “remove” takes a cancelled one out.

books 🔒

The address books a contact can go into: [{id, name}].

calendars 🔒

The calendars an event can go into.

collection_of 🔒

The collection a file is in.

completions 🔒

Addresses to complete what is typed in an address field, as JSON.

contact 🔒

A contact, every field, for its card and its form.

contact_for 🔒

The contact with this address, by file; empty when there is none.

delete_contact 🔒

Deletes a contact, after ten seconds to undo.

delete_event 🔒

Deletes an event, or only this occurrence of a repeating one, after ten seconds to undo.

event 🔒

An event as its form shows it.

find_uid 🔒

The event file with this UID, in any calendar.

google_sentence 🔒

What went wrong while signing in with Google, in your language (its mail’s sign-in too, gmail.rs).

invitation 🔒

The invitation a message carries, as the reader shows it; empty when it carries none.

move_contact 🔒

A contact moved to another address book: written there, then taken out here. When the book would not keep something the card holds, nothing moves until confirmed: returns {"losses": [words]}, else {"key"} or {"error"}.

move_event 🔒

An event moved by a drag in the agenda: its occurrence starting at start now from new_start to new_end (Unix seconds), that time alone or every time (agenda::moved); then sent, the agenda and the plan made again, and “Undo” offered for ten seconds, which writes back what the file held, unless it changed since (a sync, another device). Returns what went wrong, else “”.

nudge 🔒

The account’s background sync runs now.

ours 🔒

A file inside Sioul’s address books and calendars, never elsewhere: no “..”, which starts_with would let through (“contacts/../../.bashrc”).

overlaps 🔒

Two events at once in the next days days, their margins counted, those set aside left out, as JSON: [{key, day, today, first, second}], each event {key, title, from, to} (“09:30”), for the Porch and the agenda.

reported 🔒

What a sync said: the account’s status, conflicts in the status line, the pages again.

save_contact 🔒

Saves the contact form: into its file, or a new one in the first address book; then sent. Returns the contact’s file.

save_event 🔒

Saves the event form: into its file, or a new one in calendar (“account/id”); then sent.

send_answer 🔒

The REPLY to the organizer, through the account the invitation came to.

set_overlap_aside 🔒

An overlap set aside for good; returns what went wrong, else “”.

show_pim 🔒

Computes both pages on a thread and shows them.

start_dav_watcher 🔒

start_dav_watchers 🔒

Starts a background sync for each contacts-and-calendars account that has none.

stop_dav_watcher 🔒

Stops an account’s background sync: it was removed.

with_smtp 🔒

The account with its sending server, found and kept when it had none.