user-scanner 1.0.1.5__py3-none-any.whl → 1.0.2.0__py3-none-any.whl

user_scanner/__init__.py

@@ -0,0 +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", required = True,  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,10 @@ 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:
+       pass
+    else:
+       print_banner()
 
 
     from user_scanner import dev, social, creator, community, gaming
@@ -98,4 +102,4 @@ def main():
         run_checks(args.username)
 
 if __name__ == "__main__":
-    main()
+    main()

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/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/version.json

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

{user_scanner-1.0.1.5.dist-info → user_scanner-1.0.2.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: user-scanner
-Version: 1.0.1.5
+Version: 1.0.2.0
 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.5.dist-info → user_scanner-1.0.2.0.dist-info}/RECORD

@@ -1,5 +1,8 @@
-user_scanner/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-user_scanner/__main__.py,sha256=ihYZxGeiYebJLG72tegPQBYJtjn8CkKKzu87cSvKBVE,3653
+user_scanner/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+user_scanner/__main__.py,sha256=CwiTh1JMcc7f007hAULJQUxtBl_T25WwVz5ov50pX-I,3664
+user_scanner/version.json,sha256=Cg76jtg6LF1WMxx8Bh3Bsu6-Bhh0Xf3_CoSKTqU3MV8,49
+user_scanner/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+user_scanner/cli/banner.py,sha256=mg9yKqaK5VRvZKs7vteU1wyUlCnrmWpGC5nq9BmTGNc,1504
 user_scanner/community/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 user_scanner/community/coderlegion.py,sha256=wva0seSkd4h7kSjIprW0wM7JC0zspFjXGnDHkeIJ3YI,1141
 user_scanner/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -36,8 +39,10 @@ user_scanner/social/telegram.py,sha256=QxK2jD2QEvrYmnkxysl_yk7-G6CRWvkK5EnK6n5q3
 user_scanner/social/threads.py,sha256=QRidTYquAMDHJSg68ySpWCbliRYdWJkbOqn8RfWzFQQ,1231
 user_scanner/social/x.py,sha256=NetPGmPnWEKv6za9E_Ekah9bAeeFlEeY3qbTJQo7AqE,1560
 user_scanner/social/youtube.py,sha256=zuyWCy5FtEilaIcUZ4dTCctRR9deFnwwWJkf-h_1K0E,1943
-user_scanner-1.0.1.5.dist-info/entry_points.txt,sha256=XqU3kssYZ0vXaPy5qYUOTCu4u-48Xie7QWFpBCYc7Nc,59
-user_scanner-1.0.1.5.dist-info/licenses/LICENSE,sha256=XH1QyQG68zo1opDIZHTHcTAbe9XMzewvTaFTukcN9vc,1061
-user_scanner-1.0.1.5.dist-info/WHEEL,sha256=G2gURzTEtmeR8nrdXUJfNiB3VYVxigPQ-bEQujpNiNs,82
-user_scanner-1.0.1.5.dist-info/METADATA,sha256=G5FcuQ-aGzISWtiVSNT7X3vD4B6ShPiOC1_gJsprzp8,4154
-user_scanner-1.0.1.5.dist-info/RECORD,,
+user_scanner/utils/update.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+user_scanner/utils/version.py,sha256=ou6CF7ndVwEYvSpO4Se-B-71AvVezZcaZJpYFgDQsqM,621
+user_scanner-1.0.2.0.dist-info/entry_points.txt,sha256=XqU3kssYZ0vXaPy5qYUOTCu4u-48Xie7QWFpBCYc7Nc,59
+user_scanner-1.0.2.0.dist-info/licenses/LICENSE,sha256=XH1QyQG68zo1opDIZHTHcTAbe9XMzewvTaFTukcN9vc,1061
+user_scanner-1.0.2.0.dist-info/WHEEL,sha256=G2gURzTEtmeR8nrdXUJfNiB3VYVxigPQ-bEQujpNiNs,82
+user_scanner-1.0.2.0.dist-info/METADATA,sha256=UcvJmRVaf3R8LOQ6eQqkCA_-b-wt1a32J6chUqLLxN4,4970
+user_scanner-1.0.2.0.dist-info/RECORD,,