user-scanner 1.0.7.0__py3-none-any.whl → 1.0.8.0__py3-none-any.whl

user_scanner/core/orchestrator.py

@@ -1,33 +1,18 @@
 import importlib
-import pkgutil
 from colorama import Fore, Style
 import threading
 from itertools import permutations
 import httpx
-from httpx import ConnectError, TimeoutException
 from pathlib import Path
-from typing import Dict
+from user_scanner.core.result import Result, AnyResult
+from typing import Callable, Dict, List
 
 lock = threading.Condition()
 # Basically which thread is the one to print
 print_queue = 0
 
 
-def load_categories() -> Dict[str, Path]:
-    root = Path(__file__).resolve().parent.parent  # Should be user_scanner
-    categories = {}
-
-    for subfolder in root.iterdir():
-        if subfolder.is_dir() and \
-                not subfolder.name.lower() in ["cli", "utils", "core"] and \
-                not "__" in subfolder.name:  # Removes __pycache__
-            categories[subfolder.name] = subfolder.resolve()
-
-    return categories
-
-
 def load_modules(category_path: Path):
-
     modules = []
     for file in category_path.glob("*.py"):
         if file.name == "__init__.py":
@@ -40,6 +25,19 @@ def load_modules(category_path: Path):
     return modules
 
 
+def load_categories() -> Dict[str, Path]:
+    root = Path(__file__).resolve().parent.parent  # Should be user_scanner
+    categories = {}
+
+    for subfolder in root.iterdir():
+        if subfolder.is_dir() and \
+                not subfolder.name.lower() in ["cli", "utils", "core"] and \
+                not "__" in subfolder.name:  # Removes __pycache__
+            categories[subfolder.name] = subfolder.resolve()
+
+    return categories
+
+
 def worker_single(module, username, i):
     global print_queue
 
@@ -53,12 +51,17 @@ def worker_single(module, username, i):
     if func:
         try:
             result = func(username)
+            reason = ""
+
+            if isinstance(result, Result) and result.has_reason():
+                reason = f" ({result.get_reason()})"
+
             if result == 1:
                 output = f"  {Fore.GREEN}[✔] {site_name} ({username}): Available{Style.RESET_ALL}"
             elif result == 0:
                 output = f"  {Fore.RED}[✘] {site_name} ({username}): Taken{Style.RESET_ALL}"
             else:
-                output = f"  {Fore.YELLOW}[!] {site_name} ({username}): Error{Style.RESET_ALL}"
+                output = f"  {Fore.YELLOW}[!] {site_name} ({username}): Error{reason}{Style.RESET_ALL}"
         except Exception as e:
             output = f"  {Fore.YELLOW}[!] {site_name}: Exception - {e}{Style.RESET_ALL}"
     else:
@@ -106,7 +109,7 @@ def run_checks(username):
         print()
 
 
