Module backend 

The object behind the window.

It hands QML the core’s views as JSON (sioul_core::view), already in your language, and runs everything slow on background threads: fetching mail, finding servers, testing logins. Results come back to Qt’s thread through qt_thread().queue. Each mail account has a watcher that keeps its inbox open with IDLE, so a verified code becomes a notification within seconds.

Modules

qobject

Structs

FoundView 🔒

The settings found, as the form shows them.

Job 🔒

A page computed on a thread, one computation at a time: asked again while one runs, it runs once more after it, with everything changed meanwhile. Fetches and changes ask often; a thread each would pile up on a slow disk.

Shared 🔒

What the background threads and the window share.

SioulRust

Views 🔒

Everything the window shows, computed off Qt’s thread.

World 🔒

What the Porch and the budgets read: the configuration and its lists.

Enums

Afterwards 🔒

What happens to an attachment once the antivirus found it clean. One the desktop would run rather than show (links::is_program: programs, scripts, shortcuts, installers, disk images) is only saved.

Constants

REPLAN_EVERY 🔒

The plan is made again every twelve hours, and when the day changes: a task not done by its planned day moves on, and what waits for it follows.

SAID_FOR 🔒

How long what you did stays in the status line before routine news.

WEATHER_FRESH 🔒

A forecast is kept half an hour.

Statics

AWAY 🔒

Sioul put away on a phone: the pages are not computed for nobody (Android stops an app that works in the background); each job asked meanwhile runs once when it is back (back_here).

Functions

add_mail 🔒

A mail account added: tested with its password (given, or, None, the one its address’s calendars and contacts use), then kept; its watcher started.

attachment_cache 🔒

Where attachments are written to be opened: <cache>/sioul/attachments/<message>/.

call_Sioul_signal_handler_accountAdded 🔒

call_Sioul_signal_handler_accountPasswordDone 🔒

call_Sioul_signal_handler_accountsChanged 🔒

call_Sioul_signal_handler_agendaChanged 🔒

call_Sioul_signal_handler_awayChanged 🔒

call_Sioul_signal_handler_bitwardenAnswered 🔒

call_Sioul_signal_handler_bitwardenFound 🔒

call_Sioul_signal_handler_blockedChanged 🔒

call_Sioul_signal_handler_budgetsChanged 🔒

call_Sioul_signal_handler_busyChanged 🔒

call_Sioul_signal_handler_composeRequested 🔒

call_Sioul_signal_handler_contactsChanged 🔒

call_Sioul_signal_handler_copyRequested 🔒

call_Sioul_signal_handler_draftFilesArrived 🔒

call_Sioul_signal_handler_draftsChanged 🔒

call_Sioul_signal_handler_duplicatesChanged 🔒

call_Sioul_signal_handler_focusSessionChanged 🔒

call_Sioul_signal_handler_forecastChanged 🔒

call_Sioul_signal_handler_formBusyChanged 🔒

call_Sioul_signal_handler_formErrorChanged 🔒

call_Sioul_signal_handler_foundChanged 🔒

call_Sioul_signal_handler_healthViewChanged 🔒

call_Sioul_signal_handler_keysChanged 🔒

call_Sioul_signal_handler_lettersChanged 🔒

call_Sioul_signal_handler_linksChanged 🔒

call_Sioul_signal_handler_mailAccountsChanged 🔒

call_Sioul_signal_handler_mailFiltersFound 🔒

call_Sioul_signal_handler_mailFolderChanged 🔒

call_Sioul_signal_handler_mailSearchChanged 🔒

call_Sioul_signal_handler_messageRead 🔒

call_Sioul_signal_handler_missedViewChanged 🔒

call_Sioul_signal_handler_modeChanged 🔒

call_Sioul_signal_handler_needsViewChanged 🔒

call_Sioul_signal_handler_notesChanged 🔒

call_Sioul_signal_handler_openUrl 🔒

call_Sioul_signal_handler_overlapsChanged 🔒

call_Sioul_signal_handler_paperKept 🔒

call_Sioul_signal_handler_phoneAccountChosen 🔒

call_Sioul_signal_handler_placesChanged 🔒

call_Sioul_signal_handler_placesFoundChanged 🔒

call_Sioul_signal_handler_porchChanged 🔒

call_Sioul_signal_handler_readingChanged 🔒

call_Sioul_signal_handler_realtimeChanged 🔒

call_Sioul_signal_handler_reminderOpened 🔒

call_Sioul_signal_handler_scanUnavailable 🔒

call_Sioul_signal_handler_scoutedChanged 🔒

call_Sioul_signal_handler_scoutingChanged 🔒

call_Sioul_signal_handler_securityKeyChanged 🔒

call_Sioul_signal_handler_shareEstimated 🔒

call_Sioul_signal_handler_shareListed 🔒

call_Sioul_signal_handler_sharePutBackDone 🔒

call_Sioul_signal_handler_shareStarted 🔒

call_Sioul_signal_handler_sharedIn 🔒

call_Sioul_signal_handler_sitesChanged 🔒

call_Sioul_signal_handler_spamChanged 🔒

call_Sioul_signal_handler_statusChanged 🔒

call_Sioul_signal_handler_taskDone 🔒

call_Sioul_signal_handler_tasksChanged 🔒

call_Sioul_signal_handler_undoLineChanged 🔒

