fix: Actually deprecate scratchdb methods

Author: faretek1

scratchattach/site/project.py

@@ -9,6 +9,7 @@
 from io import BytesIO
 
 from typing import Any
+from typing_extensions import deprecated
 from . import user, comment, studio
 from scratchattach.utils import exceptions
 from scratchattach.utils import commons
@@ -487,8 +488,8 @@ def set_fields(self, fields_dict, *, use_site_api=False):
         use_site_api (bool):
             When enabled, the fields are set using the scratch.mit.edu/site-api API.
             This function allows setting more fields than Project.set_fields.
-            For example you can also share / unshare the project by setting the "shared" field.
-            According to the Scratch team, this API is deprecated. As of 2024 it's still fully functional tho.
+            For example, you can also share / unshare the project by setting the "shared" field.
+            According to the Scratch team, this API is deprecated. As of 2024 it's still fully functional though.
         """
         self._assert_permission()
         if use_site_api:
@@ -716,7 +717,7 @@ def set_notes(self, text):
         """
         self.set_fields({"description": text})
 
-
+    @deprecated("Deprecated because ScratchDB is down indefinitely.")
     def ranks(self):
         """
         Gets information about the project's ranks. Fetched from ScratchDB.
@@ -727,7 +728,6 @@ def ranks(self):
         Returns:
             dict: A dict containing the project's ranks. If the ranks aren't available, all values will be -1.
         """
-        print("Warning: Project.ranks method is deprecated because ScratchDB is down indefinitely.")
         return requests.get(
             f"https://scratchdb.lefty.one/v3/project/info/{self.id}"
         ).json()["statistics"]["ranks"]

scratchattach/site/user.py

@@ -824,6 +824,7 @@ def comment_by_id(self, comment_id) -> comment.Comment:
     def message_events(self):
         return message_events.MessageEvents(self)
 
+    @deprecated("This method is deprecated because ScratchDB is down indefinitely.")
     def stats(self):
         """
         Gets information about the user's stats. Fetched from ScratchDB.
@@ -834,7 +835,6 @@ def stats(self):
         Returns:
             dict: A dict containing the user's stats. If the stats aren't available, all values will be -1.
         """
-        print("Warning: ScratchDB is down indefinitely, therefore this method is deprecated.")
         try:
             stats= requests.get(
                 f"https://scratchdb.lefty.one/v3/user/info/{self.username}"
@@ -844,6 +844,7 @@ def stats(self):
             stats = {"loves":-1,"favorites":-1,"comments":-1,"views":-1,"followers":-1,"following":-1}
         return stats
 
+    @deprecated("Warning: ScratchDB is down indefinitely, therefore this method is deprecated.")
     def ranks(self):
         """
         Gets information about the user's ranks. Fetched from ScratchDB.
@@ -854,7 +855,6 @@ def ranks(self):
         Returns:
             dict: A dict containing the user's ranks. If the ranks aren't available, all values will be -1.
         """
-        print("Warning: ScratchDB is down indefinitely, therefore this method is deprecated.")
         try:
             return requests.get(
                 f"https://scratchdb.lefty.one/v3/user/info/{self.username}"