user-scanner 1.0.9.1__tar.gz → 1.0.10.1__tar.gz

{user_scanner-1.0.9.1 → user_scanner-1.0.10.1}/PKG-INFO

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: user-scanner
-Version: 1.0.9.1
+Version: 1.0.10.1
 Summary: Check username availability across multiple popular platforms
 Keywords: username,checker,availability,social,tech,python,user-scanner
 Author-email: Kaif <kafcodec@gmail.com>
-Requires-Python: >=3.7
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: httpx
@@ -13,9 +13,9 @@ Project-URL: Homepage, https://github.com/kaifcodec/user-scanner
 
 # User Scanner
 
-![1000136215](https://github.com/user-attachments/assets/49ec8d24-665b-4115-8525-01a8d0ca2ef4)
+![User Scanner Logo](https://github.com/user-attachments/assets/49ec8d24-665b-4115-8525-01a8d0ca2ef4)
 <p align="center">
-  <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/badge/Version-1.0.10.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" />
@@ -32,6 +32,8 @@ Perfect for finding a **unique username** across GitHub, Twitter, Reddit, Instag
 ### Features
 
 - ✅ Check usernames across **social networks**, **developer platforms**, and **creator communities**
+- ✅ Can be used as a username OSINT tool
+- ✅ Smart auto-update system, Detects new releases on PyPI and interactively prompts the user to upgrade.
 - ✅ 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
@@ -39,7 +41,6 @@ Perfect for finding a **unique username** across GitHub, Twitter, Reddit, Instag
 - ✅ 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
 ---
 
@@ -78,7 +79,7 @@ user-scanner -u <username> -f <format> -o <output-file>
 Generate multiple username variations by appending a suffix:
 
 ```bash
-user-scanner -u <username> -p <suffix> 
+user-scanner -u <username> -p <suffix>
 ```
 Optionally, scan a specific category or single module with limit:
 
@@ -87,9 +88,20 @@ 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 (can be 0s-1s)
+```
+---
+
+### Update
+
+Update the tool to the latest PyPI version:
+
+```bash
+user-scanner -U
+
 ```
 
 ---
+
 ### Screenshot: 
 
 - Note*: New modules are constantly getting added so this might have only limited, outdated output:

{user_scanner-1.0.9.1 → user_scanner-1.0.10.1}/README.md

@@ -1,8 +1,8 @@
 # User Scanner
 
-![1000136215](https://github.com/user-attachments/assets/49ec8d24-665b-4115-8525-01a8d0ca2ef4)
+![User Scanner Logo](https://github.com/user-attachments/assets/49ec8d24-665b-4115-8525-01a8d0ca2ef4)
 <p align="center">
-  <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/badge/Version-1.0.10.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" />
@@ -19,6 +19,8 @@ Perfect for finding a **unique username** across GitHub, Twitter, Reddit, Instag
 ### Features
 
 - ✅ Check usernames across **social networks**, **developer platforms**, and **creator communities**
+- ✅ Can be used as a username OSINT tool
+- ✅ Smart auto-update system, Detects new releases on PyPI and interactively prompts the user to upgrade.
 - ✅ 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
@@ -26,7 +28,6 @@ Perfect for finding a **unique username** across GitHub, Twitter, Reddit, Instag
 - ✅ 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
 ---
 
@@ -65,7 +66,7 @@ user-scanner -u <username> -f <format> -o <output-file>
 Generate multiple username variations by appending a suffix:
 
 ```bash
-user-scanner -u <username> -p <suffix> 
+user-scanner -u <username> -p <suffix>
 ```
 Optionally, scan a specific category or single module with limit:
 
@@ -74,9 +75,20 @@ 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 (can be 0s-1s)
+```
+---
+
+### Update
+
+Update the tool to the latest PyPI version:
+
+```bash
+user-scanner -U
+
 ```
 
 ---
+
 ### Screenshot: 
 
 - Note*: New modules are constantly getting added so this might have only limited, outdated output:

{user_scanner-1.0.9.1 → user_scanner-1.0.10.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "flit_core.buildapi"
 
 [project]
 name = "user-scanner"
-version = "1.0.9.1"
+version = "1.0.10.1"
 description = "Check username availability across multiple popular platforms"
 readme = "README.md"
 license = {file = "LICENSE"}
@@ -16,7 +16,7 @@ dependencies = [
   "colorama"
 ]
 
-requires-python = ">=3.7"
+requires-python = ">=3.10"
 keywords = ["username", "checker", "availability", "social", "tech", "python", "user-scanner"]
 
 [project.urls]
@@ -27,3 +27,7 @@ user-scanner = "user_scanner.__main__:main"
 
 [tool.flit.sdist]
 exclude = ["tests/", "docs/", ".github/", ".git", "rm_pycache.py", "che.py", ".gitignore"]
+
+[tool.pytest.ini_options]
+pythonpath = "."
+testpaths = ["tests"]

{user_scanner-1.0.9.1 → user_scanner-1.0.10.1}/user_scanner/__main__.py

@@ -1,17 +1,29 @@
 import argparse
 import time
-import re
+import sys
 from user_scanner.cli import printer
 from user_scanner.core.orchestrator import generate_permutations, load_categories
 from colorama import Fore, Style
 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
+from user_scanner.core.helpers import is_last_value
+from user_scanner.utils.updater_logic import check_for_updates
+from user_scanner.utils.update import update_self
+
+# Color configs
+R = Fore.RED
+G = Fore.GREEN
+C = Fore.CYAN
+Y = Fore.YELLOW
+X = Fore.RESET
+
 
 MAX_PERMUTATIONS_LIMIT = 100 # To prevent excessive generation
 
+
 def main():
+
     parser = argparse.ArgumentParser(
         prog="user-scanner",
         description="Scan usernames across multiple platforms."
@@ -51,15 +63,25 @@ def main():
     parser.add_argument(
         "-o", "--output", type=str, help="Specify the output file"
     )
+    parser.add_argument(
+        "-U", "--update", action="store_true",  help="Update user-scanner to latest version"
+    )
 
     args = parser.parse_args()
 
     Printer = printer.Printer(args.format)
 
+    if args.update is True:
+        update_self()
+        print(f"[{G}+{X}] {G}Update successful. Please restart the tool.{X}")
+        sys.exit(0)
+
     if args.list:
         Printer.print_modules(args.category)
         return
 
+    check_for_updates()
+
     if not args.username:
         parser.print_help()
         return
@@ -70,19 +92,19 @@ def main():
 
     if args.permute and args.delay == 0 and Printer.is_console:
         print(
-        Fore.YELLOW
+        Y
         + "[!] 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.
+    # Added permutation support , generate all possible permutation of given sequence.
     if args.permute:
         usernames = generate_permutations(args.username, args.permute , args.stop)
         if Printer.is_console:
             print(
-                Fore.CYAN + f"[+] Generated {len(usernames)} username permutations" + Style.RESET_ALL)
+                C + f"[+] Generated {len(usernames)} username permutations" + Style.RESET_ALL)
 
     if args.module and "." in args.module:
         args.module = args.module.replace(".", "_")
@@ -96,7 +118,7 @@ def main():
         print(Printer.get_start())
         for i, name in enumerate(usernames):
             is_last = i == len(usernames) - 1
-            if arg == None:
+            if arg is None:
                 results.extend(func(name, Printer, is_last))
             else:
                 results.extend(func(arg, name, Printer, is_last))
@@ -118,7 +140,7 @@ def main():
                 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)
+                R + f"[!] Module '{args.module}' not found in any category." + Style.RESET_ALL)
 
     elif args.category:
         # Category-wise scan
@@ -139,7 +161,7 @@ def main():
             "\n[!] The console format cannot be "
             f"written to file: '{args.output}'."
         )
-        print(Fore.RED + msg + Style.RESET_ALL)
+        print(R + msg + Style.RESET_ALL)
         return
 
     content = Printer.get_start()

user_scanner-1.0.10.1/user_scanner/cli/banner.py

@@ -0,0 +1,24 @@
+from colorama import Fore, Style, init
+from ..core.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()
+
+
+def print_banner():
+    print(BANNER_ASCII)
+
+
+if __name__ == "__main__":
+    print_banner()

{user_scanner-1.0.9.1 → user_scanner-1.0.10.1}/user_scanner/cli/printer.py

@@ -15,7 +15,7 @@ def indentate(msg: str, indent: int):
 
 class Printer:
     def __init__(self, format: Literal["console", "csv", "json"]) -> None:
-        if not format in ["console", "csv", "json"]:
+        if format not in ["console", "csv", "json"]:
             raise ValueError(f"Invalid output-format: {format}")
         self.mode: str = format
         self.indent: int = 0
@@ -42,7 +42,7 @@ class Printer:
 
     def get_end(self, json_char: str = "]") -> str:
         if not self.is_json:
-            return
+            return ""
         self.indent = max(self.indent - 1, 0)
         return indentate(json_char, self.indent)
 

user_scanner-1.0.10.1/user_scanner/community/hackernews.py

@@ -0,0 +1,33 @@
+import re
+from user_scanner.core.orchestrator import generic_validate, Result
+
+
+def validate_hackernews(user: str) -> Result:
+    if not (2 <= len(user) <= 15):
+        return Result.error("Length must be 2-15 characters")
+
+    if not re.match(r'^[a-zA-Z0-9_-]+$', user):
+        return Result.error("Only use letters, numbers, underscores, and hyphens")
+
+    url = f"https://news.ycombinator.com/user?id={user}"
+
+    def process(response):
+        if "No such user." in response.text:
+            return Result.available()
+        if f"profile: {user}" in response.text.lower() or "created:" in response.text:
+            return Result.taken()
+        return Result.error("Unexpected response structure")
+
+    return generic_validate(url, process, timeout=3.0, follow_redirects=True)
+
+
+if __name__ == "__main__":
+    user = input("Username?: ").strip()
+    result = validate_hackernews(user)
+
+    if result == 1:
+        print("Available!")
+    elif result == 0:
+        print("Unavailable!")
+    else:
+        print(f"Error occurred! Reason: {result.get_reason()}")

user_scanner-1.0.10.1/user_scanner/config.json

@@ -0,0 +1 @@
+{"auto_update_status": true}

{user_scanner-1.0.9.1 → user_scanner-1.0.10.1}/user_scanner/core/orchestrator.py

@@ -6,9 +6,9 @@ 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 user_scanner.core.result import Result
 from typing import Callable, Dict, List
-from user_scanner.core.utils import get_site_name, is_last_value
+from user_scanner.core.helpers import get_site_name, is_last_value
 
 
 def load_modules(category_path: Path):
@@ -17,6 +17,8 @@ def load_modules(category_path: Path):
         if file.name == "__init__.py":
             continue
         spec = importlib.util.spec_from_file_location(file.stem, str(file))
+        if spec is None or spec.loader is None:
+            continue
         module = importlib.util.module_from_spec(spec)
         spec.loader.exec_module(module)
 
@@ -30,8 +32,8 @@ def load_categories() -> Dict[str, Path]:
 
     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__
+                subfolder.name.lower() not in ["cli", "utils", "core"] and \
+                "__" not in subfolder.name:  # Removes __pycache__
             categories[subfolder.name] = subfolder.resolve()
 
     return categories
@@ -88,9 +90,9 @@ def run_module_single(module, username: str, printer: Printer, last: bool = True
     if category:
         result.update(category=category)
 
-    site_name = get_site_name(module)
+    get_site_name(module)
     msg = printer.get_result_output(result)
-    if last == False and printer.is_json:
+    if not last and printer.is_json:
         msg += ","
     print(msg)
 
@@ -114,9 +116,9 @@ def run_checks_category(category_path: Path, username: str, printer: Printer, la
             results.append(result)
 
             is_last = last and is_last_value(modules, i)
-            site_name = get_site_name(modules[i])
+            get_site_name(modules[i])
             msg = printer.get_result_output(result)
-            if is_last == False and printer.is_json:
+            if not is_last and printer.is_json:
                 msg += ","
             print(msg)
 
@@ -131,7 +133,7 @@ def run_checks(username: str, printer: Printer, last: bool = True) -> List[Resul
 
     categories = list(load_categories().values())
     for i, category_path in enumerate(categories):
-        last_cat: int = last and (i == len(categories) - 1)
+        last_cat = last and (i == len(categories) - 1)
         temp = run_checks_category(category_path, username, printer, last_cat)
         results.extend(temp)
 
@@ -140,7 +142,7 @@ def run_checks(username: str, printer: Printer, last: bool = True) -> List[Resul
 
 def make_request(url: str, **kwargs) -> httpx.Response:
     """Simple wrapper to **httpx.get** that predefines headers and timeout"""
-    if not "headers" in kwargs:
+    if "headers" not 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",
@@ -149,7 +151,7 @@ def make_request(url: str, **kwargs) -> httpx.Response:
             'sec-fetch-dest': "document",
         }
 
-    if not "timeout" in kwargs:
+    if "timeout" not in kwargs:
         kwargs["timeout"] = 5.0
 
     method = kwargs.pop("method", "GET")
@@ -157,14 +159,13 @@ def make_request(url: str, **kwargs) -> httpx.Response:
     return httpx.request(method.upper(), url, **kwargs)
 
 
-def generic_validate(url: str, func: Callable[[httpx.Response], AnyResult], **kwargs) -> AnyResult:
+def generic_validate(url: str, func: Callable[[httpx.Response], Result], **kwargs) -> Result:
     """
     A generic validate function that makes a request and executes the provided function on the response.
     """
     try:
         response = make_request(url, **kwargs)
         result = func(response)
-        result.url = url
         return result
     except Exception as e:
         return Result.error(e, url=url)

{user_scanner-1.0.9.1 → user_scanner-1.0.10.1}/user_scanner/core/result.py

@@ -1,5 +1,4 @@
 from enum import Enum
-from typing import Literal
 
 DEBUG_MSG = """Result {{
   status: {status},
@@ -80,10 +79,10 @@ class Result:
         return self.status.value
 
     def has_reason(self) -> bool:
-        return self.reason != None
+        return self.reason is not None
 
     def get_reason(self) -> str:
-        if self.reason == None:
+        if self.reason is None:
             return ""
         if isinstance(self.reason, str):
             return self.reason
@@ -124,5 +123,3 @@ class Result:
 
         return NotImplemented
 
-
-AnyResult = Literal[0, 1, 2] | Result

{user_scanner-1.0.9.1/user_scanner/utils → user_scanner-1.0.10.1/user_scanner/core}/version.py

@@ -1,14 +1,15 @@
 import json
+import httpx
 from pathlib import Path
 
-_SCRIPT_DIR = Path(__file__).resolve().parent
-VERSION_FILE = _SCRIPT_DIR.parent / "version.json"
+SCRIPT_DIR = Path(__file__).parent
+VERSION_FILE = SCRIPT_DIR.parent / "version.json"
 
 
 def load_local_version():
     try:
         data = json.loads(VERSION_FILE.read_text())
-        return data.get("version", "0.0.0"), data.get("version_type", "local")
+        return data.get("version", "error_report_via_gh_issues"), data.get("version_type", "local")
     except FileNotFoundError:
         return "N/A", "file_missing"
     except json.JSONDecodeError:
@@ -17,6 +18,14 @@ def load_local_version():
         return "N/A", "error"
 
 
+def get_pypi_version(pypi_url):
+    try:
+        pypi_version = httpx.get(pypi_url, timeout=7).json()["info"]["version"]
+    except Exception as e:
+        print(e)
+        return None
+    return pypi_version
+
 if __name__ == "__main__":
     version, version_type = load_local_version()
     print(f"Version: {version}, Type: {version_type}")

{user_scanner-1.0.9.1 → user_scanner-1.0.10.1}/user_scanner/creator/hashnode.py

@@ -1,4 +1,3 @@
-import httpx
 from user_scanner.core.result import Result
 from user_scanner.core.orchestrator import generic_validate
 

{user_scanner-1.0.9.1 → user_scanner-1.0.10.1}/user_scanner/creator/medium.py

@@ -6,8 +6,19 @@ def validate_medium(user):
     url = f"https://medium.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",
+        'User-Agent': "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/143.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': "identity",
+        'upgrade-insecure-requests': "1",
+        'sec-fetch-site': "none",
+        'sec-fetch-mode': "navigate",
+        'sec-fetch-user': "?1",
+        'sec-fetch-dest': "document",
+        'sec-ch-ua': "\"Google Chrome\";v=\"143\", \"Chromium\";v=\"143\", \"Not A(Brand\";v=\"24\"",
+        'sec-ch-ua-mobile': "?0",
+        'sec-ch-ua-platform': "\"Linux\"",
+        'accept-language': "en-US,en;q=0.9",
+        'priority': "u=0, i"
     }
 
     def process(response):
@@ -34,4 +45,4 @@ if __name__ == "__main__":
     elif result == 0:
         print("Unavailable!")
     else:
-        print("Error occurred!")
+        print(f"Error occurred! Reason: {result.get_reason()}")

user_scanner-1.0.10.1/user_scanner/creator/substack.py

@@ -0,0 +1,36 @@
+import re
+from user_scanner.core.orchestrator import status_validate, Result
+
+
+def validate_substack(user: str) -> Result:
+    if not (4 <= len(user) <= 32):
+        return Result.error("Length must be 4-32 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("Usernames can only contain lowercase letters and numbers")
+
+    url = f"https://{user}.substack.com"
+
+    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",
+        '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_substack(user)
+
+    if result == 1:
+        print("Available!")
+    elif result == 0:
+        print("Unavailable!")
+    else:
+        print(f"Error occurred! Reason: {result.get_reason()}")

user_scanner-1.0.10.1/user_scanner/gaming/lichess.py

@@ -0,0 +1,40 @@
+import re
+from user_scanner.core.orchestrator import generic_validate, Result
+
+
+def validate_lichess(user: str) -> Result:
+    if not (2 <= len(user) <= 20):
+        return Result.error("Length must be 2-20 characters")
+
+    if not re.match(r'^[a-zA-Z0-9_-]+$', user):
+        return Result.error("Usernames can only contain letters, numbers, underscores, and hyphens")
+
+    if re.search(r'[_-]{2,}', user):
+        return Result.error("Username cannot contain consecutive underscores or hyphens")
+
+    if not re.match(r'.*[a-zA-Z0-9]$', user):
+        return Result.error("Username must end with a letter or a number")
+
+    url = f"https://lichess.org/api/player/autocomplete?term={user}&exists=1"
+
+    def process(response):
+        res_text = response.text.strip().lower()
+        if res_text == "true":
+            return Result.taken()
+        if res_text == "false":
+            return Result.available()
+        return Result.error("Unexpected error, report it via github issues")
+
+    return generic_validate(url, process, timeout=3.0)
+
+
+if __name__ == "__main__":
+    user = input("Username?: ").strip()
+    result = validate_lichess(user)
+
+    if result == 1:
+        print("Available!")
+    elif result == 0:
+        print("Unavailable!")
+    else:
+        print(f"Error occurred! Reason: {result.get_reason()}")

{user_scanner-1.0.9.1 → user_scanner-1.0.10.1}/user_scanner/gaming/monkeytype.py

@@ -1,9 +1,10 @@
 from user_scanner.core.orchestrator import generic_validate
 from user_scanner.core.result import Result
+from urllib.parse import quote
 
-def validate_monkeytype(user: str) -> int:
-
-    url = f"https://api.monkeytype.com/users/checkName/{user}"
+def validate_monkeytype(user: str) -> Result:
+    safe_user = quote(user, safe="")
+    url = f"https://api.monkeytype.com/users/checkName/{safe_user}"
 
     headers = {
         "User-Agent": (
@@ -28,6 +29,16 @@ def validate_monkeytype(user: str) -> int:
                 return Result.available()
             elif available is False:
                 return Result.taken()
+
+        # Surface Monkeytype validation errors (e.g. special characters)
+        try:
+            data = response.json()
+            errors = data.get("validationErrors")
+            if errors:
+                return Result.error("; ".join(errors))
+        except Exception:
+            pass
+
         return Result.error("Invalid status code")
 
     return generic_validate(url, process, headers=headers)
@@ -42,4 +53,4 @@ if __name__ == "__main__":
     elif result == 0:
         print("Unavailable!")
     else:
-        print("Error occurred!")
+        print("Error occured!")

{user_scanner-1.0.9.1 → user_scanner-1.0.10.1}/user_scanner/social/discord.py

@@ -1,4 +1,3 @@
-import httpx
 from user_scanner.core.result import Result
 from user_scanner.core.orchestrator import generic_validate
 

user_scanner-1.0.10.1/user_scanner/social/mastodon.py

@@ -0,0 +1,30 @@
+import re
+from user_scanner.core.orchestrator import status_validate
+from user_scanner.core.result import Result
+
+
+def validate_mastodon(user: str) -> Result:
+    if not (3 <= len(user) <= 30):
+        return Result.error("Length must be 3-30 characters")
+
+    if not re.match(r'^[a-zA-Z0-9_-]+$', user):
+        return Result.error("Usernames can only contain letters, numbers, underscores and hyphens")
+
+    if not re.match(r'^[a-zA-Z0-9].*[a-zA-Z0-9]$', user):
+        return Result.error("Username must start and end with a letter or number")
+
+    url = f"https://mastodon.social/api/v1/accounts/lookup?acct={user}"
+
+    return status_validate(url, 404, 200, follow_redirects=True)
+
+
+if __name__ == "__main__":
+    user = input("Username?: ").strip()
+    result = validate_mastodon(user)
+
+    if result == 1:
+        print("Available!")
+    elif result == 0:
+        print("Unavailable!")
+    else:
+        print(f"Error occurred! Reason: {result.get_reason()}")

{user_scanner-1.0.9.1 → user_scanner-1.0.10.1}/user_scanner/social/soundcloud.py

@@ -5,11 +5,6 @@ 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()
@@ -28,7 +23,7 @@ def validate_soundcloud(user):
 
         return Result.error()
 
-    return generic_validate(url, process, headers=headers, follow_redirects=True)
+    return generic_validate(url, process, follow_redirects=True)
 
 
 if __name__ == "__main__":

{user_scanner-1.0.9.1 → user_scanner-1.0.10.1}/user_scanner/social/telegram.py

@@ -3,13 +3,13 @@ from user_scanner.core.orchestrator import generic_validate
 from user_scanner.core.result import Result
 
 
-def validate_telegram(user: str) -> int:
+def validate_telegram(user: str) -> Result:
     url = f"https://t.me/{user}"
 
     def process(r):
         if r.status_code == 200:
             if re.search(r'<div[^>]*class="tgme_page_extra"[^>]*>', r.text):
-                return Result.taken() 
+                return Result.taken()
             else:
                 return Result.available()
         return Result.error()

user_scanner-1.0.10.1/user_scanner/social/tiktok.py

@@ -0,0 +1,50 @@
+import re
+from user_scanner.core.orchestrator import generic_validate
+from user_scanner.core.result import Result
+
+
+def validate_tiktok(user: str) -> Result:
+    if not (2 <= len(user) <= 24):
+        return Result.error("Length must be 2-24 characters")
+
+    if user.isdigit():
+        return Result.error("Usernames cannot contain numbers only")
+
+    if not re.match(r'^[a-zA-Z0-9_.]+$', user):
+        return Result.error("Usernames can only contain letters, numbers, underscores and periods")
+
+    if user.startswith(".") or user.endswith("."):
+        return Result.error("Username cannot start nor end with a period")
+
+    headers = {
+        'User-Agent': "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/141.0.0.0 Safari/537.36",
+        'Accept': "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
+        'Accept-Encoding': "identity",
+        'Accept-Language': "en-US,en;q=0.9",
+        'sec-fetch-dest': "document",
+        'Connection': "keep-alive"
+    }
+
+    url = f"https://www.tiktok.com/@{user}"
+
+    def process(response) -> Result:
+        if response.status_code == 200:
+            if "statuscode\":10221" in response.text.lower():
+                return Result.available()
+            else:
+                return Result.taken()
+        return Result.error("Unable to load tiktok")
+
+    return generic_validate(url, process, headers=headers)
+
+
+if __name__ == "__main__":
+    user = input("Username?: ").strip()
+    result = validate_tiktok(user)
+
+    if result == 1:
+        print("Available!")
+    elif result == 0:
+        print("Unavailable!")
+    else:
+        print(f"Error occurred! Reason: {result.get_reason()}")

user_scanner-1.0.10.1/user_scanner/utils/update.py

@@ -0,0 +1,34 @@
+import subprocess
+import sys
+from colorama import Fore
+
+def get_version(package_name):
+    try:
+        from importlib.metadata import version  # Python 3.8+
+        return version(package_name)
+    except Exception:
+        return "Unknown"
+
+def update_self():
+    print("Updating user-scanner using pip...\n")
+    try:
+        subprocess.check_call([
+            sys.executable, "-m", "pip", "uninstall", "user-scanner", "-y"
+        ])
+        subprocess.check_call([
+            sys.executable, "-m", "pip", "install", "user-scanner"
+        ])
+    except subprocess.CalledProcessError as e:
+        print(f"{Fore.RED}Failed to update user-scanner: {e}{Fore.reset}")
+        return
+
+
+    user_scanner_ver = get_version("user-scanner")
+
+    print("\nInstalled Version:")
+    print(f"   • user-scanner: {user_scanner_ver}")
+
+if __name__ == "__main__":
+    user_scanner_ver = get_version("user-scanner")
+    print(user_scanner_ver)
+

user_scanner-1.0.10.1/user_scanner/utils/updater_logic.py

@@ -0,0 +1,83 @@
+from pathlib import Path
+from colorama import Fore
+import sys
+import json
+import os
+from user_scanner.core.version import get_pypi_version, load_local_version
+from user_scanner.utils.update import update_self
+
+# Color configs
+R = Fore.RED
+G = Fore.GREEN
+C = Fore.CYAN
+Y = Fore.YELLOW
+X = Fore.RESET
+
+CONFIG_PATH = Path(__file__).parent.parent / "config.json"
+
+
+def _get_config_path(path: str | Path | None = None) -> Path:
+    """
+    Determine the config path in this order:
+      1. explicit path argument (if provided)
+      2. environment variable USER_SCANNER_CONFIG (if set)
+      3. default CONFIG_PATH
+    """
+    if path:
+        return Path(path)
+    env = os.environ.get("USER_SCANNER_CONFIG")
+    if env:
+        return Path(env)
+    return CONFIG_PATH
+
+
+def load_config(path: str | Path | None = None) -> dict:
+    cp = _get_config_path(path)
+    if cp.exists():
+        return json.loads(cp.read_text())
+
+    default = {"auto_update_status": True}
+    # Ensure parent exists
+    cp.parent.mkdir(parents=True, exist_ok=True)
+    cp.write_text(json.dumps(default, indent=2))
+    return default
+
+
+def save_config_change(status: bool, path: str | Path | None = None):
+    cp = _get_config_path(path)
+    content = load_config(path)
+    content["auto_update_status"] = status
+    cp.parent.mkdir(parents=True, exist_ok=True)
+    cp.write_text(json.dumps(content, indent=2))
+
+
+def check_for_updates():
+    if not load_config().get("auto_update_status", False):
+        return
+
+    try:
+        PYPI_URL = "https://pypi.org/pypi/user-scanner/json"
+        latest_ver = get_pypi_version(PYPI_URL)
+        current_ver, _ = load_local_version()
+
+        if current_ver != latest_ver:
+            print(
+                f"\n[!] New version available: "
+                f"{R}{current_ver}{X} -> {C}{latest_ver}{X}\n"
+            )
+
+            choice = input(
+                f"{Y}Do you want to update?{X} (y/n/d: {R}don't ask again{X}): "
+            ).strip().lower()
+
+            if choice == "y":
+                update_self()
+                print(f"[{G}+{X}] {G}Update successful. Please restart the tool.{X}")
+                sys.exit(0)
+
+            elif choice == "d":
+                save_config_change(False)
+                print(f"[{Y}*{X}] {R}Auto-update checks disabled.{X}")
+
+    except Exception as e:
+        print(f"[{Y}!{X}] {R}Update check failed{X}: {e}")

{user_scanner-1.0.9.1 → user_scanner-1.0.10.1}/user_scanner/version.json

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

user_scanner-1.0.9.1/user_scanner/cli/banner.py

@@ -1,34 +0,0 @@
-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-1.0.9.1/user_scanner/social/mastodon.py

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