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

user_scanner/__init__.py

@@ -0,0 +1 @@
+

user_scanner/__main__.py

@@ -2,23 +2,27 @@ import argparse
 import re
 from user_scanner.core.orchestrator import run_checks, load_modules
 from colorama import Fore, Style
+from .cli import banner
+from .cli.banner import print_banner
 
 CATEGORY_MAPPING = {
     "dev": "dev",
     "social": "social",
     "creator": "creator",
     "community": "community",
-    "gaming": "gaming"
+    "gaming": "gaming",
+    "donation": "donation"
 }
 
 def list_modules(category=None):
-    from user_scanner import dev, social, creator, community, gaming
+    from user_scanner import dev, social, creator, community, gaming, donation
     packages = {
         "dev": dev,
         "social": social,
         "creator": creator,
         "community": community,
-        "gaming": gaming
+        "gaming": gaming,
+        "donation": donation
     }
 
     categories_to_list = [category] if category else packages.keys()
@@ -37,7 +41,7 @@ def main():
         description="Scan usernames across multiple platforms."
     )
     parser.add_argument(
-        "-u", "--username", help="Username to scan across platforms"
+        "-u", "--username",  help="Username to scan across platforms"
     )
     parser.add_argument(
         "-c", "--category", choices=CATEGORY_MAPPING.keys(),
@@ -55,13 +59,13 @@ def main():
 
     args = parser.parse_args()
 
+    if args.module and "." in args.module:
+       args.module = args.module.replace(".", "_")
+
     if args.list:
         list_modules(args.category)
         return
 
-    if not args.username:
-        print(Fore.RED + "[!] Please provide a username with -u or --username." + Style.RESET_ALL)
-        return
 
     # Special username checks before run
     if (args.module == "x" or args.category == "social"):
@@ -70,13 +74,18 @@ def main():
     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")
+    if not args.username:
+       parser.print_help()
+       return
+    else:
+       print_banner()
 
 
-    from user_scanner import dev, social, creator, community, gaming
+    from user_scanner import dev, social, creator, community, gaming, donation
 
     if args.module:
         # Single module search across all categories
-        packages = [dev, social, creator, community, gaming]
+        packages = [dev, social, creator, community, gaming, donation]
         found = False
         for package in packages:
             modules = load_modules(package)
@@ -98,4 +107,4 @@ def main():
         run_checks(args.username)
 
 if __name__ == "__main__":
-    main()
+    main()

user_scanner/cli/banner.py

@@ -0,0 +1,32 @@
+import json
+from colorama import Fore, Style, init
+from ..utils.version import load_local_version
+
+
+version, version_type = load_local_version()
+init(autoreset=True)
+C_RED = Fore.RED + Style.BRIGHT
+C_CYAN = Fore.CYAN + Style.BRIGHT
+C_GREEN = Fore.GREEN + Style.BRIGHT
+C_WHITE = Fore.WHITE + Style.BRIGHT
+C_MAGENTA = Fore.MAGENTA + Style.BRIGHT
+BANNER_ASCII = fr"""{C_CYAN}      _   _ ___  ___ _ __      ___  ___ __ _ _ __  _ __   ___ _ __
+     | | | / __|/ _ \ '__|____/ __|/ __/ _` | '_ \| '_ \ / _ \ '__|
+     | |_| \__ \  __/ | |_____\__ \ (_| (_| | | | | | | |  __/ |
+      \__,_|___/\___|_|       |___/\___\__,_|_| |_|_| |_|\___|_| Version: {version}
+{Style.RESET_ALL}""".strip()
+
+INFO_BOX = f"""{C_MAGENTA}      ╔════════════════════════════════════════╗
+      ║ {C_RED}♚ {C_GREEN}Project Name{C_WHITE} : UserScanner           {C_MAGENTA}║
+      ║ {C_RED}♚ {C_GREEN}Author{C_WHITE} : Kaif                        {C_MAGENTA}║
+      ║ {C_RED}♚ {C_GREEN}Github{C_WHITE} : github.com/kaifcodec        {C_MAGENTA}║
+      ║ {C_RED}♚ {C_GREEN}Email{C_WHITE}  : kaifcodec@gmail.com         {C_MAGENTA}║
+      ══════════════════════════════════════════{Style.RESET_ALL}""".strip()
+
+def print_banner():
+    print(BANNER_ASCII)
+    print(INFO_BOX)
+    print(" ")
+
+if __name__ == "__main__":
+    print_banner()

user_scanner/community/coderlegion.py

@@ -1,30 +1,9 @@
-import httpx
-from httpx import ConnectError, TimeoutException
+from ..core.orchestrator import status_validate
 
-def validate_coderlegion(user):
-    url = f"https://coderlegion.com/user/{user}"
-
-    headers = {
-        'User-Agent': "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/128.0.0.0 Safari/537.36",
-        '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",
-        'Accept-Language': "en-US,en;q=0.9",
-    }
-    try:
-        response = httpx.get(url, headers=headers, timeout = 15.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
+def validate_coderlegion(user): 
+   url = f"https://coderlegion.com/user/{user}"
+   
+   return status_validate(url, 404, 200, timeout = 15.0)
 
 if __name__ == "__main__":
    user = input ("Username?: ").strip()

user_scanner/core/orchestrator.py

@@ -1,6 +1,14 @@
 import importlib
 import pkgutil
 from colorama import Fore, Style
+import threading
+
+import httpx
+from httpx import ConnectError, TimeoutException
+
+lock = threading.Condition()
+#Basically which thread is the one to print
+print_queue = 0
 
 def load_modules(package):
 
@@ -13,80 +21,120 @@ def load_modules(package):
             print(f"Failed to import {name}: {e}")
     return modules
 
-def run_module_single(module, username):
+def worker_single(module, username, i):
+    global print_queue
 
     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()
+    site_name = module.__name__.split('.')[-1].capitalize().replace("_",".")
     if site_name == "X":
         site_name = "X (Twitter)"
 
+    output = ""
     if func:
         try:
             result = func(username)
             if result == 1:
-                print(f"  {Fore.GREEN}[✔] {site_name}: Available{Style.RESET_ALL}")
+                output = f"  {Fore.GREEN}[✔] {site_name}: Available{Style.RESET_ALL}"
             elif result == 0:
-                print(f"  {Fore.RED}[✘] {site_name}: Taken{Style.RESET_ALL}")
+                output = f"  {Fore.RED}[✘] {site_name}: Taken{Style.RESET_ALL}"
             else:
-                print(f"  {Fore.YELLOW}[!] {site_name}: Error{Style.RESET_ALL}")
+                output = f"  {Fore.YELLOW}[!] {site_name}: Error{Style.RESET_ALL}"
         except Exception as e:
-            print(f"  {Fore.YELLOW}[!] {site_name}: Exception - {e}{Style.RESET_ALL}")
+            output = f"  {Fore.YELLOW}[!] {site_name}: Exception - {e}{Style.RESET_ALL}"
     else:
-        print(f"  {Fore.YELLOW}[!] {site_name} has no validate_ function{Style.RESET_ALL}")
+        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()
+
+        print(output)
+        print_queue += 1
+        lock.notify_all()
+
+def run_module_single(module, username):
+    #Just executes as if it was a thread
+    worker_single(module, username, print_queue)
+    
 def run_checks_category(package, username, verbose=False):
+    global print_queue
+    
     modules = load_modules(package)
     category_name = package.__name__.split('.')[-1].capitalize()
     print(f"{Fore.MAGENTA}== {category_name} SITES =={Style.RESET_ALL}")
 
-    for module in modules:
-        run_module_single(module, username)
+    print_queue = 0
 
-def run_checks(username):
+    threads = []
+    for i, module in enumerate(modules):
+        t = threading.Thread(target=worker_single, args=(module, username, i))
+        threads.append(t)
+        t.start()
 
-    from user_scanner import dev, social,creator, community, gaming
+    for t in threads:
+        t.join()
 
-    categories = [
-        ("DEV", dev),
-        ("SOCIAL", social),
-        ("CREATOR", creator),
-        ("COMMUNITY", community),
-        ("GAMING", gaming)
-    ]
+def run_checks(username):
+    from user_scanner import dev, social, creator, community, gaming, donation
 
-    print(f"\n{Fore.CYAN} Checking username: {username}{Style.RESET_ALL}\n")
+    packages = [dev, social, creator, community, gaming, donation]
 
-    for cat_name, package in categories:
-        try:
-            modules = load_modules(package)
-        except ModuleNotFoundError:
-            continue
-
-        print(f"{Fore.MAGENTA}== {cat_name} SITES =={Style.RESET_ALL}")
-
-        for module in modules:
-            # Find the first function starting with "validate_"
-            func = None
-            for f in dir(module):
-                if f.startswith("validate_") and callable(getattr(module, f)):
-                    func = getattr(module, f)
-                    break
-            if not func:
-                continue
-
-            site_name = module.__name__.split('.')[-1].capitalize()
-            if site_name == "X":
-               site_name = "X (Twitter)"
-            try:
-                result = func(username)
-                if result == 1:
-                    print(f"  {Fore.GREEN}[✔] {site_name}: Available{Style.RESET_ALL}")
-                elif result == 0:
-                    print(f"  {Fore.RED}[✘] {site_name}: Taken{Style.RESET_ALL}")
-                else:
-                    print(f"  {Fore.YELLOW}[!] {site_name}: Error{Style.RESET_ALL}")
-            except Exception as e:
-                print(f"  {Fore.YELLOW}[!] {site_name}: Exception - {e}{Style.RESET_ALL}")
+    print(f"\n{Fore.CYAN} Checking username: {username}{Style.RESET_ALL}\n")
 
+    for package in packages:
+        run_checks_category(package, username)
         print()
+
+def make_get_request(url, **kwargs):
+    """Simple wrapper to **httpx.get** that predefines headers and timeout"""
+    if not "headers" in kwargs:
+        kwargs["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,*/*;q=0.8",
+            'Accept-Encoding': "gzip, deflate, br",
+            'Accept-Language': "en-US,en;q=0.9",
+            'sec-fetch-dest': "document",
+        }
+
+    if not "timeout" in kwargs:
+        kwargs["timeout"] = 5.0
+
+    return httpx.get(url, **kwargs)
+
+def generic_validate(url, func, **kwargs):
+    """
+    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
+    
+def status_validate(url, available, taken, **kwargs):
+    """
+    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):
+        #Checks if a number is equal or is contained inside
+        contains = lambda a,b: (isinstance(a,list) and b in a) or (a == b)
+
+        status = response.status_code
+        available_value = contains(available, status)
+        taken_value = contains(taken, status)
+
+        if available_value and taken_value:
+            return 2 # Can't be both available and taken
+        elif available_value:
+            return 1
+        elif taken_value:
+            return 0
+        return 2
+
+    return generic_validate(url, inner, **kwargs)

user_scanner/creator/devto.py

@@ -1,29 +1,9 @@
-import httpx
-from httpx import ConnectError, TimeoutException
+from ..core.orchestrator import status_validate
 
 def validate_devto(user):
-    url = f"https://dev.to/{user}"
+   url = f"https://dev.to/{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",
-    }
-
-    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
+   return status_validate(url, 404, 200, follow_redirects = True)
 
 if __name__ == "__main__":
    user = input ("Username?: ").strip()