-def make_get_request(url, **kwargs):
+def make_get_request(url: str, **kwargs) -> httpx.Response:
     """Simple wrapper to **httpx.get** that predefines headers and timeout"""
     if not "headers" in kwargs:
         kwargs["headers"] = {
@@ -123,26 +126,24 @@ def make_get_request(url, **kwargs):
     return httpx.get(url, **kwargs)
 
 
-def generic_validate(url, func, **kwargs):
+def generic_validate(url: str, func: Callable[[httpx.Response], AnyResult], **kwargs) -> AnyResult:
     """
     A generic validate function that makes a request and executes the provided function on the response.
     """
     try:
         response = make_get_request(url, **kwargs)
         return func(response)
-    except (ConnectError, TimeoutException):
-        return 2
-    except Exception:
-        return 2
+    except Exception as e:
+        return Result.error(e)
 
 
-def status_validate(url, available, taken, **kwargs):
+def status_validate(url: str, available: int | List[int], taken: int | List[int], **kwargs) -> Result:
     """
     Function that takes a **url** and **kwargs** for the request and 
     checks if the request status matches the availabe or taken.
     **Available** and **Taken** must either be whole numbers or lists of whole numbers.
     """
-    def inner(response):
+    def inner(response: httpx.Response):
         # Checks if a number is equal or is contained inside
         def contains(a, b): return (isinstance(a, list) and b in a) or (a == b)
         status = response.status_code
@@ -150,12 +151,13 @@ def status_validate(url, available, taken, **kwargs):
         taken_value = contains(taken, status)
 
         if available_value and taken_value:
-            return 2  # Can't be both available and taken
+            # Can't be both available and taken
+            return Result.error("Invalid status match. Report this on Github.")
         elif available_value:
-            return 1
+            return Result.available()
         elif taken_value:
-            return 0
-        return 2
+            return Result.taken()
+        return Result.error("Status didn't match. Report this on Github.")
 
     return generic_validate(url, inner, **kwargs)
 

user_scanner/core/result.py

@@ -0,0 +1,79 @@
+from enum import Enum
+from typing import Literal
+
+
+def humanize_exception(e: Exception) -> str:
+    msg = str(e).lower()
+
+    if "10054" in msg:
+        return "Connection closed by remote server"
+    if "11001" in msg:
+        return "Could not resolve hostname"
+
+    return str(e)
+
+
+class Status(Enum):
+    TAKEN = 0
+    AVAILABLE = 1
+    ERROR = 2
+
+
+class Result:
+    def __init__(self, status: Status, reason: str | Exception | None = None):
+        self.status = status
+        self.reason = reason
+
+    @classmethod
+    def taken(cls):
+        return cls(Status.TAKEN)
+
+    @classmethod
+    def available(cls):
+        return cls(Status.AVAILABLE)
+
+    @classmethod
+    def error(cls, reason: str | Exception | None = None):
+        return cls(Status.ERROR, reason)
+
+    @classmethod
+    def from_number(cls, i: int, reason: str | Exception | None = None):
+        try:
+            status = Status(i)
+        except ValueError:
+            return cls(Status.ERROR, "Invalid status. Please contact maintainers.")
+
+        return cls(status,  reason if status == Status.ERROR else None)
+
+    def to_number(self) -> int:
+        return self.status.value
+
+    def has_reason(self) -> bool:
+        return self.reason != None
+
+    def get_reason(self) -> str:
+        if self.reason == None:
+            return ""
+        if isinstance(self.reason, str):
+            return self.reason
+        #Format the exception
+        msg = humanize_exception(self.reason)
+        return f"{type(self.reason).__name__}: {msg.capitalize()}"
+
+    def __str__(self):
+        return self.get_reason()
+
+    def __eq__(self, other):
+        if isinstance(other, Status):
+            return self.status == other
+
+        if isinstance(other, Result):
+            return self.status == other.status
+
+        if isinstance(other, int):
+            return self.to_number() == other
+
+        return NotImplemented
+
+
+AnyResult = Literal[0, 1, 2] | Result

user_scanner/creator/hashnode.py

@@ -1,6 +1,5 @@
 import httpx
-import json
-from httpx import ConnectError, TimeoutException
+from user_scanner.core.result import Result
 
 
 def validate_hashnode(user):
@@ -27,21 +26,17 @@ def validate_hashnode(user):
 
             if 'status' in data:
                 if data['status'] == 1:
-                    return 1
+                    return Result.available()
                 elif data['status'] == 0:
-                    return 0
+                    return Result.taken()
 
-            return 2
+            return Result.error("Status not found")
 
         else:
-            return 2
-
-    except (ConnectError, TimeoutException):
-        return 2
-    except json.JSONDecodeError:
-        return 2
-    except Exception:
-        return 2
+            return Result.error("Invalid status code")
+
+    except Exception as e:
+        return Result.error(e)
 
 
 if __name__ == "__main__":

user_scanner/creator/itch_io.py

@@ -2,11 +2,6 @@ from user_scanner.core.orchestrator import status_validate
 
 
 def validate_itch_io(user):
-    """
-    Checks if a itch.io username is available.
-    Returns: 1 -> available, 0 -> taken, 2 -> error
-    """
-
     url = f"https://{user}.itch.io"
 
     return status_validate(url, 404, 200, follow_redirects=True)

user_scanner/creator/medium.py

@@ -1,5 +1,5 @@
-import httpx
-from httpx import ConnectError, TimeoutException
+from user_scanner.core.orchestrator import generic_validate
+from user_scanner.core.result import Result
 
 
 def validate_medium(user):
@@ -10,24 +10,19 @@ def validate_medium(user):
         'Accept': "text/html",
     }
 
-    try:
-        response = httpx.get(url, headers=headers, timeout=3.0)
-
+    def process(response):
         if response.status_code == 200:
             html_text = response.text
 
             username_tag = f'property="profile:username" content="{user}"'
 
             if username_tag in html_text:
-                return 0
+                return Result.taken()
             else:
-                return 1
-        return 2
+                return Result.available()
+        return Result.error()
 
-    except (ConnectError, TimeoutException):
-        return 2
-    except Exception:
-        return 2
+    return generic_validate(url, process, headers=headers)
 
 
 if __name__ == "__main__":

user_scanner/creator/patreon.py

@@ -8,12 +8,6 @@ def validate_patreon(user):
 
 
 if __name__ == "__main__":
-    try:
-        import httpx
-    except ImportError:
-        print("Error: 'httpx' library is not installed.")
-        exit()
-
     user = input("Username?: ").strip()
     result = validate_patreon(user)
 

user_scanner/creator/producthunt.py

@@ -1,5 +1,4 @@
-import httpx
-from httpx import ConnectError, TimeoutException
+from user_scanner.core.orchestrator import status_validate
 
 
 def validate_producthunt(user):
@@ -12,23 +11,7 @@ def validate_producthunt(user):
         'Accept-Language': "en-US,en;q=0.9",
     }
 
