user-scanner 1.0.5.0__py3-none-any.whl → 1.0.9.0__py3-none-any.whl

user_scanner/gaming/monkeytype.py

@@ -1,4 +1,5 @@
-from ..core.orchestrator import generic_validate
+from user_scanner.core.orchestrator import generic_validate
+from user_scanner.core.result import Result
 
 def validate_monkeytype(user: str) -> int:
 
@@ -24,21 +25,15 @@ def validate_monkeytype(user: str) -> int:
             available = payload.get("available")
 
             if available is True:
-                return 1
+                return Result.available()
             elif available is False:
-                return 0
-        return 2
-    
+                return Result.taken()
+        return Result.error("Invalid status code")
 
-    return generic_validate(url, process, headers = headers)
+    return generic_validate(url, process, headers=headers)
 
-if __name__ == "__main__":
-    try:
-        import httpx  # noqa: F401
-    except ImportError:
-        print("Error: 'httpx' library is not installed.")
-        raise SystemExit(1)
 
+if __name__ == "__main__":
     user = input("Username?: ").strip()
     result = validate_monkeytype(user)
 

user_scanner/gaming/osu.py

@@ -1,22 +1,19 @@
-from ..core.orchestrator import status_validate
+from user_scanner.core.orchestrator import status_validate
+
 
 def validate_osu(user):
-    """
-    Checks if a Osu username is available.
-    Returns: 1 -> available, 0 -> taken, 2 -> error
-    """
-    
     url = f"https://osu.ppy.sh/users/{user}"
-    
-    return status_validate(url, 404, [200, 302], follow_redirects = True)
+
+    return status_validate(url, 404, [200, 302], follow_redirects=True)
+
 
 if __name__ == "__main__":
-   user = input ("Username?: ").strip()
-   result = validate_osu(user)
+    user = input("Username?: ").strip()
+    result = validate_osu(user)
 
-   if result == 1:
-      print("Available!")
-   elif result == 0:
-      print("Unavailable!")
-   else:
-      print("Error occurred!")
+    if result == 1:
+        print("Available!")
+    elif result == 0:
+        print("Unavailable!")
+    else:
+        print("Error occurred!")

user_scanner/gaming/roblox.py

@@ -1,34 +1,43 @@
-from ..core.orchestrator import generic_validate
+from user_scanner.core.orchestrator import generic_validate
+from user_scanner.core.result import Result
 
-def validate_roblox(user):
-    """
-    Checks if a roblox username is available.
-    Returns: 1 -> available, 0 -> taken, 2 -> error
-    """
 
-    url = f"https://users.roblox.com/v1/users/search?keyword={user}&limit=10" # official api
+def validate_roblox(user):
+    # official api
+    url = f"https://users.roblox.com/v1/users/search?keyword={user}&limit=10"
 
     def process(response):
-        search_results = response.json() # api response
-
-        if "errors" in search_results: # this usually triggers when timeout or ratelimit
-            return 2
-
-        for entry in search_results["data"]: # iterates through the entries in the search results
+        search_results = response.json()  # api response
+
+        if response.status_code == 429:
+            return Result.error("Too many requests")
+
+        if response.status_code == 400:
+            error = search_results["errors"][0] #Api states theres always an error
+            if error["code"] == 6:
+                return Result.error("Username is too short")
+            if error["code"] == 5:
+                return Result.error("Username was filtered")
+            #Shouldn't be able to reach this
+            return Result.error("Invalid username")
+
+        # iterates through the entries in the search results
+        for entry in search_results["data"]:
             # .lower() so casing from the API doesn't matter
-            if entry["name"].lower() == user.lower(): # if a username matches the user
-                return 0
-        return 1
+            if entry["name"].lower() == user.lower():  # if a username matches the user
+                return Result.taken()
+        return Result.available()
+
+    return generic_validate(url, process, follow_redirects=True)
 
-    return generic_validate(url, process, follow_redirects = True)
 
 if __name__ == "__main__":
