user-scanner 1.0.8.0__py3-none-any.whl → 1.0.8.1__py3-none-any.whl

user_scanner/community/__init__.py

@@ -0,0 +1 @@
+# community

user_scanner/community/stackoverflow.py

@@ -0,0 +1,35 @@
+from user_scanner.core.orchestrator import generic_validate
+from user_scanner.core.result import Result
+
+def validate_stackoverflow(user: str) -> Result:
+    url = f"https://stackoverflow.com/users/filter?search={user}"
+
+    def process(response):
+        if response.status_code == 200:
+            text = response.text
+
+            if "No users matched your search." in text:
+                return Result.available()
+
+            pattern = f'>{user}<'
+            if pattern in text:
+                return Result.taken()
+
+            return Result.available()
+
+        return Result.error("Unexpected status code from Stack Overflow")
+
+    return generic_validate(url, process)
+
+
+if __name__ == "__main__":
+    user = input("Username?: ").strip()
+    result = validate_stackoverflow(user)
+
+    if result == Result.available():
+        print("Available!")
+    elif result == Result.taken():
+        print("Unavailable!")
+    else:
+        msg = result.get_reason()
+        print("Error occurred!" + msg)

user_scanner/core/orchestrator.py

@@ -1,4 +1,5 @@
 import importlib
+import importlib.util
 from colorama import Fore, Style
 import threading
 from itertools import permutations

user_scanner/creator/producthunt.py

@@ -1,25 +1,47 @@
-from user_scanner.core.orchestrator import status_validate
+from user_scanner.core.orchestrator import status_validate, Result
 
 
-def validate_producthunt(user):
-    url = f"https://www.producthunt.com/@{user}"
-
+def validate_youtube(user) -> Result:
+    url = f"https://m.youtube.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",
+        'User-Agent': "Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/143.0.0.0 Mobile 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",
+        'Accept-Encoding': "identity",
+        'sec-ch-dpr': "2.75",
+        'sec-ch-viewport-width': "980",
+        'sec-ch-ua': "\"Google Chrome\";v=\"143\", \"Chromium\";v=\"143\", \"Not A(Brand\";v=\"24\"",
+        'sec-ch-ua-mobile': "?1",
+        'sec-ch-ua-full-version': "\"143.0.7499.52\"",
+        'sec-ch-ua-arch': "\"\"",
+        'sec-ch-ua-platform': "\"Android\"",
+        'sec-ch-ua-platform-version': "\"15.0.0\"",
+        'sec-ch-ua-bitness': "\"\"",
+        'sec-ch-ua-wow64': "?0",
+        'sec-ch-ua-full-version-list': "\"Google Chrome\";v=\"143.0.7499.52\", \"Chromium\";v=\"143.0.7499.52\", \"Not A(Brand\";v=\"24.0.0.0\"",
+        'sec-ch-ua-form-factors': "\"Mobile\"",
+        'upgrade-insecure-requests': "1",
+        'x-browser-channel': "stable",
+        'x-browser-year': "2025",
+        'x-browser-copyright': "Copyright 2025 Google LLC. All Rights reserved.",
+        'sec-fetch-site': "none",
+        'sec-fetch-mode': "navigate",
+        'sec-fetch-user': "?1",
+        'sec-fetch-dest': "document",
+        'accept-language': "en-US,en;q=0.9",
+        'priority': "u=0, i"
     }
 
-    status_validate(url, 404, 200, headers=headers, follow_redirects=True)
+    return status_validate(url, 404, 200, headers=headers)
+
 
 if __name__ == "__main__":
     user = input("Username?: ").strip()
-    result = validate_producthunt(user)
+    result = validate_youtube(user)
 
     if result == 1:
         print("Available!")
     elif result == 0:
         print("Unavailable!")
     else:
-        print("Error occured!")
+        reason = result.get_reason()
+        print(f"Error occurred! Reason: {reason}")

user_scanner/social/youtube.py

@@ -1,25 +1,29 @@
-from user_scanner.core.orchestrator import status_validate
+from user_scanner.core.orchestrator import status_validate, Result
 
 
-def validate_youtube(user):
+def validate_youtube(user) -> Result:
     url = f"https://m.youtube.com/@{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",
+        'User-Agent': "Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/143.0.0.0 Mobile 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, zstd",
-        'device-memory': "4",
-        'sec-ch-ua': "\"Google Chrome\";v=\"141\", \"Not?A_Brand\";v=\"8\", \"Chromium\";v=\"141\"",
+        'Accept-Encoding': "identity",
+        'sec-ch-dpr': "2.75",
+        'sec-ch-viewport-width': "980",
+        'sec-ch-ua': "\"Google Chrome\";v=\"143\", \"Chromium\";v=\"143\", \"Not A(Brand\";v=\"24\"",
         'sec-ch-ua-mobile': "?1",
