feat: convert to staff or partner

Author: thekaveman

README.md

@@ -25,8 +25,19 @@ for more information.
 bin/create.sh USER [OPTIONS]
 ```
 
-* `USER` is the username (sans domain) to create
-* `OPTIONS` is a list of options for [GAM user create](https://github.com/taers232c/GAMADV-XTD3/wiki/Users#create-a-user)
+- `USER` is the username (sans domain) to create
+- `OPTIONS` is a list of options for [GAM user create](https://github.com/taers232c/GAMADV-XTD3/wiki/Users#create-a-user)
+
+## Convert a user
+
+**Usage:**
+
+```bash
+bin/convert.sh USER TYPE
+```
+
+- `USER` is the username (sans domain) to convert
+- `TYPE` is either `STAFF` to convert the user to a staff member, or `PARTNER` to conver the user to a partner.
 
 ## Offboarding a user
 
@@ -36,9 +47,9 @@ bin/create.sh USER [OPTIONS]
 bin/offboard.sh USER [ALIAS]
 ```
 
-* `USER` is the username (sans domain) to offboard
-* `ALIAS` is optional, and is a username (sans domain) that will get an alias
-   added for the offboarded `USER`
+- `USER` is the username (sans domain) to offboard
+- `ALIAS` is optional, and is a username (sans domain) that will get an alias
+  added for the offboarded `USER`
 
 Read more about the [offboarding process in Compiler's notes](https://docs.google.com/document/d/1UEwQzJZyJEkRs3PRwOi0-KXwBFne70am4Nk9-_qYItE/edit#heading=h.liqi1hwxykhs).
 
@@ -48,4 +59,4 @@ This script creates a local backup of `USER`'s inbox; a separate script can be r
 bin/archive-gmail-backup.sh USER
 ```
 
-* `USER` is the account in compiler.la (sans domain) with a local backup to archive
+- `USER` is the account in compiler.la (sans domain) with a local backup to archive

bin/common.sh

@@ -6,6 +6,8 @@ DOMAIN="compiler.la"
 # Compiler's archive account
 ARCHIVE="archive@$DOMAIN"
 # Compiler groups
+PARTNERS="partners@$DOMAIN"
+STAFF="staff@$DOMAIN"
 TEAM="team@$DOMAIN"
 
 # prints a simple timestamp HH:mm:ss
@@ -31,3 +33,18 @@ archive_user_exists() {
         exit 1
     fi
 }
+
+user_in_group() {
+    user="$1"
+    group="$2"
+
+    gam print groups member "$user" | grep "$group" &> /dev/null
+}
+
+user_is_partner() {
+    user_in_group "$1" "$PARTNERS"
+}
+
+user_is_staff() {
+    user_in_group "$1" "$STAFF"
+}

bin/convert.sh

@@ -0,0 +1,54 @@
+#!/usr/bin/env bash
+set -u
+
+SCRIPT_DIR=$(builtin cd "$(dirname ${BASH_SOURCE[0]})" && builtin pwd)
+
+source "${SCRIPT_DIR}/common.sh"
+
+__usage="
+Usage: $(basename $0) USER TYPE
+
+Arguments:
+  USER         The account in $DOMAIN (sans domain) to convert
+  TYPE         The type of conversion [STAFF or PARTNER]
+"
+
+# print usage for -? or -h or --help
+if [[ "$#" -lt 1 || "$1" =~ ^(-\?|-h|--help)$ ]]; then
+    echo "$__usage"
+    exit 0
+fi
+
+# the full account name to convert
+ACCOUNT="$1@$DOMAIN"
+
+# verify $ACCOUNT exists before continuing
+if ! user_exists $ACCOUNT; then
+    echo_ts "Account $ACCOUNT does not exist, stopping"
+    exit 1
+else
+    echo_ts "Account $ACCOUNT exists, continuing..."
+fi
+
+TYPE="$2"
+
+if echo "$TYPE" | grep -i staff &> /dev/null; then
+    if user_is_staff "$ACCOUNT"; then
+        echo_ts "Account $ACCOUNT is already a member of $STAFF"
+        exit 1
+    fi
+    GROUP="$STAFF"
+elif echo "$TYPE" | grep -i partner &> /dev/null; then
+    if user_is_partner "$ACCOUNT"; then
+        echo_ts "Account $ACCOUNT is already a member of $PARTNERS"
+        exit 1
+    fi
+    GROUP="$PARTNERS"
+else
+    echo_ts "Unsupported conversion type: $TYPE"
+    exit 1
+fi
+
+echo_ts "Converting $ACCOUNT to $TYPE..."
+
+gam user $ACCOUNT add groups member $GROUP