-   user = input ("Username?: ").strip()
-   result = validate_roblox(user)
-
-   if result == 1:
-      print("Available!")
-   elif result == 0:
-      print("Unavailable!")
-   else:
-      print("Error occurred!")
+    user = input("Username?: ").strip()
+    result = validate_roblox(user)
+
+    if result == 1:
+        print("Available!")
+    elif result == 0:
+        print("Unavailable!")
+    else:
+        print("Error occurred!")

user_scanner/gaming/steam.py

@@ -1,30 +1,29 @@
-from ..core.orchestrator import generic_validate
+from user_scanner.core.orchestrator import generic_validate
+from user_scanner.core.result import Result
 
-def validate_steam(user):
-    """
-    Checks if a steam username is available.
-    Returns: 1 -> available, 0 -> taken, 2 -> error
-    """
 
+def validate_steam(user):
     url = f"https://steamcommunity.com/id/{user}/"
 
     def process(response):
         if response.status_code == 200:
-            if response.text.find("Error</title>") != -1:
-                return 1
+            if "Error</title>" in response.text:
+                return Result.available()
             else:
-                return 0
-        return 2
+                return Result.taken()
+
+        return Result.error("Invalid status code")
 
     return generic_validate(url, process)
 
+
 if __name__ == "__main__":
-   user = input ("Username?: ").strip()
-   result = validate_steam(user)
-
-   if result == 1:
-      print("Available!")
-   elif result == 0:
-      print("Unavailable!")
-   else:
-      print("Error occurred!")
+    user = input("Username?: ").strip()
+    result = validate_steam(user)
+
+    if result == 1:
+        print("Available!")
+    elif result == 0:
+        print("Unavailable!")
+    else:
+        print("Error occurred!")

user_scanner/social/bluesky.py

@@ -1,5 +1,6 @@
-import re
-from ..core.orchestrator import generic_validate
+from user_scanner.core.orchestrator import generic_validate
+from user_scanner.core.result import Result
+
 
 def validate_bluesky(user):
     handle = user if user.endswith('.bsky.social') else f"{user}.bsky.social"
@@ -24,35 +25,30 @@ def validate_bluesky(user):
         'handle': handle,
     }
 
-    if not re.fullmatch(r"^[a-zA-Z0-9\.-]{1,64}$", user):
-        return 2
-    
     def process(response):
         if response.status_code == 200:
             data = response.json()
             result_type = data.get('result', {}).get('$type')
 
             if result_type == "com.atproto.temp.checkHandleAvailability#resultAvailable":
-                return 1
+                return Result.available()
             elif result_type == "com.atproto.temp.checkHandleAvailability#resultUnavailable":
-                return 0
-        return 2
+                return Result.taken()
+        elif response.status_code == 400:
+            return Result.error("Username can only contain letters, numbers, hyphens (no leading/trailing)")
+
+        return Result.error("Invalid status code!")
+
+    return generic_validate(url, process, headers=headers, params=params, timeout=15.0)
 
-    return generic_validate(url, process, headers = headers, params = params, timeout = 15.0)
 
 if __name__ == "__main__":
-   try:
-       import httpx
-   except ImportError:
-       print("Error: 'httpx' library is not installed.")
-       exit()
-
-   user = input ("Username?: ").strip()
-   result = validate_bluesky(user)
-
-   if result == 1:
-      print("Available!")
-   elif result == 0:
-      print("Unavailable!")
-   else:
-      print("Error occured!")
+    user = input("Username?: ").strip()
+    result = validate_bluesky(user)
+
+    if result == 1:
+        print("Available!")
+    elif result == 0:
+        print("Unavailable!")
+    else:
+        print("Error occured!")

user_scanner/social/discord.py

@@ -1,5 +1,5 @@
 import httpx
-from httpx import ConnectError, TimeoutException
+from user_scanner.core.result import Result
 
 def validate_discord(user):
     url = "https://discord.com/api/v9/unique-username/username-attempt-unauthed"