checked_attachment 🔒

Writes an attachment to the cache, has the antivirus check it, then opens or saves it; a threat, or no antivirus, and the copy is deleted. On a phone, which has no antivirus Sioul can call, nothing is scanned and nothing claims it: the attachment opens in the app you choose, or Android asks where to save it (attachments).

coalesced 🔒

Runs work on a thread for the job which picks out (see Job).

compute 🔒

config_path 🔒

downloads 🔒

The downloads folder the desktop names.

end_work_now 🔒

Work time or quiet time, as the window shows it. “Work now” taken back, as Sioul starts or closes; the rest of the overrides kept.

file_url 🔒

A file’s address for Qt and the desktop: “file:///home/me/A%20b.pdf”, and “file:///C:/Users/me/A%20b.pdf” on Windows; what an address cannot hold as is (“#”, “?”, spaces, accents) percent-encoded, so the file itself is reached.

forget_opened_attachments 🔒

Attachments written to be opened in an earlier session, taken out of the cache once a day old: a decrypted one would stay readable there otherwise.

free_path 🔒

name, else “name (2).ext”, “name (3).ext”… so nothing is overwritten.

give_password 🔒

An account’s password given on this device: tested with its server (its mail, or its calendars and contacts), kept in the keyring, its sync started again; account_password_done says how it went.

json 🔒

learn 🔒

Learns the provider’s authserv-id once per session, while it is unknown.

load_config 🔒

local_path 🔒

The file a file:// address names (from a file dialog, a drop), its percent-escapes undone; “file:///C:/…” is “C:\…” on Windows. Anything else is a path already.

mark_from_mail 🔒

A file come by mail marked as the system marks what comes from the Internet: the Mark of the Web on Windows, the quarantine on macOS. Office then opens it in Protected View, Gatekeeper checks it. A disk that cannot keep the mark leaves the file as it is.

message_json 🔒

A message laid out for reading, as JSON (view::MessageView); empty if it cannot be read. Read on a thread of its own (read_message).

mode_json 🔒

mode_now 🔒

The time now: what it is for, and until when (docs/areas.md; hours).

notify_codes 🔒

One quiet notification per verified code among new mail, with a copy button.

offline 🔒

Whether Sioul stays off the network: SIOUL_DEMO set, for a demo profile and its pictures. Nothing is fetched or sent by itself; what is kept on this computer is shown.

one_at_a_time 🔒

The lock of something done one at a time, when nothing holds it; a panic in an earlier run (bad data in a file) does not stop it for the session.

one_file_name 🔒

An attachment’s name as one file in a folder. The core takes any path out of it; Windows also reads “C:x” as a drive, “a:b” as a hidden stream and “CON”, “NUL”… as devices: those characters become “_”, those names get one in front, and the dots and spaces it would drop at the end go.

pace_of 🔒

The pace of an address: its own, else everyone’s.

read_shielded 🔒

A shielded address that allows the AI: what it has not read yet, read now, before the Porch shows it again. Nothing is sent without a key.

reading_json 🔒

How long text reads, for the window’s theme; and whether the places show their names.

reported 🔒

What a watcher said: the account’s status, the provider’s id to learn, notifications for new codes, and the views again.

retie_project 🔒

A project’s routes changed: the mail already here that only its text or an attachment ties to it, tied now, on a thread (routes on the sender and the subject are matched again each time the project shows). Each message as the Porch takes it (porch::Gate): never one it sets aside (a blocked sender, forged, a borrowed name, spam a route does not protect).

say 🔒

session_language 🔒

The session’s language: its variables (LC_ALL, LC_MESSAGES, LANG) when it has them, as on Linux; else the system’s own setting, as Qt reads it on Windows and macOS, where a window started from the desktop gets none.

set_status 🔒

show 🔒

Computes the views on a thread and shows them, unless newer ones came first.

sort_on_server 🔒

After a fetch of account (new: its inbox’s arrivals, maybe none), on a thread of its own (it reaches the server; this is the watcher’s): what your own spam filter moves, as you chose, into the Junk folder; then your mail filters (docs/client.md, “Filters”), on the arrivals still unread and what waits for another look, never on what the spam filter reviews. What a filter could not act on is told as new mail, and why said in the status line; the Porch is read again when something moved.

start_new_watchers 🔒

Syncs for the accounts not started yet this session: those another device’s settings just brought. One that stopped (a password refused) is not tried again here: retries can lock an account.

start_watcher 🔒

start_watchers 🔒

Starts a watcher for every mail account that has none running.

system_locale 🔒

Elsewhere the session’s variables say it all.

tell 🔒

Says what became of something you did; it stays a while (SAID_FOR).

tie_to_projects 🔒

Mail just fetched that a project takes, by its routes or its conversation: tied to the project, so its page shows it whatever its routes need, and the replies that come later follow it.

tr 🔒

One translator for the session: the configuration’s language, else the session’s.

update_paces 🔒

Gives every running watcher its pace from the configuration, and real time.

update_weather 🔒

The weather applet, from the forecast kept, fetched again when it is half an hour old; nothing without a place.

want_password 🔒

Notes whether an account’s password is wanted after what its sync said: none here, or refused. Its card then offers to give one.

weather_cache 🔒

Where the forecast is kept between fetches (the phone’s card reads it too, homecard).

Type Aliases

QtThread 🔒