1 Introduction
2 ------------
3
4 The vContent distribution provides support for the parsing of the general file
5 format described in RFCs 2445, 2425 and 2426, together with support for the
6 more specialised iCalendar and vCalendar formats through the vCalendar module
7 which applies certain data representation conversions. The vCard format is
8 also supported, but merely through the general vContent module.
9
10 Using the Modules
11 -----------------
12
13 The tests directory contains a number of demonstrations of parsing using the
14 modules:
15
16 test_calendar.py A straightforward test of vCalendar parsing
17 test_calendar_stream.py A round-trip test of stream parsing and output
18 test_card.py A straightforward test of vCard parsing
19 test_card_stream.py A round-trip test of stream parsing and output
20
21 Contact, Copyright and Licence Information
22 ------------------------------------------
23
24 The author can be contacted at the following e-mail address:
25
26 paul@boddie.org.uk
27
28 Copyright and licence information can be found in the docs directory - see
29 docs/COPYING.txt and docs/gpl-3.0.txt for more information.
30
31 New in vContent 0.3 (Changes since vContent 0.2.1)
32 --------------------------------------------------
33
34 * Added support for interpreting recurrence rules.
35 * Fixed conversion to dictionary for multivalued definitions (such as
36 FREEBUSY).
37 * Raise a ParseError upon parsing ill-formed files.
38 * Produce a value of None for empty properties.
39 * Employ proper Unicode readers and writers.
40 * Added timezone-related section types.
41
42 New in vContent 0.2.1 (Changes since vContent 0.2)
43 --------------------------------------------------
44
45 * Fixed infinite loop caused by carriage return at end of input.
46
47 New in vContent 0.2 (Changes since vContent 0.1)
48 ------------------------------------------------
49
50 * Added support for writing resources through a specific write method
51 instead of using a stream, thus changing the iterwrite function's
52 signature.
53 * Added support for multiple property values, producing lists for
54 collections of such values when parsing, and accepting lists of such
55 values when writing. Tuples of values are also handled where such values
56 are separated by semicolons.