user-scanner 1.0.0.4__tar.gz → 1.0.0.6__tar.gz

user_scanner-1.0.0.6/PKG-INFO

@@ -0,0 +1,90 @@
+Metadata-Version: 2.4
+Name: user-scanner
+Version: 1.0.0.6
+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
+
+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`.
+
+---
+
+## 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
+
+```
+---
+
+## 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)
+```
+
+**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.
+
+---
+
+## 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.
+
+## ⚠️ `community/` is small looking for contributions
+

user_scanner-1.0.0.6/README.md

@@ -0,0 +1,76 @@
+# User Scanner
+
+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`.
+
+---
+
+## 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
+
+```
+---
+
+## 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)
+```
+
+**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.
+
+---
+
+## 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.
+
+## ⚠️ `community/` is small looking for contributions

{user_scanner-1.0.0.4 → user_scanner-1.0.0.6}/pyproject.toml

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

{user_scanner-1.0.0.4 → user_scanner-1.0.0.6}/user_scanner/__main__.py

@@ -62,6 +62,9 @@ def main():
         return
     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. Bluesky will throw error. (Supported: only hyphens and digits)" + Style.RESET_ALL +"\n")
+
 
     from user_scanner import dev, social, creator, community
 

user_scanner-1.0.0.6/user_scanner/social/bluesky.py

@@ -0,0 +1,71 @@
+import httpx
+from httpx import ConnectError, TimeoutException
+import re
+import json
+
+def validate_bluesky(user):
+    handle = user if user.endswith('.bsky.social') else f"{user}.bsky.social"
+    url = "https://bsky.social/xrpc/com.atproto.temp.checkHandleAvailability"
+
+    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-Encoding': "gzip",
+        'atproto-accept-labelers': "did:plc:ar7c4by46qjdydhdevvrndac;redact",
+        'sec-ch-ua-platform': "\"Android\"",
+        'sec-ch-ua': "\"Google Chrome\";v=\"141\", \"Not?A_Brand\";v=\"8\", \"Chromium\";v=\"141\"",
+        'sec-ch-ua-mobile': "?1",
+        'origin': "https://bsky.app",
+        'sec-fetch-site': "cross-site",
+        'sec-fetch-mode': "cors",
+        'sec-fetch-dest': "empty",
+        'referer': "https://bsky.app/",
+        'accept-language': "en-US,en;q=0.9",
+    }
+
+    params = {
+        'handle': handle,
+    }
+
+    if not re.fullmatch(r"^[a-zA-Z0-9\.-]{1,64}$", user):
+        return 2
+
+    try:
+        response = httpx.get(url, headers=headers, params=params, timeout = 15.0)
+        status = response.status_code
+
+        if status == 200:
+            data = response.json()
+            result_type = data.get('result', {}).get('$type')
+
+            if result_type == "com.atproto.temp.checkHandleAvailability#resultAvailable":
+                return 1
+            elif result_type == "com.atproto.temp.checkHandleAvailability#resultUnavailable":
+                return 0
+            else:
+                return 2
+        else:
+            return 2
+
+    except (ConnectError, TimeoutException):
+        return 2
+    except json.JSONDecodeError:
+        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_bluesky(user)
+
+   if result == 1:
+      print("Available!")
+   elif result == 0:
+      print("Unavailable!")
+   else:
+      print("Error occured!")

{user_scanner-1.0.0.4 → user_scanner-1.0.0.6}/user_scanner/social/instagram.py

@@ -13,9 +13,9 @@ def validate_instagram(user):
         'X-Requested-With': "XMLHttpRequest",
         'Referer': f"https://www.instagram.com/{user}/",
     }
-    
+
     try:
-        response = httpx.get(url, headers=headers, timeout = 15.0)
+        response = httpx.get(url, headers=headers, timeout = 3.0)
         status = response.status_code
 
         if status == 200:

{user_scanner-1.0.0.4 → user_scanner-1.0.0.6}/user_scanner/social/x.py

@@ -1,5 +1,6 @@
 import httpx
 import json
+from colorama import Fore, Style
 from httpx import ConnectError, TimeoutException
 
 def validate_x(user):
@@ -19,6 +20,7 @@ def validate_x(user):
     try:
         response = httpx.get(url, params=params, headers=headers, timeout = 3.0)
         status = response.status_code
+       # print(response.text)
         if status in [401, 403, 429]:
             return 2
 
@@ -29,8 +31,8 @@ def validate_x(user):
                 return 1
             elif data.get('reason') == 'taken':
                 return 0
-            elif data.get('reason') == "improper_format":
-                print(data.get('desc'))
+            elif (data.get('reason') == "improper_format" or data.get('reason') == "invalid_username"):
+                print("\n" +"  "+f"{Fore.CYAN}X says: {data.get('desc')}{Style.RESET_ALL}")
                 return 2
             else:
                 return 2

user_scanner-1.0.0.4/PKG-INFO

@@ -1,14 +0,0 @@
-Metadata-Version: 2.4
-Name: user-scanner
-Version: 1.0.0.4
-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

user_scanner-1.0.0.4/README.md

@@ -1 +0,0 @@
-# user-scanner