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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: user-scanner
-Version: 1.0.4.2
+Version: 1.0.5.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.5.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:

{user_scanner-1.0.4.2 → user_scanner-1.0.5.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.5.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:

{user_scanner-1.0.4.2 → user_scanner-1.0.5.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "flit_core.buildapi"
 
 [project]
 name = "user-scanner"
-version = "1.0.4.2"
+version = "1.0.5.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.5.0}/user_scanner/__main__.py

@@ -10,17 +10,19 @@ 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()
@@ -79,11 +81,11 @@ def main():
        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)

user_scanner-1.0.5.0/user_scanner/community/coderlegion.py

@@ -0,0 +1,18 @@
+from ..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.5.0}/user_scanner/core/orchestrator.py

@@ -3,6 +3,9 @@ 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
 print_queue = 0
@@ -74,18 +77,64 @@ def run_checks_category(package, username, verbose=False):
         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
+        contains = lambda a,b: (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.5.0/user_scanner/creator/devto.py

@@ -0,0 +1,17 @@
+from ..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.5.0/user_scanner/creator/itch_io.py

@@ -0,0 +1,22 @@
+from ..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.5.0/user_scanner/creator/kaggle.py

@@ -0,0 +1,18 @@
+from ..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.5.0/user_scanner/creator/patreon.py

@@ -0,0 +1,23 @@
+from ..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!")

user_scanner-1.0.5.0/user_scanner/dev/codeberg.py

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

user_scanner-1.0.5.0/user_scanner/dev/cratesio.py

@@ -0,0 +1,24 @@
+from ..core.orchestrator import status_validate
+
+def validate_cratesio(user):
+   url = f"https://crates.io/api/v1/users/{user}"
+
+   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",
+      'Referer': "https://crates.io/",
+      'sec-fetch-mode': "cors",
+   }
+
+   return status_validate(url, 404, 200, headers = headers)
+
+if __name__ == "__main__":
+   user = input ("Username?: ").strip()
+   result = validate_cratesio(user)
+
+   if result == 1:
+      print("Available!")
+   elif result == 0:
+      print("Unavailable!")
+   else:
+      print("Error occurred!")

user_scanner-1.0.5.0/user_scanner/dev/dockerhub.py

@@ -0,0 +1,22 @@
+from ..core.orchestrator import status_validate
+
+def validate_dockerhub(user):
+   url = f"https://hub.docker.com/v2/users/{user}/"
+
+   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': "application/json",
+   }
+
+   return status_validate(url, 404, 200, headers = headers)
+
+if __name__ == "__main__":
+   user = input ("Username?: ").strip()
+   result = validate_dockerhub(user)
+
+   if result == 1:
+      print("Available!")
+   elif result == 0:
+      print("Unavailable!")
+   else:
+      print("Error occurred!")

user_scanner-1.0.5.0/user_scanner/dev/github.py

@@ -0,0 +1,31 @@
+from ..core.orchestrator import status_validate
+
+def validate_github(user):
+   url = f"https://github.com/signup_check/username?value={user}"
+
+   headers = {
+      'User-Agent': "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/140.0.0.0 Safari/537.36",
+      'Accept-Encoding': "gzip, deflate, br, zstd",
+      'sec-ch-ua-platform': "\"Linux\"",
+      'sec-ch-ua': "\"Chromium\";v=\"140\", \"Not=A?Brand\";v=\"24\", \"Google Chrome\";v=\"140\"",
+      'sec-ch-ua-mobile': "?0",
+      'sec-fetch-site': "same-origin",
+      'sec-fetch-mode': "cors",
+      'sec-fetch-dest': "empty",
+      'referer': "https://github.com/signup?source=form-home-signup&user_email=",
+      'accept-language': "en-US,en;q=0.9",
+      'priority': "u=1, i"
+   }
+
+   return status_validate(url, 200, 422, headers = headers)
+
+if __name__ == "__main__":
+   user = input ("Username?: ").strip()
+   result = validate_github(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.5.0}/user_scanner/dev/gitlab.py