-    try:
-        response = httpx.get(url, headers=headers,
-                             timeout=3.0, follow_redirects=True)
-        status = response.status_code
-
-        if status == 200:
-            return 0
-        elif status == 404:
-            return 1
-        else:
-            return 2
-
-    except (ConnectError, TimeoutException):
-        return 2
-    except Exception:
-        return 2
-
+    status_validate(url, 404, 200, headers=headers, follow_redirects=True)
 
 if __name__ == "__main__":
     user = input("Username?: ").strip()

user_scanner/dev/github.py

@@ -1,4 +1,4 @@
-from user_scanner.core.orchestrator import status_validate
+from user_scanner.core.orchestrator import generic_validate, Result
 
 
 def validate_github(user):
@@ -18,7 +18,24 @@ def validate_github(user):
         'priority': "u=1, i"
     }
 
-    return status_validate(url, 200, 422, headers=headers)
+    GITHUB_INVALID_MSG = (
+        "Username may only contain alphanumeric characters or single hyphens, "
+        "and cannot begin or end with a hyphen."
+    )
+
+    def process(response):
+        if response.status_code == 200:
+            return Result.available()
+
+        if response.status_code == 422:
+            if GITHUB_INVALID_MSG in response.text:
+                return Result.error("Cannot start/end with hyphen or use double hyphens")
+
+            return Result.taken()
+
+        return Result.error("Unexpected GitHub response report it via issues")
+
+    return generic_validate(url, process, headers=headers)
 
 
 if __name__ == "__main__":

user_scanner/dev/gitlab.py

@@ -1,4 +1,5 @@
 from user_scanner.core.orchestrator import generic_validate
+from user_scanner.core.result import Result
 
 
 def validate_gitlab(user):
@@ -18,11 +19,11 @@ def validate_gitlab(user):
                 # Corrected: Compare against Python boolean True/False
                 # AVAILABLE (return 1) if "exists": true
                 if data['exists'] is False:
-                    return 1
+                    return Result.available()
                 # UNAVAILABLE (return 0) if "exists": false
                 elif data['exists'] is True:
-                    return 0
-        return 2
+                    return Result.taken()
+        return Result.error("Invalid status code")
 
     return generic_validate(url, process, headers=headers)
 

user_scanner/dev/huggingface.py

@@ -0,0 +1,19 @@
+from user_scanner.core.orchestrator import status_validate
+
+
+def validate_huggingface(user):
+    url = f"https://huggingface.co/{user}"
+
+    return status_validate(url, 404, 200, follow_redirects=True)
+
+
+if __name__ == "__main__":
+    user = input("Username?: ").strip()
+    result = validate_huggingface(user)
+
+    if result == 1:
+        print("Available!")
+    elif result == 0:
+        print("Unavailable!")
+    else:
+        print("Error occurred!")

user_scanner/dev/npmjs.py

@@ -1,34 +1,18 @@
-import httpx
-from httpx import ConnectError, TimeoutException
+import re
+from user_scanner.core.orchestrator import status_validate, Result
 
 
 def validate_npmjs(user):
-    url = f"https://www.npmjs.com/~{user}"
+    if re.match(r'^[^a-zA-Z0-9_-]', user):
+        return Result.error("Username cannot start with a period")
 
-    headers = {
-        'User-Agent': "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/141.0.0.0 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",
-        'accept-language': "en-US,en;q=0.9",
-        'priority': "u=0, i"
-    }
+    if re.search(r'[A-Z]', user):
+        return Result.error("Username cannot contain uppercase letters.")
 
-    try:
-        response = httpx.head(url, headers=headers,
-                              timeout=3.0, follow_redirects=True)
-        status = response.status_code
+    url = f"https://www.npmjs.com/~{user}"
 
-        if status == 200:
-            return 0
-        elif status == 404:
-            return 1
-        else:
-            return 2
 
-    except (ConnectError, TimeoutException):
-        return 2
-    except Exception:
-        return 2
+    return status_validate(url, 404, 200, timeout=3.0, follow_redirects=True)
 
 
 if __name__ == "__main__":
@@ -40,4 +24,4 @@ if __name__ == "__main__":
     elif result == 0:
         print("Unavailable!")
     else:
-        print("Error occurred!")
+        print(f"Error occurred! Reason: {result}")

user_scanner/donation/buymeacoffee.py

@@ -1,6 +1,3 @@
-import httpx
-from httpx import ConnectError, TimeoutException
-
 from user_scanner.core.orchestrator import status_validate
 
 

user_scanner/gaming/chess_com.py

@@ -1,4 +1,5 @@
 from user_scanner.core.orchestrator import generic_validate
+from user_scanner.core.result import Result
 
 
 def validate_chess_com(user):
@@ -16,22 +17,16 @@ def validate_chess_com(user):
             data = response.json()
             if data.get('valid') is True:
                 # 'valid': true means the username is NOT taken
-                return 1
+                return Result.available()
             elif data.get('valid') is False:
                 # 'valid': false means the username IS taken
