Synchronise Lookup groups.

This causes Lookup groups and their members to be synchronised with groups in Google. As for people, there are various configuration options to control which groups to synchronise, and enforce limits on the number of changes the script will perform.

The group name and email in Google are based on the Lookup groupID and groupName, noting that the email is the group's unique identifier in Google:

email = {groupID}@{groups_domain} name = {groupName}@groups.lookup.cam.ac.uk

where groups_domain is a configurable secondary domain or domain alias for groups in Google.

The rationale for this choice is that it will allow for easier searching by Lookup groupID and groupName (assuming that searches operate from the start of these fields), while using a separate namespace for group identifiers to avoid possible conflicts with users and groups from other sources.

Note: The main sync.py script has become quite long, and could probably use refactoring, but keeping it as it is for now to make it easier to diff.

Closes #10 (closed)

gsuitesync/sync.py

@@ -51,6 +51,10 @@ class Configuration(config.ConfigurationDataclassMixin):
     # The organization unit path in which new accounts are placed
     new_user_org_unit_path: str = '/'
 
+    # Suffix appended to the names of groups created in Google. The Google group name will be
+    # "{groupName}{group_name_suffix}", where {groupName} is the Lookup group name.
+    group_name_suffix: str = ' from lookup.cam.ac.uk'
+
     # Inter-batch delay in seconds. This is useful to avoid hitting Google rate limits.
     inter_batch_delay: numbers.Real = 5
 
@@ -339,7 +343,7 @@ def sync(configuration, *, read_only=True):
         # 73 and 4096 characters respectively in Google.
         expected_google_group = {
             'name': _trim_text(
-                managed_group_entry.groupName, maxlen=73, suffix='@groups.lookup.cam.ac.uk'
+                managed_group_entry.groupName, maxlen=73, suffix=sync_config.group_name_suffix
             ),
             'description': _trim_text(managed_group_entry.description, maxlen=4096)
         }