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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: user-scanner
-Version: 1.0.9.1
+Version: 1.0.10.0
 Summary: Check username availability across multiple popular platforms
 Keywords: username,checker,availability,social,tech,python,user-scanner
 Author-email: Kaif <kafcodec@gmail.com>
@@ -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.0}/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.0}/pyproject.toml

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

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

@@ -1,6 +1,7 @@
 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
@@ -8,10 +9,22 @@ 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.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 +64,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 +93,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(".", "_")
@@ -118,7 +141,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 +162,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.0/user_scanner/cli/banner.py

@@ -0,0 +1,25 @@
+import json
+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.10.0/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.0/user_scanner/config.json

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

{user_scanner-1.0.9.1/user_scanner/utils → user_scanner-1.0.10.0/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.10.0/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.0/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.10.0/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.0/user_scanner/utils/updater_logic.py

@@ -0,0 +1,62 @@
+from pathlib import Path
+from colorama import Fore
+import sys
+import json
+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 load_config() -> dict:
+    if CONFIG_PATH.exists():
+        return json.loads(CONFIG_PATH.read_text())
+
+    default = {"auto_update_status": True}
+    CONFIG_PATH.write_text(json.dumps(default, indent=2))
+    return default
+
+
+def save_config_change(status: bool):
+    content = load_config()
+    content["auto_update_status"] = status
+    CONFIG_PATH.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.0}/user_scanner/version.json

@@ -1,4 +1,4 @@
 {
-"version": "1.0.9.1",
+"version": "1.0.10.0",
 "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()