user-scanner 1.0.0.1__tar.gz → 1.0.4.2__tar.gz

user_scanner-1.0.4.2/PKG-INFO

@@ -0,0 +1,165 @@
+Metadata-Version: 2.4
+Name: user-scanner
+Version: 1.0.4.2
+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
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx
+Requires-Dist: colorama
+Project-URL: Homepage, https://github.com/kaifcodec/user-scanner
+
+# 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.4.2-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" />
+  <img src="https://img.shields.io/badge/Tested%20on-Linux-balck?style=for-the-badge&logo=Linux" />
+  <img src="https://img.shields.io/pepy/dt/user-scanner?style=for-the-badge" />
+</p>
+
+---
+
+Scan a username across multiple social, developer, and creator platforms to see if it’s available.  
+Perfect for finding a **unique username** across GitHub, Twitter, Reddit, Instagram, and more, all in one command.
+
+
+### Features
+
+- ✅ Check usernames across **social networks**, **developer platforms**, and **creator communities**.
+- ✅ Clear **Available / Taken / Error** output for each platform.
+- ✅ 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
+
+```bash
+pip install user-scanner
+```
+
+---
+
+### Usage
+
+Scan a username across all platforms:
+
+```bash
+user-scanner -u <username>
+```
+Optionally, scan a specific category or single module:
+
+```bash
+user-scanner -u <username> -c dev
+user-scanner -l # Lists all available modules
+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
+
+== DEV SITES ==
+  [✔] Codeberg: Available
+  [✔] Cratesio: Available
+  [✔] Dockerhub: Available
+  [✘] Github: Taken
+  [✔] Gitlab: Available
+  [✔] Launchpad: Available
+  [✔] Npmjs: Available
+  [✔] Replit: Available
+
+== SOCIAL SITES ==
+  [✔] Bluesky: Available
+  [✔] Discord: Available
+  [✘] Instagram: Taken
+  [✔] Mastodon: Available
+  [✔] Pinterest: Available
+  [✘] Reddit: Taken
+  [✔] Snapchat: Available
+  [✔] Telegram: Available 
+  [✘] Threads: Taken
+  [✔] X (Twitter): Available
+  [✔] Youtube: Available
+
+== CREATOR SITES ==
+  [✔] Devto: Available
+  [✔] Hashnode: Available
+  [✔] Kaggle: Available
+  [✔] Medium: Available
+  [✔] Patreon: Available
+
+== COMMUNITY SITES ==
+  [✔] Coderlegion: Available
+
+== GAMING SITES ==
+  [✔] Chess_com: Available
+  [✔] Osu: Available
+  [✔] Roblox: Available
+  ...
+  ...
+  ...
+```
+### Contributing: 
+
+Modules are organized by category:
+
+```
+user_scanner/
+├── dev/        # Developer platforms (GitHub, GitLab, etc.)
+├── 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, roblox, monkeytype etc.)
+```
+
+**Module guidelines:**
+- Each module must define a `validate_<site>()` function that takes a `username` and returns:
+  - `1` → Available  
+  - `0` → Taken  
+  - `2` → Error / Could not check
+- Use `httpx` for requests, `colorama` for colored output.
+- Optional: modules can define a CLI parser if they support custom arguments.
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for examples.
+
+### 📧 Contact:
+- [Email](kaifcodec@gmail.com)
+  
+---
+
+### Dependencies: 
+- [httpx](https://pypi.org/project/httpx/)
+- [colorama](https://pypi.org/project/colorama/)
+
+---
+
+### License
+
+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.4.2/README.md

@@ -0,0 +1,151 @@
+# 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.4.2-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" />
+  <img src="https://img.shields.io/badge/Tested%20on-Linux-balck?style=for-the-badge&logo=Linux" />
+  <img src="https://img.shields.io/pepy/dt/user-scanner?style=for-the-badge" />
+</p>
+
+---
+
+Scan a username across multiple social, developer, and creator platforms to see if it’s available.  
+Perfect for finding a **unique username** across GitHub, Twitter, Reddit, Instagram, and more, all in one command.
+
+
+### Features
+
+- ✅ Check usernames across **social networks**, **developer platforms**, and **creator communities**.
+- ✅ Clear **Available / Taken / Error** output for each platform.
+- ✅ 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
+
+```bash
+pip install user-scanner
+```
+
+---
+
+### Usage
+
+Scan a username across all platforms:
+
+```bash
+user-scanner -u <username>
+```
+Optionally, scan a specific category or single module:
+
+```bash
+user-scanner -u <username> -c dev
+user-scanner -l # Lists all available modules
+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
+
+== DEV SITES ==
+  [✔] Codeberg: Available
+  [✔] Cratesio: Available
+  [✔] Dockerhub: Available
+  [✘] Github: Taken
+  [✔] Gitlab: Available
+  [✔] Launchpad: Available
+  [✔] Npmjs: Available
+  [✔] Replit: Available
+
+== SOCIAL SITES ==
+  [✔] Bluesky: Available
+  [✔] Discord: Available
+  [✘] Instagram: Taken
+  [✔] Mastodon: Available
+  [✔] Pinterest: Available
+  [✘] Reddit: Taken
+  [✔] Snapchat: Available
+  [✔] Telegram: Available 
+  [✘] Threads: Taken
+  [✔] X (Twitter): Available
+  [✔] Youtube: Available
+
+== CREATOR SITES ==
+  [✔] Devto: Available
+  [✔] Hashnode: Available
+  [✔] Kaggle: Available
+  [✔] Medium: Available
+  [✔] Patreon: Available
+
+== COMMUNITY SITES ==
+  [✔] Coderlegion: Available
+
+== GAMING SITES ==
+  [✔] Chess_com: Available
+  [✔] Osu: Available
+  [✔] Roblox: Available
+  ...
+  ...
+  ...
+```
+### Contributing: 
+
+Modules are organized by category:
+
+```
+user_scanner/
+├── dev/        # Developer platforms (GitHub, GitLab, etc.)
+├── 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, roblox, monkeytype etc.)
+```
+
+**Module guidelines:**
+- Each module must define a `validate_<site>()` function that takes a `username` and returns:
+  - `1` → Available  
+  - `0` → Taken  
+  - `2` → Error / Could not check
+- Use `httpx` for requests, `colorama` for colored output.
+- Optional: modules can define a CLI parser if they support custom arguments.
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for examples.
+
+### 📧 Contact:
+- [Email](kaifcodec@gmail.com)
+  
+---
+
+### Dependencies: 
+- [httpx](https://pypi.org/project/httpx/)
+- [colorama](https://pypi.org/project/colorama/)
+
+---
+
+### License
+
+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.0.1 → user_scanner-1.0.4.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "flit_core.buildapi"
 
 [project]
 name = "user-scanner"
-version = "1.0.0.1"
+version = "1.0.4.2"
 description = "Check username availability across multiple popular platforms"
 readme = "README.md"
 license = {file = "LICENSE"}
@@ -24,3 +24,6 @@ Homepage = "https://github.com/kaifcodec/user-scanner"
 
 [project.scripts]
 user-scanner = "user_scanner.__main__:main"
+
+[tool.flit.sdist]
+exclude = ["tests/", "docs/", ".github/", ".git", "rm_pycache", "che.py", ".gitignore"]

user_scanner-1.0.4.2/user_scanner/__init__.py

@@ -0,0 +1 @@
+

{user_scanner-1.0.0.1 → user_scanner-1.0.4.2}/user_scanner/__main__.py

@@ -1,21 +1,26 @@
 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"
+    "community": "community",
+    "gaming": "gaming"
 }
 
 def list_modules(category=None):
-    from user_scanner import dev, social, creator, community
+    from user_scanner import dev, social, creator, community, gaming
     packages = {
         "dev": dev,
         "social": social,
         "creator": creator,
-        "community": community
+        "community": community,
+        "gaming": gaming
     }
 
     categories_to_list = [category] if category else packages.keys()
@@ -34,7 +39,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(),
@@ -52,19 +57,33 @@ 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
 
+
+    # Special username checks before run
+    if (args.module == "x" 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. X (Twitter) doesn't support these." + Style.RESET_ALL)
+    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:
-        print(Fore.RED + "[!] Please provide a username with -u or --username." + Style.RESET_ALL)
-        return
+       parser.print_help()
+       return
+    else:
+       print_banner()
+
 
-    from user_scanner import dev, social, creator, community
+    from user_scanner import dev, social, creator, community, gaming
 
     if args.module:
         # Single module search across all categories
-        packages = [dev, social, creator, community]
+        packages = [dev, social, creator, community, gaming]
         found = False
         for package in packages:
             modules = load_modules(package)

user_scanner-1.0.4.2/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-1.0.4.2/user_scanner/community/coderlegion.py

@@ -0,0 +1,39 @@
+import httpx
+from httpx import ConnectError, TimeoutException
+
+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
+
+if __name__ == "__main__":
+   user = input ("Username?: ").strip()
+   result = validate_coderlegion(user)
+
+   if result == 1:
+      print("Available!")
+   elif result == 0:
+      print("Unavailable!")
+   else:
+      print("Error occured!")
+

user_scanner-1.0.4.2/user_scanner/core/orchestrator.py

@@ -0,0 +1,91 @@
+import importlib
+import pkgutil
+from colorama import Fore, Style
+import threading
+
+lock = threading.Condition()
+#Basically which thread is the one to print
+print_queue = 0
+
+def load_modules(package):
+
+    modules = []
+    for _, name, _ in pkgutil.iter_modules(package.__path__, package.__name__ + "."):
+        try:
+            module = importlib.import_module(name)
+            modules.append(module)
+        except Exception as e:
+            print(f"Failed to import {name}: {e}")
+    return modules
+
+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().replace("_",".")
+    if site_name == "X":
+        site_name = "X (Twitter)"
+
+    output = ""
+    if func:
+        try:
+            result = func(username)
+            if result == 1:
+                output = f"  {Fore.GREEN}[✔] {site_name}: Available{Style.RESET_ALL}"
+            elif result == 0:
+                output = f"  {Fore.RED}[✘] {site_name}: Taken{Style.RESET_ALL}"
+            else:
+                output = f"  {Fore.YELLOW}[!] {site_name}: Error{Style.RESET_ALL}"
+        except Exception as e:
+            output = f"  {Fore.YELLOW}[!] {site_name}: Exception - {e}{Style.RESET_ALL}"
+    else:
+        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}")
+
+    print_queue = 0
+
+    threads = []
+    for i, module in enumerate(modules):
+        t = threading.Thread(target=worker_single, args=(module, username, i))
+        threads.append(t)
+        t.start()
+
+    for t in threads:
+        t.join()
+
+def run_checks(username):
+    from user_scanner import dev, social, creator, community, gaming
+
+    categories = [
+        ("DEV", dev),
+        ("SOCIAL", social),
+        ("CREATOR", creator),
+        ("COMMUNITY", community),
+        ("GAMING", gaming)
+    ]
+
+    print(f"\n{Fore.CYAN} Checking username: {username}{Style.RESET_ALL}\n")
+
+    for _, package in categories:
+        run_checks_category(package, username)
+        print()

user_scanner-1.0.4.2/user_scanner/creator/itch_io.py

@@ -0,0 +1,45 @@
+import httpx
+from httpx import ConnectError, TimeoutException
+
+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"
+
+    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",
+    }
+
+    try:
+        response = httpx.get(url, headers = headers, timeout = 5, 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 as e:
+        return 2
+
+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-1.0.0.1 → user_scanner-1.0.4.2}/user_scanner/creator/kaggle.py

@@ -10,17 +10,13 @@ def validate_kaggle(user):
     }
 
     try:
-        # Use GET request for maximum fidelity, though we only check status code
         response = httpx.get(url, headers=headers, timeout=3.0, follow_redirects=True)
         status = response.status_code
 
-        # If a profile exists (Taken) -> 200 OK
         if status == 200:
            return 0
-        # If no profile exists (Available) -> 404 Not Found
         elif status == 404:
            return 1
-        # Other status codes are errors
         else:
            return 2
 

user_scanner-1.0.4.2/user_scanner/creator/patreon.py

@@ -0,0 +1,45 @@
+import httpx
+from httpx import ConnectError, TimeoutException
+
+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
+
+if __name__ == "__main__":
+   try:
+       import httpx
+   except ImportError:
+       print("Error: 'httpx' library is not installed.")
+       exit()
+
+   user = input ("Username?: ").strip()
+   result = validate_patreon(user)
+
+   if result == 1:
+      print("Available!")
+   elif result == 0:
+      print("Unavailable!")
+   else:
+      print("Error occured!")