user-scanner 1.1.0.4__tar.gz → 1.1.0.6__tar.gz

{user_scanner-1.1.0.4 → user_scanner-1.1.0.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: user-scanner
-Version: 1.1.0.4
+Version: 1.1.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>
@@ -16,7 +16,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.1.0.4-blueviolet?style=for-the-badge&logo=github" />
+  <img src="https://img.shields.io/badge/Version-1.1.0.6-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" />
@@ -34,23 +34,15 @@ Perfect for finding a **unique username** across GitHub, Twitter, Reddit, Instag
 
 ## Features
 
-- ✅ Check an email across multiple sites to see if it’s registered.  
-- ✅ Scan usernames across **social networks**, **developer platforms**, **creator communities**, and more.  
-- ✅ Can be used purely as a username tool.  
-- ✅ Smart auto-update system detects new releases on PyPI and prompts the user to upgrade interactively.  
-- ✅ Clear `Registered` and `Not Registered` for email scanning `Available` / `Taken` / `Error` output for username scans
-- ✅ Robust error handling: displays the exact reason a username or email cannot be used (e.g., underscores or hyphens at the start/end).  
-- ✅ Fully modular: easily add new platform modules.  
-- ✅ Wildcard-based username permutations for automatic variation generation using a provided suffix.  
-- ✅ Option to select results format (**JSON**, **CSV**, console).  
-- ✅ Save scanning and OSINT results in the preferred format and output file (ideal for power users).  
-- ✅ Command-line interface ready: works immediately after `pip install`.  
-- ✅ Lightweight with minimal dependencies; runs on any machine.
-- ✅ **Proxy support** with round-robin rotation
-- ✅ **Proxy validation** to test and filter working proxies before scanning
-- ✅ **Bulk username scanning** from file support for checking multiple usernames at once
-- ✅ **Bulk email scanning** from file support for checking multiple emails at once
----
+- ✅ Email & username OSINT: check email registrations and username availability across social, developer, creator, and other platforms  
+- ✅ Dual-mode usage: works as an email scanner, username scanner, or username-only tool  
+- ✅ Clear results: `Registered` / `Not Registered` for emails and `Available` / `Taken` / `Error` for usernames with precise failure reasons  
+- ✅ Fully modular architecture for easy addition of new platform modules  
+- ✅ Bulk scanning support for usernames and emails via input files  
+- ✅ Wildcard-based username permutations with automatic variation generation  
+- ✅ Multiple output formats: console, **JSON**, and **CSV**, with file export support  
+- ✅ Proxy support with rotation and pre-scan proxy validation  
+- ✅ Smart auto-update system with interactive upgrade prompts via PyPI  
 
 ## Virtual Environment (optional but recommended)
 
@@ -102,14 +94,11 @@ pip install user-scanner
 
 ### Basic username/email scan
 
-Scan a single username across **all** available modules/platforms:
+Scan a single email or username across **all** available modules/platforms:
 
 ```bash
-user-scanner -e john_doe@gmail.com
-user-scanner --email john_doe@gmail.com # long version
-
-user-scanner -u john_doe
-user-scanner --username john_doe # long version
+user-scanner -e john_doe@gmail.com   # single email scanning 
+user-scanner -u john_doe             # single username scanning 
 ```
 
 ### Selective scanning
@@ -121,23 +110,14 @@ user-scanner -u john_doe -c dev # developer platforms only
 user-scanner -u john_doe -m github # only GitHub
 ```
 
-### Bulk username scanning
+### Bulk email/username scanning
 
-Scan multiple usernames from a file (one username per line):
-- Can also be combined with categories or modules using `-c` and `-m` flags
+Scan multiple emails/usernames from a file (one email/username per line):
+- Can also be combined with categories or modules using `-c` , `-m` and other flags
 
 ```bash
-user-scanner -uf usernames.txt
-```
-
-
-### Bulk email scanning
-
-Scan multiple emails from a file (one email per line):
-- Can also be combined with categories or modules using `-c` and `-m` flags
-
-```bash
-user-scanner -ef emails.txt
+user-scanner -ef emails.txt     # bulk email scan
+user-scanner -uf usernames.txt  # bulk username scan
 ```
 
 ### Username/Email variations (suffix only)
@@ -163,37 +143,22 @@ user-scanner -u john_doe -P proxies.txt --validate-proxies # recommended
 ```
 
 This will:
-1. Test all proxies from the file
-2. Filter out non-working proxies
-3. Save working proxies to `validated_proxies.txt`
-4. Use only validated proxies for scanning
-
----
-
-### Update
-
-Update the tool to the latest PyPI version:
+1. Filter out non-working proxies
+2. Save working proxies to `validated_proxies.txt`
+3. Use only validated proxies for scanning
 
-```bash
-user-scanner -U
-```
 ---
 
-## Screenshot: 
+## Screenshots: 
 
-- Note*: New modules are constantly getting added so this might have only limited, outdated output:
+- Note*: New modules are constantly getting added so screenshots might show only limited, outdated output:
 
-<img width="1080" height="656" alt="1000146096" src="https://github.com/user-attachments/assets/1101e2f8-18ea-45a4-9492-92e237ecc670" />
+<img width="1080" height="800" alt="1000146237" src="https://github.com/user-attachments/assets/1bb7d7cb-9b78-495a-ae95-01a9ef48d9a2" />
 
 ---
 
 <img width="1072" height="848" alt="user-scanner's main usage screenshot" src="https://github.com/user-attachments/assets/34e44ca6-e314-419e-9035-d951b493b47f" />
 
----
-
-<img width="1080" height="352" alt="user-scanner's wildcard username feature" src="https://github.com/user-attachments/assets/578b248c-2a05-4917-aab3-6372a7c28045" />
-
-
 ---
 
 ## Contributing
@@ -212,8 +177,7 @@ user_scanner/
 │   ├── creator/      # Creator platforms (Hashnode, Dev.to, Medium, Patreon, etc.)
 │   ├── community/    # Community platforms (forums, StackOverflow, HackerNews, etc.)
 │   ├── gaming/       # Gaming sites (chess.com, Lichess, Roblox, Minecraft, etc.)
-│   └── donation/     # Donation platforms (BuyMeACoffee, Liberapay)
-|...
+    ...
 ```
 
 **Module guidelines:**

{user_scanner-1.1.0.4 → user_scanner-1.1.0.6}/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.1.0.4-blueviolet?style=for-the-badge&logo=github" />
+  <img src="https://img.shields.io/badge/Version-1.1.0.6-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" />
@@ -20,23 +20,15 @@ Perfect for finding a **unique username** across GitHub, Twitter, Reddit, Instag
 
 ## Features
 
-- ✅ Check an email across multiple sites to see if it’s registered.  
-- ✅ Scan usernames across **social networks**, **developer platforms**, **creator communities**, and more.  
-- ✅ Can be used purely as a username tool.  
-- ✅ Smart auto-update system detects new releases on PyPI and prompts the user to upgrade interactively.  
-- ✅ Clear `Registered` and `Not Registered` for email scanning `Available` / `Taken` / `Error` output for username scans
-- ✅ Robust error handling: displays the exact reason a username or email cannot be used (e.g., underscores or hyphens at the start/end).  
-- ✅ Fully modular: easily add new platform modules.  
-- ✅ Wildcard-based username permutations for automatic variation generation using a provided suffix.  
-- ✅ Option to select results format (**JSON**, **CSV**, console).  
-- ✅ Save scanning and OSINT results in the preferred format and output file (ideal for power users).  
-- ✅ Command-line interface ready: works immediately after `pip install`.  
-- ✅ Lightweight with minimal dependencies; runs on any machine.
-- ✅ **Proxy support** with round-robin rotation
-- ✅ **Proxy validation** to test and filter working proxies before scanning
-- ✅ **Bulk username scanning** from file support for checking multiple usernames at once
-- ✅ **Bulk email scanning** from file support for checking multiple emails at once
----
+- ✅ Email & username OSINT: check email registrations and username availability across social, developer, creator, and other platforms  
+- ✅ Dual-mode usage: works as an email scanner, username scanner, or username-only tool  
+- ✅ Clear results: `Registered` / `Not Registered` for emails and `Available` / `Taken` / `Error` for usernames with precise failure reasons  
+- ✅ Fully modular architecture for easy addition of new platform modules  
+- ✅ Bulk scanning support for usernames and emails via input files  
+- ✅ Wildcard-based username permutations with automatic variation generation  
+- ✅ Multiple output formats: console, **JSON**, and **CSV**, with file export support  
+- ✅ Proxy support with rotation and pre-scan proxy validation  
+- ✅ Smart auto-update system with interactive upgrade prompts via PyPI  
 
 ## Virtual Environment (optional but recommended)
 
@@ -88,14 +80,11 @@ pip install user-scanner
 
 ### Basic username/email scan
 
-Scan a single username across **all** available modules/platforms:
+Scan a single email or username across **all** available modules/platforms:
 
 ```bash
-user-scanner -e john_doe@gmail.com
-user-scanner --email john_doe@gmail.com # long version
-
-user-scanner -u john_doe
-user-scanner --username john_doe # long version
+user-scanner -e john_doe@gmail.com   # single email scanning 
+user-scanner -u john_doe             # single username scanning 
 ```
 
 ### Selective scanning
@@ -107,23 +96,14 @@ user-scanner -u john_doe -c dev # developer platforms only
 user-scanner -u john_doe -m github # only GitHub
 ```
 
-### Bulk username scanning
+### Bulk email/username scanning
 
-Scan multiple usernames from a file (one username per line):
-- Can also be combined with categories or modules using `-c` and `-m` flags
+Scan multiple emails/usernames from a file (one email/username per line):
+- Can also be combined with categories or modules using `-c` , `-m` and other flags
 
 ```bash
-user-scanner -uf usernames.txt
-```
-
-
-### Bulk email scanning
-
-Scan multiple emails from a file (one email per line):
-- Can also be combined with categories or modules using `-c` and `-m` flags
-
-```bash
-user-scanner -ef emails.txt
+user-scanner -ef emails.txt     # bulk email scan
+user-scanner -uf usernames.txt  # bulk username scan
 ```
 
 ### Username/Email variations (suffix only)
@@ -149,37 +129,22 @@ user-scanner -u john_doe -P proxies.txt --validate-proxies # recommended
 ```
 
 This will:
-1. Test all proxies from the file
-2. Filter out non-working proxies
-3. Save working proxies to `validated_proxies.txt`
-4. Use only validated proxies for scanning
-
----
-
-### Update
-
-Update the tool to the latest PyPI version:
+1. Filter out non-working proxies
+2. Save working proxies to `validated_proxies.txt`
+3. Use only validated proxies for scanning
 
-```bash
-user-scanner -U
-```
 ---
 
-## Screenshot: 
+## Screenshots: 
 
-- Note*: New modules are constantly getting added so this might have only limited, outdated output:
+- Note*: New modules are constantly getting added so screenshots might show only limited, outdated output:
 
-<img width="1080" height="656" alt="1000146096" src="https://github.com/user-attachments/assets/1101e2f8-18ea-45a4-9492-92e237ecc670" />
+<img width="1080" height="800" alt="1000146237" src="https://github.com/user-attachments/assets/1bb7d7cb-9b78-495a-ae95-01a9ef48d9a2" />
 
 ---
 
 <img width="1072" height="848" alt="user-scanner's main usage screenshot" src="https://github.com/user-attachments/assets/34e44ca6-e314-419e-9035-d951b493b47f" />
 
----
-
-<img width="1080" height="352" alt="user-scanner's wildcard username feature" src="https://github.com/user-attachments/assets/578b248c-2a05-4917-aab3-6372a7c28045" />
-
-
 ---
 
 ## Contributing
@@ -198,8 +163,7 @@ user_scanner/
 │   ├── creator/      # Creator platforms (Hashnode, Dev.to, Medium, Patreon, etc.)
 │   ├── community/    # Community platforms (forums, StackOverflow, HackerNews, etc.)
 │   ├── gaming/       # Gaming sites (chess.com, Lichess, Roblox, Minecraft, etc.)
-│   └── donation/     # Donation platforms (BuyMeACoffee, Liberapay)
-|...
+    ...
 ```
 
 **Module guidelines:**

{user_scanner-1.1.0.4 → user_scanner-1.1.0.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "flit_core.buildapi"
 
 [project]
 name = "user-scanner"
-version = "1.1.0.4"
+version = "1.1.0.6"
 description = "Check username availability across multiple popular platforms"
 readme = "README.md"
 license = {file = "LICENSE"}
@@ -27,8 +27,24 @@ Homepage = "https://github.com/kaifcodec/user-scanner"
 [project.scripts]
 user-scanner = "user_scanner.__main__:main"
 
+[tool.flit.module]
+name = "user_scanner"
+
 [tool.flit.sdist]
-exclude = ["tests/", "docs/", ".github/", ".git", "rm_pycache.py", "che.py", ".gitignore"]
+exclude = [
+  "tests/",
+  "docs/",
+  ".github/",
+  ".git",
+  ".gitignore",
+  ".ruff_cache/",
+  "**/.ruff_cache/**",
+  "__pycache__/",
+  "**/__pycache__/**",
+  "*.pyc",
+  "rm_pycache.py",
+  "che.py"
+]
 
 [tool.pytest.ini_options]
 pythonpath = "."

user_scanner-1.1.0.6/user_scanner/email_scan/dev/leetcode.py

@@ -0,0 +1,64 @@
+import httpx
+from user_scanner.core.result import Result
+
+
+async def _check(email: str) -> Result:
+    headers = {
+        'User-Agent': "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/144.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",
+        'Accept-Language': "en-US,en;q=0.9",
+        'Referer': "https://leetcode.com/accounts/login/",
+        'Origin': "https://leetcode.com",
+    }
+
+    try:
+        async with httpx.AsyncClient(timeout=5.0, follow_redirects=True) as client:
+            await client.get("https://leetcode.com/accounts/login/", headers=headers)
+            csrf_token = client.cookies.get("csrftoken")
+
+            if not csrf_token:
+                return Result.error("CSRF token not found, possible rate-limit")
+
+            headers.update({
+                'x-requested-with': "XMLHttpRequest",
+                'referer': "https://leetcode.com/accounts/password/reset/",
+            })
+
+            payload = {
+                'next': 'undefined',
+                'userName': '',
+                'email': email,
+                'csrfmiddlewaretoken': csrf_token
+            }
+
+            response = await client.post(
+                "https://leetcode.com/accounts/password/reset/",
+                headers=headers,
+                data=payload
+            )
+
+            if response.status_code in [200, 400]:
+                data = response.json()
+
+                if data.get("location") == "/accounts/password/reset/done/":
+                    return Result.taken()
+
+                email_field = data.get("form", {}).get(
+                    "fields", {}).get("email", {})
+                errors = email_field.get("errors", [])
+
+                if any("not assigned to any user account" in err for err in errors):
+                    return Result.available()
+
+                return Result.error("Unexpected response data")
+
+            return Result.error(f"HTTP {response.status_code}")
+
+    except httpx.TimeoutException:
+        return Result.error("Connection timed out")
+    except Exception as e:
+        return Result.error(e)
+
+
+async def validate_leetcode(email: str) -> Result:
+    return await _check(email)

user_scanner-1.1.0.6/user_scanner/email_scan/learning/duolingo.py

@@ -0,0 +1,36 @@
+import httpx
+from user_scanner.core.result import Result
+
+async def _check(email: str) -> Result:
+    headers = {
+        'authority': 'www.duolingo.com',
+        'Accept': 'application/json, text/plain, */*',
+        'Accept-Language': 'en-US,en;q=0.9',
+        'User-Agent': "Mozilla/5.0 (X11; Linux x86_64; rv:130.0) Gecko/20100101 Firefox/130.0",
+        'Referer': 'https://www.duolingo.com/',
+    }
+
+    try:
+        async with httpx.AsyncClient(timeout=5.0, follow_redirects=True) as client:
+            response = await client.get(
+                f"https://www.duolingo.com/2017-06-30/users?email={email}",
+                headers=headers
+            )
+
+            if response.status_code == 200:
+                data = response.json()
+                # Duolingo returns a list of users matching the email
+                if data.get("users") and len(data["users"]) > 0:
+                    return Result.taken()
+                else:
+                    return Result.available()
+            
+            return Result.error(f"HTTP {response.status_code}")
+
+    except httpx.TimeoutException:
+        return Result.error("Connection timed out")
+    except Exception as e:
+        return Result.error(e)
+
+async def validate_duolingo(email: str) -> Result:
+    return await _check(email)

user_scanner-1.1.0.6/user_scanner/email_scan/other/eventbrite.py

@@ -0,0 +1,51 @@
+import httpx
+from user_scanner.core.result import Result
+
+
+async def _check(email: str) -> Result:
+    headers = {
+        'User-Agent': "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/144.0.0.0 Safari/537.36",
+        'Accept': '*/*',
+        'Accept-Language': 'en,en-US;q=0.9',
+        'Referer': 'https://www.eventbrite.com/signin/',
+        'Content-Type': 'application/json',
+        'X-Requested-With': 'XMLHttpRequest',
+        'Origin': 'https://www.eventbrite.com',
+    }
+
+    try:
+        async with httpx.AsyncClient(timeout=5.0, follow_redirects=True) as client:
+            await client.get("https://www.eventbrite.com/signin/", headers=headers)
+
+            csrf_token = client.cookies.get("csrftoken")
+            if not csrf_token:
+                return Result.error("CSRF token not found")
+
+            headers["X-CSRFToken"] = csrf_token
+            payload = {"email": email}
+
+            response = await client.post(
+                'https://www.eventbrite.com/api/v3/users/lookup/',
+                headers=headers,
+                json=payload
+            )
+
+            if response.status_code == 200:
+                data = response.json()
+                if data.get("exists") is True:
+                    return Result.taken()
+                elif data.get("exists") is False:
+                    return Result.available()
+                else:
+                    return Result.error(data)
+
+            return Result.error(f"HTTP {response.status_code}")
+
+    except httpx.TimeoutException:
+        return Result.error("Connection timed out")
+    except Exception as e:
+        return Result.error(e)
+
+
+async def validate_eventbrite(email: str) -> Result:
+    return await _check(email)

user_scanner-1.1.0.6/user_scanner/email_scan/pipeline/axonaut.py

@@ -0,0 +1,38 @@
+import httpx
+from user_scanner.core.result import Result
+
+
+async def _check(email: str) -> Result:
+    headers = {
+        'authority': 'axonaut.com',
+        'User-Agent': "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/144.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.9',
+        'referer': 'https://axonaut.com/en',
+        'accept-language': 'en-US,en;q=0.9',
+    }
+
+    try:
+        async with httpx.AsyncClient(timeout=5.0, follow_redirects=False) as client:
+            response = await client.get(
+                f'https://axonaut.com/onboarding/?email={email}',
+                headers=headers
+            )
+
+            if response.status_code == 302 and "/login?email" in response.headers.get('Location', ''):
+
+                return Result.taken()
+
+            elif response.status_code == 200:
+                return Result.available()
+
+            else:
+                return Result.error(f"HTTP {response.status_code}")
+
+    except httpx.TimeoutException:
+        return Result.error("Connection timed out")
+    except Exception as e:
+        return Result.error(str(e))
+
+
+async def validate_axonaut(email: str) -> Result:
+    return await _check(email)

user_scanner-1.1.0.6/user_scanner/email_scan/pipeline/hubspot.py

@@ -0,0 +1,52 @@
+import httpx
+from user_scanner.core.result import Result
+
+
+async def _check(email: str) -> Result:
+    headers = {
+        'authority': 'api.hubspot.com',
+        'User-Agent': "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/144.0.0.0 Safari/537.36",
+        'content-type': 'application/json',
+        'origin': 'https://app.hubspot.com',
+        'referer': 'https://app.hubspot.com/',
+        'accept-language': 'en-US,en;q=0.9',
+    }
+
+    try:
+        async with httpx.AsyncClient(timeout=5.0, follow_redirects=True) as client:
+            payload = {
+                "email": email,
+                "password": "",
+                "rememberLogin": False
+            }
+
+            response = await client.post(
+                'https://api.hubspot.com/login-api/v1/login',
+                headers=headers,
+                json=payload
+            )
+
+            # HubSpot returns 400 for both "wrong password" and "user not found"
+            if response.status_code == 400:
+                data = response.json()
+                status = data.get("status")
+
+                if status == "INVALID_PASSWORD":
+                    return Result.taken()
+
+                elif status == "INVALID_USER":
+                    return Result.available()
+
+                else:
+                    return Result.error(data)
+
+            return Result.error(f"HTTP {response.status_code}")
+
+    except httpx.TimeoutException:
+        return Result.error("Connection timed out")
+    except Exception as e:
+        return Result.error(str(e))
+
+
+async def validate_hubspot(email: str) -> Result:
+    return await _check(email)

user_scanner-1.1.0.6/user_scanner/email_scan/pipeline/insightly.py

@@ -0,0 +1,43 @@
+import httpx
+from user_scanner.core.result import Result
+
+
+async def _check(email: str) -> Result:
+    headers = {
+        'authority': 'accounts.insightly.com',
+        'accept': 'application/json, text/javascript, */*; q=0.01',
+        'x-requested-with': 'XMLHttpRequest',
+        'User-Agent': "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/144.0.0.0 Safari/537.36",
+        'content-type': 'application/x-www-form-urlencoded; charset=UTF-8',
+        'origin': 'https://accounts.insightly.com',
+        'referer': 'https://accounts.insightly.com/?plan=trial',
+        'accept-language': 'en-US,en;q=0.9',
+    }
+
+    try:
+        async with httpx.AsyncClient(timeout=5.0, follow_redirects=True) as client:
+            payload = {'emailaddress': email}
+
+            response = await client.post(
+                'https://accounts.insightly.com/signup/isemailvalid',
+                headers=headers,
+                data=payload
+            )
+
+            if "An account exists for this address." in response.text:
+                return Result.taken()
+
+            elif response.text.strip() == "true":
+                return Result.available()
+
+            else:
+                return Result.error(f"Unexpected response: {response.status_code}")
+
+    except httpx.TimeoutException:
+        return Result.error("Connection timed out")
+    except Exception as e:
+        return Result.error(str(e))
+
+
+async def validate_insightly(email: str) -> Result:
+    return await _check(email)