-                return 0
-        return 2
+                return Result.taken()
+        return Result.error("Invalid status code")
 
     return generic_validate(url, process, headers=headers)
 
 
 if __name__ == "__main__":
-    try:
-        import httpx
-    except ImportError:
-        print("Error: 'httpx' library is not installed.")
-        exit()
-
     user = input("Username?: ").strip()
     result = validate_chess_com(user)
 

user_scanner/gaming/minecraft.py

@@ -2,11 +2,6 @@ from user_scanner.core.orchestrator import status_validate
 
 
 def validate_minecraft(user):
-    """
-    Checks for minecraft username with mojang api.
-    Returns: 1 -> available, 0 -> taken, 2 -> error
-    """
-
     url = f"https://api.mojang.com/minecraft/profile/lookup/name/{user}"
 
     return status_validate(url, 404, 200, follow_redirects=True)

user_scanner/gaming/monkeytype.py

@@ -1,5 +1,5 @@
 from user_scanner.core.orchestrator import generic_validate
-
+from user_scanner.core.result import Result
 
 def validate_monkeytype(user: str) -> int:
 
@@ -25,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)
 
 
 if __name__ == "__main__":
-    try:
-        import httpx  # noqa: F401
-    except ImportError:
-        print("Error: 'httpx' library is not installed.")
-        raise SystemExit(1)
-
     user = input("Username?: ").strip()
     result = validate_monkeytype(user)
 

user_scanner/gaming/osu.py

@@ -2,11 +2,6 @@ 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)

user_scanner/gaming/roblox.py

@@ -1,27 +1,32 @@
 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
-    """
-
     # 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
+        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
+                return Result.taken()
+        return Result.available()
 
     return generic_validate(url, process, follow_redirects=True)
 

user_scanner/gaming/steam.py

@@ -1,21 +1,18 @@
 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
-    """
-
     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)
 

user_scanner/social/bluesky.py

@@ -1,5 +1,5 @@
-import re
 from user_scanner.core.orchestrator import generic_validate
+from user_scanner.core.result import Result
 
 
 def validate_bluesky(user):
@@ -25,30 +25,24 @@ 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)
 
 
 if __name__ == "__main__":
-    try:
-        import httpx
-    except ImportError:
-        print("Error: 'httpx' library is not installed.")
-        exit()
-
     user = input("Username?: ").strip()
     result = validate_bluesky(user)
 

user_scanner/social/discord.py

@@ -1,6 +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"
@@ -21,14 +20,12 @@ def validate_discord(user):
         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
+                return Result.available()
+        return Result.error("Invalid status code")
+    except Exception as e:
+        return Result.error(e)
 
 
 if __name__ == "__main__":

user_scanner/social/mastodon.py

@@ -8,12 +8,6 @@ def validate_mastodon(user):
 
 
 if __name__ == "__main__":
-    try:
-        import httpx
-    except ImportError:
-        print("Error: 'httpx' library is not installed.")
-        exit()
-
     user = input("Username?: ").strip()
     result = validate_mastodon(user)
 

user_scanner/social/pinterest.py

@@ -1,5 +1,5 @@
 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}/"
@@ -7,11 +7,11 @@ 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)
 

user_scanner/social/reddit.py

@@ -1,4 +1,5 @@
 from user_scanner.core.orchestrator import generic_validate
+from user_scanner.core.result import Result
 
 
 def validate_reddit(user):
@@ -7,11 +8,11 @@ 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)
 

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,18 +1,18 @@
 import re
 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
+            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)
 

user_scanner/social/x.py

@@ -1,8 +1,5 @@
-import httpx
-import json
-from colorama import Fore, Style
-from httpx import ConnectError, TimeoutException
-
+from user_scanner.core.result import Result
+from user_scanner.core.orchestrator import generic_validate
 
 def validate_x(user):
     url = "https://api.twitter.com/i/users/username_available.json"
@@ -18,31 +15,24 @@ def validate_x(user):
         "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",
     }
 
-    try:
-        response = httpx.get(url, params=params, headers=headers, timeout=3.0)
+    def process(response):
         status = response.status_code
-       # print(response.text)
+
         if status in [401, 403, 429]:
-            return 2
+            return Result.error()
 
         elif status == 200:
             data = response.json()
             if data.get('valid') is True:
-                return 1
+                return Result.available()
             elif data.get('reason') == 'taken':
-                return 0
+                return Result.taken()
             elif (data.get('reason') == "improper_format" or data.get('reason') == "invalid_username"):
-                print(
-                    "\n" + "  "+f"{Fore.CYAN}X says: {data.get('desc')}{Style.RESET_ALL}")
-                return 2
-            else:
-                return 2
+                return Result.error(f"X says: {data.get('desc')}")
 
-    except (ConnectError, TimeoutException, json.JSONDecodeError):
-        return 2
-    except Exception:
-        return 2
+        return Result.error()
 
