user-scanner 1.0.7.0__tar.gz → 1.0.8.0__tar.gz

{user_scanner-1.0.7.0 → user_scanner-1.0.8.0}/PKG-INFO

@@ -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.7.0 → user_scanner-1.0.8.0}/README.md

@@ -2,7 +2,7 @@
 
 ![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" />
@@ -72,7 +72,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: 
@@ -99,9 +105,6 @@ user_scanner/
 
 See [CONTRIBUTING.md](CONTRIBUTING.md) for examples.
 
-### 📧 Contact:
-- [Email](kaifcodec@gmail.com)
-  
 ---
 
 ### Dependencies: 

{user_scanner-1.0.7.0 → user_scanner-1.0.8.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "flit_core.buildapi"
 
 [project]
 name = "user-scanner"
-version = "1.0.7.0"
+version = "1.0.8.0"
 description = "Check username availability across multiple popular platforms"
 readme = "README.md"
 license = {file = "LICENSE"}

{user_scanner-1.0.7.0 → user_scanner-1.0.8.0}/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-1.0.8.0/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-1.0.7.0 → user_scanner-1.0.8.0}/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-1.0.7.0 → user_scanner-1.0.8.0}/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-1.0.7.0 → user_scanner-1.0.8.0}/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-1.0.7.0 → user_scanner-1.0.8.0}/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-1.0.7.0 → user_scanner-1.0.8.0}/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-1.0.7.0 → user_scanner-1.0.8.0}/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-1.0.7.0 → user_scanner-1.0.8.0}/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-1.0.8.0/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-1.0.8.0/user_scanner/dev/npmjs.py

@@ -0,0 +1,27 @@
+import re
+from user_scanner.core.orchestrator import status_validate, Result
+
+
+def validate_npmjs(user):
+    if re.match(r'^[^a-zA-Z0-9_-]', user):
+        return Result.error("Username cannot start with a period")
+
+    if re.search(r'[A-Z]', user):
+        return Result.error("Username cannot contain uppercase letters.")
+
+    url = f"https://www.npmjs.com/~{user}"
+
+
+    return status_validate(url, 404, 200, timeout=3.0, follow_redirects=True)
+
+
+if __name__ == "__main__":
+    user = input("Username?: ").strip()
+    result = validate_npmjs(user)
+
+    if result == 1:
+        print("Available!")
+    elif result == 0:
+        print("Unavailable!")
+    else:
+        print(f"Error occurred! Reason: {result}")

{user_scanner-1.0.7.0 → user_scanner-1.0.8.0}/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-1.0.7.0 → user_scanner-1.0.8.0}/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-1.0.7.0 → user_scanner-1.0.8.0}/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-1.0.7.0 → user_scanner-1.0.8.0}/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-1.0.7.0 → user_scanner-1.0.8.0}/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-1.0.7.0 → user_scanner-1.0.8.0}/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-1.0.7.0 → user_scanner-1.0.8.0}/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-1.0.7.0 → user_scanner-1.0.8.0}/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-1.0.7.0 → user_scanner-1.0.8.0}/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-1.0.7.0 → user_scanner-1.0.8.0}/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-1.0.7.0 → user_scanner-1.0.8.0}/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-1.0.7.0 → user_scanner-1.0.8.0}/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-1.0.8.0/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-1.0.7.0 → user_scanner-1.0.8.0}/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-1.0.7.0 → user_scanner-1.0.8.0}/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-1.0.7.0 → user_scanner-1.0.8.0}/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-1.0.7.0 → user_scanner-1.0.8.0}/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/user_scanner/dev/npmjs.py

@@ -1,43 +0,0 @@
-import httpx
-from httpx import ConnectError, TimeoutException
-
-
-def validate_npmjs(user):
-    url = f"https://www.npmjs.com/~{user}"
-
-    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"
-    }
-
-    try:
-        response = httpx.head(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
-
-
-if __name__ == "__main__":
-    user = input("Username?: ").strip()
-    result = validate_npmjs(user)
-
-    if result == 1:
-        print("Available!")
-    elif result == 0:
-        print("Unavailable!")
-    else:
-        print("Error occurred!")