feat: empty search query

solves #432

Author: faretek1

scratchattach/site/session.py

@@ -496,9 +496,11 @@ def search_projects(self, *, query: str = "", mode: str = "trending", language:
         Returns:
             list<scratchattach.project.Project>: List that contains the search results.
         """
+        query = f"&q={query}" if query else ""
+
         response = commons.api_iterative(
             f"https://api.scratch.mit.edu/search/projects", limit=limit, offset=offset,
-            add_params=f"&language={language}&mode={mode}&q={query}")
+            add_params=f"&language={language}&mode={mode}{query}")
         return commons.parse_object_list(response, project.Project, self)
 
     def explore_projects(self, *, query: str = "*", mode: str = "trending", language: str = "en", limit: int = 40,
@@ -526,20 +528,19 @@ def explore_projects(self, *, query: str = "*", mode: str = "trending", language
 
     def search_studios(self, *, query: str = "", mode: str = "trending", language: str = "en", limit: int = 40,
                        offset: int = 0) -> list[studio.Studio]:
-        if not query:
-            raise ValueError("The query can't be empty for search")
+        query = f"&q={query}" if query else ""
+
         response = commons.api_iterative(
             f"https://api.scratch.mit.edu/search/studios", limit=limit, offset=offset,
-            add_params=f"&language={language}&mode={mode}&q={query}")
+            add_params=f"&language={language}&mode={mode}{query}")
         return commons.parse_object_list(response, studio.Studio, self)
 
     def explore_studios(self, *, query: str = "", mode: str = "trending", language: str = "en", limit: int = 40,
                         offset: int = 0) -> list[studio.Studio]:
-        if not query:
-            raise ValueError("The query can't be empty for explore")
+        query = f"&q={query}" if query else ""
         response = commons.api_iterative(
             f"https://api.scratch.mit.edu/explore/studios", limit=limit, offset=offset,
-            add_params=f"&language={language}&mode={mode}&q={query}")
+            add_params=f"&language={language}&mode={mode}{query}")
         return commons.parse_object_list(response, studio.Studio, self)
 
     # --- Create project API ---

tests/test_search.py

@@ -0,0 +1,16 @@
+import sys
+
+
+def test_search():
+    sys.path.insert(0, ".")
+    import scratchattach as sa
+    from util import session
+    sess = session()
+
+    print(sess.search_projects())
+    print(sess.explore_projects())
+    print(sess.search_studios())
+    print(sess.explore_studios())
+
+if __name__ == "__main__":
+    test_search()