@@ -1,23 +1,18 @@
-import httpx
-import json
-from httpx import ConnectError, TimeoutException
+from ..core.orchestrator import generic_validate
 
 def validate_gitlab(user):
     url = f"https://gitlab.com/users/{user}/exists"
 
     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': "application/json, text/plain, */*",
-          'X-Requested-With': "XMLHttpRequest",
-          'Referer': "https://gitlab.com/users/sign_up",
+        'User-Agent': "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/141.0.0.0 Safari/537.36",
+        'Accept': "application/json, text/plain, */*",
+        'X-Requested-With': "XMLHttpRequest",
+        'Referer': "https://gitlab.com/users/sign_up",
     }
 
-    try:
-        response = httpx.get(url, headers=headers, timeout=3.0)
-
+    def process(response):
         if response.status_code == 200:
             data = response.json()
-
             if 'exists' in data:
                 # Corrected: Compare against Python boolean True/False
                 # AVAILABLE (return 1) if "exists": true
@@ -26,18 +21,9 @@ def validate_gitlab(user):
                 # UNAVAILABLE (return 0) if "exists": false
                 elif data['exists'] is True:
                     return 0
-
-            return 2
-
-        else:
-           return 2
-
-    except (ConnectError, TimeoutException):
-        return 2
-    except json.JSONDecodeError:
-        return 2
-    except Exception:
         return 2
+    
+    return generic_validate(url, process, headers = headers)
 
 if __name__ == "__main__":
    user = input ("Username?: ").strip()

user_scanner-1.0.5.0/user_scanner/dev/launchpad.py

@@ -0,0 +1,24 @@
+from ..core.orchestrator import status_validate
+
+def validate_launchpad(user):
+   url = f"https://launchpad.net/~{user}"
+
+   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': "text/html,application/xhtml+xml,application/xml;q=0.9",
+      'Accept-Encoding': "gzip, deflate, br, zstd",
+      'Upgrade-Insecure-Requests': "1",
+   }
+
+   return status_validate(url, 404, 200, headers = headers, follow_redirects=True)
+
+if __name__ == "__main__":
+   user = input ("Username?: ").strip()
+   result = validate_launchpad(user)
+
+   if result == 1:
+      print("Available!")
+   elif result == 0:
+      print("Unavailable!")
+   else:
+      print("Error occurred!")

user_scanner-1.0.5.0/user_scanner/dev/replit.py

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

user_scanner-1.0.5.0/user_scanner/donation/buymeacoffee.py

@@ -0,0 +1,21 @@
+import httpx
+from httpx import ConnectError, TimeoutException
+
+from ..core.orchestrator import status_validate
+
+def validate_buymeacoffee(user):
+    url = f"https://buymeacoffee.com/{user}"
+
+    return status_validate(url, 404, 200, follow_redirects = True)
+
+
+if __name__ == "__main__":
+   user = input ("Username?: ").strip()
+   result = validate_buymeacoffee(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.5.0}/user_scanner/gaming/chess_com.py

@@ -1,6 +1,4 @@
-import httpx
-from httpx import ConnectError, TimeoutException
-import json
+from ..core.orchestrator import generic_validate
 
 def validate_chess_com(user):
     url = f"https://www.chess.com/callback/user/valid?username={user}"
@@ -12,11 +10,8 @@ def validate_chess_com(user):
         'Accept-Language': "en-US,en;q=0.9",
     }
 
-    try:
-        response = httpx.get(url, headers=headers, timeout = 3.0)
-        status = response.status_code
-
-        if status == 200:
+    def process(response):
+        if response.status_code == 200:
             data = response.json()
             if data.get('valid') is True:
                 # 'valid': true means the username is NOT taken
@@ -24,18 +19,10 @@ def validate_chess_com(user):
             elif data.get('valid') is False:
                 # 'valid': false means the username IS taken
                 return 0
-            else:
-                return 2
-        else:
-           return 2
-
-    except (ConnectError, TimeoutException):
-        return 2
-    except json.JSONDecodeError:
-        return 2
-    except Exception:
         return 2
 
+    return generic_validate(url, process, headers = headers)
+
 if __name__ == "__main__":
    try:
        import httpx