gam7 7.19.3__py3-none-any.whl → 7.20.1__py3-none-any.whl

gam/__init__.py

@@ -25,7 +25,7 @@ https://github.com/GAM-team/GAM/wiki
 """
 
 __author__ = 'GAM Team <google-apps-manager@googlegroups.com>'
-__version__ = '7.19.03'
+__version__ = '7.20.01'
 __license__ = 'Apache License 2.0 (http://www.apache.org/licenses/LICENSE-2.0)'
 
 #pylint: disable=wrong-import-position
@@ -4731,6 +4731,7 @@ def clearServiceCache(service):
   return False
 
 DISCOVERY_URIS = [googleapiclient.discovery.V1_DISCOVERY_URI, googleapiclient.discovery.V2_DISCOVERY_URI]
+CLASSROOM_DEVELOPER_PREVIEW_DISCOVERY_URI = "https://{api}.googleapis.com/$discovery/rest?labels=DEVELOPER_PREVIEW&version={apiVersion}"
 
 # Used for API.CLOUDRESOURCEMANAGER, API.SERVICEUSAGE, API.IAM
 def getAPIService(api, httpObj):
@@ -4750,8 +4751,13 @@ def getService(api, httpObj):
     triesLimit = 3
     for n in range(1, triesLimit+1):
       try:
+        if api != API.CLASSROOM or not GC.Values[GC.DEVELOPER_PREVIEW_API_KEY]:
+          discoveryServiceUrl = DISCOVERY_URIS[v2discovery]
+        else:
+          discoveryServiceUrl = CLASSROOM_DEVELOPER_PREVIEW_DISCOVERY_URI
+        developerKey = GC.Values[GC.DEVELOPER_PREVIEW_API_KEY]
         service = googleapiclient.discovery.build(api, version, http=httpObj, cache_discovery=False,
-                                                  discoveryServiceUrl=DISCOVERY_URIS[v2discovery], static_discovery=False)
+                                                  discoveryServiceUrl=discoveryServiceUrl, developerKey=developerKey, static_discovery=False)
         GM.Globals[GM.CURRENT_API_SERVICES].setdefault(api, {})
         GM.Globals[GM.CURRENT_API_SERVICES][api][version] = service._rootDesc.copy()
         if GM.Globals[GM.CACHE_DISCOVERY_ONLY]:
@@ -26998,31 +27004,33 @@ CHAT_SPACES_ADMIN_ORDERBY_CHOICE_MAP = {
 
 # gam [<UserTypeEntity>] show chatspaces
 #	[types <ChatSpaceTypeList>]
-#	[fields <ChatSpaceFieldNameList>]
+#	[fields <ChatSpaceFieldNameList>] [showaccesssettings]
 #	[formatjson]
 # gam [<UserTypeEntity>] print chatspaces [todrive <ToDriveAttribute>*]
 #	[types <ChatSpaceTypeList>]
-#	[fields <ChatSpaceFieldNameList>]
+#	[fields <ChatSpaceFieldNameList>] [showaccesssettings]
 #	[formatjson [quotechar <Character>]]
 # gam <UserItem> show chatspaces asadmin
 #	[query <String>] [querytime<String> <Time>]
 #	[orderby <ChatSpaceAdminOrderByFieldName> [ascending|descending]]
-#	[fields <ChatSpaceFieldNameList>]
+#	[fields <ChatSpaceFieldNameList>] [showaccesssettings]
 #	[formatjson]
 # gam <UserItem> print chatspaces asadmin [todrive <ToDriveAttribute>*]
 #	[query <String>] [querytime<String> <Time>]
 #	[orderby <ChatSpaceAdminOrderByFieldName> [ascending|descending]]
-#	[fields <ChatSpaceFieldNameList>]
+#	[fields <ChatSpaceFieldNameList>] [showaccesssettings]
 #	[formatjson [quotechar <Character>]]
 def printShowChatSpaces(users):
   csvPF = CSVPrintFile(['User', 'name'] if not isinstance(users, list) else ['name']) if Act.csvFormat() else None
   FJQC = FormatJSONQuoteChar(csvPF)
   OBY = OrderBy(CHAT_SPACES_ADMIN_ORDERBY_CHOICE_MAP)
   useAdminAccess, api, kwargsCS = _getChatAdminAccess(API.CHAT_SPACES_ADMIN, API.CHAT_SPACES)
+  kwargsSAS = {'useAdminAccess': useAdminAccess}
   fieldsList = []
   queries = []
   queryTimes = {}
   pfilter = ''
+  showAccessSettings = False
   if useAdminAccess:
     function = 'search'
     queries = ['customer = "customers/my_customer" AND spaceType = "SPACE"']
@@ -27038,8 +27046,12 @@ def printShowChatSpaces(users):
       pass
     elif useAdminAccess and _getChatSpaceSearchParms(myarg, queries, queryTimes, OBY):
       pass
+    elif myarg == 'showaccesssettings':
+      showAccessSettings = True
     else:
       FJQC.GetFormatJSONQuoteChar(myarg, True)
+  if showAccessSettings and fieldsList:
+    fieldsList.extend(['name', 'spaceType'])
   fields = getItemFieldsFromFieldsList('spaces', fieldsList)
   i, count, users = getEntityArgument(users)
   if useAdminAccess:
@@ -27064,6 +27076,17 @@ def printShowChatSpaces(users):
                                            GAPI.PERMISSION_DENIED, GAPI.FAILED_PRECONDITION],
                              retryReasons=GAPI.SERVICE_NOT_AVAILABLE_RETRY_REASONS,
                              fields=fields, pageSize=CHAT_PAGE_SIZE, **kwargsCS)
+      if showAccessSettings:
+        for space in spaces:
+          if space['spaceType'] == 'SPACE':
+            try:
+              result = callGAPI(chat.spaces(), 'get',
+                                throwReasons=[GAPI.NOT_FOUND, GAPI.INVALID_ARGUMENT, GAPI.INTERNAL_ERROR,
+                                              GAPI.PERMISSION_DENIED, GAPI.FAILED_PRECONDITION],
+                                name=space['name'], fields='accessSettings', **kwargsSAS)
+              space.update(result)
+            except (GAPI.notFound, GAPI.invalidArgument, GAPI.internalError, GAPI.permissionDenied, GAPI.failedPrecondition):
+              pass
     except (GAPI.notFound, GAPI.invalidArgument, GAPI.internalError, GAPI.permissionDenied) as e:
       exitIfChatNotConfigured(chat, kvList, str(e), i, count)
       continue
@@ -48430,6 +48453,14 @@ def _convertCourseUserIdToEmail(croom, userId, emails, entityValueList, i, count
     emails[userId] = userEmail
   return userEmail
 
+def _getCourseOwnerSA(croom, course, useOwnerAccess):
+  if not useOwnerAccess:
+    return croom
+  courseOwnerId = course["ownerId"]
+  if courseOwnerId not in GM.Globals[GM.CLASSROOM_OWNER_SA]:
+    _, GM.Globals[GM.CLASSROOM_OWNER_SA][courseOwnerId] = buildGAPIServiceObject(API.CLASSROOM, f'uid:{courseOwnerId}')
+  return GM.Globals[GM.CLASSROOM_OWNER_SA][courseOwnerId]
+
 def _getCoursesOwnerInfo(croom, courseIds, useOwnerAccess, addCIIdScope=True):
   coursesInfo = {}
   for courseId in courseIds:
@@ -48443,13 +48474,10 @@ def _getCoursesOwnerInfo(croom, courseIds, useOwnerAccess, addCIIdScope=True):
                           throwReasons=[GAPI.NOT_FOUND, GAPI.SERVICE_NOT_AVAILABLE,
                                         GAPI.FORBIDDEN, GAPI.PERMISSION_DENIED],
                           retryReasons=GAPI.SERVICE_NOT_AVAILABLE_RETRY_REASONS,
-                          id=courseId, fields='name,ownerId')
-        if useOwnerAccess:
-          _, ocroom = buildGAPIServiceObject(API.CLASSROOM, f'uid:{course["ownerId"]}')
-        else:
-          ocroom = croom
+                          id=courseId, fields='id,name,ownerId')
+        ocroom = _getCourseOwnerSA(croom, course, useOwnerAccess)
         if ocroom is not None:
-          coursesInfo[ciCourseId] = {'name': course['name'], 'croom': ocroom}
+          coursesInfo[ciCourseId] = {'id': course['id'], 'name': course['name'], 'croom': ocroom}
       except GAPI.notFound:
         entityDoesNotExistWarning(Ent.COURSE, courseId)
       except GAPI.serviceNotAvailable as e:
@@ -48836,12 +48864,9 @@ def doPrintCourses():
     for field in courseShowProperties['skips']:
       course.pop(field, None)
     courseId = course['id']
-    if useOwnerAccess:
-      _, ocroom = buildGAPIServiceObject(API.CLASSROOM, f'uid:{course["ownerId"]}')
-      if not ocroom:
-        continue
-    else:
-      ocroom = croom
+    ocroom = _getCourseOwnerSA(croom, course, useOwnerAccess)
+    if not ocroom:
+      continue
     if courseShowProperties['ownerEmail']:
       course['ownerEmail'] = _convertCourseUserIdToEmail(croom, course['ownerId'], ownerEmails,
                                                          [Ent.COURSE, courseId, Ent.OWNER_ID, course['ownerId']], i, count)
@@ -49651,12 +49676,9 @@ def doPrintCourseParticipants():
   for course in coursesInfo:
     i += 1
     courseId = course['id']
-    if useOwnerAccess:
-      _, ocroom = buildGAPIServiceObject(API.CLASSROOM, f'uid:{course["ownerId"]}')
-      if not ocroom:
-        continue
-    else:
-      ocroom = croom
+    ocroom = _getCourseOwnerSA(croom, course, useOwnerAccess)
+    if not ocroom:
+      continue
     _, teachers, students = _getCourseAliasesMembers(croom, ocroom, courseId, courseShowProperties, teachersFields, studentsFields, True, i, count)
     if showItemCountOnly:
       if courseShowProperties['members'] != 'students':
@@ -51209,6 +51231,461 @@ def printShowClassroomProfile(users):
   if csvPF:
     csvPF.writeCSVfile('Classroom User Profiles')
 
+# gam create course-studentgroups
+#	(course|class <CourseEntity>)*|([teacher <UserItem>] [student <UserItem>] [states <CourseStateList>])
+#	title <String>
+#	[csv [todrive <ToDriveAttribute>*] [formatjson [quotechar <Character>]]]
+def doCreateCourseStudentGroups():
+  croom = buildGAPIObject(API.CLASSROOM)
+  csvPF = None
+  FJQC = FormatJSONQuoteChar(None)
+  courseSelectionParameters = _initCourseSelectionParameters()
+  courseShowProperties = _initCourseShowProperties(['name'])
+  useOwnerAccess = GC.Values[GC.USE_COURSE_OWNER_ACCESS]
+  kwargs  = {'courseId': None, 'body': {}}
+  while Cmd.ArgumentsRemaining():
+    myarg = getArgument()
+    if myarg == 'title':
+      kwargs['body']['title'] = getString(Cmd.OB_STRING)
+    elif _getCourseSelectionParameters(myarg, courseSelectionParameters):
+      pass
+    elif myarg == 'csv':
+      csvPF = CSVPrintFile(['courseId', 'courseName', 'studentGroupId', 'studentGroupTitle'])
+      FJQC = FormatJSONQuoteChar(csvPF)
+    elif csvPF and myarg == 'todrive':
+      csvPF.GetTodriveParameters()
+    else:
+      FJQC.GetFormatJSONQuoteChar(myarg, True)
+  if 'title' not in kwargs['body']:
+    missingArgumentExit('title')
+  if csvPF and FJQC.formatJSON:
+    csvPF.SetJSONTitles(['courseId', 'courseName', 'JSON'])
+  coursesInfo = _getCoursesInfo(croom, courseSelectionParameters, courseShowProperties, useOwnerAccess)
+  if coursesInfo is None:
+    return
+  count = len(coursesInfo)
+  i = 0
+  for course in coursesInfo:
+    i += 1
+    courseId = course['id']
+    ocroom = _getCourseOwnerSA(croom, course, useOwnerAccess)
+    if not ocroom:
+      continue
+    kwargs['courseId'] = courseId
+    kvList = [Ent.COURSE, courseId, Ent.COURSE_STUDENTGROUP, None]
+    try:
+      studentGroup = callGAPI(ocroom.courses().studentGroups(), 'create',
+                              throwReasons=[GAPI.NOT_FOUND, GAPI.SERVICE_NOT_AVAILABLE, GAPI.NOT_IMPLEMENTED,
+                                            GAPI.FORBIDDEN, GAPI.PERMISSION_DENIED],
+                              retryReasons=GAPI.SERVICE_NOT_AVAILABLE_RETRY_REASONS,
+                              previewVersion='V1_20250630_PREVIEW',
+                              **kwargs)
+      kvList[-1] = f"{studentGroup['title']}({studentGroup['id']})"
+      if not csvPF:
+        entityActionPerformed(kvList, i, count)
+      elif not  FJQC.formatJSON:
+        csvPF.WriteRow({'courseId': courseId, 'courseName': course['name'],
+                        'studentGroupId': studentGroup['id'], 'studentGroupTitle': studentGroup['title']})
+      else:
+        csvPF.WriteRowNoFilter({'courseId': courseId, 'courseName': course['name'],
+                                'JSON': json.dumps(cleanJSON(studentGroup), ensure_ascii=False, sort_keys=True)})
+    except GAPI.notFound as e:
+      entityActionFailedWarning(kvList, str(e), i, count)
+    except (GAPI.serviceNotAvailable, GAPI.notImplemented) as e:
+      entityActionFailedExit([Ent.COURSE, courseId], str(e), i, count)
+    except (GAPI.forbidden, GAPI.permissionDenied) as e:
+      ClientAPIAccessDeniedExit(str(e))
+  if csvPF:
+    csvPF.writeCSVfile('Course Student Groups')
+
+# gam update course-studentgroup <CourseID> <StudentGroupID> title <String>
+def doUpdateCourseStudentGroups():
+  croom = buildGAPIObject(API.CLASSROOM)
+  courseId = getString(Cmd.OB_COURSE_ID)
+  studentGroupId = getString(Cmd.OB_STUDENTGROUP_ID)
+  kwargs = {'courseId': courseId, 'id':  studentGroupId, 'body': {}, 'updateMask': ''}
+  while Cmd.ArgumentsRemaining():
+    myarg = getArgument()
+    if myarg == 'title':
+      kwargs['body']['title'] = getString(Cmd.OB_STRING)
+      kwargs['updateMask'] = myarg
+    else:
+      unknownArgumentExit()
+  if 'title' not in kwargs['body']:
+    missingArgumentExit('title')
+  _, count, coursesInfo = _getCoursesOwnerInfo(croom, [courseId], GC.Values[GC.USE_COURSE_OWNER_ACCESS])
+  if count == 0:
+    return
+  ocroom = coursesInfo[courseId]['croom']
+  courseId = coursesInfo[courseId]['id']
+  kvList = [Ent.COURSE, courseId, Ent.COURSE_STUDENTGROUP, studentGroupId]
+  try:
+    studentGroup = callGAPI(ocroom.courses().studentGroups(), 'patch',
+                            throwReasons=[GAPI.NOT_FOUND, GAPI.SERVICE_NOT_AVAILABLE, GAPI.NOT_IMPLEMENTED,
+                                          GAPI.FORBIDDEN, GAPI.PERMISSION_DENIED],
+                            retryReasons=GAPI.SERVICE_NOT_AVAILABLE_RETRY_REASONS,
+                            previewVersion='V1_20250630_PREVIEW',
+                            **kwargs)
+    kvList[-1] = f"{studentGroup['title']}({studentGroup['id']})"
+    entityActionPerformed(kvList)
+  except GAPI.notFound as e:
+    entityActionFailedWarning(kvList, str(e))
+  except (GAPI.serviceNotAvailable, GAPI.notImplemented) as e:
+    entityActionFailedExit([Ent.COURSE, courseId], str(e))
+  except (GAPI.forbidden, GAPI.permissionDenied) as e:
+    ClientAPIAccessDeniedExit(str(e))
+
+# gam delete course-studentgroups <CourseID> <StudentGroupIDEntity>
+def doDeleteCourseStudentGroups():
+  croom = buildGAPIObject(API.CLASSROOM)
+  courseId = getString(Cmd.OB_COURSE_ID)
+  studentGroupIds = getEntityList(Cmd.OB_STUDENTGROUP_ID_ENTITY, shlexSplit=False)
+  checkForExtraneousArguments()
+  _, count, coursesInfo = _getCoursesOwnerInfo(croom, [courseId], GC.Values[GC.USE_COURSE_OWNER_ACCESS])
+  if count == 0:
+    return
+  ocroom = coursesInfo[courseId]['croom']
+  courseId = coursesInfo[courseId]['id']
+  kwargs = {'courseId': courseId, 'id': None}
+  kvList = [Ent.COURSE, courseId, Ent.COURSE_STUDENTGROUP, None]
+  count = len(studentGroupIds)
+  i = 0
+  for studentGroupId in studentGroupIds:
+    i += 1
+    kwargs['id'] = kvList[-1] = studentGroupId
+    try:
+      callGAPI(ocroom.courses().studentGroups(), 'delete',
+               throwReasons=[GAPI.NOT_FOUND, GAPI.SERVICE_NOT_AVAILABLE, GAPI.NOT_IMPLEMENTED,
+                             GAPI.FORBIDDEN, GAPI.PERMISSION_DENIED],
+               retryReasons=GAPI.SERVICE_NOT_AVAILABLE_RETRY_REASONS,
+               previewVersion='V1_20250630_PREVIEW',
+               **kwargs)
+      entityActionPerformed(kvList, i, count)
+    except GAPI.notFound as e:
+      entityActionFailedWarning(kvList, str(e), i, count)
+    except (GAPI.serviceNotAvailable, GAPI.notImplemented) as e:
+      entityActionFailedExit([Ent.COURSE, courseId], str(e), i, count)
+    except (GAPI.forbidden, GAPI.permissionDenied) as e:
+      ClientAPIAccessDeniedExit(str(e))
+
+# gam clear course-studentgroups
+#	(course|class <CourseEntity>)*|([teacher <UserItem>] [student <UserItem>] [states <CourseStateList>])
+def doClearCourseStudentGroups():
+  croom = buildGAPIObject(API.CLASSROOM)
+  courseSelectionParameters = _initCourseSelectionParameters()
+  courseShowProperties = _initCourseShowProperties(['name'])
+  useOwnerAccess = GC.Values[GC.USE_COURSE_OWNER_ACCESS]
+  while Cmd.ArgumentsRemaining():
+    myarg = getArgument()
+    if _getCourseSelectionParameters(myarg, courseSelectionParameters):
+      pass
+    else:
+      unknownArgumentExit()
+  coursesInfo = _getCoursesInfo(croom, courseSelectionParameters, courseShowProperties, useOwnerAccess)
+  if coursesInfo is None:
+    return
+  count = len(coursesInfo)
+  i = 0
+  for course in coursesInfo:
+    i += 1
+    courseId = course['id']
+    ocroom = _getCourseOwnerSA(croom, course, useOwnerAccess)
+    if not ocroom:
+      continue
+    kwargs = {'courseId': courseId, 'id': None}
+    kvList = [Ent.COURSE, courseId, Ent.COURSE_STUDENTGROUP, None]
+    studentGroups = []
+    printGettingEntityItemForWhom(Ent.COURSE_STUDENTGROUP, formatKeyValueList('', [Ent.Singular(Ent.COURSE), courseId], currentCount(i, count)))
+    pageMessage = getPageMessage()
+    try:
+      studentGroups = callGAPIpages(ocroom.courses().studentGroups(), 'list', 'studentGroups',
+                                    pageMessage=pageMessage,
+                                    throwReasons=[GAPI.NOT_FOUND, GAPI.SERVICE_NOT_AVAILABLE, GAPI.NOT_IMPLEMENTED,
+                                                  GAPI.FORBIDDEN, GAPI.PERMISSION_DENIED],
+                                    retryReasons=GAPI.SERVICE_NOT_AVAILABLE_RETRY_REASONS,
+                                    previewVersion='V1_20250630_PREVIEW',
+                                    courseId=courseId)
+    except GAPI.notFound as e:
+      entityActionFailedWarning([Ent.COURSE, courseId], str(e))
+      continue
+    except (GAPI.serviceNotAvailable, GAPI.notImplemented) as e:
+      entityActionFailedExit([Ent.COURSE, courseId], str(e))
+    except (GAPI.forbidden, GAPI.permissionDenied) as e:
+      ClientAPIAccessDeniedExit(str(e))
+    jcount = len(studentGroups)
+    entityPerformActionNumItems([Ent.COURSE, courseId], jcount, Ent.COURSE_STUDENTGROUP, i, count)
+    Ind.Increment()
+    j = 0
+    for studentGroup in studentGroups:
+      j += 1
+      kwargs['id'] = kvList[-1] = studentGroup['id']
+      try:
+        callGAPI(ocroom.courses().studentGroups(), 'delete',
+                 throwReasons=[GAPI.NOT_FOUND, GAPI.SERVICE_NOT_AVAILABLE, GAPI.NOT_IMPLEMENTED,
+                               GAPI.FORBIDDEN, GAPI.PERMISSION_DENIED],
+                 retryReasons=GAPI.SERVICE_NOT_AVAILABLE_RETRY_REASONS,
+                 previewVersion='V1_20250630_PREVIEW',
+                 **kwargs)
+        entityActionPerformed(kvList, j, jcount)
+      except GAPI.notFound as e:
+        entityActionFailedWarning(kvList, str(e), j, jcount)
+      except (GAPI.serviceNotAvailable, GAPI.notImplemented) as e:
+        entityActionFailedExit([Ent.COURSE, courseId], str(e), j, jcount)
+      except (GAPI.forbidden, GAPI.permissionDenied) as e:
+        ClientAPIAccessDeniedExit(str(e))
+    Ind.Decrement()
+
+# gam print course-studentgroups [todrive <ToDriveAttribute>*]
+#	(course|class <CourseEntity>)*|([teacher <UserItem>] [student <UserItem>] [states <CourseStateList>])
+#	[showitemcountonly] [formatjson [quotechar <Character>]]
+def doPrintCourseStudentGroups(showMembers=False):
+  croom = buildGAPIObject(API.CLASSROOM)
+  cd = buildGAPIObject(API.DIRECTORY)
+  csvPF = CSVPrintFile(['courseId', 'courseName', 'studentGroupId', 'studentGroupTitle'])
+  FJQC = FormatJSONQuoteChar(csvPF)
+  courseSelectionParameters = _initCourseSelectionParameters()
+  courseShowProperties = _initCourseShowProperties(['name'])
+  showItemCountOnly = False
+  useOwnerAccess = GC.Values[GC.USE_COURSE_OWNER_ACCESS]
+  while Cmd.ArgumentsRemaining():
+    myarg = getArgument()
+    if myarg == 'todrive':
+      csvPF.GetTodriveParameters()
+    elif _getCourseSelectionParameters(myarg, courseSelectionParameters):
+      pass
+    elif myarg == 'showitemcountonly':
+      showItemCountOnly = True
+    else:
+      FJQC.GetFormatJSONQuoteChar(myarg, True)
+  coursesInfo = _getCoursesInfo(croom, courseSelectionParameters, courseShowProperties, useOwnerAccess)
+  if coursesInfo is None:
+    if showItemCountOnly:
+      writeStdout('0\n')
+    return
+  itemCount = 0
+  count = len(coursesInfo)
+  i = 0
+  for course in coursesInfo:
+    i += 1
+    courseId = course['id']
+    ocroom = _getCourseOwnerSA(croom, course, useOwnerAccess)
+    if not ocroom:
+      continue
+    studentGroups = []
+    printGettingEntityItemForWhom(Ent.COURSE_STUDENTGROUP, formatKeyValueList('', [Ent.Singular(Ent.COURSE), courseId], currentCount(i, count)))
+    pageMessage = getPageMessage()
+    try:
+      studentGroups = callGAPIpages(ocroom.courses().studentGroups(), 'list', 'studentGroups',
+                                    pageMessage=pageMessage,
+                                    throwReasons=[GAPI.NOT_FOUND, GAPI.SERVICE_NOT_AVAILABLE, GAPI.NOT_IMPLEMENTED,
+                                                  GAPI.FORBIDDEN, GAPI.PERMISSION_DENIED],
+                                    retryReasons=GAPI.SERVICE_NOT_AVAILABLE_RETRY_REASONS,
+                                    previewVersion='V1_20250630_PREVIEW',
+                                    courseId=courseId)
+    except GAPI.notFound as e:
+      entityActionFailedWarning([Ent.COURSE, courseId], str(e))
+      continue
+    except (GAPI.serviceNotAvailable, GAPI.notImplemented) as e:
+      entityActionFailedExit([Ent.COURSE, courseId], str(e))
+    except (GAPI.forbidden, GAPI.permissionDenied) as e:
+      ClientAPIAccessDeniedExit(str(e))
+    if not showMembers and showItemCountOnly:
+      itemCount += len(studentGroups)
+      continue
+    for studentGroup in studentGroups:
+      studentGroupId = studentGroup['id']
+      if not showMembers:
+        if not FJQC.formatJSON:
+          csvPF.WriteRowTitles({'courseId': courseId, 'courseName': course['name'],
+                                'studentGroupId': studentGroupId, 'studentGroupTitle': studentGroup['title']})
+        else:
+          row = {'courseId': courseId, 'courseName': course['name']}
+          if csvPF.CheckRowTitles(row):
+            row['JSON'] = json.dumps(cleanJSON(studentGroup), ensure_ascii=False, sort_keys=False)
+            csvPF.WriteRowTitles(row)
+        continue
+      printGettingEntityItemForWhom(Ent.USER, formatKeyValueList('', [Ent.Singular(Ent.COURSE_STUDENTGROUP), studentGroupId],
+                                                                 currentCount(i, count)))
+      pageMessage = getPageMessage()
+      try:
+        students = callGAPIpages(ocroom.courses().studentGroups().studentGroupMembers(), 'list', 'studentGroupMembers',
+                                 pageMessage=pageMessage,
+                                 throwReasons=[GAPI.NOT_FOUND, GAPI.SERVICE_NOT_AVAILABLE,
+                                               GAPI.FORBIDDEN, GAPI.PERMISSION_DENIED],
+                                 retryReasons=GAPI.SERVICE_NOT_AVAILABLE_RETRY_REASONS,
+                                 previewVersion='V1_20250630_PREVIEW',
+                                 courseId=courseId, studentGroupId=studentGroupId)
+        if showItemCountOnly:
+          itemCount += len(students)
+          continue
+        for member in students:
+          member['userEmail'] = convertUIDtoEmailAddress(f"id:{member['userId']}", cd=cd, emailTypes=['user'])
+      except GAPI.notFound as e:
+        entityActionFailedWarning([Ent.COURSE, courseId, Ent.COURSE_STUDENTGROUP, studentGroupId], str(e))
+        continue
+      except (GAPI.serviceNotAvailable, GAPI.notImplemented) as e:
+        entityActionFailedExit([Ent.COURSE, courseId, Ent.COURSE_STUDENTGROUP, studentGroupId], str(e))
+      except (GAPI.forbidden, GAPI.permissionDenied) as e:
+        ClientAPIAccessDeniedExit(str(e))
+      if not FJQC.formatJSON:
+        row = {'courseId': courseId, 'courseName': course['name'],
+               'studentGroupId': studentGroupId, 'studentGroupTitle': studentGroup['title']}
+        for member in students:
+          csvPF.WriteRowTitles(flattenJSON(member, flattened=row.copy()))
+      else:
+        row = {'courseId': courseId, 'courseName': course['name'],
+               'studentGroupId': studentGroupId, 'studentGroupTitle': studentGroup['title']}
+        row['JSON'] = json.dumps(list(students))
+        csvPF.WriteRowNoFilter(row)
+  if showItemCountOnly:
+    writeStdout(f'{itemCount}\n')
+    return
+  if not showMembers:
+    title = 'Course Student Groups'
+  else:
+    title = 'Course Student Group Members'
+  csvPF.writeCSVfile(title)
+
+# gam create course-studentgroup-members <CourseID> <StudentGroupID> <UserTypeEntity>
+# gam delete course-studentgroup-members <CourseID> <StudentGroupID> <UserTypeEntity>
+# gam sync course-studentgroup-members <CourseID> <StudentGroupID> <UserTypeEntity>
+# gam clear course-studentgroup-members <CourseID> <StudentGroupID>
+def doProcessCourseStudentGroupMembers():
+  def _getCurrentStudents():
+    printGettingEntityItemForWhom(Ent.USER, Ent.Singular(Ent.COURSE_STUDENTGROUP), studentGroupId)
+    pageMessage = getPageMessage()
+    try:
+      return callGAPIpages(ocroom.courses().studentGroups().studentGroupMembers(), 'list', 'studentGroupMembers',
+                           pageMessage=pageMessage,
+                           throwReasons=[GAPI.NOT_FOUND, GAPI.SERVICE_NOT_AVAILABLE,
+                                         GAPI.FORBIDDEN, GAPI.PERMISSION_DENIED],
+                           retryReasons=GAPI.SERVICE_NOT_AVAILABLE_RETRY_REASONS,
+                           previewVersion='V1_20250630_PREVIEW',
+                           courseId=courseId, studentGroupId=studentGroupId)
+    except GAPI.notFound as e:
+      entityActionFailedWarning([Ent.COURSE, courseId, Ent.COURSE_STUDENTGROUP, studentGroupId], str(e))
+      return []
+    except (GAPI.serviceNotAvailable, GAPI.notImplemented) as e:
+      entityActionFailedExit([Ent.COURSE, courseId, Ent.COURSE_STUDENTGROUP, studentGroupId], str(e))
+    except (GAPI.forbidden, GAPI.permissionDenied) as e:
+      ClientAPIAccessDeniedExit(str(e))
+
+  def _getStudentUserId(kvList, student, i, count):
+    normalizedEmailAddressOrUID = normalizeEmailAddressOrUID(student)
+    if normalizedEmailAddressOrUID.find('@') == -1:
+      return normalizedEmailAddressOrUID
+    try:
+      return callGAPI(cd.users(), 'get',
+                      throwReasons=GAPI.USER_GET_THROW_REASONS,
+                      userKey=normalizedEmailAddressOrUID, fields='id')['id']
+    except (GAPI.userNotFound, GAPI.domainNotFound, GAPI.domainCannotUseApis, GAPI.forbidden,
+            GAPI.badRequest, GAPI.backendError, GAPI.systemError) as e:
+      entityActionFailedWarning(kvList, str(e), i, count)
+    return None
+
+  def _processStudent(function, kvList, kwargs, i, count):
+    try:
+      callGAPI(ocroom.courses().studentGroups().studentGroupMembers(), function,
+               throwReasons=[GAPI.NOT_FOUND, GAPI.ALREADY_EXISTS,
+                             GAPI.SERVICE_NOT_AVAILABLE, GAPI.NOT_IMPLEMENTED,
+                             GAPI.FORBIDDEN, GAPI.PERMISSION_DENIED],
+               retryReasons=GAPI.SERVICE_NOT_AVAILABLE_RETRY_REASONS,
+               previewVersion='V1_20250630_PREVIEW',
+               **kwargs)
+      entityActionPerformed(kvList, i, count)
+    except (GAPI.alreadyExists, GAPI.notFound) as e:
+      entityActionFailedWarning(kvList, str(e), i, count)
+    except (GAPI.serviceNotAvailable, GAPI.notImplemented) as e:
+      entityActionFailedExit([Ent.COURSE, courseId], str(e))
+    except (GAPI.forbidden, GAPI.permissionDenied) as e:
+      ClientAPIAccessDeniedExit(str(e))
+
+  def _addStudents(students, getUserIds):
+    count = len(students)
+    i = 0
+    entityPerformActionNumItems([Ent.COURSE, courseId, Ent.COURSE_STUDENTGROUP, studentGroupId], count, Ent.USER)
+    kvList = [Ent.COURSE, courseId, Ent.COURSE_STUDENTGROUP, studentGroupId, Ent.USER, '']
+    kwargs = {'courseId': courseId, 'studentGroupId': studentGroupId, 'body': {'userId': ''}}
+    for student in students:
+      i += 1
+      if getUserIds:
+        userId = _getStudentUserId(kvList, student, i, count)
+        if userId is None:
+          continue
+        kvList[-1] = student
+      else:
+        userId = student
+        kvList[-1] = convertUIDtoEmailAddress(f"id:{userId}", cd=cd, emailTypes=['user'])
+      kwargs['body']['userId'] = userId
+      _processStudent('create', kvList, kwargs, i, count)
+
+  def _removeStudents(students, getUserIds):
+    count = len(students)
+    i = 0
+    entityPerformActionNumItems([Ent.COURSE, courseId, Ent.COURSE_STUDENTGROUP, studentGroupId], count, Ent.USER)
+    kvList = [Ent.COURSE, courseId, Ent.COURSE_STUDENTGROUP, studentGroupId, Ent.USER, '']
+    kwargs = {'courseId': courseId, 'studentGroupId': studentGroupId, 'userId': ''}
+    for student in students:
+      i += 1
+      if getUserIds:
+        userId = _getStudentUserId(kvList, student, i, count)
+        if userId is None:
+          continue
+        kvList[-1] = student
+      else:
+        userId = student
+        kvList[-1] = convertUIDtoEmailAddress(f"id:{userId}", cd=cd, emailTypes=['user'])
+      kwargs['userId'] = userId
+      _processStudent('delete', kvList, kwargs, i, count)
+
+  croom = buildGAPIObject(API.CLASSROOM)
+  cd = buildGAPIObject(API.DIRECTORY)
+  action = Act.Get()
+  courseId = getString(Cmd.OB_COURSE_ID)
+  studentGroupId = getString(Cmd.OB_STUDENTGROUP_ID)
+  if action != Act.CLEAR:
+    _, clStudents = getEntityToModify(defaultEntityType=Cmd.ENTITY_USERS, groupMemberType=Ent.TYPE_USER)
+    clStudents = [normalizeEmailAddressOrUID(student) for student in clStudents]
+    checkForExtraneousArguments()
+  _, count, coursesInfo = _getCoursesOwnerInfo(croom, [courseId], GC.Values[GC.USE_COURSE_OWNER_ACCESS])
+  if count == 0:
+    return
+  ocroom = coursesInfo[courseId]['croom']
+  courseId = coursesInfo[courseId]['id']
+  if action in {Act.SYNC, Act.CLEAR}:
+    currentStudents = [student['userId'] for student in _getCurrentStudents()]
+  if action == Act.CLEAR:
+    _removeStudents(currentStudents, False)
+  elif action == Act.DELETE:
+    _removeStudents(clStudents, True)
+  elif action in {Act.ADD, Act.CREATE}:
+    _addStudents(clStudents, True)
+  else: # elif action == Act.SYNC:
+    currentMembersSet = set(currentStudents)
+    syncMembersSet = set()
+    count = len(clStudents)
+    i = 0
+    kvList = [Ent.COURSE, courseId, Ent.COURSE_STUDENTGROUP, studentGroupId, Ent.USER, '']
+    for student in clStudents:
+      i += 1
+      kvList[-1] = student
+      userId = _getStudentUserId(kvList, student, i, count)
+      if userId is None:
+        continue
+      syncMembersSet.add(userId)
+    removeStudentsSet = currentMembersSet-syncMembersSet
+    addStudentsSet = syncMembersSet-currentMembersSet
+    Act.Set(Act.DELETE)
+    _removeStudents(removeStudentsSet, False)
+    Act.Set(Act.ADD)
+    _addStudents(addStudentsSet, False)
+
+# gam print course-studentgroup-members [todrive <ToDriveAttribute>*]
+#	(course|class <CourseEntity>)*|([teacher <UserItem>] [student <UserItem>] [states <CourseStateList>])
+#	[showitemcountonly] [formatjson [quotechar <Character>]]
+def doPrintCourseStudentGroupMembers():
+  doPrintCourseStudentGroups(showMembers=True)
+
 def _showASPs(user, asps, i=0, count=0):
   Act.Set(Act.SHOW)
   jcount = len(asps)
@@ -77337,6 +77814,8 @@ MAIN_ADD_CREATE_FUNCTIONS = {
   Cmd.ARG_CIGROUP:		doCreateCIGroup,
   Cmd.ARG_CONTACT:		doCreateDomainContact,
   Cmd.ARG_COURSE:		doCreateCourse,
+  Cmd.ARG_COURSESTUDENTGROUP:	doCreateCourseStudentGroups,
+  Cmd.ARG_COURSESTUDENTGROUPMEMBERS:	doProcessCourseStudentGroupMembers,
   Cmd.ARG_DATATRANSFER:		doCreateDataTransfer,
   Cmd.ARG_DEVICE:		doCreateCIDevice,
   Cmd.ARG_DOMAIN:		doCreateDomain,
@@ -77412,6 +77891,8 @@ MAIN_COMMANDS_WITH_OBJECTS = {
     (Act.CLEAR,
      {Cmd.ARG_ALERTSETTINGS:	doClearAlertSettings,
       Cmd.ARG_CONTACT:		doClearDomainContacts,
+      Cmd.ARG_COURSESTUDENTGROUP:	doClearCourseStudentGroups,
+      Cmd.ARG_COURSESTUDENTGROUPMEMBERS:	doProcessCourseStudentGroupMembers,
      }
     ),
   'close':
@@ -77454,6 +77935,8 @@ MAIN_COMMANDS_WITH_OBJECTS = {
       Cmd.ARG_CONTACTPHOTO:	doDeleteDomainContactPhoto,
       Cmd.ARG_COURSE:		doDeleteCourse,
       Cmd.ARG_COURSES:		doDeleteCourses,
+      Cmd.ARG_COURSESTUDENTGROUP:	doDeleteCourseStudentGroups,
+      Cmd.ARG_COURSESTUDENTGROUPMEMBERS:	doProcessCourseStudentGroupMembers,
       Cmd.ARG_DEVICE:		doDeleteCIDevice,
       Cmd.ARG_DEVICEUSER:	doDeleteCIDeviceUser,
       Cmd.ARG_DOMAIN:		doDeleteDomain,
@@ -77631,6 +78114,8 @@ MAIN_COMMANDS_WITH_OBJECTS = {
       Cmd.ARG_COURSEANNOUNCEMENTS:	doPrintCourseAnnouncements,
       Cmd.ARG_COURSEMATERIALS:	doPrintCourseMaterials,
       Cmd.ARG_COURSEPARTICIPANTS:	doPrintCourseParticipants,
+      Cmd.ARG_COURSESTUDENTGROUP:	doPrintCourseStudentGroups,
+      Cmd.ARG_COURSESTUDENTGROUPMEMBERS:	doPrintCourseStudentGroupMembers,
       Cmd.ARG_COURSESUBMISSIONS:	doPrintCourseSubmissions,
       Cmd.ARG_COURSETOPICS:	doPrintCourseTopics,
       Cmd.ARG_COURSEWORK:	doPrintCourseWork,
@@ -77815,6 +78300,7 @@ MAIN_COMMANDS_WITH_OBJECTS = {
     (Act.SYNC,
      {Cmd.ARG_DEVICE:		doSyncCIDevices,
       Cmd.ARG_SHAREDDRIVEACLS:	copySyncSharedDriveACLs,
+      Cmd.ARG_COURSESTUDENTGROUPMEMBERS:	doProcessCourseStudentGroupMembers,
      }
     ),
   'unhide':
@@ -77837,6 +78323,7 @@ MAIN_COMMANDS_WITH_OBJECTS = {
       Cmd.ARG_CONTACTPHOTO:	doUpdateDomainContactPhoto,
       Cmd.ARG_COURSE:		doUpdateCourse,
       Cmd.ARG_COURSES:		doUpdateCourses,
+      Cmd.ARG_COURSESTUDENTGROUP:	doUpdateCourseStudentGroups,
       Cmd.ARG_CROS:		doUpdateCrOSDevices,
       Cmd.ARG_CUSTOMER:		doUpdateCustomer,
       Cmd.ARG_DEVICE:		doUpdateCIDevice,
@@ -77954,6 +78441,7 @@ MAIN_COMMANDS_OBJ_ALIASES = {
   Cmd.ARG_CLASSROOMINVITATIONS:	Cmd.ARG_CLASSROOMINVITATION,
   Cmd.ARG_CONTACTS:		Cmd.ARG_CONTACT,
   Cmd.ARG_CONTACTPHOTOS:	Cmd.ARG_CONTACTPHOTO,
+  Cmd.ARG_COURSESTUDENTGROUPS:	Cmd.ARG_COURSESTUDENTGROUP,
   Cmd.ARG_CROSES:		Cmd.ARG_CROS,
   Cmd.ARG_DATATRANSFERS:	Cmd.ARG_DATATRANSFER,
   Cmd.ARG_DEVICES:		Cmd.ARG_DEVICE,

gam/gamlib/glcfg.py

@@ -145,6 +145,8 @@ CSV_OUTPUT_USERS_AUDIT = 'csv_output_users_audit'
 CUSTOMER_ID = 'customer_id'
 # If debug_level > 0: extra_args['prettyPrint'] = True, httplib2.debuglevel = gam_debug_level, appsObj.debug = True
 DEBUG_LEVEL = 'debug_level'
+# Developer Preview API Key
+DEVELOPER_PREVIEW_API_KEY = 'developer_preview_api_key'
 # When retrieving lists of ChromeOS devices from API, how many should be retrieved in each chunk
 DEVICE_MAX_RESULTS = 'device_max_results'
 # Domain obtained from gam.cfg or oauth2.txt
@@ -370,6 +372,7 @@ Defaults = {
   CSV_OUTPUT_USERS_AUDIT: FALSE,
   CUSTOMER_ID: MY_CUSTOMER,
   DEBUG_LEVEL: '0',
+  DEVELOPER_PREVIEW_API_KEY: '',
   DEVICE_MAX_RESULTS: '200',
   DOMAIN: '',
   DRIVE_DIR: '',
@@ -536,6 +539,7 @@ VAR_INFO = {
   CSV_OUTPUT_USERS_AUDIT: {VAR_TYPE: TYPE_BOOLEAN},
   CUSTOMER_ID: {VAR_TYPE: TYPE_STRING, VAR_ENVVAR: 'CUSTOMER_ID', VAR_LIMITS: (0, None)},
   DEBUG_LEVEL: {VAR_TYPE: TYPE_INTEGER, VAR_SIGFILE: 'debug.gam', VAR_LIMITS: (0, None), VAR_SFFT: ('0', '4')},
+  DEVELOPER_PREVIEW_API_KEY: {VAR_TYPE: TYPE_STRING, VAR_LIMITS: (0, None)},
   DEVICE_MAX_RESULTS: {VAR_TYPE: TYPE_INTEGER, VAR_LIMITS: (1, 200)},
   DOMAIN: {VAR_TYPE: TYPE_STRING, VAR_ENVVAR: 'GA_DOMAIN', VAR_LIMITS: (0, None)},
   DRIVE_DIR: {VAR_TYPE: TYPE_DIRECTORY, VAR_ENVVAR: 'GAMDRIVEDIR'},

gam/gamlib/glclargs.py

@@ -528,6 +528,9 @@ class GamCLArgs():
   ARG_COURSEANNOUNCEMENTS = 'courseannouncements'
   ARG_COURSEMATERIALS = 'coursematerials'
   ARG_COURSEPARTICIPANTS = 'courseparticipants'
+  ARG_COURSESTUDENTGROUP = 'coursestudentgroup'
+  ARG_COURSESTUDENTGROUPS = 'coursestudentgroups'
+  ARG_COURSESTUDENTGROUPMEMBERS = 'coursestudentgroupmembers'
   ARG_COURSESUBMISSIONS = 'coursesubmissions'
   ARG_COURSETOPICS = 'coursetopics'
   ARG_COURSEWORK = 'coursework'
@@ -1055,6 +1058,8 @@ class GamCLArgs():
   OB_STATE_NAME_LIST = "StateNameList"
   OB_STRING = 'String'
   OB_STRING_LIST = 'StringList'
+  OB_STUDENTGROUP_ID = 'StudentGroupID'
+  OB_STUDENTGROUP_ID_ENTITY = 'StudentGroupIDEntity'
   OB_STUDENT_ITEM = 'StudentItem'
   OB_TAG = 'Tag'
   OB_TAGMANAGER_PATH_LIST = 'TagManagerPathList'

gam/gamlib/glentity.py

@@ -155,6 +155,8 @@ class GamEntity():
   COURSE_MATERIAL_STATE = 'cmst'
   COURSE_NAME = 'cona'
   COURSE_STATE = 'cost'
+  COURSE_STUDENTGROUP = 'cosg'
+  COURSE_STUDENTGROUP_MEMBER = 'csgm'
   COURSE_SUBMISSION_ID = 'csid'
   COURSE_SUBMISSION_STATE = 'csst'
   COURSE_TOPIC = 'ctop'
@@ -517,6 +519,8 @@ class GamEntity():
     COURSE_MATERIAL_STATE: ['Course Material States', 'Course Material State'],
     COURSE_NAME: ['Course Names', 'Course Name'],
     COURSE_STATE: ['Course States', 'Course State'],
+    COURSE_STUDENTGROUP: ['Course Student Groups', 'Course Student Group'],
+    COURSE_STUDENTGROUP_MEMBER: ['Course Student Group Members', 'Course Student Group Member'],
     COURSE_SUBMISSION_ID: ['Course Submission IDs', 'Course Submission ID'],
     COURSE_SUBMISSION_STATE: ['Course Submission States', 'Course Submission State'],
     COURSE_TOPIC: ['Course Topics', 'Course Topic'],

gam/gamlib/glglobals.py

@@ -31,6 +31,8 @@ API_CALLS_RETRY_DATA = 'rtry'
 CACHE_DIR = 'gacd'
 # Reset GAM cache directory after discovery
 CACHE_DISCOVERY_ONLY = 'gcdo'
+# Classroom owner service object
+CLASSROOM_OWNER_SA = 'cosa'
 # Classroom service not available
 CLASSROOM_SERVICE_NOT_AVAILABLE = 'csna'
 # Command logging
@@ -221,6 +223,7 @@ Globals = {
   API_CALLS_RETRY_DATA: {},
   CACHE_DIR: None,
   CACHE_DISCOVERY_ONLY: True,
+  CLASSROOM_OWNER_SA: {},
   CLASSROOM_SERVICE_NOT_AVAILABLE: False,
   CMDLOG_HANDLER: None,
   CMDLOG_LOGGER: None,

gam/gamlib/glmsgs.py

@@ -53,7 +53,7 @@ Please go to:
  5. Click "NEXT"
  6. Under "Audience", choose INTERNAL
  7. Click "NEXT"
- 8. Under, "Contact Information", enter an email address in "Email addresses *"
+ 8. Under, "Contact Information", enter {2} or another value in "Email addresses *"
  9. Click "NEXT"
 10. Under "Finish", click "I agree to the Google API Services: User Data Policy."
 11. Click "CONTINUE"

gam/googleapiclient/version.py

@@ -12,4 +12,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-__version__ = "2.164.0"
+__version__ = "2.179.0"

{gam7-7.19.3.dist-info → gam7-7.20.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gam7
-Version: 7.19.3
+Version: 7.20.1
 Summary: CLI tool to manage Google Workspace
 Project-URL: Homepage, https://github.com/GAM-team/GAM
 Project-URL: Issues, https://github.com/GAM-team/GAM/issues

{gam7-7.19.3.dist-info → gam7-7.20.1.dist-info}/RECORD

@@ -1,4 +1,4 @@
-gam/__init__.py,sha256=ngnkOfi7vZjdRs83cEbcphscUZiEoju6GlIDSBF9nVM,3584315
+gam/__init__.py,sha256=sa-yzi7R7kgKEULVunOY9AKzQbWAZfX9XH3tRPwGefg,3608416
 gam/__main__.py,sha256=amz0-959ph6zkZKqjaar4n60yho-T37w6qWI36qx0CA,1049
 gam/cacerts.pem,sha256=DUsVo2XlFYwfkhe3gnxa-Km4Z4noz74hSApXwTT-nQE,44344
 gam/cbcm-v1.1beta1.json,sha256=xO5XloCQQULmPbFBx5bckdqmbLFQ7sJ2TImhE1ysDIY,19439
@@ -24,14 +24,14 @@ gam/atom/url.py,sha256=pxO1TlORxyKQTQ1bkBE1unFzjnv9c8LjJkm-UEORShY,4276
 gam/gamlib/__init__.py,sha256=z5mF-y0j8pm-YNFBaiuxB4M_GAUPG-cXWwrhYwrVReM,679
 gam/gamlib/glaction.py,sha256=1Il_HrChVnPkzZwiZs5au4mFQVtq4K1Z42uIuR6qdnI,9419
 gam/gamlib/glapi.py,sha256=u97M7Y2BeP3tYEEGYEz-9kY4fdV0fYkeqC3YN-sRwNc,36028
-gam/gamlib/glcfg.py,sha256=87OwNxPbZy9nZr9n-12RSqTYai3zsZNYtR5WBaia6Y0,27906
-gam/gamlib/glclargs.py,sha256=pgomQOKbiKOI5TfdC0hTT5BqGbQcikDMRfkUk6DEXrM,43881
-gam/gamlib/glentity.py,sha256=ZQTdjVtGe8soMlgcSHJIpLHjQ_UtUL9qfw8ux-C4kik,34855
+gam/gamlib/glcfg.py,sha256=7Ut-7sDTw-WVHZfvDWn_dlVNfuWd6VsPDBpQ3qnyzJE,28100
+gam/gamlib/glclargs.py,sha256=9Oze97BT_GS2WXf4LYg4JlSCmZ_8fG2a33Ft1_pX43k,44134
+gam/gamlib/glentity.py,sha256=8F98YR1ronheiQShD6WHlY-YnBKfMDrc33iRuRoLIvo,35097
 gam/gamlib/glgapi.py,sha256=pdBbwNtnCwFWxJGaP-_3hdTjSNoOCJF2yo76WdQOi1k,40426
 gam/gamlib/glgdata.py,sha256=weRppttWm6uRyqtBoGPKoHiNZ2h28nhfUV4J_mbCszY,2707
-gam/gamlib/glglobals.py,sha256=J0xcHggVrUBzHJ5GruenKV-qV1zPKcK2qWgAgN3i5Jw,9608
+gam/gamlib/glglobals.py,sha256=oJfaLUQj46XqwrOzRfWhGqO0f1P26xjJZefaILJUFGE,9695
 gam/gamlib/glindent.py,sha256=RfBa2LDfLIqPLL5vMfC689TCVmqn8xf-qulSzkiatrc,1228
-gam/gamlib/glmsgs.py,sha256=vephDvTNbv55f79QzZWEKDcBTXr8knrwDxvx-1TYM6M,33997
+gam/gamlib/glmsgs.py,sha256=uluaFxw5YCG1so9uvOYU6HvAwGJNqJcB1curD8hH-G0,34001
 gam/gamlib/glskus.py,sha256=e1u3zw1MGQjBgAFXqjrGWQl2d7eYpVlMYGpIKNwjskQ,15360
 gam/gamlib/gluprop.py,sha256=IyPLCyvn7-NHTUenM71YPQPXRZXx6CB5q-GtJ-FYd1c,11461
 gam/gamlib/glverlibs.py,sha256=xoQXiwcE_-HVYKv-VYA8O0mazRsc9mN-_ysj1dAlMyc,992
@@ -58,15 +58,15 @@ gam/googleapiclient/http.py,sha256=ITE51oqDBqN1-AA5D-Tnlj3egGc_5O0V5xSzBw3UTKI,6
 gam/googleapiclient/mimeparse.py,sha256=wwouQMCjppTocJtiQhkkTa27kocYwlFRALL2z11Xo1Y,6530
 gam/googleapiclient/model.py,sha256=NQDO1GhOGNVCJlSSCLOecdA11yf8RDXfSLFxYb3R7EE,14085
 gam/googleapiclient/schema.py,sha256=rR3u8WPQ_V8a7GCUsNuvtf6GxzwuMO0HaqsTBp3tnyM,10414
-gam/googleapiclient/version.py,sha256=vY1VaLgft_SIONbdSFPvHzipKt1agXbOX-Z-ZFbo9s0,599
+gam/googleapiclient/version.py,sha256=CQnalMsxpdK1_gw_iADQK3D0RNBQ2vMlzw3PbyNFWC4,599
 gam/googleapiclient/discovery_cache/__init__.py,sha256=ww_vl0vhVLuHSEdRTv3-gq6EDG--Ff7rILYHHFifnzc,2315
 gam/googleapiclient/discovery_cache/appengine_memcache.py,sha256=6T1pQj-toAhDwfgLuiggFGhxKNGw5y-NnLUzLIF_M4s,1657
 gam/googleapiclient/discovery_cache/base.py,sha256=yCDPtxnbNN-p5_9fzBacC6P3wcUPlaCQIy5v_dXTons,1389
 gam/googleapiclient/discovery_cache/file_cache.py,sha256=sim3Mg4HgRYo3vX75jvcKy_aV568EvIrtBfvfbw-044,4774
 gam/iso8601/__init__.py,sha256=Z2PsYbXgAH5a5xzUvgczCboPzqWpm65kRcIngCnhViU,1218
 gam/iso8601/iso8601.py,sha256=Li2FHZ4sBTWuthuQhyCvmvj0j6At8JbGzkSv2fc2RHU,4384
-gam7-7.19.3.dist-info/METADATA,sha256=TeUdQCPXnItSyqXwJbMSkU3f43C-2H1wKRyc2AF7YPM,2940
-gam7-7.19.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-gam7-7.19.3.dist-info/entry_points.txt,sha256=HVUM5J7dA8YwvJfG30jiLefR19ExMs387TWugWd9sf4,42
-gam7-7.19.3.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-gam7-7.19.3.dist-info/RECORD,,
+gam7-7.20.1.dist-info/METADATA,sha256=7C53COsDbo2DNmBB177TsMQBp3Y_fgnMnx88aqQXuHg,2940
+gam7-7.20.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+gam7-7.20.1.dist-info/entry_points.txt,sha256=HVUM5J7dA8YwvJfG30jiLefR19ExMs387TWugWd9sf4,42
+gam7-7.20.1.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+gam7-7.20.1.dist-info/RECORD,,