add README

Use a per-exchange-calendar cache file

We now use ~/.gooswapper to store our cache files (rather than CWD),
and also use one cache file per exchange calendar ID.

Add Copyright notice

Add LICENSE (AGPLv3)

current state-of-play notes

Add looping support

If you specify -l now, run through the main loop every 10 minutes.

re-order setup actions

This is so we can put a loop round those that we want to repeat, after
having done all the necessary login actions.

Bugfix: handle events with no gcal_id link

...this is typically where we can't edit the Exchange event (because
we don't own it). We could, as alternatives:

i) try and re-match each time
ii) store the link value in our cache and use that

Basic CLI

usage: gooswapper.py [-h] [--auth_host_name AUTH_HOST_NAME]
                     [--noauth_local_webserver]
                     [--auth_host_port [AUTH_HOST_PORT [AUTH_HOST_PORT ...]]]
                     [--logging_level {DEBUG,INFO,WARNING,ERROR,CRITICAL}]
                     [-g GCALID] [-l]
                     exchuser exchemail

Gooswapper calendar sync

positional arguments:
  exchuser              Exchange user e.g. 'SANGER\mv3'
  exchemail             Exchange calendar email e.g. ISGGroup@sanger.ac.uk

optional arguments:
  -h, --help            show this help message and exit
  --auth_host_name AUTH_HOST_NAME
                        Hostname when running a local web server.
  --noauth_local_webserver
                        Do not run a local web server.
  --auth_host_port [AUTH_HOST_PORT [AUTH_HOST_PORT ...]]
                        Port web server should listen on.
  --logging_level {DEBUG,INFO,WARNING,ERROR,CRITICAL}
                        Set the logging level of detail.
  -g GCALID, --gcalid GCALID
                        google Calendar ID
  -l, --loop            keep running indefinitely

(-l not yet implemented)

When matching, add google events where we have unmatched exchange ones

i.e. if you have an event in Exchange where a matching google event
isn't found by matching, then create that event in google.

handle empty subjects when matching

add option to ignore existing gcal_id links

check event isn't already cancelled before deleting

Handle the remaining recurrence types

These are in simple forms, as can be generated via the Outlook web
UI...

Handle updates to recurring events

Update changekey of master event after adjusting instances

Changing the instances (e.g. by adding a gcal_link) updates the
changekey of the master instance. So we need to reflect this in our
cache.

Remove warning about not supporting modified/deleted recurrences

Don't store instances of recurring events in the cache

...as they don't appear in the usual listing, which means we end up
considering them as deleted events.

Handle modified / deleted recurrences

This has a bug in that adding the modified events to the events cache
causes them to get deleted on the next run (since they don't appear in
the events listing normally).

handle weekly recurrence pattern

only register gcal_link if necessary

more verbose logging of recurrence

add utility function to pop an event from the cache

Start on recurring event support

...currently only daily events, but this is tested and works across a
DST change.

Make start and end times be rendered in target timezone

This is consistent with how we were handling all-day events
previously, and means that recurring events work round DST changes
better.

restrict fields passed to event.save()

This avoids problems where the event has some fields we can't edit.

check for empty body

Remove some no-longer needed lines

These were part of getting to the bottom of why saving wasn't working,
which we have now fixed (see previous commit).

Add code to propagate changes, and match events

Updating is a fairly simple process of copying across the fields we
think we care about.

Matching looks for non-recurring events with the same title in the
same time range.

pass gcal_tz where needed

Split out building gcal event structure (no functional change)

...this will enable us to use it for updates as well as creation

correct warning text

Cache the auto-discovery values from Exchange

This saves us a bit of time.

Also support single non-all-day events

store gcal_link in cache immediately (rather than waiting for next cache update

fix syntax of extendedProperties setting

Remove old commented-out deletion code

During testing, it made life easier to automatically delete new events
sometimes. We don't want to do that any more :)

delete linked events

Switch to using a named tuple for the cache

This lets us store more than one field per event, fairly simply.

Remove old part-written broken function

This was a previous iteration that never actually worked (it led to
the GlobalObjectId work, which in turn led to just using item_id)

Remove GlobalObjectId code

Firstly, we can use item_id instead; secondly, it doesn't always
actually work :-/

Move to keying by item_id

item_id is constant (changekey changes if an event is updated) and
searchable, so use it as primary key.

Remove commented-out account line

(previous work thought that ServiceAccount might be misbehaving)

tidy up the exchange extended property

The two commented-out versions were wrong ("gooswapper") and unhelpful
(the number, stolen from the exchangelib docs); better is to use a
public string entry.

Initial commit

This now can cope with new all-day events from exchange, and make the
corresponding event in gcal.

git ignore file