pimutils/khal

Feature Request: Formatter for the recurrence of a recurring meeting

Open

#1165 opened on Jul 10, 2022

View on GitHub
 (2 comments) (0 reactions) (0 assignees)Python (2,349 stars) (191 forks)batch import
beginner friendlyhelp wantedtype: enhancement

Description

I would like to be able to see what the recurrence is for a recurring meeting, particularly on import. As the event display is controlled by a --format or equivalent configuration, I would propose having a {repeat} or {repeat-details} format option, even if that means it is just a dump of the "raw" RRULE as the first pass.

Contributor guide

Tech stack
python
Domain
cli
Issue type
feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
half day
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
fresh
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
Python programmingBasic understanding of iCalendar RRULEFamiliarity with khal's format configuration
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
55
Research direction
Examine the existing format system in khal (likely in `khal/src/formatter.py` or similar) to see how placeholders like {start} or {title} are processed. Look at the RRULE attribute of events from the icalendar library, which stores recurrence rules. Implement a new placeholder, e.g., {repeat}, that outputs the RRULE string. As a first pass, simply output the raw RRULE string. Ensure compatibility with the existing formatting options.