Installation.Installation

PloneiCalendar.PloneiCalendar

Factory method for a PloneiCalendar object

PloneiCalendar.addPloneiCalendar

PloneiCalendar Tool

PloneiCalendarTool.PloneiCalendarTool

PloneiCalendarWorkflow.createPloneicalendar_workflow

PloneiCalendarWorkflow.setupPloneicalendar_workflow

__init__.initialize

common.StreamWrapper

common.UnicodeAwareException

common.DT2dt

common.dedent

common.dt2DT

common.from_locale

Parse a ISO-8601 YYYY-MM-DD date value.

Examples:

>>> parse_date('2003-09-01') datetime.date(2003, 9, 1) >>> parse_date('20030901') Traceback (most recent call last): ... ValueError: Invalid date: '20030901' >>> parse_date('2003-IX-01') Traceback (most recent call last): ... ValueError: Invalid date: '2003-IX-01' >>> parse_date('2003-09-31') Traceback (most recent call last): ... ValueError: Invalid date: '2003-09-31' >>> parse_date('2003-09-30-15-42') Traceback (most recent call last): ... ValueError: Invalid date: '2003-09-30-15-42'

common.parse_date

Parse a ISO 8601 date/time value.

Only a small subset of ISO 8601 is accepted:

YYYY-MM-DD HH:MM:SS YYYY-MM-DD HH:MM:SS.ssssss YYYY-MM-DDTHH:MM:SS YYYY-MM-DDTHH:MM:SS.ssssss

Returns a datetime.datetime object without a time zone.

Examples:

>>> parse_datetime('2003-04-05 11:22:33.456789') datetime.datetime(2003, 4, 5, 11, 22, 33, 456789)

>>> parse_datetime('2003-04-05 11:22:33.456') datetime.datetime(2003, 4, 5, 11, 22, 33, 456000)

>>> parse_datetime('2003-04-05 11:22:33.45678999') datetime.datetime(2003, 4, 5, 11, 22, 33, 456789)

>>> parse_datetime('01/02/03') Traceback (most recent call last): ... ValueError: Bad datetime: 01/02/03

common.parse_datetime

Parse a ISO 8601 HH:MM time value.

Examples:

>>> parse_time('01:25') datetime.time(1, 25) >>> parse_time('9:15') datetime.time(9, 15) >>> parse_time('12:1') datetime.time(12, 1) >>> parse_time('00:00') datetime.time(0, 0) >>> parse_time('23:59') datetime.time(23, 59) >>> parse_time('24:00') Traceback (most recent call last): ... ValueError: Invalid time: '24:00' >>> parse_time('06:30PM') Traceback (most recent call last): ... ValueError: Invalid time: '06:30PM'

common.parse_time

Converts a timedelta to an integer representing the number of minutes

common.toSeconds

common.toTime

common.to_locale

common.to_unicode

parser.DateRange

Invalid syntax in an iCalendar file.

parser.ICalParseError

An object which reads in an iCal.

Short grammar of iCalendar files (RFC 2445 is the full spec):

contentline = name *(";" param ) ":" value CRLF

iCalendar event.

Life cycle: when a VEvent is created, a number of properties should be added to it using the add method. Then validate should be called. After that you can start using query methods (getOne, hasProp, iterDates).

Events are classified into two kinds:

Format a timedelta as an iCalendar DURATION value.

>>> ical_duration(datetime.timedelta(11)) 'P11D' >>> ical_duration(datetime.timedelta(-14)) '-P14D' >>> ical_duration(datetime.timedelta(1, 7384)) 'P1DT2H3M4S' >>> ical_duration(datetime.timedelta(1, 7380)) 'P1DT2H3M' >>> ical_duration(datetime.timedelta(1, 7200)) 'P1DT2H' >>> ical_duration(datetime.timedelta(0, 7200)) 'PT2H' >>> ical_duration(datetime.timedelta(0, 7384)) 'PT2H3M4S' >>> ical_duration(datetime.timedelta(0, 184)) 'PT3M4S' >>> ical_duration(datetime.timedelta(0, 22)) 'PT22S' >>> ical_duration(datetime.timedelta(0, 3622)) 'PT1H0M22S'

parser.ical_duration

parser.ical_text

Parse list of categories. Return list of category strings.

>>> categories = [('testing', ... {}), ... ('another', ... {})] >>> parse_categories(categories) ['testing', 'another']

parser.parse_categories

Parse iCalendar DATE value. Returns a date instance.

>>> parse_date('20030405') datetime.date(2003, 4, 5) >>> parse_date('20030405T060708') Traceback (most recent call last): ... ValueError: Invalid iCalendar date: '20030405T060708' >>> parse_date('') Traceback (most recent call last): ... ValueError: Invalid iCalendar date: '' >>> parse_date('yyyymmdd') Traceback (most recent call last): ... ValueError: Invalid iCalendar date: 'yyyymmdd'

parser.parse_date

Parse iCalendar DATE-TIME value. Returns a datetime instance.

>>> parse_date_time('20030405T060708') datetime.datetime(2003, 4, 5, 6, 7, 8) >>> parse_date_time('20030405T060708Z') datetime.datetime(2003, 4, 5, 6, 7, 8) >>> parse_date_time('20030405T060708A') Traceback (most recent call last): ... ValueError: Invalid iCalendar date-time: '20030405T060708A' >>> parse_date_time('') Traceback (most recent call last): ... ValueError: Invalid iCalendar date-time: ''

parser.parse_date_time

Parse iCalendar DURATION value. Returns a timedelta instance.

>>> parse_duration('+P11D') datetime.timedelta(11) >>> parse_duration('-P2W') datetime.timedelta(-14) >>> parse_duration('P1DT2H3M4S') datetime.timedelta(1, 7384) >>> parse_duration('P1DT2H3M') datetime.timedelta(1, 7380) >>> parse_duration('P1DT2H') datetime.timedelta(1, 7200) >>> parse_duration('PT2H') datetime.timedelta(0, 7200) >>> parse_duration('PT2H3M4S') datetime.timedelta(0, 7384) >>> parse_duration('PT3M4S') datetime.timedelta(0, 184) >>> parse_duration('PT22S') datetime.timedelta(0, 22) >>> parse_duration('') Traceback (most recent call last): ... ValueError: Invalid iCalendar duration: '' >>> parse_duration('xyzzy') Traceback (most recent call last): ... ValueError: Invalid iCalendar duration: 'xyzzy' >>> parse_duration('P') Traceback (most recent call last): ... ValueError: Invalid iCalendar duration: 'P' >>> parse_duration('P1WT2H') Traceback (most recent call last): ... ValueError: Invalid iCalendar duration: 'P1WT2H'

parser.parse_duration

Parse iCalendar PERIOD value. Returns a Period instance.

>>> p = parse_period('20030405T060708/20030405T060709') >>> print repr(p).replace('),', '),\\n ') Period(datetime.datetime(2003, 4, 5, 6, 7, 8), datetime.datetime(2003, 4, 5, 6, 7, 9)) >>> parse_period('20030405T060708/PT1H1M1S') Period(datetime.datetime(2003, 4, 5, 6, 7, 8), datetime.timedelta(0, 3661)) >>> parse_period('xyzzy') Traceback (most recent call last): ... ValueError: Invalid iCalendar period: 'xyzzy' >>> parse_period('foo/foe') Traceback (most recent call last): ... ValueError: Invalid iCalendar period: 'foo/foe'

parser.parse_period

parser.parse_text