5 points | by ashenfad 5 days ago ago
2 comments
calgebra lets you compose calendar timelines using Python's set operators: | (union), & (intersection), - (difference), and ~ (complement).
Queries are lazy—you build expressions first, then execute via slicing.
Example – find when a team is free for a 2+ hour meeting:
from calgebra import day_of_week, time_of_day, hours, HOUR # Define business hours weekend = day_of_week(["saturday", "sunday"], tz="US/Pacific") weekdays = ~weekend business_hours = weekdays & time_of_day(start=9*HOUR, duration=8*HOUR, tz="US/Pacific") # Team calendars (Google Calendar, .ics files, etc.) team_busy = alice | bob | charlie # One expression to find available slots free_slots = (business_hours - team_busy) & (hours >= 2)
- Set operations on any timeline source
- Recurring patterns via RFC 5545 (dateutil under the hood)
- Filter by duration, metadata, or custom properties
- Google Calendar read/write
- iCalendar (.ics) import/export
Fwiw, I think focused DSLs are a great pairing with code-focused agents like huggingface's smol-agents or agex (my other hobby project).
Video of a calgebra-enabled agent: https://youtu.be/10kG4tw0D4k
Would love feedback!
Pretty cool! A small but useful library for working with calendar intervals and schedules in Python
calgebra lets you compose calendar timelines using Python's set operators: | (union), & (intersection), - (difference), and ~ (complement).
Queries are lazy—you build expressions first, then execute via slicing.
Example – find when a team is free for a 2+ hour meeting:
Features:- Set operations on any timeline source
- Recurring patterns via RFC 5545 (dateutil under the hood)
- Filter by duration, metadata, or custom properties
- Google Calendar read/write
- iCalendar (.ics) import/export
Fwiw, I think focused DSLs are a great pairing with code-focused agents like huggingface's smol-agents or agex (my other hobby project).
Video of a calgebra-enabled agent: https://youtu.be/10kG4tw0D4k
Would love feedback!
Pretty cool! A small but useful library for working with calendar intervals and schedules in Python