-        'sec-ch-ua-full-version': "\"141.0.7390.111\"",
+        'sec-ch-ua-full-version': "\"143.0.7499.52\"",
         'sec-ch-ua-arch': "\"\"",
         'sec-ch-ua-platform': "\"Android\"",
         'sec-ch-ua-platform-version': "\"15.0.0\"",
+        'sec-ch-ua-model': "\"I2404\"",
         'sec-ch-ua-bitness': "\"\"",
         'sec-ch-ua-wow64': "?0",
-        'sec-ch-ua-full-version-list': "\"Google Chrome\";v=\"141.0.7390.111\", \"Not?A_Brand\";v=\"8.0.0.0\", \"Chromium\";v=\"141.0.7390.111\"",
+        'sec-ch-ua-full-version-list': "\"Google Chrome\";v=\"143.0.7499.52\", \"Chromium\";v=\"143.0.7499.52\", \"Not A(Brand\";v=\"24.0.0.0\"",
         'sec-ch-ua-form-factors': "\"Mobile\"",
         'upgrade-insecure-requests': "1",
+        'x-browser-channel': "stable",
+        'x-browser-year': "2025",
+        'x-browser-copyright': "Copyright 2025 Google LLC. All Rights reserved.",
         'sec-fetch-site': "none",
         'sec-fetch-mode': "navigate",
         'sec-fetch-user': "?1",
@@ -28,7 +32,8 @@ def validate_youtube(user):
         'priority': "u=0, i"
     }
 
-    status_validate(url, 404, 200, headers=headers, follow_redirects=True)
+
+    return status_validate(url, 404, 200, headers=headers)
 
 
 if __name__ == "__main__":
@@ -40,4 +45,6 @@ if __name__ == "__main__":
     elif result == 0:
         print("Unavailable!")
     else:
-        print("Error occured!")
+        reason = result.get_reason()
+        print(f"Error occurred! Reason: {reason}")
+

user_scanner/version.json

@@ -1,4 +1,4 @@
 {
-"version": "1.0.8.0",
+"version": "1.0.8.1",
 "version_type": "pypi"
 }

