Skip to main content

Module capture

Module capture 

Source
Expand description

Quick capture: one line typed, a task made. What the line says besides the title is shown as chips before the task is made, so nothing is misread silently (docs/tasks.md).

At the end of the line, in the languages in use (words::CaptureWords; English and French built in), in any order:

  • the day to start: “today”, “tomorrow”, “friday”, “next week”, “in 3 days”, “30/10”, “30 oct”, “2026-10-30” (“aujourd’hui”, “demain”, “vendredi”, “semaine prochaine”, “dans 3 jours”, “30 octobre”);
  • how long: “~15m”, “~1h”, “~1h30”;
  • the date asked, in braces: “{30/10}”, “{vendredi}”;
  • a project or a tag: “#housing”.

Anywhere in the line, “@tomorrow” or “@30/10” gives the day to start, and “@call”, “@write”, “@online”, “@out”, “@read”, “@think”, “@make” (or in French: “@appel”, “@écrire”, “@enligne”, “@dehors”, “@lire”, “@réfléchir”, “@faire”) the task’s kind, as does “@” and the name of a kind you added (“@errand”). Without one, a first word that says it plainly gives it: “Call the bank” is a call, “Remplir le formulaire” a form online. A kind you took away is never given. Words are compared folded: capitals and accents aside (“fevrier”, “Écrire”).

Structs§

Captured
A captured line: the task it makes, and the chips to show.
Chip
Something the line said besides the title.

Functions§

add_days 🔒
None past what a calendar holds (“in 99999999 days”), where Span::days would panic.
capture
Reads one typed line. projects are the project ids a “#word” may name; any other “#word” is a tag (CATEGORIES). kinds are your kinds, id and name; empty, Sioul’s. The words are those in use (words::current).
capture_with
capture, read with these words.
guess_kind 🔒
The kind a first word says plainly (kind_verbs); none for a word that could be several (“ask”, “demander”: a call or a message?).
kind_in 🔒
The kind of Sioul’s (tasks::KINDS) whose words hold word, folded.
month 🔒
A month by one of its names (CaptureWords::months, by number), a dot after it or not.
named_kind 🔒
The kind a word after “@” names: one of Sioul’s (kind_words, in the languages in use) while you keep it; else one of yours, by its id or its name.
next_date 🔒
A day and month without a year: the next one from today.
parse_day
A day, as typed: one to three words, in the languages in use (words::current).
parse_day_with
A day, as typed, read with these words.
parse_minutes
“~15m”, “~1h”, “~1h30”, “~90” → minutes.
said 🔒
Whether a folded word or phrase is one of a list’s, folded, its spaces made one.
weekday 🔒