@@ -12,33 +12,29 @@ def validate_discord(user):
         "origin": "https://discord.com",
         "referer": "https://discord.com/register"
     }
-    
+
     data = {"username": user}
-    
+
     try:
         response = httpx.post(url, headers=headers, json=data, timeout=3.0)
         if response.status_code == 200:
             status = response.json().get("taken")
             if status is True:
-                return 0
+                return Result.taken()
             elif status is False:
-                return 1
-        return 2
-    except (ConnectError, TimeoutException):
-        return 2
-    except Exception:
-        return 2
-
-if __name__ == "__main__":
-   user = input ("Username?: ").strip()
-   result = validate_discord(user)
-   
-   if result == 1:
-      print("Available!")
-   elif result == 0:
-      print("Unavailable!")
-   else:
-      print("Error occured!")
+                return Result.available()
+        return Result.error("Invalid status code")
+    except Exception as e:
+        return Result.error(e)
 
 
+if __name__ == "__main__":
+    user = input("Username?: ").strip()
+    result = validate_discord(user)
 
+    if result == 1:
+        print("Available!")
+    elif result == 0:
+        print("Unavailable!")
+    else:
+        print("Error occured!")

user_scanner/social/instagram.py

@@ -1,27 +1,29 @@
-from ..core.orchestrator import status_validate
+from user_scanner.core.orchestrator import status_validate
+
 
 def validate_instagram(user):
-   url = f"https://www.instagram.com/api/v1/users/web_profile_info/?username={user}"
+    url = f"https://www.instagram.com/api/v1/users/web_profile_info/?username={user}"
+
+    headers = {
+        'User-Agent': "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/128.0.0.0 Safari/537.36",
+        'X-IG-App-ID': "936619743392459",
+        'Accept': "application/json, text/javascript, */*; q=0.01",
+        'Accept-Encoding': "gzip, deflate, br",
+        'Accept-Language': "en-US,en;q=0.9",
+        'X-Requested-With': "XMLHttpRequest",
+        'Referer': f"https://www.instagram.com/{user}/",
+    }
 
-   headers = {
-      'User-Agent': "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/128.0.0.0 Safari/537.36",
-      'X-IG-App-ID': "936619743392459",
-      'Accept': "application/json, text/javascript, */*; q=0.01",
-      'Accept-Encoding': "gzip, deflate, br",
-      'Accept-Language': "en-US,en;q=0.9",
-      'X-Requested-With': "XMLHttpRequest",
-      'Referer': f"https://www.instagram.com/{user}/",
-   }
+    return status_validate(url, 404, 200, headers=headers)
 
-   return status_validate(url, 404, 200, headers = headers)
 
 if __name__ == "__main__":
-   user = input ("Username?: ").strip()
-   result = validate_instagram(user)
+    user = input("Username?: ").strip()
+    result = validate_instagram(user)
 
-   if result == 1:
-      print("Available!")
-   elif result == 0:
-      print("Unavailable!")
-   else:
-      print("Error occured!")
+    if result == 1:
+        print("Available!")
+    elif result == 0:
+        print("Unavailable!")
+    else:
+        print("Error occured!")

user_scanner/social/mastodon.py

@@ -1,23 +1,19 @@
-from ..core.orchestrator import status_validate
+from user_scanner.core.orchestrator import status_validate
+
 
 def validate_mastodon(user):
     url = f"https://mastodon.social/@{user}"
 
-    return status_validate(url, 404, 200, follow_redirects = True)
+    return status_validate(url, 404, 200, follow_redirects=True)
 
-if __name__ == "__main__":
-   try:
-       import httpx
-   except ImportError:
-       print("Error: 'httpx' library is not installed.")
-       exit()
 
-   user = input ("Username?: ").strip()
-   result = validate_mastodon(user)
+if __name__ == "__main__":
+    user = input("Username?: ").strip()
+    result = validate_mastodon(user)
 