{user_scanner-1.0.8.0.dist-info → user_scanner-1.0.8.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: user-scanner
-Version: 1.0.8.0
+Version: 1.0.8.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.8.0-blueviolet?style=for-the-badge&logo=github" />
+  <img src="https://img.shields.io/badge/Version-1.0.8.1-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" />
@@ -33,9 +33,10 @@ Perfect for finding a **unique username** across GitHub, Twitter, Reddit, Instag
 
 - ✅ Check usernames across **social networks**, **developer platforms**, and **creator communities**.
 - ✅ Clear **Available / Taken / Error** output for each platform.
+- ✅ Robust error handling: It prints the exact reason (e.g. Cannot use underscores, hyphens at the start/end)
 - ✅ Fully modular: add new platform modules easily.
-- ✅ Wildcard-based username permutations for automatic variation generation
-- ✅ Command-line interface ready: works directly after `pip install`.
+- ✅ Wildcard-based username permutations for automatic variation generation using provided suffix
+- ✅ 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.
 ---
@@ -109,12 +110,14 @@ user_scanner/
 ```
 
 **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.
+This project contains small "validator" modules that check whether a username exists on a given platform. Each validator is a single function that returns a Result object (see `core/orchestrator.py`).
+
+Result semantics:
+- Result.available() → `available`
+- Result.taken() → `taken`
+- Result.error(message: Optional[str]) → `error`, blocked, unknown, or request failure (include short diagnostic message when helpful)
+
+Follow this document when adding or updating validators.
 
 See [CONTRIBUTING.md](CONTRIBUTING.md) for examples.
 

{user_scanner-1.0.8.0.dist-info → user_scanner-1.0.8.1.dist-info}/RECORD

@@ -1,12 +1,13 @@
 user_scanner/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 user_scanner/__main__.py,sha256=r_8gq8wSRs3U7yUkTAv4e4MPopX0MUf_EbwedBTPs44,5082
-user_scanner/version.json,sha256=35gyNCy3acbWFMZxPDR9qcG1lQ6Y2OGYyhr3q3rs_AE,49
+user_scanner/version.json,sha256=_1eU-X0UN6AjXfkZNFG3CCPFc6S2N4WQmSrbnp5Dvog,49
 user_scanner/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 user_scanner/cli/banner.py,sha256=3t6owaDArERlvpcszA1Yi3dtksvh8a9tLyrxRowTC40,1499
-user_scanner/community/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+user_scanner/community/__init__.py,sha256=5EzlM991pJqvqIRc05_QV5BureJZ7wiCRm1AyEY6pms,12
 user_scanner/community/coderlegion.py,sha256=W_bdjzdFPRgUrNFFlylvToSJ4AzaFCtTsUy_MRVDdSo,451
+user_scanner/community/stackoverflow.py,sha256=MTL8O0TLHkjVbugBh1pLxELJLU3hkX_YEHjGjaKTJi4,1007
 user_scanner/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-user_scanner/core/orchestrator.py,sha256=cB_aXFYlaZFWIYejZ_iI_c_n6xh2nr9Tm5bN79sCaKo,6102
+user_scanner/core/orchestrator.py,sha256=8dLzV-0zUafZxMLIGAT65Tp4YJtvboelR6eL9M22_4M,6124
 user_scanner/core/result.py,sha256=HWz9JjRk74shAdM56ZtdG6hIp4dgcahqYSnpOp3uCak,1933
 user_scanner/creator/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 user_scanner/creator/devto.py,sha256=mIACmG1a4eoctywxb5p04sI0YVi3dsjCRw9YVOFBEKQ,435
@@ -15,7 +16,7 @@ user_scanner/creator/itch_io.py,sha256=JsFkFzBfJI18DeuSYJIOPGEV_9v7t-jtwmBYCA9W2
 user_scanner/creator/kaggle.py,sha256=QaXIG02OGxvQZEvwHm50RKNd7joxGOq0Ht3cFfrYEiU,445
 user_scanner/creator/medium.py,sha256=NIOYnk8_ASD0kYfKqs8t6uZZTV4D-5-ZxyHMzOMMOuI,1015
 user_scanner/creator/patreon.py,sha256=g-r85pxirf0ihK3STyGYPIzp59MB7JH64Opb4wq1fyU,461
-user_scanner/creator/producthunt.py,sha256=vt26oQR68E7xCOHD7I7Je_M4WSc0-aFfhbMkif6G2FM,879
+user_scanner/creator/producthunt.py,sha256=p0HoIIVhmv9bBkelhfzRYudUFoyk_qeT66-hPpHEFqk,1938
 user_scanner/dev/__init__.py,sha256=qUR0eLwN-gO6oKk-1cmCVT4G_AxUHHMgpV3wJ7URXi4,7
 user_scanner/dev/codeberg.py,sha256=Z6nV0_8xZhMiCcNn9Hn79VVh6y0ar9fqL7KS2b7IaDo,447
 user_scanner/dev/cratesio.py,sha256=mJnlLJoMLlQ7f_95QD7LgH1xCj-e6FooOFkpYypBfG4,724
@@ -48,11 +49,11 @@ user_scanner/social/soundcloud.py,sha256=e2yU1w2fnH1EhzYed0kxgcqgWz0YoCQQFf6yKqh
 user_scanner/social/telegram.py,sha256=9IS-0pghMifNRmj62NcxCOvn23Hvg0AJJcuhCa_aXD4,765
 user_scanner/social/threads.py,sha256=rK8Gm_riDdr0djo23tk38fNVVEBuC6nj2iTXvWrqXeE,951
 user_scanner/social/x.py,sha256=sAnboHHZN2DWyKeds46GLZHxGG-G_bjzfVNIkblSHx8,1406
-user_scanner/social/youtube.py,sha256=PYGp-73ZnXPgpV-7q9-zfN6aF3geqUGul0CaoSO0u9M,1702
+user_scanner/social/youtube.py,sha256=UPu584teg75P7FT05RFG3nobbHgPmzjr-ZwyN2sw6gw,1980
 user_scanner/utils/update.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 user_scanner/utils/version.py,sha256=mPh24EwITyXgD3AMgbflRL180pS0JfrvuJdnoErOU34,623
-user_scanner-1.0.8.0.dist-info/entry_points.txt,sha256=XqU3kssYZ0vXaPy5qYUOTCu4u-48Xie7QWFpBCYc7Nc,59
-user_scanner-1.0.8.0.dist-info/licenses/LICENSE,sha256=XH1QyQG68zo1opDIZHTHcTAbe9XMzewvTaFTukcN9vc,1061
-user_scanner-1.0.8.0.dist-info/WHEEL,sha256=G2gURzTEtmeR8nrdXUJfNiB3VYVxigPQ-bEQujpNiNs,82
-user_scanner-1.0.8.0.dist-info/METADATA,sha256=InqyZQhX0lcSUl5-0GnU-gqErYDLDfROk3ovrv8io3o,4850
-user_scanner-1.0.8.0.dist-info/RECORD,,
+user_scanner-1.0.8.1.dist-info/entry_points.txt,sha256=XqU3kssYZ0vXaPy5qYUOTCu4u-48Xie7QWFpBCYc7Nc,59
+user_scanner-1.0.8.1.dist-info/licenses/LICENSE,sha256=XH1QyQG68zo1opDIZHTHcTAbe9XMzewvTaFTukcN9vc,1061
+user_scanner-1.0.8.1.dist-info/WHEEL,sha256=G2gURzTEtmeR8nrdXUJfNiB3VYVxigPQ-bEQujpNiNs,82
+user_scanner-1.0.8.1.dist-info/METADATA,sha256=e14tVl6oz9iSik_h3jmapma4fdyyv3YYdWaYh-82sfY,5153
+user_scanner-1.0.8.1.dist-info/RECORD,,