How pycalendar/icalendar works
icalendar is a Python RFC 5545 library for creating, inspecting, modifying, parsing, and generating calendar data. Its principal workflow is to parse calendar text into components and typed properties, let callers work with the calendar model, then serialize it again. It also supports xCal XML and multiple timezone providers. The graph reflects documented capabilities and source-index references; unsampled modules are represented only where their role is clear, and their runtime links are left unverified where necessary.
Main entry points: component.py Component model · parameter.py Parameter parser · datetime.py Date-time values · property.py xCal properties
Components 21
Calendar model
- Calendar API
src/icalendar/cal/calendar.py - Component model
src/icalendar/cal/component.py
Calendar formats
- iCalendar parser
src/icalendar/parser/ical/component.py - Content lines
src/icalendar/parser/content_line.py - xCal properties
src/icalendar/parser/xcal/property.py - xCal parser state
src/icalendar/parser/xcal/base.py - XML adapter
src/icalendar/parser/xcal/adapter.py - xCal wrapper
src/icalendar/parser/xcal/wrapper.py
Properties and parameters
- Parameter parser
src/icalendar/parser/parameter.py - Property factory
src/icalendar/prop/factory.py - Date-time values
src/icalendar/prop/dt/datetime.py - Text values
src/icalendar/prop/text.py - Parameter access
src/icalendar/param.py
Timezone support
- Timezone proxy
src/icalendar/timezone/tzp.py - Timezone providers
src/icalendar/timezone
Shared utilities
- Case-insensitive map
src/icalendar/caselessdict.py - Encoding helpers
src/icalendar/parser_tools.py - Date-time tools
src/icalendar/tools.py - Compatibility helpers
src/icalendar/compatibility.py - Calendar enums
src/icalendar/enums.py
Other components
- Python caller
Connections 29
- Python caller → Calendar API: uses calendar API
- Calendar API → Component model: manages components
- Python caller → Component model: inspects and modifies
- Component model → iCalendar parser: parses iCalendar
src/icalendar/cal/component.py - Component model → xCal properties: parses xCal
src/icalendar/cal/component.py - iCalendar parser → Content lines: reads content lines
src/icalendar/parser/ical/component.py - iCalendar parser → Parameter parser: uses parameters
src/icalendar/parser/ical/component.py - iCalendar parser → Component model: builds components
src/icalendar/parser/ical/component.py - Component model → Property factory: uses property types
src/icalendar/cal/component.py - xCal properties → xCal parser state: consumes XML elements
src/icalendar/parser/xcal/property.py - xCal properties → XML adapter: adapts elements
src/icalendar/parser/xcal/property.py - xCal properties → Parameter parser: uses parameters
src/icalendar/parser/xcal/property.py - xCal wrapper → xCal properties: wraps properties
src/icalendar/parser/xcal/wrapper.py - xCal wrapper → XML adapter: uses adapter
src/icalendar/parser/xcal/wrapper.py - Content lines → Parameter parser: parses parameters
src/icalendar/parser/content_line.py - Parameter parser → Parameter access: provides parameter values
src/icalendar/parser/parameter.py - Property factory → Date-time values: creates typed values
- Property factory → Text values: creates typed values
src/icalendar/prop/__init__.py - Date-time values → Timezone proxy: localizes date-times
src/icalendar/prop/dt/datetime.py - Timezone proxy → Timezone providers: selects provider
src/icalendar/timezone/tzp.py - Timezone proxy → Date-time tools: uses date-time tools
src/icalendar/timezone/tzp.py - Component model → Case-insensitive map: uses case-insensitive map
src/icalendar/cal/component.py - Component model → Encoding helpers: uses encoding helpers
src/icalendar/cal/component.py - Date-time values → Encoding helpers: decodes values
src/icalendar/prop/dt/datetime.py - Date-time values → Compatibility helpers: uses compatibility types
src/icalendar/prop/dt/datetime.py - Date-time values → Parameter access: uses parameter access
src/icalendar/prop/dt/datetime.py - Parameter parser → Case-insensitive map: uses case-insensitive map
src/icalendar/parser/parameter.py - Parameter parser → Compatibility helpers: uses compatibility types
src/icalendar/parser/parameter.py - Parameter parser → Calendar enums: uses calendar enums
src/icalendar/parser/parameter.py