-   if result == 1:
-      print("Available!")
-   elif result == 0:
-      print("Unavailable!")
-   else:
-      print("Error occured!")
+    if result == 1:
+        print("Available!")
+    elif result == 0:
+        print("Unavailable!")
+    else:
+        print("Error occured!")

user_scanner/social/pinterest.py

@@ -1,4 +1,5 @@
-from ..core.orchestrator import generic_validate
+from user_scanner.core.orchestrator import generic_validate
+from user_scanner.core.result import Result
 
 def validate_pinterest(user):
     url = f"https://www.pinterest.com/{user}/"
@@ -6,21 +7,22 @@ def validate_pinterest(user):
     def process(response):
         if response.status_code == 200:
             if "User not found." in response.text:
-                return 1
+                return Result.available()
             else:
-                return 0
+                return Result.taken()
         else:
-           return 2
+            return Result.error("Invalid status code")
+
+    return generic_validate(url, process, follow_redirects=True)
 
-    return generic_validate(url, process, follow_redirects = True)
 
 if __name__ == "__main__":
-   user = input ("Username?: ").strip()
-   result = validate_pinterest(user)
+    user = input("Username?: ").strip()
+    result = validate_pinterest(user)
 
-   if result == 1:
-      print("Available!")
-   elif result == 0:
-      print("Unavailable!")
-   else:
-      print("Error occured!")
+    if result == 1:
+        print("Available!")
+    elif result == 0:
+        print("Unavailable!")
+    else:
+        print("Error occured!")

user_scanner/social/reddit.py

@@ -1,4 +1,6 @@
-from ..core.orchestrator import generic_validate
+from user_scanner.core.orchestrator import generic_validate
+from user_scanner.core.result import Result
+
 
 def validate_reddit(user):
     url = f"https://www.reddit.com/user/{user}/"
@@ -6,21 +8,22 @@ def validate_reddit(user):
     def process(response):
         if response.status_code == 200:
             if "Sorry, nobody on Reddit goes by that name." in response.text:
-                return 1
+                return Result.available()
             else:
-                return 0
+                return Result.taken()
         else:
-           return 2
+            return Result.error()
+
+    return generic_validate(url, process, follow_redirects=True)
 
-    return generic_validate(url, process, follow_redirects = True)
 
 if __name__ == "__main__":
-   user = input ("Username?: ").strip()
-   result = validate_reddit(user)
+    user = input("Username?: ").strip()
+    result = validate_reddit(user)
 
-   if result == 1:
-      print("Available!")
-   elif result == 0:
-      print("Unavailable!")
-   else:
-      print("Error occured!")
+    if result == 1:
+        print("Available!")
+    elif result == 0:
+        print("Unavailable!")
+    else:
+        print("Error occured!")

user_scanner/social/snapchat.py

@@ -1,33 +1,35 @@
-from ..core.orchestrator import status_validate
+from user_scanner.core.orchestrator import status_validate
+
 
 def validate_snapchat(user):
-   url = f"https://www.snapchat.com/@{user}"
+    url = f"https://www.snapchat.com/@{user}"
+
+    headers = {
+        'User-Agent': "Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/141.0.0.0 Mobile Safari/537.36",
+        'Accept': "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7",
+        'Accept-Encoding': "gzip, deflate, br, zstd",
+        'sec-ch-ua': "\"Google Chrome\";v=\"141\", \"Not?A_Brand\";v=\"8\", \"Chromium\";v=\"141\"",
+        'sec-ch-ua-mobile': "?1",
+        'sec-ch-ua-platform': "\"Android\"",
+        'upgrade-insecure-requests': "1",
+        'sec-fetch-site': "none",
+        'sec-fetch-mode': "navigate",
+        'sec-fetch-user': "?1",
+        'sec-fetch-dest': "document",
+        'accept-language': "en-US,en;q=0.9",
+        'priority': "u=0, i"
+    }
 
