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

{user_scanner-1.0.4.2 → user_scanner-1.0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: user-scanner
-Version: 1.0.4.2
+Version: 1.0.6.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.4.2-blueviolet?style=for-the-badge&logo=github" />
+  <img src="https://img.shields.io/badge/Version-1.0.6.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" />
@@ -63,53 +63,13 @@ user-scanner -u <username> -m github
 
 ```
 ---
-### Example Output: 
+### Screenshot: 
+
+- Note*: New modules are constantly getting added so this might have only limited, outdated output:
+
+<img width="1008" height="568" alt="1000139959" src="https://github.com/user-attachments/assets/467a4aa0-238d-4110-b9a6-d4b96c244432" />
+
 
-- 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:
@@ -121,6 +81,7 @@ user_scanner/
 ├── creator/    # Creator platforms (Hashnode, Dev.to, Medium, etc.)
 ├── community/  # Community platforms (forums, niche sites)
 ├── gaming/     # Gaming sites (chess.com, roblox, monkeytype etc.)
+├── donation/   # Donation taking sites (buymeacoffe.com, similar...)
 ```
 
 **Module guidelines:**
@@ -149,8 +110,9 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for examples.
 This project is licensed under the **MIT License**. See [LICENSE](LICENSE) for details.
 
 
-<!--- 
-## 🌟 Stars: 
+---
+
+### Star History
 
 <a href="https://www.star-history.com/#kaifcodec/user-scanner&type=date&legend=top-left">
  <picture>
@@ -159,7 +121,4 @@ This project is licensed under the **MIT License**. See [LICENSE](LICENSE) for d
    <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 → user_scanner-1.0.6.0}/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.4.2-blueviolet?style=for-the-badge&logo=github" />
+  <img src="https://img.shields.io/badge/Version-1.0.6.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" />
@@ -50,53 +50,13 @@ user-scanner -u <username> -m github
 
 ```
 ---
-### Example Output: 
+### Screenshot: 
+
+- Note*: New modules are constantly getting added so this might have only limited, outdated output:
+
+<img width="1008" height="568" alt="1000139959" src="https://github.com/user-attachments/assets/467a4aa0-238d-4110-b9a6-d4b96c244432" />
+
 
-- 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:
@@ -108,6 +68,7 @@ user_scanner/
 ├── creator/    # Creator platforms (Hashnode, Dev.to, Medium, etc.)
 ├── community/  # Community platforms (forums, niche sites)
 ├── gaming/     # Gaming sites (chess.com, roblox, monkeytype etc.)
+├── donation/   # Donation taking sites (buymeacoffe.com, similar...)
 ```
 
 **Module guidelines:**
@@ -136,8 +97,9 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for examples.
 This project is licensed under the **MIT License**. See [LICENSE](LICENSE) for details.
 
 
-<!--- 
-## 🌟 Stars: 
+---
+
+### Star History
 
 <a href="https://www.star-history.com/#kaifcodec/user-scanner&type=date&legend=top-left">
  <picture>
@@ -146,6 +108,3 @@ This project is licensed under the **MIT License**. See [LICENSE](LICENSE) for d
    <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 → user_scanner-1.0.6.0}/pyproject.toml

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

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

@@ -10,17 +10,20 @@ CATEGORY_MAPPING = {
     "social": "social",
     "creator": "creator",
     "community": "community",
-    "gaming": "gaming"
+    "gaming": "gaming",
+    "donation": "donation"
 }
 
+
 def list_modules(category=None):
-    from user_scanner import dev, social, creator, community, gaming
+    from user_scanner import dev, social, creator, community, gaming, donation
     packages = {
         "dev": dev,
         "social": social,
         "creator": creator,
         "community": community,
-        "gaming": gaming
+        "gaming": gaming,
+        "donation": donation
     }
 
     categories_to_list = [category] if category else packages.keys()
@@ -28,11 +31,13 @@ def list_modules(category=None):
     for cat_name in categories_to_list:
         package = packages[cat_name]
         modules = load_modules(package)
-        print(Fore.MAGENTA + f"\n== {cat_name.upper()} SITES =={Style.RESET_ALL}")
+        print(Fore.MAGENTA +
+              f"\n== {cat_name.upper()} SITES =={Style.RESET_ALL}")
         for module in modules:
             site_name = module.__name__.split(".")[-1]
             print(f"  - {site_name}")
 
