user-scanner 1.0.8.1__py3-none-any.whl → 1.0.9.1__py3-none-any.whl

user_scanner/__main__.py

@@ -1,27 +1,16 @@
 import argparse
 import time
 import re
-from user_scanner.core.orchestrator import run_checks, load_modules , generate_permutations, load_categories
+from user_scanner.cli import printer
+from user_scanner.core.orchestrator import generate_permutations, load_categories
 from colorama import Fore, Style
-from .cli import banner
-from .cli.banner import print_banner
+from user_scanner.cli.banner import print_banner
+from typing import List
+from user_scanner.core.result import Result
+from user_scanner.core.utils import is_last_value
 
 MAX_PERMUTATIONS_LIMIT = 100 # To prevent excessive generation
 
-def list_modules(category=None):
-    categories = load_categories()
-    categories_to_list = [category] if category else categories.keys()
-
-    for cat_name in categories_to_list:
-        path = categories[cat_name]
-        modules = load_modules(path)
-        print(Fore.MAGENTA +
-            f"\n== {cat_name.upper()} SITES =={Style.RESET_ALL}")
-        for module in modules:
-            site_name = module.__name__.split(".")[-1]
-            print(f"  - {site_name}")
-
-
 def main():
     parser = argparse.ArgumentParser(
         prog="user-scanner",
@@ -43,91 +32,127 @@ def main():
     parser.add_argument(
         "-v", "--verbose", action="store_true", help="Enable verbose output"
     )
-    
+
     parser.add_argument(
         "-p", "--permute",type=str,help="Generate username permutations using a string pattern (e.g -p 234)"
     )
     parser.add_argument(
         "-s", "--stop",type=int,default=MAX_PERMUTATIONS_LIMIT,help="Limit the number of username permutations generated"
     )
-    
+
     parser.add_argument(
         "-d", "--delay",type=float,default=0,help="Delay in seconds between requests (recommended: 1-2 seconds)"
     )
-    
+
+    parser.add_argument(
+        "-f", "--format", choices=["console", "csv", "json"], default="console", help="Specify the output format (default: console)"
+    )
+
+    parser.add_argument(
+        "-o", "--output", type=str, help="Specify the output file"
+    )
+
     args = parser.parse_args()
-        
+
+    Printer = printer.Printer(args.format)
+
     if args.list:
-        list_modules(args.category)
+        Printer.print_modules(args.category)
         return
-    
+
     if not args.username:
         parser.print_help()
         return
-        
-    # Special username checks before run
-    if (args.module == "x" or args.category == "social"):
-        if re.search(r"[^a-zA-Z0-9._-]", args.username):
-            print(
-                Fore.RED + f"[!] Username '{args.username}' contains unsupported special characters. X (Twitter) doesn't support these." + Style.RESET_ALL)
-    if (args.module == "bluesky" or args.category == "social"):
-        if re.search(r"[^a-zA-Z0-9\.-]", args.username):
-            print(
-                Fore.RED + f"[!] Username '{args.username}' contains unsupported special characters. Bluesky will throw error. (Supported: only hyphens and digits)" + Style.RESET_ALL + "\n")
-    print_banner()
 
-    if args.permute and args.delay == 0:
+
+    if Printer.is_console:
+        print_banner()
+
+    if args.permute and args.delay == 0 and Printer.is_console:
         print(
         Fore.YELLOW
         + "[!] Warning: You're generating multiple usernames with NO delay between requests. "
         "This may trigger rate limits or IP bans. Use --delay 1 or higher. (Use only if the sites throw errors otherwise ignore)\n"
         + Style.RESET_ALL)
-        
+
     usernames = [args.username]  # Default single username list
-    
+
     #Added permutation support , generate all possible permutation of given sequence.
     if args.permute:
         usernames = generate_permutations(args.username, args.permute , args.stop)
-        print(Fore.CYAN + f"[+] Generated {len(usernames)} username permutations" + Style.RESET_ALL)
+        if Printer.is_console:
+            print(
+                Fore.CYAN + f"[+] Generated {len(usernames)} username permutations" + Style.RESET_ALL)
 
-    
-    
     if args.module and "." in args.module:
         args.module = args.module.replace(".", "_")
 
+    def run_all_usernames(func, arg = None) -> List[Result]:
+        """
+        Executes a function for all given usernames.
+        Made in order to simplify main()
+        """
+        results = []
+        print(Printer.get_start())
+        for i, name in enumerate(usernames):
+            is_last = i == len(usernames) - 1
+            if arg == None:
+                results.extend(func(name, Printer, is_last))
+            else:
+                results.extend(func(arg, name, Printer, is_last))
+            if args.delay > 0 and not is_last:
+                time.sleep(args.delay)
+        if Printer.is_json:
+            print(Printer.get_end())
+        return results
+
+    results =  []
 
     if args.module:
         # Single module search across all categories
-        found = False
-        for cat_path in load_categories().values():
-            modules = load_modules(cat_path)
+        from user_scanner.core.orchestrator import run_module_single, find_module
+        modules = find_module(args.module)
+
+        if len(modules) > 0:
             for module in modules:
-                site_name = module.__name__.split(".")[-1]
-                if site_name.lower() == args.module.lower():
-                    from user_scanner.core.orchestrator import run_module_single
-                    for name in usernames:   # <-- permutation support here
-                        run_module_single(module, name)
-                        if args.delay > 0:
-                            time.sleep(args.delay)
-                    found = True
-        if not found:
+                results.extend(run_all_usernames(run_module_single, module))
+        else:
             print(
                 Fore.RED + f"[!] Module '{args.module}' not found in any category." + Style.RESET_ALL)
+
     elif args.category:
         # Category-wise scan
         category_package = load_categories().get(args.category)
         from user_scanner.core.orchestrator import run_checks_category
-        
-        for name in usernames:   # <-- permutation support here
-            run_checks_category(category_package, name, args.verbose)
-            if args.delay > 0:
-                time.sleep(args.delay)
+        results = run_all_usernames(run_checks_category, category_package)
+
     else:
         # Full scan
-        for name in usernames:
-            run_checks(name)
-            if args.delay > 0:
-                time.sleep(args.delay)
+        from user_scanner.core.orchestrator import run_checks
+        results = run_all_usernames(run_checks)
+
+    if not args.output:
+        return
+
+    if args.output and Printer.is_console:
+        msg = (
+            "\n[!] The console format cannot be "
+            f"written to file: '{args.output}'."
+        )
+        print(Fore.RED + msg + Style.RESET_ALL)
+        return
+
+    content = Printer.get_start()
+
+    for i,result in enumerate(results):
+        char = "" if Printer.is_csv or is_last_value(results, i) else ","
+        content += "\n" + Printer.get_result_output(result) + char
+
+    if Printer.is_json:
+        content += "\n" + Printer.get_end()
+
+    with open(args.output, "a", encoding="utf-8") as f:
+        f.write(content)
 
 
 if __name__ == "__main__":

user_scanner/cli/printer.py

@@ -0,0 +1,117 @@
+from colorama import Fore, Style
+from typing import Literal
+from user_scanner.core.result import Result, Status
+
+INDENT = "  "
+CSV_HEADER = "username,category,site_name,status,url,reason"
+
+
+def indentate(msg: str, indent: int):
+    if indent <= 0:
+        return msg
+    tabs = INDENT * indent
+    return "\n".join([f"{tabs}{line}" for line in msg.split("\n")])
+
+
+class Printer:
+    def __init__(self, format: Literal["console", "csv", "json"]) -> None:
+        if not format in ["console", "csv", "json"]:
+            raise ValueError(f"Invalid output-format: {format}")
+        self.mode: str = format
+        self.indent: int = 0
+
+    @property
+    def is_console(self) -> bool:
+        return self.mode == "console"
+
+    @property
+    def is_csv(self) -> bool:
+        return self.mode == "csv"
+
+    @property
+    def is_json(self) -> bool:
+        return self.mode == "json"
+
+    def get_start(self, json_char: str = "[") -> str:
+        if self.is_json:
+            self.indent += 1
+            return indentate(json_char, self.indent - 1)
+        elif self.is_csv:
+            return CSV_HEADER
+        return ""
+
+    def get_end(self, json_char: str = "]") -> str:
+        if not self.is_json:
+            return
+        self.indent = max(self.indent - 1, 0)
+        return indentate(json_char, self.indent)
+
+    def get_result_output(self, result: Result) -> str:
+        #In principle result should always have this
+        site_name = result.site_name
+        username = result.username
+
+        match (result.status, self.mode):
+            case (Status.AVAILABLE, "console"):
+                return f"{INDENT}{Fore.GREEN}[✔] {site_name} ({username}): Available{Style.RESET_ALL}"
+
+            case (Status.TAKEN, "console"):
+                return f"{INDENT}{Fore.RED}[✘] {site_name} ({username}): Taken{Style.RESET_ALL}"
+
+            case (Status.ERROR, "console"):
+                reason = ""
+                if isinstance(result, Result) and result.has_reason():
+                    reason = f" ({result.get_reason()})"
+                return f"{INDENT}{Fore.YELLOW}[!] {site_name} ({username}): Error{reason}{Style.RESET_ALL}"
+
+            case (_, "json"):
+                return indentate(result.to_json().replace("\t", INDENT), self.indent)
+
+            case (_, "csv"):
+                return result.to_csv()
+
+        return ""
+
+    def print_modules(self, category: str | None = None):
+        from user_scanner.core.orchestrator import load_categories, load_modules
+        categories = load_categories()
+        categories_to_list = [category] if category else categories.keys()
+
+        # Print the start
+        if self.is_json:
+            print(self.get_start("{"))
+        elif self.is_csv:
+            print("category,site_name")
+
+        for i, cat_name in enumerate(categories_to_list):
+            path = categories[cat_name]
+            modules = load_modules(path)
+
+            # Print for each category
+            match self.mode:
+                case "console":
+                    print(Fore.MAGENTA +
+                          f"\n== {cat_name.upper()} SITES =={Style.RESET_ALL}")
+                case "json":
+                    print(self.get_start(f"\"{cat_name}\": ["))
+
+            for j, module in enumerate(modules):
+                is_last = j == len(modules) - 1
+                site_name = module.__name__.split(".")[-1].capitalize()
+
+                # Print for each site name
+                match self.mode:
+                    case "console":
+                        print(f"{INDENT}- {site_name}")
+                    case "json":
+                        msg = f"\"{site_name}\"" + ("" if is_last else ",")
+                        print(indentate(msg, self.indent))
+                    case "csv":
+                        print(f"{cat_name},{site_name}")
+
+            if self.is_json:
+                is_last = i == len(categories_to_list) - 1
+                print(self.get_end("]" if is_last else "],"))
+
+        if self.is_json:
+            print(self.get_end("}"))

user_scanner/core/orchestrator.py

@@ -1,16 +1,14 @@
 import importlib
 import importlib.util
 from colorama import Fore, Style
-import threading
+from concurrent.futures import ThreadPoolExecutor
 from itertools import permutations
 import httpx
 from pathlib import Path
+from user_scanner.cli.printer import Printer
 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
+from user_scanner.core.utils import get_site_name, is_last_value
 
 
 def load_modules(category_path: Path):
@@ -39,78 +37,108 @@ def load_categories() -> Dict[str, Path]:
     return categories
 
 
-def worker_single(module, username, i):
-    global print_queue
+def find_module(name: str):
+    name = name.lower()
+
+    matches = [
+        module
+        for category_path in load_categories().values()
+        for module in load_modules(category_path)
+        if module.__name__.split(".")[-1].lower() == name
+    ]
+
+    return matches
+
+def find_category(module) -> str | None:
+
+    module_file = getattr(module, '__file__', None)
+    if not module_file:
+        return None
+
+    category = Path(module_file).parent.name.lower()
+    categories = load_categories()
+    if category in categories:
+        return category.capitalize()
+
+    return None
+
+
 
+def worker_single(module, username: str) -> Result:
     func = next((getattr(module, f) for f in dir(module)
                  if f.startswith("validate_") and callable(getattr(module, f))), None)
-    site_name = module.__name__.split('.')[-1].capitalize().replace("_", ".")
-    if site_name == "X":
-        site_name = "X (Twitter)"
 
-    output = ""
-    if func:
-        try:
-            result = func(username)
-            reason = ""
+    site_name = get_site_name(module)
 
-            if isinstance(result, Result) and result.has_reason():
-                reason = f" ({result.get_reason()})"
+    if not func:
+        return Result.error(f"{site_name} has no validate_ function", site_name=site_name, username=username)
+
+    try:
+        result: Result = func(username)
+        result.update(site_name=site_name, username=username)
+        return result
+    except Exception as e:
+        return Result.error(e, site_name=site_name, username=username)
 
-            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{reason}{Style.RESET_ALL}"
-        except Exception as e:
-            output = f"  {Fore.YELLOW}[!] {site_name}: Exception - {e}{Style.RESET_ALL}"
-    else:
-        output = f"  {Fore.YELLOW}[!] {site_name} has no validate_ function{Style.RESET_ALL}"
 
-    with lock:
-        # Waits for in-order printing
-        while i != print_queue:
-            lock.wait()
+def run_module_single(module, username: str, printer: Printer, last: bool = True) -> List[Result]:
+    result = worker_single(module, username)
 
-        print(output)
-        print_queue += 1
-        lock.notify_all()
+    category = find_category(module)
+    if category:
+        result.update(category=category)
 
+    site_name = get_site_name(module)
+    msg = printer.get_result_output(result)
+    if last == False and printer.is_json:
+        msg += ","
+    print(msg)
 
-def run_module_single(module, username):
-    # Just executes as if it was a thread
-    worker_single(module, username, print_queue)
+    return [result]
 
 
-def run_checks_category(category_path:Path, username:str, verbose=False):
-    global print_queue
 
+def run_checks_category(category_path: Path, username: str, printer: Printer, last: bool = True) -> List[Result]:
     modules = load_modules(category_path)
+
     category_name = category_path.stem.capitalize()
-    print(f"{Fore.MAGENTA}== {category_name} SITES =={Style.RESET_ALL}")
+    if printer.is_console:
+        print(f"\n{Fore.MAGENTA}== {category_name} SITES =={Style.RESET_ALL}")
+
+    results = []
 
-    print_queue = 0
+    with ThreadPoolExecutor(max_workers=10) as executor:
+        exec_map = executor.map(lambda m: worker_single(m, username), modules)
+        for i, result in enumerate(exec_map):
+            result.update(category = category_name)
+            results.append(result)
 
-    threads = []
-    for i, module in enumerate(modules):
-        t = threading.Thread(target=worker_single, args=(module, username, i))
-        threads.append(t)
-        t.start()
+            is_last = last and is_last_value(modules, i)
+            site_name = get_site_name(modules[i])
+            msg = printer.get_result_output(result)
+            if is_last == False and printer.is_json:
+                msg += ","
+            print(msg)
 
-    for t in threads:
-        t.join()
+    return results
 
 
-def run_checks(username):
-    print(f"\n{Fore.CYAN} Checking username: {username}{Style.RESET_ALL}\n")
+def run_checks(username: str, printer: Printer, last: bool = True) -> List[Result]:
+    if printer.is_console:
+        print(f"\n{Fore.CYAN} Checking username: {username}{Style.RESET_ALL}")
 
-    for category_path in load_categories().values():
-        run_checks_category(category_path, username)
-        print()
+    results = []
 
+    categories = list(load_categories().values())
+    for i, category_path in enumerate(categories):
+        last_cat: int = last and (i == len(categories) - 1)
+        temp = run_checks_category(category_path, username, printer, last_cat)
+        results.extend(temp)
 
-def make_get_request(url: str, **kwargs) -> httpx.Response:
+    return results
+
+
+def make_request(url: str, **kwargs) -> httpx.Response:
     """Simple wrapper to **httpx.get** that predefines headers and timeout"""
     if not "headers" in kwargs:
         kwargs["headers"] = {
@@ -124,7 +152,9 @@ def make_get_request(url: str, **kwargs) -> httpx.Response:
     if not "timeout" in kwargs:
         kwargs["timeout"] = 5.0
 
-    return httpx.get(url, **kwargs)
+    method = kwargs.pop("method", "GET")
+
+    return httpx.request(method.upper(), url, **kwargs)
 
 
 def generic_validate(url: str, func: Callable[[httpx.Response], AnyResult], **kwargs) -> AnyResult:
@@ -132,10 +162,12 @@ def generic_validate(url: str, func: Callable[[httpx.Response], AnyResult], **kw
     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)
+        response = make_request(url, **kwargs)
+        result = func(response)
+        result.url = url
+        return result
     except Exception as e:
-        return Result.error(e)
+        return Result.error(e, url=url)
 
 
 def status_validate(url: str, available: int | List[int], taken: int | List[int], **kwargs) -> Result:
@@ -162,6 +194,7 @@ def status_validate(url: str, available: int | List[int], taken: int | List[int]
 
     return generic_validate(url, inner, **kwargs)
 
+
 def generate_permutations(username, pattern, limit=None):
     """
     Generate all order-based permutations of characters in `pattern`

user_scanner/core/result.py

@@ -1,6 +1,24 @@
 from enum import Enum
 from typing import Literal
 
+DEBUG_MSG = """Result {{
+  status: {status},
+  reason: "{reason}",
+  username: "{username}",
+  site_name: "{site_name}",
+  category: "{category}",
+}}"""
+
+JSON_TEMPLATE = """{{
+\t"username": "{username}",
+\t"category": "{category}",
+\t"site_name": "{site_name}",
+\t"status": "{status}",
+\t"reason": "{reason}"
+}}"""
+
+CSV_TEMPLATE = "{username},{category},{site_name},{status},{reason}"
+
 
 def humanize_exception(e: Exception) -> str:
     msg = str(e).lower()
@@ -18,23 +36,36 @@ class Status(Enum):
     AVAILABLE = 1
     ERROR = 2
 
+    def __str__(self):
+        return super().__str__().split(".")[1].capitalize()
+
 
 class Result:
-    def __init__(self, status: Status, reason: str | Exception | None = None):
+    def __init__(self, status: Status, reason: str | Exception | None = None, **kwargs):
         self.status = status
         self.reason = reason
 
+        self.username = None
+        self.site_name = None
+        self.category = None
+        self.update(**kwargs)
+
+    def update(self, **kwargs):
+        for field in ("username", "site_name", "category"):
+            if field in kwargs and kwargs[field] is not None:
+                setattr(self, field, kwargs[field])
+
     @classmethod
-    def taken(cls):
-        return cls(Status.TAKEN)
+    def taken(cls, **kwargs):
+        return cls(Status.TAKEN, **kwargs)
 
     @classmethod
-    def available(cls):
-        return cls(Status.AVAILABLE)
+    def available(cls, **kwargs):
+        return cls(Status.AVAILABLE, **kwargs)
 
     @classmethod
-    def error(cls, reason: str | Exception | None = None):
-        return cls(Status.ERROR, reason)
+    def error(cls, reason: str | Exception | None = None, **kwargs):
+        return cls(Status.ERROR, reason, **kwargs)
 
     @classmethod
     def from_number(cls, i: int, reason: str | Exception | None = None):
@@ -56,10 +87,28 @@ class Result:
             return ""
         if isinstance(self.reason, str):
             return self.reason
-        #Format the exception
+        # Format the exception
         msg = humanize_exception(self.reason)
         return f"{type(self.reason).__name__}: {msg.capitalize()}"
 
+    def as_dict(self) -> dict:
+        return {
+            "status": self.status,
+            "reason": self.get_reason(),
+            "username": self.username,
+            "site_name": self.site_name,
+            "category": self.category
+        }
+
+    def debug(self) -> str:
+        return DEBUG_MSG.format(**self.as_dict())
+
+    def to_json(self) -> str:
+        return JSON_TEMPLATE.format(**self.as_dict())
+
+    def to_csv(self) -> str:
+        return CSV_TEMPLATE.format(**self.as_dict())
+
     def __str__(self):
         return self.get_reason()
 

user_scanner/core/utils.py

@@ -0,0 +1,9 @@
+def get_site_name(module) -> str:
+    name = module.__name__.split('.')[-1].capitalize().replace("_", ".")
+    if name == "X":
+        return "X (Twitter)"
+    return name
+
+
+def is_last_value(values, i: int) -> bool:
+    return i == len(values) - 1

user_scanner/creator/hashnode.py

@@ -1,5 +1,6 @@
 import httpx
 from user_scanner.core.result import Result
+from user_scanner.core.orchestrator import generic_validate
 
 
 def validate_hashnode(user):
@@ -18,9 +19,7 @@ def validate_hashnode(user):
         'Referer': "https://hashnode.com/signup",
     }
 
-    try:
-        response = httpx.post(url, json=payload, headers=headers, timeout=3.0)
-
+    def process(response):
         if response.status_code == 200:
             data = response.json()
 
@@ -35,9 +34,7 @@ def validate_hashnode(user):
         else:
             return Result.error("Invalid status code")
 
-    except Exception as e:
-        return Result.error(e)
-
+    return generic_validate(url, process, method="POST", json=payload, headers=headers, timeout=3.0)
 
 if __name__ == "__main__":
     user = input("Username?: ").strip()

user_scanner/creator/itch_io.py

@@ -1,8 +1,19 @@
-from user_scanner.core.orchestrator import status_validate
+import re
+from user_scanner.core.orchestrator import status_validate, Result
 
 
-def validate_itch_io(user):
-    url = f"https://{user}.itch.io"
+def validate_itch_io(user: str) -> Result:
+    if not (2 <= len(user) <= 25):
+        return Result.error("Length must be 2-25 characters.")
+
+    if not re.match(r'^[a-z0-9_-]+$', user):
+
+        if re.search(r'[A-Z]', user):
+            return Result.error("Use lowercase letters only.")
+
+        return Result.error("Only use lowercase letters, numbers, underscores, and hyphens.")
+
+    url = f"https://itch.io/profile/{user}"
 
     return status_validate(url, 404, 200, follow_redirects=True)
 
@@ -16,4 +27,4 @@ if __name__ == "__main__":
     elif result == 0:
         print("Unavailable!")
     else:
-        print("Error occurred!")
+        print(f"Error occurred! Reason: {result.get_reason()}")

user_scanner/dev/bitbucket.py

@@ -0,0 +1,34 @@
+import re
+from user_scanner.core.orchestrator import status_validate, Result
+
+
+def validate_bitbucket(user: str) -> Result:
+    if not (1 <= len(user) <= 30):
+        return Result.error("Length must be 1-30 characters.")
+
+    if not re.match(r'^[a-z0-9][a-z0-9_-]*$', user):
+
+        if re.search(r'[A-Z]', user):
+            return Result.error("Use lowercase letters only.")
+
+        return Result.error("Only use lowercase letters, numbers, hyphens, and underscores.")
+
+    url = f"https://bitbucket.org/{user}/"
+
+    return status_validate(url, 404, [200, 302], follow_redirects=True)
+
+
+if __name__ == "__main__":
+    user = input("Username?: ").strip()
+    result = validate_bitbucket(user)
+
+    if result == 1:
+        print("Available!")
+    elif result == 0:
+        print("Unavailable!")
+    else:
+        print(f"Error occurred! Reason: {result.get_reason()}")
+
+
+
+

user_scanner/dev/github.py

@@ -29,7 +29,7 @@ def validate_github(user):
 
         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.error("Cannot start/end with hyphen or use double hyphens, underscores")
 
             return Result.taken()
 

user_scanner/dev/leetcode.py

@@ -0,0 +1,35 @@
+import re
+from user_scanner.core.orchestrator import status_validate, Result
+
+
+def validate_leetcode(user: str) -> Result:
+    if not (3 <= len(user) <= 30):
+        return Result.error("Length must be between 3 and 30 characters")
+
+    if not re.match(r'^[a-zA-Z0-9._-]+$', user):
+        return Result.error("Can only use letters, numbers, underscores, periods, or hyphens")
+
+    url = f"https://leetcode.com/u/{user}/"
+
+    headers = {
+      'User-Agent': "Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/143.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': "identity",
+      'upgrade-insecure-requests': "1",
+      'accept-language': "en-US,en;q=0.9",
+      'priority': "u=0, i"
+    }
+
+    return status_validate(url, 404, 200, headers=headers, follow_redirects=True)
+
+
+if __name__ == "__main__":
+    user = input("Username?: ").strip()
+    result = validate_leetcode(user)
+
+    if result == 1:
+        print("Available!")
+    elif result == 0:
+        print("Unavailable!")
+    else:
+        print(f"Error occurred! Reason: {result.get_reason()}")

user_scanner/dev/sourceforge.py

@@ -0,0 +1,30 @@
+import re
+from user_scanner.core.orchestrator import status_validate, Result
+
+
+def validate_sourceforge(user: str) -> Result:
+    if not (3 <= len(user) <= 30):
+        return Result.error("Length must be 3-30 characters.")
+
+    if not re.match(r'^[a-z0-9-]+$', user):
+
+        if re.search(r'[A-Z]', user):
+            return Result.error("Use lowercase letters only.")
+
+        return Result.error("Only use lowercase letters, numbers, and dashes.")
+
+    url = f"https://sourceforge.net/u/{user}/"
+
+    return status_validate(url, 404, 200, follow_redirects=True)
+
+
+if __name__ == "__main__":
+    user = input("Username?: ").strip()
+    result = validate_sourceforge(user)
+
+    if result == 1:
+        print("Available!")
+    elif result == 0:
+        print("Unavailable!")
+    else:
+        print(f"Error occurred! Reason: {result.get_reason()}")

user_scanner/social/discord.py

@@ -1,5 +1,6 @@
 import httpx
 from user_scanner.core.result import Result
+from user_scanner.core.orchestrator import generic_validate
 
 def validate_discord(user):
     url = "https://discord.com/api/v9/unique-username/username-attempt-unauthed"
@@ -15,8 +16,7 @@ def validate_discord(user):
 
     data = {"username": user}
 
-    try:
-        response = httpx.post(url, headers=headers, json=data, timeout=3.0)
+    def process(response):
         if response.status_code == 200:
             status = response.json().get("taken")
             if status is True:
@@ -24,8 +24,8 @@ def validate_discord(user):
             elif status is False:
                 return Result.available()
         return Result.error("Invalid status code")
-    except Exception as e:
-        return Result.error(e)
+
+    return generic_validate(url, process, method="POST", json=data, headers=headers, timeout=3.0)
 
 
 if __name__ == "__main__":

user_scanner/social/twitch.py

@@ -0,0 +1,83 @@
+import json
+import re
+import httpx
+from user_scanner.core.orchestrator import generic_validate, Result
+
+
+def validate_twitch(user: str) -> Result:
+    if not (4 <= len(user) <= 25):
+        return Result.error("Username must be between 4 and 25 characters long")
+
+    if not re.match(r"^[a-zA-Z0-9]+$", user):
+        return Result.error("Username can only contain alphanumeric characters (a-z, 0-9)")
+
+    url = "https://gql.twitch.tv/gql"
+
+    payload = [
+      {
+        "operationName": "ChannelLayout",
+        "variables": {
+          "channelLogin": user,
+          "includeIsDJ": True
+        },
+        "extensions": {
+          "persistedQuery": {
+            "version": 1,
+            "sha256Hash": "4c361fa1874dc8f6a49e62b56aa1032eccb31311bdb653918a924f96a8b2d1a6"
+          }
+        }
+      }
+    ]
+
+    headers = {
+      'User-Agent': "Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/143.0.0.0 Mobile Safari/537.36",
+      'Accept-Encoding': "identity",
+      'Content-Type': "application/json",
+      'sec-ch-ua-platform': "\"Android\"",
+      'accept-language': "en-US",
+      'client-id': "kimne78kx3ncx6brgo4mv6wki5h1ko",
+      'client-version': "7bb0442d-1175-4ab5-9d32-b1f370536cbf",
+      'origin': "https://m.twitch.tv",
+      'referer': "https://m.twitch.tv/",
+    }
+
+    def process(response: httpx.Response) -> Result:
+        if response.status_code != 200:
+            return Result.error(f"Unexpected status code: {response.status_code}")
+
+        try:
+            data = response.json()
+        except json.JSONDecodeError as e:
+            return Result.error(f"Failed to decode JSON response: {e}")
+
+        user_data = data[0].get('data', {}).get('user', {})
+        typename = user_data.get('__typename')
+
+        if typename == "User":
+            return Result.taken()
+        elif typename == "UserDoesNotExist":
+            return Result.available()
+        else:
+            return Result.error("Unexpected GraphQL response structure or type.")
+
+    return generic_validate(
+        url,
+        process,
+        headers=headers,
+        method='POST',
+        content=json.dumps(payload),
+        follow_redirects=False
+    )
+
+
+if __name__ == "__main__":
+    user = input("Twitch Username?: ").strip()
+    result = validate_twitch(user)
+
+    if result == 1:
+        print("Available!")
+    elif result == 0:
+        print("Unavailable!")
+    else:
+        reason = result.get_reason()
+        print(f"Error occurred! Reason: {reason}")

user_scanner/version.json

@@ -1,4 +1,4 @@
 {
-"version": "1.0.8.1",
+"version": "1.0.9.1",
 "version_type": "pypi"
 }

{user_scanner-1.0.8.1.dist-info → user_scanner-1.0.9.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: user-scanner
-Version: 1.0.8.1
+Version: 1.0.9.1
 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.8.1-blueviolet?style=for-the-badge&logo=github" />
+  <img src="https://img.shields.io/badge/Version-1.0.9.1-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" />
@@ -31,14 +31,16 @@ Perfect for finding a **unique username** across GitHub, Twitter, Reddit, Instag
 
 ### Features
 
-- ✅ Check usernames across **social networks**, **developer platforms**, and **creator communities**.
-- ✅ Clear **Available / Taken / Error** output for each platform.
+- ✅ Check usernames across **social networks**, **developer platforms**, and **creator communities**
+- ✅ Clear **Available / Taken / Error** output for each platform
 - ✅ Robust error handling: It prints the exact reason (e.g. Cannot use underscores, hyphens at the start/end)
-- ✅ Fully modular: add new platform modules easily.
+- ✅ Fully modular: add new platform modules easily
 - ✅ Wildcard-based username permutations for automatic variation generation using provided suffix
+- ✅ Selection of results format (e.g. json, csv, console (default))
+- ✅ Get the scanning results in preferred format (json/csv) in specified output file (suitable for power users)
 - ✅ Command-line interface ready: works directly after `pip install`
-- ✅ Can be used as username OSINT tool.
-- ✅ Very low and lightweight dependencies, can be run on any machine.
+- ✅ Can be used as username OSINT tool
+- ✅ Very low and lightweight dependencies, can be run on any machine
 ---
 
 ### Installation
@@ -62,15 +64,21 @@ Optionally, scan a specific category or single module:
 user-scanner -u <username> -c dev
 user-scanner -l # Lists all available modules
 user-scanner -u <username> -m github
-user-scanner -u <username> -p <suffix> 
+```
 
+Also, the output file and format can be specified: <br>
+
+```bash
+user-scanner -u <username> -f console #Default format
+user-scanner -u <username> -f csv
+user-scanner -u <username> -f json
+user-scanner -u <username> -f <format> -o <output-file>
 ```
 
 Generate multiple username variations by appending a suffix:
 
 ```bash
 user-scanner -u <username> -p <suffix> 
-
 ```
 Optionally, scan a specific category or single module with limit:
 
@@ -78,7 +86,7 @@ Optionally, scan a specific category or single module with limit:
 user-scanner -u <username> -p <suffix> -c dev
 user-scanner -u <username> -p <suffix> -m github
 user-scanner -u <username> -p <suffix> -s <number> # limit generation of usernames
-user-scanner -u <username> -p <suffix> -d <seconds> #delay to avoid rate-limits
+user-scanner -u <username> -p <suffix> -d <seconds> # delay to avoid rate-limits (can be 0s-1s)
 ```
 
 ---
@@ -94,6 +102,10 @@ user-scanner -u <username> -p <suffix> -d <seconds> #delay to avoid rate-limits
 
 <img width="1080" height="352" alt="1000140393" src="https://github.com/user-attachments/assets/578b248c-2a05-4917-aab3-6372a7c28045" />
 
+---
+
+<img width="992" height="556" alt="1000141265" src="https://github.com/user-attachments/assets/9babb19f-bc87-4e7b-abe5-c52b8b1b672c" />
+
 
 ### Contributing: 
 

{user_scanner-1.0.8.1.dist-info → user_scanner-1.0.9.1.dist-info}/RECORD

@@ -1,32 +1,37 @@
 user_scanner/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-user_scanner/__main__.py,sha256=r_8gq8wSRs3U7yUkTAv4e4MPopX0MUf_EbwedBTPs44,5082
-user_scanner/version.json,sha256=_1eU-X0UN6AjXfkZNFG3CCPFc6S2N4WQmSrbnp5Dvog,49
+user_scanner/__main__.py,sha256=jmfWuPNToix9UtLNh7IYrm-M22QBdSPtmMHv4ZY66Bc,5253
+user_scanner/version.json,sha256=xMl1CJDy9wpMkJKVCDUR1Vh7d-oyLU4gx1symSWOLIY,49
 user_scanner/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 user_scanner/cli/banner.py,sha256=3t6owaDArERlvpcszA1Yi3dtksvh8a9tLyrxRowTC40,1499
+user_scanner/cli/printer.py,sha256=H8rNw0ewG3G0JquKnMLW8PbHmFcALaEZZNUAsAUScHg,4027
 user_scanner/community/__init__.py,sha256=5EzlM991pJqvqIRc05_QV5BureJZ7wiCRm1AyEY6pms,12
 user_scanner/community/coderlegion.py,sha256=W_bdjzdFPRgUrNFFlylvToSJ4AzaFCtTsUy_MRVDdSo,451
 user_scanner/community/stackoverflow.py,sha256=MTL8O0TLHkjVbugBh1pLxELJLU3hkX_YEHjGjaKTJi4,1007
 user_scanner/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-user_scanner/core/orchestrator.py,sha256=8dLzV-0zUafZxMLIGAT65Tp4YJtvboelR6eL9M22_4M,6124
-user_scanner/core/result.py,sha256=HWz9JjRk74shAdM56ZtdG6hIp4dgcahqYSnpOp3uCak,1933
+user_scanner/core/orchestrator.py,sha256=nfe0KEcT2U_MB48OgmuvQ0tHvQdnJm8VVi06QxiuJMU,7059
+user_scanner/core/result.py,sha256=8qrIXO5jg6OjWkLtEq25lx_b1hLgtDFugdDyrJX4vcU,3300
+user_scanner/core/utils.py,sha256=v3XLUXmknf9zl_JBOmnss3280SrEWBdPcz-zq3S8lak,249
 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/hashnode.py,sha256=NEIpSyf0zbcZ_QNjU3C7F5oApvVpUQOd_oQuughM-Qc,1403
+user_scanner/creator/itch_io.py,sha256=2a8UVh-_OaWQPcSUHUuijDGpWDxsR8DoCcU1BdTRqqs,854
 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=p0HoIIVhmv9bBkelhfzRYudUFoyk_qeT66-hPpHEFqk,1938
 user_scanner/dev/__init__.py,sha256=qUR0eLwN-gO6oKk-1cmCVT4G_AxUHHMgpV3wJ7URXi4,7
+user_scanner/dev/bitbucket.py,sha256=qAIlFCmMaNTUx2-a5wJKHjbQjERcJt0zKHJmjLAeXr4,876
 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/github.py,sha256=9Q4G84WTAeWfNliApKdRFl1MJLfHvDPJ09mwr8P1ePo,1702
 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/leetcode.py,sha256=PTJcgp1W3fzLDK_Jy_VvRjKnLftLYMJaw3kfMjHqt9c,1246
 user_scanner/dev/npmjs.py,sha256=k-DhFqGJWDoQ79EzR8hmVrJk07AfJfPUWnIYuKc2G6w,713
 user_scanner/dev/replit.py,sha256=SI_i2l4w9tm2kBX4-cONBAT8dSynXoGEP4zcU8ngnh0,442
+user_scanner/dev/sourceforge.py,sha256=Kt8MmpCgB1tNwYRI9PYOZzIrL1VfnpzeNC43DcbZlbI,850
 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
@@ -39,7 +44,7 @@ user_scanner/gaming/roblox.py,sha256=Qs51jLgKh-Ehqlco_j8CFtJ4CLVoZeBwPugDvAyLw3Q
 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/discord.py,sha256=S_6ItjRcxip_L60UJ2rdLRFf4eXT7fMN7roCKA-lDfc,1193
 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
@@ -48,12 +53,13 @@ user_scanner/social/snapchat.py,sha256=XEW_W4jEBX4AiHREcfHGstt97Ez3GI-3bKSzhtMyn
 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/twitch.py,sha256=blsh5sMT7miF5-xqVXYLieTILzkop2PsWqv9HhP8G40,2509
 user_scanner/social/x.py,sha256=sAnboHHZN2DWyKeds46GLZHxGG-G_bjzfVNIkblSHx8,1406
 user_scanner/social/youtube.py,sha256=UPu584teg75P7FT05RFG3nobbHgPmzjr-ZwyN2sw6gw,1980
 user_scanner/utils/update.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 user_scanner/utils/version.py,sha256=mPh24EwITyXgD3AMgbflRL180pS0JfrvuJdnoErOU34,623
-user_scanner-1.0.8.1.dist-info/entry_points.txt,sha256=XqU3kssYZ0vXaPy5qYUOTCu4u-48Xie7QWFpBCYc7Nc,59
-user_scanner-1.0.8.1.dist-info/licenses/LICENSE,sha256=XH1QyQG68zo1opDIZHTHcTAbe9XMzewvTaFTukcN9vc,1061
-user_scanner-1.0.8.1.dist-info/WHEEL,sha256=G2gURzTEtmeR8nrdXUJfNiB3VYVxigPQ-bEQujpNiNs,82
-user_scanner-1.0.8.1.dist-info/METADATA,sha256=e14tVl6oz9iSik_h3jmapma4fdyyv3YYdWaYh-82sfY,5153
-user_scanner-1.0.8.1.dist-info/RECORD,,
+user_scanner-1.0.9.1.dist-info/entry_points.txt,sha256=XqU3kssYZ0vXaPy5qYUOTCu4u-48Xie7QWFpBCYc7Nc,59
+user_scanner-1.0.9.1.dist-info/licenses/LICENSE,sha256=XH1QyQG68zo1opDIZHTHcTAbe9XMzewvTaFTukcN9vc,1061
+user_scanner-1.0.9.1.dist-info/WHEEL,sha256=G2gURzTEtmeR8nrdXUJfNiB3VYVxigPQ-bEQujpNiNs,82
+user_scanner-1.0.9.1.dist-info/METADATA,sha256=NXrrk_8W1d8k7DbXvyAhMYq9QFCL-opRBVicqcOQVDI,5697
+user_scanner-1.0.9.1.dist-info/RECORD,,