-   headers = {
-      'User-Agent': "Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/141.0.0.0 Mobile Safari/537.36",
-      'Accept': "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7",
-      'Accept-Encoding': "gzip, deflate, br, zstd",
-      'sec-ch-ua': "\"Google Chrome\";v=\"141\", \"Not?A_Brand\";v=\"8\", \"Chromium\";v=\"141\"",
-      'sec-ch-ua-mobile': "?1",
-      'sec-ch-ua-platform': "\"Android\"",
-      'upgrade-insecure-requests': "1",
-      'sec-fetch-site': "none",
-      'sec-fetch-mode': "navigate",
-      'sec-fetch-user': "?1",
-      'sec-fetch-dest': "document",
-      'accept-language': "en-US,en;q=0.9",
-      'priority': "u=0, i"
-   }
+    return status_validate(url, 404, 200, headers=headers, follow_redirects=True)
 
-   return status_validate(url, 404, 200, headers = headers, follow_redirects = True)
 
 if __name__ == "__main__":
-   user = input ("Username?: ").strip()
-   result = validate_snapchat(user)
+    user = input("Username?: ").strip()
+    result = validate_snapchat(user)
 
-   if result == 1:
-      print("Available!")
-   elif result == 0:
-      print("Unavailable!")
-   else:
-      print("Error occured!")
+    if result == 1:
+        print("Available!")
+    elif result == 0:
+        print("Unavailable!")
+    else:
+        print("Error occured!")

user_scanner/social/soundcloud.py

@@ -0,0 +1,43 @@
+from user_scanner.core.orchestrator import generic_validate
+from user_scanner.core.result import Result
+
+
+def validate_soundcloud(user):
+    url = f"https://soundcloud.com/{user}"
+
+    headers = {
+        'User-Agent': "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36",
+        'Accept': "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
+    }
+
+    def process(response):
+        if response.status_code == 404:
+            return Result.available()
+
+        if response.status_code == 200:
+            text = response.text
+
+            if f'soundcloud://users:{user}' in text:
+                return Result.taken()
+            if f'"username":"{user}"' in text:
+                return Result.taken()
+            if 'soundcloud://users:' in text and '"username":"' in text:
+                return Result.taken()
+
+            return Result.available()
+
+        return Result.error()
+
+    return generic_validate(url, process, headers=headers, follow_redirects=True)
+
+
+if __name__ == "__main__":
+    user = input("Username?: ").strip()
+    result = validate_soundcloud(user)
+
+    if result == 1:
+        print("Available!")
+    elif result == 0:
+        print("Unavailable!")
+    else:
+        print("Error occured!")

user_scanner/social/telegram.py

@@ -1,27 +1,29 @@
 import re
-from ..core.orchestrator import generic_validate
+from user_scanner.core.orchestrator import generic_validate
+from user_scanner.core.result import Result
+
 
 def validate_telegram(user: str) -> int:
-    """
-    Checks if a Telegram username is available.
-    Returns: 1 -> available, 0 -> taken, 2 -> error
-    """
     url = f"https://t.me/{user}"
 
     def process(r):
         if r.status_code == 200:
-            return 0 if re.search(r'<div[^>]*class="tgme_page_extra"[^>]*>', r.text) else 1
-        return 2
-    
-    return generic_validate(url, process, follow_redirects = True)
+            if re.search(r'<div[^>]*class="tgme_page_extra"[^>]*>', r.text):
+                return Result.taken() 
+            else:
+                return Result.available()
+        return Result.error()
+
+    return generic_validate(url, process, follow_redirects=True)
+
 
 if __name__ == "__main__":
-   user = input ("Username?: ").strip()
-   result = validate_telegram(user)
+    user = input("Username?: ").strip()
+    result = validate_telegram(user)
 
-   if result == 1:
-      print("Available!")
-   elif result == 0:
-      print("Unavailable!")
-   else:
-      print("Error occured!")
+    if result == 1:
+        print("Available!")
+    elif result == 0:
+        print("Unavailable!")
+    else:
+        print("Error occured!")