73 lines (51 loc) · 2.41 KB

Implementation Libraries

Recommended libraries for TaskMark implementations. See specification.md for core spec.

Core Capabilities

TaskMark parsers need libraries for:

Capability	Purpose
Natural language → datetime	Parse phrases like "next Friday 3pm"
Natural language → recurrence	Parse "every Tuesday" into RRULE
RRULE → dates	Generate occurrence dates from RRULE
Timezone handling	Timezone-aware datetime operations

Processing Pipeline

Step	Input	Output
1	Natural language date	Datetime object
2	Natural language recurrence	RRULE string (RFC 5545)
3	RRULE string	List of datetime objects
4	Datetime object	Timezone-aware datetime

Language-Specific Recommendations

Python

Purpose	Library	Notes
Natural language dates	dateparser	Multi-language support
Natural language recurrence	recurrent	Parses to RRULE
RRULE processing	python-dateutil	Full RFC 5545 support
Datetime wrapper	pendulum	Timezone-aware operations

JavaScript/TypeScript

Purpose	Library	Notes
Natural language dates	chrono-node	Multi-language support
RRULE processing	rrule	Full RFC 5545 support
Datetime handling	luxon	Timezone-aware operations

Go

Purpose	Library	Notes
RRULE processing	teambition/rrule-go	RFC 5545 support
Datetime handling	Standard `time` package	Built-in timezone support

Rust

Purpose	Library	Notes
RRULE processing	rrule	RFC 5545 support
Datetime handling	chrono	Timezone-aware operations

Implementation Notes

Implementations SHOULD:

Use ISO 8601 for all date parsing and serialization
Support RRULE (RFC 5545) for recurrence patterns
Handle timezone conversion correctly
Preserve date precision (date-only vs datetime vs with timezone)