feat: unfollowers

NOTE: this method requests ALL followers twice. So it can be slow. Don't spam.
solves #461

Author: faretek1

scratchattach/site/user.py

@@ -247,6 +247,33 @@ def featured_data(self):
         except Exception:
             return None
 
+    def unfollowers(self) -> list[User]:
+        """
+        Get all unfollowers by comparing API response and HTML response.
+        NOTE: This method can take a long time to run.
+
+        Based on https://juegostrower.github.io/unfollowers/
+        """
+        follower_count = self.follower_count()
+
+        # regular followers
+        usernames = []
+        for i in range(1, 2 + follower_count // 60):
+            with requests.no_error_handling():
+                resp = requests.get(f"https://scratch.mit.edu/users/{self.username}/followers/", params={"page": i})
+            soup = BeautifulSoup(resp.text, "html.parser")
+            usernames.extend(span.text.strip() for span in soup.select("span.title"))
+
+        # api response contains all-time followers, including deleted and unfollowed
+        unfollowers = []
+        for offset in range(0, follower_count, 40):
+            unfollowers.extend(user for user in self.followers(offset=offset, limit=40) if user.username not in usernames)
+
+        return unfollowers
+
+    def unfollower_usernames(self) -> list[str]:
+        return [user.username for user in self.unfollowers()]
+
     def follower_count(self):
         with requests.no_error_handling():
             text = requests.get(

tests/test_user.py

@@ -2,12 +2,15 @@
 import sys
 
 
-def test_import():
+def test_user():
     sys.path.insert(0, ".")
     import scratchattach as sa
     from util import session
     sess = session()
 
+    user = sess.connect_user("faretek1")
+    assert "mochipiyo" in user.unfollower_usernames()
+
     user = sess.connect_user("ScratchAttachV2")
 
     assert user.id == 147905216
@@ -87,3 +90,6 @@ def test_import():
     status_data = user.ocular_status()
     assert status_data["status"] == "Sample status"
     assert status_data["color"] == "#855cd6"
+
+if __name__ == '__main__':
+    test_user()