#!/usr/bin/env python3

"""

# Purpose: For a Google Drive User(s), show all shared drive file permissions for deleted groups/users

# Python: Use python or python3 below as appropriate to your system; verify that you have version 3

# $ python -V or python3 -V

# Python 3.x.y

# Usage:

# 1: Get ACLs for all files, if you don't want all users, replace all users with your user selection in the command below

# $ gam config auto_batch_min 1 redirect csv ./filelistperms.csv multiprocess all users print filelist fields id,title,permissions,owners.emailaddress,mimetype pm deleted true em pmfilter

# $ gam redirect csv ./filelistperms.csv user user@domain.com print filelist fields id,title,permissions,owners.emailaddress,mimetype pm deleted true em pmfilter

# 2: From that list of ACLs, output a CSV file that lists the shared file permissions

# $ python3 GetSharedFileDeletedPermissions.py filelistperms.csv deleteperms.csv

# 3: Inspect deleteperms.csv, verify that it makes sense and then proceed

# 4: If desired, delete the ACLs

# $ gam csv ./deleteperms.csv gam user "~Owner" delete drivefileacl "~driveFileId" "~permissionId"

"""

import csv

import re

import sys

FILE_NAME = 'name'

ALT_FILE_NAME = 'title'

QUOTE_CHAR = '"' # Adjust as needed

LINE_TERMINATOR = '\n' # On Windows, you probably want '\r\n'

PERMISSIONS_N_TYPE = re.compile(r"permissions.(\d+).type")

if (len(sys.argv) > 2) and (sys.argv[2] != '-'):

outputFile = open(sys.argv[2], 'w', encoding='utf-8', newline='')

else:

outputFile = sys.stdout

outputCSV = csv.DictWriter(outputFile, ['Owner', 'driveFileId', 'driveFileTitle', 'mimeType',

'permissionId', 'role', 'type'],

lineterminator=LINE_TERMINATOR, quotechar=QUOTE_CHAR)

outputCSV.writeheader()

if (len(sys.argv) > 1) and (sys.argv[1] != '-'):

inputFile = open(sys.argv[1], 'r', encoding='utf-8')

else:

inputFile = sys.stdin

for row in csv.DictReader(inputFile, quotechar=QUOTE_CHAR):

for k, v in iter(row.items()):

mg = PERMISSIONS_N_TYPE.match(k)

if mg and v:

permissions_N = mg.group(1)

if row.get(f'permissions.{permissions_N}.deleted') == 'True':

outputCSV.writerow({'Owner': row['owners.0.emailAddress'],

'driveFileId': row['id'],

'driveFileTitle': row.get(FILE_NAME, row.get(ALT_FILE_NAME, 'Unknown')),

'mimeType': row['mimeType'],

'permissionId': f'id:{row[f"permissions.{permissions_N}.id"]}',

'role': row[f'permissions.{permissions_N}.role'],

'type': v})

if inputFile != sys.stdin:

inputFile.close()

if outputFile != sys.stdout:

outputFile.close()