user-scanner 1.0.10.0__tar.gz → 1.0.10.2__tar.gz

{user_scanner-1.0.10.0 → user_scanner-1.0.10.2}/PKG-INFO

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: user-scanner
-Version: 1.0.10.0
+Version: 1.0.10.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
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: httpx
@@ -15,7 +15,7 @@ Project-URL: Homepage, https://github.com/kaifcodec/user-scanner
 
 ![User Scanner Logo](https://github.com/user-attachments/assets/49ec8d24-665b-4115-8525-01a8d0ca2ef4)
 <p align="center">
-  <img src="https://img.shields.io/badge/Version-1.0.10.1-blueviolet?style=for-the-badge&logo=github" />
+  <img src="https://img.shields.io/badge/Version-1.0.10.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" />

{user_scanner-1.0.10.0 → user_scanner-1.0.10.2}/README.md

@@ -2,7 +2,7 @@
 
 ![User Scanner Logo](https://github.com/user-attachments/assets/49ec8d24-665b-4115-8525-01a8d0ca2ef4)
 <p align="center">
-  <img src="https://img.shields.io/badge/Version-1.0.10.1-blueviolet?style=for-the-badge&logo=github" />
+  <img src="https://img.shields.io/badge/Version-1.0.10.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" />

{user_scanner-1.0.10.0 → user_scanner-1.0.10.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "flit_core.buildapi"
 
 [project]
 name = "user-scanner"
-version = "1.0.10.0"
+version = "1.0.10.2"
 description = "Check username availability across multiple popular platforms"
 readme = "README.md"
 license = {file = "LICENSE"}
@@ -16,7 +16,7 @@ dependencies = [
   "colorama"
 ]
 
-requires-python = ">=3.7"
+requires-python = ">=3.10"
 keywords = ["username", "checker", "availability", "social", "tech", "python", "user-scanner"]
 
 [project.urls]
@@ -27,3 +27,7 @@ user-scanner = "user_scanner.__main__:main"
 
 [tool.flit.sdist]
 exclude = ["tests/", "docs/", ".github/", ".git", "rm_pycache.py", "che.py", ".gitignore"]
+
+[tool.pytest.ini_options]
+pythonpath = "."
+testpaths = ["tests"]

{user_scanner-1.0.10.0 → user_scanner-1.0.10.2}/user_scanner/__main__.py

@@ -1,6 +1,5 @@
 import argparse
 import time
-import re
 import sys
 from user_scanner.cli import printer
 from user_scanner.core.orchestrator import generate_permutations, load_categories
@@ -8,7 +7,7 @@ from colorama import Fore, Style
 from user_scanner.cli.banner import print_banner
 from typing import List
 from user_scanner.core.result import Result
-from user_scanner.core.utils import is_last_value
+from user_scanner.core.helpers import is_last_value
 from user_scanner.utils.updater_logic import check_for_updates
 from user_scanner.utils.update import update_self
 
@@ -119,7 +118,7 @@ def main():
         print(Printer.get_start())
         for i, name in enumerate(usernames):
             is_last = i == len(usernames) - 1
-            if arg == None:
+            if arg is None:
                 results.extend(func(name, Printer, is_last))
             else:
                 results.extend(func(arg, name, Printer, is_last))

{user_scanner-1.0.10.0 → user_scanner-1.0.10.2}/user_scanner/cli/banner.py

@@ -1,4 +1,3 @@
-import json
 from colorama import Fore, Style, init
 from ..core.version import load_local_version
 

{user_scanner-1.0.10.0 → user_scanner-1.0.10.2}/user_scanner/cli/printer.py

@@ -15,7 +15,7 @@ def indentate(msg: str, indent: int):
 
 class Printer:
     def __init__(self, format: Literal["console", "csv", "json"]) -> None:
-        if not format in ["console", "csv", "json"]:
+        if format not in ["console", "csv", "json"]:
             raise ValueError(f"Invalid output-format: {format}")
         self.mode: str = format
         self.indent: int = 0
@@ -42,7 +42,7 @@ class Printer:
 
     def get_end(self, json_char: str = "]") -> str:
         if not self.is_json:
-            return
+            return ""
         self.indent = max(self.indent - 1, 0)
         return indentate(json_char, self.indent)
 

{user_scanner-1.0.10.0 → user_scanner-1.0.10.2}/user_scanner/core/orchestrator.py

@@ -6,9 +6,9 @@ from itertools import permutations
 import httpx
 from pathlib import Path
 from user_scanner.cli.printer import Printer
-from user_scanner.core.result import Result, AnyResult
+from user_scanner.core.result import Result
 from typing import Callable, Dict, List
-from user_scanner.core.utils import get_site_name, is_last_value
+from user_scanner.core.helpers import get_site_name, is_last_value
 
 
 def load_modules(category_path: Path):
@@ -17,6 +17,8 @@ def load_modules(category_path: Path):
         if file.name == "__init__.py":
             continue
         spec = importlib.util.spec_from_file_location(file.stem, str(file))
+        if spec is None or spec.loader is None:
+            continue
         module = importlib.util.module_from_spec(spec)
         spec.loader.exec_module(module)
 
@@ -30,8 +32,8 @@ def load_categories() -> Dict[str, Path]:
 
     for subfolder in root.iterdir():
         if subfolder.is_dir() and \
-                not subfolder.name.lower() in ["cli", "utils", "core"] and \
-                not "__" in subfolder.name:  # Removes __pycache__
+                subfolder.name.lower() not in ["cli", "utils", "core"] and \
+                "__" not in subfolder.name:  # Removes __pycache__
             categories[subfolder.name] = subfolder.resolve()
 
     return categories
@@ -88,9 +90,9 @@ def run_module_single(module, username: str, printer: Printer, last: bool = True
     if category:
         result.update(category=category)
 
-    site_name = get_site_name(module)
+    get_site_name(module)
     msg = printer.get_result_output(result)
-    if last == False and printer.is_json:
+    if not last and printer.is_json:
         msg += ","
     print(msg)
 
@@ -114,9 +116,9 @@ def run_checks_category(category_path: Path, username: str, printer: Printer, la
             results.append(result)
 
             is_last = last and is_last_value(modules, i)
-            site_name = get_site_name(modules[i])
+            get_site_name(modules[i])
             msg = printer.get_result_output(result)
-            if is_last == False and printer.is_json:
+            if not is_last and printer.is_json:
                 msg += ","
             print(msg)
 
@@ -131,7 +133,7 @@ def run_checks(username: str, printer: Printer, last: bool = True) -> List[Resul
 
     categories = list(load_categories().values())
     for i, category_path in enumerate(categories):
-        last_cat: int = last and (i == len(categories) - 1)
+        last_cat = last and (i == len(categories) - 1)
         temp = run_checks_category(category_path, username, printer, last_cat)
         results.extend(temp)
 
@@ -140,7 +142,7 @@ def run_checks(username: str, printer: Printer, last: bool = True) -> List[Resul
 
 def make_request(url: str, **kwargs) -> httpx.Response:
     """Simple wrapper to **httpx.get** that predefines headers and timeout"""
-    if not "headers" in kwargs:
+    if "headers" not 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",
@@ -149,7 +151,7 @@ def make_request(url: str, **kwargs) -> httpx.Response:
             'sec-fetch-dest': "document",
         }
 
-    if not "timeout" in kwargs:
+    if "timeout" not in kwargs:
         kwargs["timeout"] = 5.0
 
     method = kwargs.pop("method", "GET")
@@ -157,14 +159,13 @@ def make_request(url: str, **kwargs) -> httpx.Response:
     return httpx.request(method.upper(), url, **kwargs)
 
 
-def generic_validate(url: str, func: Callable[[httpx.Response], AnyResult], **kwargs) -> AnyResult:
+def generic_validate(url: str, func: Callable[[httpx.Response], Result], **kwargs) -> Result:
     """
     A generic validate function that makes a request and executes the provided function on the response.
     """
     try:
         response = make_request(url, **kwargs)
         result = func(response)
-        result.url = url
         return result
     except Exception as e:
         return Result.error(e, url=url)

{user_scanner-1.0.10.0 → user_scanner-1.0.10.2}/user_scanner/core/result.py

@@ -1,5 +1,4 @@
 from enum import Enum
-from typing import Literal
 
 DEBUG_MSG = """Result {{
   status: {status},
@@ -80,10 +79,10 @@ class Result:
         return self.status.value
 
     def has_reason(self) -> bool:
-        return self.reason != None
+        return self.reason is not None
 
     def get_reason(self) -> str:
-        if self.reason == None:
+        if self.reason is None:
             return ""
         if isinstance(self.reason, str):
             return self.reason
@@ -124,5 +123,3 @@ class Result:
 
         return NotImplemented
 
-
-AnyResult = Literal[0, 1, 2] | Result

{user_scanner-1.0.10.0 → user_scanner-1.0.10.2}/user_scanner/creator/hashnode.py

@@ -1,4 +1,3 @@
-import httpx
 from user_scanner.core.result import Result
 from user_scanner.core.orchestrator import generic_validate
 

{user_scanner-1.0.10.0 → user_scanner-1.0.10.2}/user_scanner/creator/medium.py

@@ -6,8 +6,19 @@ def validate_medium(user):
     url = f"https://medium.com/@{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': "text/html",
+        'User-Agent': "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/143.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': "identity",
+        'upgrade-insecure-requests': "1",
+        'sec-fetch-site': "none",
+        'sec-fetch-mode': "navigate",
+        'sec-fetch-user': "?1",
+        'sec-fetch-dest': "document",
+        'sec-ch-ua': "\"Google Chrome\";v=\"143\", \"Chromium\";v=\"143\", \"Not A(Brand\";v=\"24\"",
+        'sec-ch-ua-mobile': "?0",
+        'sec-ch-ua-platform': "\"Linux\"",
+        'accept-language': "en-US,en;q=0.9",
+        'priority': "u=0, i"
     }
 
     def process(response):
@@ -34,4 +45,4 @@ if __name__ == "__main__":
     elif result == 0:
         print("Unavailable!")
     else:
-        print("Error occurred!")
+        print(f"Error occurred! Reason: {result.get_reason()}")

user_scanner-1.0.10.2/user_scanner/creator/producthunt.py

@@ -0,0 +1,25 @@
+from user_scanner.core.orchestrator import status_validate
+
+
+def validate_producthunt(user):
+    url = f"https://www.producthunt.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",
+    }
+
+    status_validate(url, 404, 200, headers=headers, follow_redirects=True)
+
+if __name__ == "__main__":
+    user = input("Username?: ").strip()
+    result = validate_producthunt(user)
+
+    if result == 1:
+        print("Available!")
+    elif result == 0:
+        print("Unavailable!")
+    else:
+        print("Error occured!")

{user_scanner-1.0.10.0 → user_scanner-1.0.10.2}/user_scanner/gaming/monkeytype.py

@@ -1,9 +1,10 @@
 from user_scanner.core.orchestrator import generic_validate
 from user_scanner.core.result import Result
+from urllib.parse import quote
 
-def validate_monkeytype(user: str) -> int:
-
-    url = f"https://api.monkeytype.com/users/checkName/{user}"
+def validate_monkeytype(user: str) -> Result:
+    safe_user = quote(user, safe="")
+    url = f"https://api.monkeytype.com/users/checkName/{safe_user}"
 
     headers = {
         "User-Agent": (
@@ -28,6 +29,16 @@ def validate_monkeytype(user: str) -> int:
                 return Result.available()
             elif available is False:
                 return Result.taken()
+
+        # Surface Monkeytype validation errors (e.g. special characters)
+        try:
+            data = response.json()
+            errors = data.get("validationErrors")
+            if errors:
+                return Result.error("; ".join(errors))
+        except Exception:
+            pass
+
         return Result.error("Invalid status code")
 
     return generic_validate(url, process, headers=headers)
@@ -42,4 +53,4 @@ if __name__ == "__main__":
     elif result == 0:
         print("Unavailable!")
     else:
-        print("Error occurred!")
+        print("Error occured!")

{user_scanner-1.0.10.0 → user_scanner-1.0.10.2}/user_scanner/social/discord.py

@@ -1,4 +1,3 @@
-import httpx
 from user_scanner.core.result import Result
 from user_scanner.core.orchestrator import generic_validate
 

user_scanner-1.0.10.2/user_scanner/social/mastodon.py

@@ -0,0 +1,30 @@
+import re
+from user_scanner.core.orchestrator import status_validate
+from user_scanner.core.result import Result
+
+
+def validate_mastodon(user: str) -> Result:
+    if not (3 <= len(user) <= 30):
+        return Result.error("Length must be 3-30 characters")
+
+    if not re.match(r'^[a-zA-Z0-9_-]+$', user):
+        return Result.error("Usernames can only contain letters, numbers, underscores and hyphens")
+
+    if not re.match(r'^[a-zA-Z0-9].*[a-zA-Z0-9]$', user):
+        return Result.error("Username must start and end with a letter or number")
+
+    url = f"https://mastodon.social/api/v1/accounts/lookup?acct={user}"
+
+    return status_validate(url, 404, 200, follow_redirects=True)
+
+
+if __name__ == "__main__":
+    user = input("Username?: ").strip()
+    result = validate_mastodon(user)
+
+    if result == 1:
+        print("Available!")
+    elif result == 0:
+        print("Unavailable!")
+    else:
+        print(f"Error occurred! Reason: {result.get_reason()}")

{user_scanner-1.0.10.0 → user_scanner-1.0.10.2}/user_scanner/social/soundcloud.py

@@ -5,11 +5,6 @@ from user_scanner.core.result import Result
 def validate_soundcloud(user):
     url = f"https://soundcloud.com/{user}"
 
-    headers = {
-        'User-Agent': "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36",
-        'Accept': "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
-    }
-
     def process(response):
         if response.status_code == 404:
             return Result.available()
@@ -28,7 +23,7 @@ def validate_soundcloud(user):
 
         return Result.error()
 
-    return generic_validate(url, process, headers=headers, follow_redirects=True)
+    return generic_validate(url, process, follow_redirects=True)
 
 
 if __name__ == "__main__":

{user_scanner-1.0.10.0 → user_scanner-1.0.10.2}/user_scanner/social/telegram.py

@@ -3,13 +3,13 @@ from user_scanner.core.orchestrator import generic_validate
 from user_scanner.core.result import Result
 
 
-def validate_telegram(user: str) -> int:
+def validate_telegram(user: str) -> Result:
     url = f"https://t.me/{user}"
 
     def process(r):
         if r.status_code == 200:
             if re.search(r'<div[^>]*class="tgme_page_extra"[^>]*>', r.text):
-                return Result.taken() 
+                return Result.taken()
             else:
                 return Result.available()
         return Result.error()

user_scanner-1.0.10.2/user_scanner/social/tiktok.py

@@ -0,0 +1,50 @@
+import re
+from user_scanner.core.orchestrator import generic_validate
+from user_scanner.core.result import Result
+
+
+def validate_tiktok(user: str) -> Result:
+    if not (2 <= len(user) <= 24):
+        return Result.error("Length must be 2-24 characters")
+
+    if user.isdigit():
+        return Result.error("Usernames cannot contain numbers only")
+
+    if not re.match(r'^[a-zA-Z0-9_.]+$', user):
+        return Result.error("Usernames can only contain letters, numbers, underscores and periods")
+
+    if user.startswith(".") or user.endswith("."):
+        return Result.error("Username cannot start nor end with a period")
+
+    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': "identity",
+        'Accept-Language': "en-US,en;q=0.9",
+        'sec-fetch-dest': "document",
+        'Connection': "keep-alive"
+    }
+
+    url = f"https://www.tiktok.com/@{user}"
+
+    def process(response) -> Result:
+        if response.status_code == 200:
+            if "statuscode\":10221" in response.text.lower():
+                return Result.available()
+            else:
+                return Result.taken()
+        return Result.error("Unable to load tiktok")
+
+    return generic_validate(url, process, headers=headers)
+
+
+if __name__ == "__main__":
+    user = input("Username?: ").strip()
+    result = validate_tiktok(user)
+
+    if result == 1:
+        print("Available!")
+    elif result == 0:
+        print("Unavailable!")
+    else:
+        print(f"Error occurred! Reason: {result.get_reason()}")

{user_scanner-1.0.10.0 → user_scanner-1.0.10.2}/user_scanner/utils/updater_logic.py

@@ -2,6 +2,7 @@ from pathlib import Path
 from colorama import Fore
 import sys
 import json
+import os
 from user_scanner.core.version import get_pypi_version, load_local_version
 from user_scanner.utils.update import update_self
 
@@ -15,19 +16,39 @@ X = Fore.RESET
 CONFIG_PATH = Path(__file__).parent.parent / "config.json"
 
 
-def load_config() -> dict:
-    if CONFIG_PATH.exists():
-        return json.loads(CONFIG_PATH.read_text())
+def _get_config_path(path: str | Path | None = None) -> Path:
+    """
+    Determine the config path in this order:
+      1. explicit path argument (if provided)
+      2. environment variable USER_SCANNER_CONFIG (if set)
+      3. default CONFIG_PATH
+    """
+    if path:
+        return Path(path)
+    env = os.environ.get("USER_SCANNER_CONFIG")
+    if env:
+        return Path(env)
+    return CONFIG_PATH
+
+
+def load_config(path: str | Path | None = None) -> dict:
+    cp = _get_config_path(path)
+    if cp.exists():
+        return json.loads(cp.read_text())
 
     default = {"auto_update_status": True}
-    CONFIG_PATH.write_text(json.dumps(default, indent=2))
+    # Ensure parent exists
+    cp.parent.mkdir(parents=True, exist_ok=True)
+    cp.write_text(json.dumps(default, indent=2))
     return default
 
 
-def save_config_change(status: bool):
-    content = load_config()
+def save_config_change(status: bool, path: str | Path | None = None):
+    cp = _get_config_path(path)
+    content = load_config(path)
     content["auto_update_status"] = status
-    CONFIG_PATH.write_text(json.dumps(content, indent=2))
+    cp.parent.mkdir(parents=True, exist_ok=True)
+    cp.write_text(json.dumps(content, indent=2))
 
 
 def check_for_updates():

{user_scanner-1.0.10.0 → user_scanner-1.0.10.2}/user_scanner/version.json

@@ -1,4 +1,4 @@
 {
-"version": "1.0.10.0",
+"version": "1.0.10.2",
 "version_type": "pypi"
 }

user_scanner-1.0.10.0/user_scanner/creator/producthunt.py

@@ -1,47 +0,0 @@
-from user_scanner.core.orchestrator import status_validate, Result
-
-
-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/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': "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"
-    }
-
-    return status_validate(url, 404, 200, headers=headers)
-
-
-if __name__ == "__main__":
-    user = input("Username?: ").strip()
-    result = validate_youtube(user)
-
-    if result == 1:
-        print("Available!")
-    elif result == 0:
-        print("Unavailable!")
-    else:
-        reason = result.get_reason()
-        print(f"Error occurred! Reason: {reason}")

user_scanner-1.0.10.0/user_scanner/social/mastodon.py

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