+
 def main():
     parser = argparse.ArgumentParser(
         prog="user-scanner",
@@ -58,32 +63,32 @@ def main():
     args = parser.parse_args()
 
     if args.module and "." in args.module:
-       args.module = args.module.replace(".", "_")
+        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 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 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
+        parser.print_help()
+        return
     else:
-       print_banner()
-
+        print_banner()
 
-    from user_scanner import dev, social, creator, community, gaming
+    from user_scanner import dev, social, creator, community, gaming, donation
 
     if args.module:
         # Single module search across all categories
-        packages = [dev, social, creator, community, gaming]
+        packages = [dev, social, creator, community, gaming, donation]
         found = False
         for package in packages:
             modules = load_modules(package)
@@ -94,7 +99,8 @@ def main():
                     run_module_single(module, args.username)
                     found = True
         if not found:
-            print(Fore.RED + f"[!] Module '{args.module}' not found in any category." + Style.RESET_ALL)
+            print(
+                Fore.RED + f"[!] Module '{args.module}' not found in any category." + Style.RESET_ALL)
     elif args.category:
         # Category-wise scan
         category_package = eval(CATEGORY_MAPPING[args.category])
@@ -104,5 +110,6 @@ def main():
         # Full scan
         run_checks(args.username)
 
+
 if __name__ == "__main__":
     main()

{user_scanner-1.0.4.2 → user_scanner-1.0.6.0}/user_scanner/cli/banner.py

@@ -23,10 +23,12 @@ INFO_BOX = f"""{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.6.0/user_scanner/community/coderlegion.py

@@ -0,0 +1,19 @@
+from user_scanner.core.orchestrator import status_validate
+
+
+def validate_coderlegion(user):
+    url = f"https://coderlegion.com/user/{user}"
+
+    return status_validate(url, 404, 200, timeout=15.0)
+
+
+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-1.0.6.0}/user_scanner/core/orchestrator.py

@@ -3,10 +3,14 @@ import pkgutil
 from colorama import Fore, Style
 import threading
 
+import httpx
+from httpx import ConnectError, TimeoutException
+
 lock = threading.Condition()
-#Basically which thread is the one to print
+# Basically which thread is the one to print
 print_queue = 0
 
+
 def load_modules(package):
 
     modules = []
@@ -18,12 +22,13 @@ def load_modules(package):
             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("_",".")
+    site_name = module.__name__.split('.')[-1].capitalize().replace("_", ".")
     if site_name == "X":
         site_name = "X (Twitter)"
 
@@ -43,7 +48,7 @@ def worker_single(module, username, i):
         output = f"  {Fore.YELLOW}[!] {site_name} has no validate_ function{Style.RESET_ALL}"
 
     with lock:
-        #Waits for in-order printing
+        # Waits for in-order printing
         while i != print_queue:
             lock.wait()
 
@@ -51,13 +56,15 @@ def worker_single(module, username, i):
         print_queue += 1
         lock.notify_all()
 
+
 def run_module_single(module, username):
-    #Just executes as if it was a thread
+    # 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}")
@@ -73,19 +80,69 @@ def run_checks_category(package, username, verbose=False):
     for t in threads:
         t.join()
 
+
 def run_checks(username):
-    from user_scanner import dev, social, creator, community, gaming
+    from user_scanner import dev, social, creator, community, gaming, donation
 
-    categories = [
-        ("DEV", dev),
-        ("SOCIAL", social),
-        ("CREATOR", creator),
-        ("COMMUNITY", community),
-        ("GAMING", gaming)
-    ]
+    packages = [dev, social, creator, community, gaming, donation]
 
     print(f"\n{Fore.CYAN} Checking username: {username}{Style.RESET_ALL}\n")
 
-    for _, package in categories:
+    for package in packages:
         run_checks_category(package, username)
         print()
+
+
+def make_get_request(url, **kwargs):
+    """Simple wrapper to **httpx.get** that predefines headers and timeout"""
+    if not "headers" 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",
+            'Accept-Encoding': "gzip, deflate, br",
+            'Accept-Language': "en-US,en;q=0.9",
+            'sec-fetch-dest': "document",
+        }
+
+    if not "timeout" in kwargs:
+        kwargs["timeout"] = 5.0
+
+    return httpx.get(url, **kwargs)
+
+
+def generic_validate(url, func, **kwargs):
+    """
+    A generic validate function that makes a request and executes the provided function on the response.
+    """
+    try:
+        response = make_get_request(url, **kwargs)
+        return func(response)
+    except (ConnectError, TimeoutException):
+        return 2
+    except Exception:
+        return 2
+
+
+def status_validate(url, available, taken, **kwargs):
+    """
+    Function that takes a **url** and **kwargs** for the request and 
+    checks if the request status matches the availabe or taken.
+    **Available** and **Taken** must either be whole numbers or lists of whole numbers.
+    """
+    def inner(response):
+        # Checks if a number is equal or is contained inside
+        def contains(a, b): return (isinstance(a, list) and b in a) or (a == b)
+
+        status = response.status_code
+        available_value = contains(available, status)
+        taken_value = contains(taken, status)
+
+        if available_value and taken_value:
+            return 2  # Can't be both available and taken
+        elif available_value:
+            return 1
+        elif taken_value:
+            return 0
+        return 2
+
+    return generic_validate(url, inner, **kwargs)

user_scanner-1.0.6.0/user_scanner/creator/devto.py

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

{user_scanner-1.0.4.2 → user_scanner-1.0.6.0}/user_scanner/creator/hashnode.py

@@ -2,20 +2,21 @@ import httpx
 import json
 from httpx import ConnectError, TimeoutException
 
+
 def validate_hashnode(user):
     url = "https://hashnode.com/utility/ajax/check-username"
 
     payload = {
-      "username": user,
-      "name": "Dummy Dummy"
+        "username": user,
+        "name": "Dummy Dummy"
     }
 
     headers = {
-      'User-Agent': "Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/141.0.0.0 Mobile Safari/537.36",
-      'Accept': "application/json",
-      'Content-Type': "application/json",
-      'Origin': "https://hashnode.com",
-      'Referer': "https://hashnode.com/signup",
+        'User-Agent': "Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/141.0.0.0 Mobile Safari/537.36",
+        'Accept': "application/json",
+        'Content-Type': "application/json",
+        'Origin': "https://hashnode.com",
+        'Referer': "https://hashnode.com/signup",
     }
 
     try:
@@ -33,7 +34,7 @@ def validate_hashnode(user):
             return 2
 
         else:
-           return 2
+            return 2
 
     except (ConnectError, TimeoutException):
         return 2
@@ -42,13 +43,14 @@ def validate_hashnode(user):
     except Exception:
         return 2
 
+
 if __name__ == "__main__":
-   user = input ("Username?: ").strip()
-   result = validate_hashnode(user)
-
-   if result == 1:
-      print("Available!")
-   elif result == 0:
-      print("Unavailable!")
-   else:
-      print("Error occurred!")
+    user = input("Username?: ").strip()
+    result = validate_hashnode(user)
+
+    if result == 1:
+        print("Available!")
+    elif result == 0:
+        print("Unavailable!")
+    else:
+        print("Error occurred!")

user_scanner-1.0.6.0/user_scanner/creator/itch_io.py

@@ -0,0 +1,24 @@
+from user_scanner.core.orchestrator import status_validate
+
+
+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"
+
+    return status_validate(url, 404, 200, follow_redirects=True)
+
+
+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.6.0/user_scanner/creator/kaggle.py

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

{user_scanner-1.0.4.2 → user_scanner-1.0.6.0}/user_scanner/creator/medium.py

@@ -1,6 +1,7 @@
 import httpx
 from httpx import ConnectError, TimeoutException
 
+
 def validate_medium(user):
     url = f"https://medium.com/@{user}"
 
@@ -15,7 +16,6 @@ def validate_medium(user):
         if response.status_code == 200:
             html_text = response.text
 
-
             username_tag = f'property="profile:username" content="{user}"'
 
             if username_tag in html_text:
@@ -29,13 +29,14 @@ def validate_medium(user):
     except Exception:
         return 2
 
+
 if __name__ == "__main__":
-   user = input ("Username?: ").strip()
-   result = validate_medium(user)
-
-   if result == 1:
-      print("Available!")
-   elif result == 0:
-      print("Unavailable!")
-   else:
-      print("Error occurred!")
+    user = input("Username?: ").strip()
+    result = validate_medium(user)
+
+    if result == 1:
+        print("Available!")
+    elif result == 0:
+        print("Unavailable!")
+    else:
+        print("Error occurred!")

user_scanner-1.0.6.0/user_scanner/creator/patreon.py

@@ -0,0 +1,25 @@
+from user_scanner.core.orchestrator import status_validate
+
+
+def validate_patreon(user):
+    url = f"https://www.patreon.com/{user}"
+
+    return status_validate(url, 404, 200, timeout=15.0, follow_redirects=True)
+
+
+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!")