user-scanner 1.0.1.6__tar.gz → 1.0.2.1__tar.gz

{user_scanner-1.0.1.6 → user_scanner-1.0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: user-scanner
-Version: 1.0.1.6
+Version: 1.0.2.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.1.6-blueviolet?style=for-the-badge&logo=github" />
+  <img src="https://img.shields.io/badge/Version-1.0.2.0-blueviolet?style=for-the-badge&logo=github" />
   <img src="https://img.shields.io/github/issues/kaifcodec/user-scanner?style=for-the-badge&logo=github" />
   <img src="https://img.shields.io/badge/Tested%20on-Termux-black?style=for-the-badge&logo=termux" />
   <img src="https://img.shields.io/badge/Tested%20on-Windows-cyan?style=for-the-badge&logo=Windows" />
@@ -36,6 +36,7 @@ Perfect for finding a **unique username** across GitHub, Twitter, Reddit, Instag
 - ✅ Fully modular: add new platform modules easily.
 - ✅ 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.
 ---
 
 ### Installation
@@ -63,6 +64,8 @@ user-scanner -u <username> -m github
 ```
 ---
 ### Example Output: 
+
+- Note*: New modules are constantly getting added so this might have only limited, outdated output: 
 ```bash
  Checking username: johndoe078
 
@@ -117,7 +120,7 @@ user_scanner/
 ├── social/     # Social platforms (Twitter/X, Reddit, Instagram, etc.)
 ├── creator/    # Creator platforms (Hashnode, Dev.to, Medium, etc.)
 ├── community/  # Community platforms (forums, niche sites)
-├── gaming/     # Gaming sites (chess.com, and many more(upcoming))
+├── gaming/     # Gaming sites (chess.com, roblox, monkeytype etc.)
 ```
 
 **Module guidelines:**
@@ -130,6 +133,9 @@ user_scanner/
 
 See [CONTRIBUTING.md](CONTRIBUTING.md) for examples.
 
+### 📧 Contact:
+- [Email](kaifcodec@gmail.com)
+  
 ---
 
 ### Dependencies: 
@@ -142,5 +148,18 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for examples.
 
 This project is licensed under the **MIT License**. See [LICENSE](LICENSE) for details.
 
+
+<!--- 
+## 🌟 Stars: 
+
+<a href="https://www.star-history.com/#kaifcodec/user-scanner&type=date&legend=top-left">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=kaifcodec/user-scanner&type=date&theme=dark&legend=top-left" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=kaifcodec/user-scanner&type=date&legend=top-left" />
+   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=kaifcodec/user-scanner&type=date&legend=top-left" />
+ </picture>
+</a>
+--->
+---
 ## ⚠️ `community/` and `gaming/` are small, looking for contributions
 

{user_scanner-1.0.1.6 → user_scanner-1.0.2.1}/README.md

@@ -2,7 +2,7 @@
 
 ![1000136215](https://github.com/user-attachments/assets/49ec8d24-665b-4115-8525-01a8d0ca2ef4)
 <p align="center">
-  <img src="https://img.shields.io/badge/Version-1.0.1.6-blueviolet?style=for-the-badge&logo=github" />
+  <img src="https://img.shields.io/badge/Version-1.0.2.0-blueviolet?style=for-the-badge&logo=github" />
   <img src="https://img.shields.io/github/issues/kaifcodec/user-scanner?style=for-the-badge&logo=github" />
   <img src="https://img.shields.io/badge/Tested%20on-Termux-black?style=for-the-badge&logo=termux" />
   <img src="https://img.shields.io/badge/Tested%20on-Windows-cyan?style=for-the-badge&logo=Windows" />
@@ -23,6 +23,7 @@ Perfect for finding a **unique username** across GitHub, Twitter, Reddit, Instag
 - ✅ Fully modular: add new platform modules easily.
 - ✅ 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.
 ---
 
 ### Installation
@@ -50,6 +51,8 @@ user-scanner -u <username> -m github
 ```
 ---
 ### Example Output: 
+
+- Note*: New modules are constantly getting added so this might have only limited, outdated output: 
 ```bash
  Checking username: johndoe078
 
@@ -104,7 +107,7 @@ user_scanner/
 ├── social/     # Social platforms (Twitter/X, Reddit, Instagram, etc.)
 ├── creator/    # Creator platforms (Hashnode, Dev.to, Medium, etc.)
 ├── community/  # Community platforms (forums, niche sites)
-├── gaming/     # Gaming sites (chess.com, and many more(upcoming))
+├── gaming/     # Gaming sites (chess.com, roblox, monkeytype etc.)
 ```
 
 **Module guidelines:**
@@ -117,6 +120,9 @@ user_scanner/
 
 See [CONTRIBUTING.md](CONTRIBUTING.md) for examples.
 
+### 📧 Contact:
+- [Email](kaifcodec@gmail.com)
+  
 ---
 
 ### Dependencies: 
@@ -129,4 +135,17 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for examples.
 
 This project is licensed under the **MIT License**. See [LICENSE](LICENSE) for details.
 
+
+<!--- 
+## 🌟 Stars: 
+
+<a href="https://www.star-history.com/#kaifcodec/user-scanner&type=date&legend=top-left">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=kaifcodec/user-scanner&type=date&theme=dark&legend=top-left" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=kaifcodec/user-scanner&type=date&legend=top-left" />
+   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=kaifcodec/user-scanner&type=date&legend=top-left" />
+ </picture>
+</a>
+--->
+---
 ## ⚠️ `community/` and `gaming/` are small, looking for contributions

{user_scanner-1.0.1.6 → user_scanner-1.0.2.1}/pyproject.toml

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

user_scanner-1.0.2.1/user_scanner/__init__.py

@@ -0,0 +1 @@
+

{user_scanner-1.0.1.6 → user_scanner-1.0.2.1}/user_scanner/__main__.py

@@ -2,6 +2,9 @@ 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",
@@ -37,7 +40,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(),
@@ -59,9 +62,6 @@ def main():
         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,6 +70,11 @@ 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
@@ -98,4 +103,4 @@ def main():
         run_checks(args.username)
 
 if __name__ == "__main__":
-    main()
+    main()

user_scanner-1.0.2.1/user_scanner/cli/banner.py

@@ -0,0 +1,39 @@
+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.2.1/user_scanner/utils/version.py

@@ -0,0 +1,20 @@
+import json
+from pathlib import Path
+
+_SCRIPT_DIR = Path(__file__).resolve().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")
+    except FileNotFoundError:
+        return "N/A", "file_missing"
+    except json.JSONDecodeError:
+        return "N/A", "json_error"
+    except Exception:
+        return "N/A", "error"
+
+if __name__ == "__main__":
+    version, version_type = load_local_version()
+    print(f"Version: {version}, Type: {version_type}")

user_scanner-1.0.2.1/user_scanner/version.json

@@ -0,0 +1,4 @@
+{
+"version": "1.0.2.0",
+"version_type": "pypi"
+}