+    return generic_validate(url, process, params=params, headers=headers)
 
 if __name__ == "__main__":
     user = input("Username?: ").strip()

user_scanner/social/youtube.py

@@ -1,5 +1,4 @@
-import httpx
-from httpx import ConnectError, TimeoutException
+from user_scanner.core.orchestrator import status_validate
 
 
 def validate_youtube(user):
@@ -29,22 +28,7 @@ def validate_youtube(user):
         'priority': "u=0, i"
     }
 
-    try:
-        response = httpx.get(url, headers=headers,
-                             follow_redirects=True, timeout=3.0)
-        status = response.status_code
-
-        if status == 200:
-            return 0
-        elif status == 404:
-            return 1
-        else:
-            return 2
-
-    except (ConnectError, TimeoutException):
-        return 2
-    except Exception:
-        return 2
+    status_validate(url, 404, 200, headers=headers, follow_redirects=True)
 
 
 if __name__ == "__main__":

user_scanner/version.json

@@ -1,4 +1,4 @@
 {
-"version": "1.0.7.0",
+"version": "1.0.8.0",
 "version_type": "pypi"
 }

{user_scanner-1.0.7.0.dist-info → user_scanner-1.0.8.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: user-scanner
-Version: 1.0.7.0
+Version: 1.0.8.0
 Summary: Check username availability across multiple popular platforms
 Keywords: username,checker,availability,social,tech,python,user-scanner
 Author-email: Kaif <kafcodec@gmail.com>
@@ -15,7 +15,7 @@ Project-URL: Homepage, https://github.com/kaifcodec/user-scanner
 
 ![1000136215](https://github.com/user-attachments/assets/49ec8d24-665b-4115-8525-01a8d0ca2ef4)
 <p align="center">
-  <img src="https://img.shields.io/badge/Version-1.0.7.0-blueviolet?style=for-the-badge&logo=github" />
+  <img src="https://img.shields.io/badge/Version-1.0.8.0-blueviolet?style=for-the-badge&logo=github" />
   <img src="https://img.shields.io/github/issues/kaifcodec/user-scanner?style=for-the-badge&logo=github" />
   <img src="https://img.shields.io/badge/Tested%20on-Termux-black?style=for-the-badge&logo=termux" />
   <img src="https://img.shields.io/badge/Tested%20on-Windows-cyan?style=for-the-badge&logo=Windows" />
@@ -85,7 +85,13 @@ user-scanner -u <username> -p <suffix> -d <seconds> #delay to avoid rate-limits
 
 - Note*: New modules are constantly getting added so this might have only limited, outdated output:
 
-<img width="1008" height="568" alt="1000139959" src="https://github.com/user-attachments/assets/467a4aa0-238d-4110-b9a6-d4b96c244432" />
+
+<img width="1080" height="770" alt="1000140392" src="https://github.com/user-attachments/assets/4638c8f6-40c6-46f8-ae17-ac65cd199d81" />
+
+
+---
+
+<img width="1080" height="352" alt="1000140393" src="https://github.com/user-attachments/assets/578b248c-2a05-4917-aab3-6372a7c28045" />
 
 
 ### Contributing: 
@@ -112,9 +118,6 @@ user_scanner/
 
 See [CONTRIBUTING.md](CONTRIBUTING.md) for examples.
 
-### 📧 Contact:
-- [Email](kaifcodec@gmail.com)
-  
 ---
 
 ### Dependencies: 

user_scanner-1.0.8.0.dist-info/RECORD

@@ -0,0 +1,58 @@
+user_scanner/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+user_scanner/__main__.py,sha256=r_8gq8wSRs3U7yUkTAv4e4MPopX0MUf_EbwedBTPs44,5082
+user_scanner/version.json,sha256=35gyNCy3acbWFMZxPDR9qcG1lQ6Y2OGYyhr3q3rs_AE,49
+user_scanner/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+user_scanner/cli/banner.py,sha256=3t6owaDArERlvpcszA1Yi3dtksvh8a9tLyrxRowTC40,1499
+user_scanner/community/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+user_scanner/community/coderlegion.py,sha256=W_bdjzdFPRgUrNFFlylvToSJ4AzaFCtTsUy_MRVDdSo,451
+user_scanner/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+user_scanner/core/orchestrator.py,sha256=cB_aXFYlaZFWIYejZ_iI_c_n6xh2nr9Tm5bN79sCaKo,6102
+user_scanner/core/result.py,sha256=HWz9JjRk74shAdM56ZtdG6hIp4dgcahqYSnpOp3uCak,1933
+user_scanner/creator/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+user_scanner/creator/devto.py,sha256=mIACmG1a4eoctywxb5p04sI0YVi3dsjCRw9YVOFBEKQ,435
+user_scanner/creator/hashnode.py,sha256=vlXsJfIG_5ShEK2xPLDl2bi6X-d08iTeoqfKeQLaB1g,1363
+user_scanner/creator/itch_io.py,sha256=JsFkFzBfJI18DeuSYJIOPGEV_9v7t-jtwmBYCA9W2P8,440
+user_scanner/creator/kaggle.py,sha256=QaXIG02OGxvQZEvwHm50RKNd7joxGOq0Ht3cFfrYEiU,445
+user_scanner/creator/medium.py,sha256=NIOYnk8_ASD0kYfKqs8t6uZZTV4D-5-ZxyHMzOMMOuI,1015
+user_scanner/creator/patreon.py,sha256=g-r85pxirf0ihK3STyGYPIzp59MB7JH64Opb4wq1fyU,461
+user_scanner/creator/producthunt.py,sha256=vt26oQR68E7xCOHD7I7Je_M4WSc0-aFfhbMkif6G2FM,879
+user_scanner/dev/__init__.py,sha256=qUR0eLwN-gO6oKk-1cmCVT4G_AxUHHMgpV3wJ7URXi4,7
+user_scanner/dev/codeberg.py,sha256=Z6nV0_8xZhMiCcNn9Hn79VVh6y0ar9fqL7KS2b7IaDo,447
+user_scanner/dev/cratesio.py,sha256=mJnlLJoMLlQ7f_95QD7LgH1xCj-e6FooOFkpYypBfG4,724
+user_scanner/dev/dockerhub.py,sha256=sPEnomGiPM2mKv2HsA-9WxaXHjzz21A6ox3IXK1etLc,643
+user_scanner/dev/github.py,sha256=km0RMd4cS5sY8IUKDKoNC1oQeCj57ld4HAjOlo1w4ms,1689
+user_scanner/dev/gitlab.py,sha256=kMDSd74XbofmJocfS4Fd9DxPryIHBMek3N_5c7Z_AJQ,1351
+user_scanner/dev/huggingface.py,sha256=hDanOZ45LeUg3hrN0CYrBnBnLqHCYtOWS0_HCvAbmDw,454
+user_scanner/dev/launchpad.py,sha256=N58ioX_dEHq2uwyyGrWnDKWwbqK9_RiuBQ1uWR5cDfg,799
+user_scanner/dev/npmjs.py,sha256=k-DhFqGJWDoQ79EzR8hmVrJk07AfJfPUWnIYuKc2G6w,713
+user_scanner/dev/replit.py,sha256=SI_i2l4w9tm2kBX4-cONBAT8dSynXoGEP4zcU8ngnh0,442
+user_scanner/donation/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+user_scanner/donation/buymeacoffee.py,sha256=86LGyChv_UKQFp2D7nIoK1B-FCAAbbfabS8NA9yLp5k,459
+user_scanner/donation/liberapay.py,sha256=njClxpbRLZQ_L2-lUYCY6QFnF4IcwfCJPCIg1iEqo7M,1120
+user_scanner/gaming/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+user_scanner/gaming/chess_com.py,sha256=74tMgukSUXwdmD9G7Jij_gudRlSfs46Xho5KNMVeyt4,1262
+user_scanner/gaming/minecraft.py,sha256=7a9H9ebLlRzGB0SjxLmzqLiDPDBZAuuNq3KKe2DZAvo,481
+user_scanner/gaming/monkeytype.py,sha256=n9KMBChs0ej7MgZqLGUDVz5CED70sQ3ksDF5pO0G05A,1380
+user_scanner/gaming/osu.py,sha256=2Xs1iM0CJ-3dNHu4tyF50_s0Ei_1mA5Zd6D6M5RmiVg,448
+user_scanner/gaming/roblox.py,sha256=Qs51jLgKh-Ehqlco_j8CFtJ4CLVoZeBwPugDvAyLw3Q,1464
+user_scanner/gaming/steam.py,sha256=l8xk_p9aiYQWCPoogQnO1iwkfojPhg6yd76OZHhKN50,740
+user_scanner/social/__init__.py,sha256=jaCkFwX1uYtF0ENifVwF8OfHrYYUTm64B9wlBq9BBfQ,9
+user_scanner/social/bluesky.py,sha256=11Y_vRj3txEDQqoD0iANgSWVSB8L87OotPQZquhneR0,1994
+user_scanner/social/discord.py,sha256=z-oIqT416ydnZUkq481rz6NTq5yc_BYu-P_Z79uR-Jw,1150
+user_scanner/social/instagram.py,sha256=GgmKGvi3meKdZ_nQJbJSBZDJTEKSoE6Cn4_VARmo62I,953
+user_scanner/social/mastodon.py,sha256=qISx-gUsddC8lFMcmERA4N0YAnXyS1Jq2Xgg7XE4sL4,450
+user_scanner/social/pinterest.py,sha256=JIJ-HPtMoGvxW7NQzm02lChFKMmE6k6GxFoUZ6OvCec,784
+user_scanner/social/reddit.py,sha256=PJ46v8WpcUY1nNSbPhbiY6B9ynB9bcakcDjopXTX2ME,787
+user_scanner/social/snapchat.py,sha256=XEW_W4jEBX4AiHREcfHGstt97Ez3GI-3bKSzhtMyn28,1277
+user_scanner/social/soundcloud.py,sha256=e2yU1w2fnH1EhzYed0kxgcqgWz0YoCQQFf6yKqhRPjM,1246
+user_scanner/social/telegram.py,sha256=9IS-0pghMifNRmj62NcxCOvn23Hvg0AJJcuhCa_aXD4,765
+user_scanner/social/threads.py,sha256=rK8Gm_riDdr0djo23tk38fNVVEBuC6nj2iTXvWrqXeE,951
+user_scanner/social/x.py,sha256=sAnboHHZN2DWyKeds46GLZHxGG-G_bjzfVNIkblSHx8,1406
+user_scanner/social/youtube.py,sha256=PYGp-73ZnXPgpV-7q9-zfN6aF3geqUGul0CaoSO0u9M,1702
+user_scanner/utils/update.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+user_scanner/utils/version.py,sha256=mPh24EwITyXgD3AMgbflRL180pS0JfrvuJdnoErOU34,623
+user_scanner-1.0.8.0.dist-info/entry_points.txt,sha256=XqU3kssYZ0vXaPy5qYUOTCu4u-48Xie7QWFpBCYc7Nc,59
+user_scanner-1.0.8.0.dist-info/licenses/LICENSE,sha256=XH1QyQG68zo1opDIZHTHcTAbe9XMzewvTaFTukcN9vc,1061
+user_scanner-1.0.8.0.dist-info/WHEEL,sha256=G2gURzTEtmeR8nrdXUJfNiB3VYVxigPQ-bEQujpNiNs,82
+user_scanner-1.0.8.0.dist-info/METADATA,sha256=InqyZQhX0lcSUl5-0GnU-gqErYDLDfROk3ovrv8io3o,4850
+user_scanner-1.0.8.0.dist-info/RECORD,,

user_scanner-1.0.7.0.dist-info/RECORD

@@ -1,55 +0,0 @@
-user_scanner/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-user_scanner/__main__.py,sha256=r_8gq8wSRs3U7yUkTAv4e4MPopX0MUf_EbwedBTPs44,5082
-user_scanner/version.json,sha256=JQUpDKvzaDU5eQcWcLXR7UejxgZkZcpBBYN1lgNmI6o,49
-user_scanner/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-user_scanner/cli/banner.py,sha256=3t6owaDArERlvpcszA1Yi3dtksvh8a9tLyrxRowTC40,1499
-user_scanner/community/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-user_scanner/community/coderlegion.py,sha256=W_bdjzdFPRgUrNFFlylvToSJ4AzaFCtTsUy_MRVDdSo,451
-user_scanner/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-user_scanner/core/orchestrator.py,sha256=mN8aeFxgIZaWuDKbjgYLmFPtOwe8TtF2bQtAgcR7nb8,5682
-user_scanner/creator/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-user_scanner/creator/devto.py,sha256=mIACmG1a4eoctywxb5p04sI0YVi3dsjCRw9YVOFBEKQ,435
-user_scanner/creator/hashnode.py,sha256=LBg8yRkB-WAVYavfeKWh6R2LWmUHMyXt02BLIXP-C4o,1378
-user_scanner/creator/itch_io.py,sha256=d-s2k410aZtaYQXpTgaKsgQ488Ag9vGJj5buw7XM32I,556
-user_scanner/creator/kaggle.py,sha256=QaXIG02OGxvQZEvwHm50RKNd7joxGOq0Ht3cFfrYEiU,445
-user_scanner/creator/medium.py,sha256=zA8zw7hrH_JOXGM3oW7dfe5kldIRNyeBWZ8UCdAqZlg,1019
-user_scanner/creator/patreon.py,sha256=aneIkwVSc7SFpE8H5HlSDMYQZc-97ZOtGZXrRb4PfWw,589
-user_scanner/creator/producthunt.py,sha256=xgv-LJ97LLmyD2GRw4g3gylUMpOKUW0asbTnULbpZsE,1205
-user_scanner/dev/__init__.py,sha256=qUR0eLwN-gO6oKk-1cmCVT4G_AxUHHMgpV3wJ7URXi4,7
-user_scanner/dev/codeberg.py,sha256=Z6nV0_8xZhMiCcNn9Hn79VVh6y0ar9fqL7KS2b7IaDo,447
-user_scanner/dev/cratesio.py,sha256=mJnlLJoMLlQ7f_95QD7LgH1xCj-e6FooOFkpYypBfG4,724
-user_scanner/dev/dockerhub.py,sha256=sPEnomGiPM2mKv2HsA-9WxaXHjzz21A6ox3IXK1etLc,643
-user_scanner/dev/github.py,sha256=jQ6q9V0snMUzGwIcbYZM_cJfiM8VZNYGm08dlDJqb6g,1113
-user_scanner/dev/gitlab.py,sha256=FBwxrYWZXRkj55r_Dq8ZJLgLVLGrv5WU5k--31b_bz8,1243
-user_scanner/dev/launchpad.py,sha256=N58ioX_dEHq2uwyyGrWnDKWwbqK9_RiuBQ1uWR5cDfg,799
-user_scanner/dev/npmjs.py,sha256=K_bfLnehgaDlroiyMiIT801noRW-AyVISGd8xwMrWTM,1215
-user_scanner/dev/replit.py,sha256=SI_i2l4w9tm2kBX4-cONBAT8dSynXoGEP4zcU8ngnh0,442
-user_scanner/donation/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-user_scanner/donation/buymeacoffee.py,sha256=8ZFuE8zjCclNP1C2RejDc4kMauGZpuYkxA1iiphSWKU,522
-user_scanner/donation/liberapay.py,sha256=njClxpbRLZQ_L2-lUYCY6QFnF4IcwfCJPCIg1iEqo7M,1120
-user_scanner/gaming/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-user_scanner/gaming/chess_com.py,sha256=LlZ-cn3wW8ysRSQ7FVnOofnJIgMbIDX_tGkdkNMhUwM,1282
-user_scanner/gaming/minecraft.py,sha256=-mNhKTDwEETZv-IuLo1dHg2NfhFgb9w9-7zvP-HxtAU,601
-user_scanner/gaming/monkeytype.py,sha256=uktLoHEV-wyjR-WsuVvgvrVCDVU3YpCISrhStM9odTU,1428
-user_scanner/gaming/osu.py,sha256=L6LYOY1GyzQ2-KimGnvuT6BEGpY7K0hgV394sy8fvak,560
-user_scanner/gaming/roblox.py,sha256=RnoME2NxMriILh1IiXQCe3J1l_G5Fs2S16YGKHCw3WY,1110
-user_scanner/gaming/steam.py,sha256=-WtY-Wm68pJRW3fseayJfG3XqwGOzuUERuC5yLX16nQ,754
-user_scanner/social/__init__.py,sha256=jaCkFwX1uYtF0ENifVwF8OfHrYYUTm64B9wlBq9BBfQ,9
-user_scanner/social/bluesky.py,sha256=TlKONKmN2lvHRomQAqwkKzlIERSRKCbtPprcD9R_8CQ,1947
-user_scanner/social/discord.py,sha256=iDnle44eyBTgeeyLb6jLysI4S-KRMNbaqDIVC0hCsMU,1135
-user_scanner/social/instagram.py,sha256=GgmKGvi3meKdZ_nQJbJSBZDJTEKSoE6Cn4_VARmo62I,953
-user_scanner/social/mastodon.py,sha256=l3Aixl7DCj_gtAiNzc3wA3pZxI-nP-zzRMuKkuwvTgM,578
-user_scanner/social/pinterest.py,sha256=_Sditb8k1xRhplsN79RIEbZNlzfxIqFD6kGh3nAmVCE,677
-user_scanner/social/reddit.py,sha256=yA7n7GFmS5mr02BOR4DeTmIT5GdnSCbUyaVarV9RMTk,700
-user_scanner/social/snapchat.py,sha256=XEW_W4jEBX4AiHREcfHGstt97Ez3GI-3bKSzhtMyn28,1277
-user_scanner/social/telegram.py,sha256=HU20t0A9jFijOUcdgzXfoNymxDBk2BhAqw7rIhSBfEQ,740
-user_scanner/social/threads.py,sha256=rK8Gm_riDdr0djo23tk38fNVVEBuC6nj2iTXvWrqXeE,951
-user_scanner/social/x.py,sha256=5UYBLmLuFpFeKQYqCkebQKB46GsfiQjV4flAdcrJAps,1591
-user_scanner/social/youtube.py,sha256=nqW1XKZOefpPTDeCvqFTJXP24SjhntIQRlevwuSGLSk,2027
-user_scanner/utils/update.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-user_scanner/utils/version.py,sha256=mPh24EwITyXgD3AMgbflRL180pS0JfrvuJdnoErOU34,623
-user_scanner-1.0.7.0.dist-info/entry_points.txt,sha256=XqU3kssYZ0vXaPy5qYUOTCu4u-48Xie7QWFpBCYc7Nc,59
-user_scanner-1.0.7.0.dist-info/licenses/LICENSE,sha256=XH1QyQG68zo1opDIZHTHcTAbe9XMzewvTaFTukcN9vc,1061
-user_scanner-1.0.7.0.dist-info/WHEEL,sha256=G2gURzTEtmeR8nrdXUJfNiB3VYVxigPQ-bEQujpNiNs,82
-user_scanner-1.0.7.0.dist-info/METADATA,sha256=B4JLyOl64Ts11qVgfch25TYE0q3r_P2Rz0sFlv0Mpcc,4757
-user_scanner-1.0.7.0.dist-info/RECORD,,