python-class-usage.sh

#!/bin/bash

# find python classes that are declared once and then list files where the name is referenced
for candidate in \
   $(grep --exclude-dir=".git" --exclude-dir="__pycache__" -hoPR '^ *class \K[a-zA-Z0-9_]*' . | \
     sort | uniq -c | grep "    1 " | cut -c 9-)
   do
      REFERENCES=$(grep --exclude-dir=".git" --exclude-dir="__pycache__" -c -cR $candidate . | grep -v ":0")
      if [ "$(wc -l <<< "$REFERENCES")" -eq "1" ]; then
        if [[ $REFERENCES == *":1" ]]; then
          echo class $candidate is an unused declaration in ${REFERENCES%:*}
        elif [[ $candidate != "_"* ]]; then
          echo class $candidate is a public name only referred to in ${REFERENCES%:*}
        fi
      fi
   done