user_scanner/creator/itch_io.py

@@ -0,0 +1,22 @@
+from ..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)
+
+if __name__ == "__main__":
+   user = input ("Username?: ").strip()
+   result = validate_itch_io(user)
+
+   if result == 1:
+      print("Available!")
+   elif result == 0:
+      print("Unavailable!")
+   else:
+      print("Error occurred!")

user_scanner/creator/kaggle.py

@@ -1,29 +1,10 @@
-import httpx
-from httpx import ConnectError, TimeoutException
+from ..core.orchestrator import status_validate
 
 def validate_kaggle(user):
-    url = f"https://www.kaggle.com/{user}"
+   url = f"https://www.kaggle.com/{user}"
 
-    headers = {
-        'User-Agent': "Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/141.0.0.0 Mobile Safari/537.36",
-        'Accept': "text/html",
-    }
+   return status_validate(url, 404, 200, follow_redirects=True)
 
-    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
 
 if __name__ == "__main__":
    user = input ("Username?: ").strip()

user_scanner/creator/patreon.py

@@ -1,31 +1,9 @@
-import httpx
-from httpx import ConnectError, TimeoutException
+from ..core.orchestrator import status_validate
 
 def validate_patreon(user):
     url = f"https://www.patreon.com/{user}"
 
-    headers = {
-        'User-Agent': "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/128.0.0.0 Safari/537.36",
-        '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",
-        'Accept-Language': "en-US,en;q=0.9",
-    }
-
-    try:
-        response = httpx.get(url, headers=headers, timeout = 15.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
+    return status_validate(url, 404, 200, timeout = 15.0, follow_redirects=True)
 
 if __name__ == "__main__":
    try:

user_scanner/creator/producthunt.py

@@ -0,0 +1,40 @@
+import httpx
+from httpx import ConnectError, TimeoutException
+
+def validate_producthunt(user):
+    url = f"https://www.producthunt.com/@{user}"
+
+    headers = {
+        'User-Agent': "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/128.0.0.0 Safari/537.36",
+        '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",
+        '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
+
+if __name__ == "__main__":
+   user = input ("Username?: ").strip()
+   result = validate_producthunt(user)
+
+   if result == 1:
+      print("Available!")
+   elif result == 0:
+      print("Unavailable!")
+   else:
+      print("Error occured!")
+

user_scanner/dev/codeberg.py

@@ -1,29 +1,9 @@
-import httpx
-from httpx import ConnectError, TimeoutException
+from ..core.orchestrator import status_validate
 
 def validate_codeberg(user):
-    url = f"https://codeberg.org/{user}"
+   url = f"https://codeberg.org/{user}"
 
-    headers = {
-        'User-Agent': "Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/141.0.0.0 Mobile Safari/537.36",
-        'Accept': "text/html",
-    }
-
-    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
+   return status_validate(url, 404, 200, follow_redirects = True)
 
 if __name__ == "__main__":
    user = input ("Username?: ").strip()

user_scanner/dev/cratesio.py

@@ -1,31 +1,16 @@
-import httpx
-from httpx import ConnectError, TimeoutException
+from ..core.orchestrator import status_validate
 
 def validate_cratesio(user):
-    url = f"https://crates.io/api/v1/users/{user}"
+   url = f"https://crates.io/api/v1/users/{user}"
 
-    headers = {
-        'User-Agent': "Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/141.0.0.0 Mobile Safari/537.36",
-        'Accept': "application/json",
-        'Referer': "https://crates.io/",
-        'sec-fetch-mode': "cors",
-    }
+   headers = {
+      'User-Agent': "Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/141.0.0.0 Mobile Safari/537.36",
+      'Accept': "application/json",
+      'Referer': "https://crates.io/",
+      'sec-fetch-mode': "cors",
+   }
 
-    try:
-        response = httpx.head(url, headers=headers, timeout=5.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
+   return status_validate(url, 404, 200, headers = headers)
 
 if __name__ == "__main__":
    user = input ("Username?: ").strip()

user_scanner/dev/dockerhub.py

@@ -1,32 +1,14 @@
-import httpx
-from httpx import ConnectError, TimeoutException
+from ..core.orchestrator import status_validate
 
 def validate_dockerhub(user):
-    url = f"https://hub.docker.com/v2/users/{user}/"
+   url = f"https://hub.docker.com/v2/users/{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': "application/json",
-    }
+   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': "application/json",
+   }
 
-    try:
-        response = httpx.get(url, headers=headers, timeout=3.0)
-        status = response.status_code
-
-        # UNAVAILABLE (return 0) if the user API endpoint returns 200 OK
-        if status == 200:
-           return 0
-        # AVAILABLE (return 1) if the user API endpoint returns 404 Not Found
-        elif status == 404:
-           return 1
-        # Other status codes are errors
-        else:
-           return 2
-
-    except (ConnectError, TimeoutException):
-        return 2
-    except Exception:
-        return 2
+   return status_validate(url, 404, 200, headers = headers)
 
 if __name__ == "__main__":
    user = input ("Username?: ").strip()