parserrules.py

   1 #!/usr/bin/python
   2 #
   3 # Copyright (c) 2011 James French <[email protected]>
   4 #
   5 # Permission is hereby granted, free of charge, to any person obtaining a copy
   6 # of this software and associated documentation files (the "Software"), to deal
   7 # in the Software without restriction, including without limitation the rights
   8 # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
   9 # copies of the Software, and to permit persons to whom the Software is
  10 # furnished to do so, subject to the following conditions:
  11 #
  12 # The above copyright notice and this permission notice shall be included in
  13 # all copies or substantial portions of the Software.
  14 #
  15 # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  16 # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  17 # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  18 # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  19 # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  20 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  21 # THE SOFTWARE.
  22
  23 # This file describes a series of rules which must handle a vobject object and
  24 # return it to the calling script
  25
  26 # The doc string will be presented to the user when run as verbose, so
  27 # please be polite
  28
  29 import vobject
  30
  31 ruleConfig = {}
  32 ruleConfig["defaultTZ"] = "UTC"
  33
  34 def facebookOrganiser(cal):
  35         '''Adds organiser details to the body of facebook calendars.'''
  36
  37         if cal.contents.has_key(u'prodid'):
  38                 if not "Facebook" in cal.prodid.value: return cal
  39
  40         for event in cal.vevent_list:
  41                 if not event.contents.has_key(u'organizer'): continue
  42                 try:
  43                         a = event.organizer.cn_paramlist
  44                         organizer = "Organised by: " + event.organizer.cn_param + " ("
  45                         organizer += event.organizer.value.lstrip('MAILTO:') + ")\n\n"
  46                         event.description.value = organizer + event.description.value
  47                 except AttributeError:
  48                         organizer = "Organized by: " + event.organizer.value
  49                         event.description.value = organizer + "\n\n" + event.description.value
  50         return cal
  51
  52 def whatPrivacy(cal):
  53         '''Marks events public so google calendar doesn't have a sad about them.'''
  54
  55         for event in cal.vevent_list:
  56                 if event.contents.has_key(u'class'):
  57                         # Bit of a hack as class is a reserved word in python
  58                         del event.contents[u'class']
  59                         event.add('class').value = "PUBLIC"
  60
  61         return cal
  62
  63 def dropAttributes(cal):
  64         '''Removing unwanted metadata'''
  65
  66         eventBlacklist = [x.lower() for x in [
  67                 "X-ALT-DESC",
  68                 "X-MICROSOFT-CDO-BUSYSTATUS",
  69                 "X-MICROSOFT-CDO-IMPORTANCE",
  70                 "X-MICROSOFT-DISALLOW-COUNTER",
  71                 "X-MS-OLK-ALLOWEXTERNCHECK",
  72                 "X-MS-OLK-AUTOSTARTCHECK",
  73                 "X-MS-OLK-CONFTYPE",
  74                 "X-MS-OLK-AUTOFILLLOCATION",
  75                 "TRANSP",
  76                 "SEQUENCE",
  77                 "PRIORITY"
  78         ]]
  79
  80         mainBlacklist = [x.lower() for x in [
  81                 "X-CLIPSTART",
  82                 "X-CALSTART",
  83                 "X-OWNER",
  84                 "X-MS-OLK-WKHRSTART",
  85                 "X-MS-OLK-WKHREND",
  86                 "X-WR-RELCALID",
  87                 "X-MS-OLK-WKHRDAYS",
  88                 "X-MS-OLK-APPTSEQTIME",
  89                 "X-CLIPEND",
  90                 "X-CALEND",
  91                 "VTIMEZONE",
  92                 "X-PRIMARY-CALENDAR"
  93         ]]
  94
  95         for event in cal.vevent_list:
  96                 for blacklist in eventBlacklist:
  97                         if event.contents.has_key(blacklist): del event.contents[blacklist]
  98
  99         for blkl in mainBlacklist:
 100                 while blkl in cal.contents: del cal.contents[blkl]
 101
 102         return cal
 103
 104 def exDate(cal):
 105         '''Replacing multi-value EXDATES with multiple single-value EXDATES'''
 106
 107         from datetime import datetime
 108         from pytz import timezone
 109
 110         default = timezone(ruleConfig["defaultTZ"])
 111
 112         for event in cal.vevent_list:
 113                 if not event.contents.has_key(u'exdate'): continue
 114                 dates = event.exdate.value
 115
 116                 del event.contents[u'exdate']
 117
 118                 for date in dates:
 119                         if isinstance(date, datetime):
 120                                 if date.tzinfo is None: date = date.replace(tzinfo = default)
 121                                 date = date.astimezone(vobject.icalendar.utc)
 122                         entry = event.add(u'exdate')
 123                         entry.value = [date]
 124
 125         return cal
 126
 127 def utcise(cal):
 128         '''Removing local timezones in favour of UTC. If the remote calendar specifies a timezone
 129         then use it, otherwise assume it's in the user-specified or default values'''
 130
 131         from datetime import datetime
 132         from pytz import timezone
 133
 134         default = timezone(ruleConfig["defaultTZ"])
 135
 136         for event in cal.vevent_list:
 137                 dtstart = getattr(event, 'dtstart', None)
 138                 dtend = getattr(event, 'dtend', None)
 139
 140                 for i in (dtstart, dtend):
 141                         if not i: continue
 142                         dt = i.value
 143                         if isinstance(dt, datetime):
 144                                 if dt.tzinfo is None: dt = dt.replace(tzinfo = default)
 145                                 i.value = dt.astimezone(vobject.icalendar.utc)
 146
 147         return cal
 148
 149 def unwantedParams(cal):
 150         '''Removing unwanted parameters'''
 151
 152         blklist = [
 153                 "LANGUAGE",
 154                 "X-VOBJ-ORIGINAL-TZID",
 155                 "TZID"
 156         ]
 157
 158         for event in cal.vevent_list:
 159                 for attr in event.contents:
 160                         attr = getattr(event, attr)
 161                         try:
 162                                 for i in blklist:
 163                                         while i in attr.params: del attr.params[i]
 164                         except AttributeError: continue
 165
 166         return cal