user-scanner 1.0.10.3__py3-none-any.whl → 1.1.0.1__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- user_scanner/__main__.py +241 -129
- user_scanner/core/email_orchestrator.py +78 -0
- user_scanner/core/formatter.py +27 -0
- user_scanner/core/helpers.py +194 -2
- user_scanner/core/orchestrator.py +24 -112
- user_scanner/core/result.py +51 -18
- user_scanner/email_scan/adult/pornhub.py +62 -0
- user_scanner/email_scan/adult/xnxx.py +46 -0
- user_scanner/email_scan/adult/xvideos.py +50 -0
- user_scanner/email_scan/community/stackoverflow.py +40 -0
- user_scanner/email_scan/creator/__init__.py +0 -0
- user_scanner/email_scan/creator/gumroad.py +82 -0
- user_scanner/email_scan/creator/patreon.py +58 -0
- user_scanner/email_scan/dev/__init__.py +0 -0
- user_scanner/email_scan/dev/bitbucket.py +33 -0
- user_scanner/email_scan/dev/github.py +72 -0
- user_scanner/email_scan/dev/huggingface.py +37 -0
- user_scanner/email_scan/gaming/__init__.py +0 -0
- user_scanner/email_scan/gaming/chess_com.py +47 -0
- user_scanner/email_scan/shopping/__init__.py +0 -0
- user_scanner/email_scan/shopping/flipkart.py +52 -0
- user_scanner/email_scan/social/__init__.py +0 -0
- user_scanner/email_scan/social/facebook.py +96 -0
- user_scanner/email_scan/social/instagram.py +48 -0
- user_scanner/email_scan/social/mastodon.py +57 -0
- user_scanner/email_scan/social/x.py +41 -0
- user_scanner/user_scan/community/lemmy.py +30 -0
- user_scanner/user_scan/creator/__init__.py +0 -0
- user_scanner/user_scan/creator/gumroad.py +22 -0
- user_scanner/user_scan/donation/__init__.py +0 -0
- user_scanner/user_scan/gaming/__init__.py +0 -0
- user_scanner/{gaming → user_scan/gaming}/roblox.py +15 -5
- user_scanner/version.json +1 -1
- user_scanner-1.1.0.1.dist-info/METADATA +239 -0
- user_scanner-1.1.0.1.dist-info/RECORD +98 -0
- user_scanner/cli/printer.py +0 -117
- user_scanner-1.0.10.3.dist-info/METADATA +0 -172
- user_scanner-1.0.10.3.dist-info/RECORD +0 -72
- /user_scanner/{creator → email_scan}/__init__.py +0 -0
- /user_scanner/{donation → email_scan/adult}/__init__.py +0 -0
- /user_scanner/{gaming → email_scan/community}/__init__.py +0 -0
- /user_scanner/{community → user_scan/community}/__init__.py +0 -0
- /user_scanner/{community → user_scan/community}/coderlegion.py +0 -0
- /user_scanner/{community → user_scan/community}/hackernews.py +0 -0
- /user_scanner/{community → user_scan/community}/stackoverflow.py +0 -0
- /user_scanner/{creator → user_scan/creator}/devto.py +0 -0
- /user_scanner/{creator → user_scan/creator}/hashnode.py +0 -0
- /user_scanner/{creator → user_scan/creator}/itch_io.py +0 -0
- /user_scanner/{creator → user_scan/creator}/kaggle.py +0 -0
- /user_scanner/{creator → user_scan/creator}/medium.py +0 -0
- /user_scanner/{creator → user_scan/creator}/patreon.py +0 -0
- /user_scanner/{creator → user_scan/creator}/producthunt.py +0 -0
- /user_scanner/{creator → user_scan/creator}/substack.py +0 -0
- /user_scanner/{creator → user_scan/creator}/twitch.py +0 -0
- /user_scanner/{dev → user_scan/dev}/__init__.py +0 -0
- /user_scanner/{dev → user_scan/dev}/bitbucket.py +0 -0
- /user_scanner/{dev → user_scan/dev}/codeberg.py +0 -0
- /user_scanner/{dev → user_scan/dev}/cratesio.py +0 -0
- /user_scanner/{dev → user_scan/dev}/dockerhub.py +0 -0
- /user_scanner/{dev → user_scan/dev}/github.py +0 -0
- /user_scanner/{dev → user_scan/dev}/gitlab.py +0 -0
- /user_scanner/{dev → user_scan/dev}/huggingface.py +0 -0
- /user_scanner/{dev → user_scan/dev}/launchpad.py +0 -0
- /user_scanner/{dev → user_scan/dev}/leetcode.py +0 -0
- /user_scanner/{dev → user_scan/dev}/npmjs.py +0 -0
- /user_scanner/{dev → user_scan/dev}/replit.py +0 -0
- /user_scanner/{dev → user_scan/dev}/sourceforge.py +0 -0
- /user_scanner/{donation → user_scan/donation}/buymeacoffee.py +0 -0
- /user_scanner/{donation → user_scan/donation}/liberapay.py +0 -0
- /user_scanner/{gaming → user_scan/gaming}/chess_com.py +0 -0
- /user_scanner/{gaming → user_scan/gaming}/lichess.py +0 -0
- /user_scanner/{gaming → user_scan/gaming}/minecraft.py +0 -0
- /user_scanner/{gaming → user_scan/gaming}/monkeytype.py +0 -0
- /user_scanner/{gaming → user_scan/gaming}/osu.py +0 -0
- /user_scanner/{gaming → user_scan/gaming}/steam.py +0 -0
- /user_scanner/{social → user_scan/social}/__init__.py +0 -0
- /user_scanner/{social → user_scan/social}/bluesky.py +0 -0
- /user_scanner/{social → user_scan/social}/discord.py +0 -0
- /user_scanner/{social → user_scan/social}/instagram.py +0 -0
- /user_scanner/{social → user_scan/social}/mastodon.py +0 -0
- /user_scanner/{social → user_scan/social}/pinterest.py +0 -0
- /user_scanner/{social → user_scan/social}/reddit.py +0 -0
- /user_scanner/{social → user_scan/social}/snapchat.py +0 -0
- /user_scanner/{social → user_scan/social}/soundcloud.py +0 -0
- /user_scanner/{social → user_scan/social}/telegram.py +0 -0
- /user_scanner/{social → user_scan/social}/threads.py +0 -0
- /user_scanner/{social → user_scan/social}/tiktok.py +0 -0
- /user_scanner/{social → user_scan/social}/x.py +0 -0
- /user_scanner/{social → user_scan/social}/youtube.py +0 -0
- {user_scanner-1.0.10.3.dist-info → user_scanner-1.1.0.1.dist-info}/WHEEL +0 -0
- {user_scanner-1.0.10.3.dist-info → user_scanner-1.1.0.1.dist-info}/entry_points.txt +0 -0
- {user_scanner-1.0.10.3.dist-info → user_scanner-1.1.0.1.dist-info}/licenses/LICENSE +0 -0
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
import httpx
|
|
2
|
+
import re
|
|
3
|
+
from user_scanner.core.result import Result
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
async def _check(email):
|
|
7
|
+
base_url = "https://mastodon.social"
|
|
8
|
+
signup_url = f"{base_url}/auth/sign_up"
|
|
9
|
+
post_url = f"{base_url}/auth"
|
|
10
|
+
|
|
11
|
+
headers = {
|
|
12
|
+
"user-agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/143.0.0.0 Safari/537.36",
|
|
13
|
+
"accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8",
|
|
14
|
+
"referer": "https://mastodon.social/explore",
|
|
15
|
+
"origin": "https://mastodon.social"
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
async with httpx.AsyncClient(http2=True, headers=headers, follow_redirects=False) as client:
|
|
19
|
+
try:
|
|
20
|
+
initial_resp = await client.get(signup_url)
|
|
21
|
+
if initial_resp.status_code != 200:
|
|
22
|
+
return Result.error(f"Failed to access signup page: {initial_resp.status_code}")
|
|
23
|
+
|
|
24
|
+
token_match = re.search(
|
|
25
|
+
r'name="csrf-token" content="([^"]+)"', initial_resp.text)
|
|
26
|
+
if not token_match:
|
|
27
|
+
return Result.error("Could not find authenticity token")
|
|
28
|
+
|
|
29
|
+
csrf_token = token_match.group(1)
|
|
30
|
+
|
|
31
|
+
payload = {
|
|
32
|
+
"authenticity_token": csrf_token,
|
|
33
|
+
"user[account_attributes][username]": "no3motions_robot_020102",
|
|
34
|
+
"user[email]": email,
|
|
35
|
+
"user[password]": "Theleftalone@me",
|
|
36
|
+
"user[password_confirmation]": "Theleftalone@me",
|
|
37
|
+
"user[agreement]": "1",
|
|
38
|
+
"button": ""
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
response = await client.post(post_url, data=payload)
|
|
42
|
+
res_text = response.text
|
|
43
|
+
res_status = response.status_code
|
|
44
|
+
if "has already been taken" in res_text:
|
|
45
|
+
return Result.taken()
|
|
46
|
+
elif "has already been taken" not in res_text and res_status == 200:
|
|
47
|
+
return Result.available()
|
|
48
|
+
elif res_status == 429:
|
|
49
|
+
return Result.error("Rate limited, use '-d' flag to avoid bot detection")
|
|
50
|
+
else:
|
|
51
|
+
return Result.error("Unexpected error, report it via GitHub issues")
|
|
52
|
+
except Exception as e:
|
|
53
|
+
return Result.error(e)
|
|
54
|
+
|
|
55
|
+
|
|
56
|
+
async def validate_mastodon(email: str) -> Result:
|
|
57
|
+
return await _check(email)
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
import httpx
|
|
2
|
+
from user_scanner.core.result import Result
|
|
3
|
+
|
|
4
|
+
async def _check(email):
|
|
5
|
+
url = "https://api.x.com/i/users/email_available.json"
|
|
6
|
+
params = {"email": email}
|
|
7
|
+
headers = {
|
|
8
|
+
"user-agent": "Mozilla/5.0 (Linux; Android 10; K) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/143.0.0.0 Mobile Safari/537.36",
|
|
9
|
+
"accept-encoding": "gzip, deflate, br, zstd",
|
|
10
|
+
"sec-ch-ua-platform": "\"Android\"",
|
|
11
|
+
"sec-ch-ua": "\"Google Chrome\";v=\"143\", \"Chromium\";v=\"143\", \"Not A(Brand\";v=\"24\"",
|
|
12
|
+
"x-twitter-client-language": "en",
|
|
13
|
+
"sec-ch-ua-mobile": "?1",
|
|
14
|
+
"x-twitter-active-user": "yes",
|
|
15
|
+
"origin": "https://x.com",
|
|
16
|
+
"priority": "u=1, i"
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
async with httpx.AsyncClient(http2=True) as client:
|
|
20
|
+
try:
|
|
21
|
+
response = await client.get(url, params=params, headers=headers)
|
|
22
|
+
|
|
23
|
+
if response.status_code == 429:
|
|
24
|
+
return Result.error("Rate limited wait for few minutes or use '-d' flag")
|
|
25
|
+
|
|
26
|
+
data = response.json()
|
|
27
|
+
taken_bool = data.get("taken")
|
|
28
|
+
|
|
29
|
+
if taken_bool is True:
|
|
30
|
+
return Result.taken()
|
|
31
|
+
elif taken_bool is False:
|
|
32
|
+
return Result.available()
|
|
33
|
+
else:
|
|
34
|
+
return Result.error("Unexpected error, report it via GitHub issues")
|
|
35
|
+
|
|
36
|
+
except Exception as e:
|
|
37
|
+
return Result.error(e)
|
|
38
|
+
|
|
39
|
+
|
|
40
|
+
async def validate_x(email: str) -> Result:
|
|
41
|
+
return await _check(email)
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
import re
|
|
2
|
+
from user_scanner.core.orchestrator import status_validate
|
|
3
|
+
from user_scanner.core.result import Result
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
def validate_lemmy(user: str) -> Result:
|
|
7
|
+
"""Check username availability on Lemmy (lemmy.world instance)"""
|
|
8
|
+
|
|
9
|
+
# Lemmy username rules: 3-20 chars, alphanumeric and underscores only
|
|
10
|
+
if not (3 <= len(user) <= 20):
|
|
11
|
+
return Result.error("Length must be 3-20 characters")
|
|
12
|
+
|
|
13
|
+
if not re.match(r'^[a-zA-Z0-9_]+$', user):
|
|
14
|
+
return Result.error("Only letters, numbers, and underscores allowed")
|
|
15
|
+
|
|
16
|
+
url = f"https://lemmy.world/api/v3/user?username={user}"
|
|
17
|
+
|
|
18
|
+
return status_validate(url, [400, 404], 200, timeout=5.0)
|
|
19
|
+
|
|
20
|
+
|
|
21
|
+
if __name__ == "__main__":
|
|
22
|
+
user = input("Username?: ").strip()
|
|
23
|
+
result = validate_lemmy(user)
|
|
24
|
+
|
|
25
|
+
if result == 1:
|
|
26
|
+
print("Available!")
|
|
27
|
+
elif result == 0:
|
|
28
|
+
print("Unavailable!")
|
|
29
|
+
else:
|
|
30
|
+
print(f"Error occurred! Reason: {result.get_reason()}")
|
|
File without changes
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import re
|
|
2
|
+
from user_scanner.core.orchestrator import status_validate, Result
|
|
3
|
+
|
|
4
|
+
def validate_gumroad(user: str) -> Result:
|
|
5
|
+
if not re.fullmatch(r"[a-z0-9]{3,20}", user):
|
|
6
|
+
return Result.error("Username must be between 3 and 20 lowercase alphanumeric characters")
|
|
7
|
+
|
|
8
|
+
url = f"https://{user}.gumroad.com/"
|
|
9
|
+
return status_validate(url, 404, 200, follow_redirects=True)
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
if __name__ == "__main__":
|
|
13
|
+
user = input("Username?: ").strip()
|
|
14
|
+
result = validate_gumroad(user)
|
|
15
|
+
|
|
16
|
+
if result == 1:
|
|
17
|
+
print("Available!")
|
|
18
|
+
elif result == 0:
|
|
19
|
+
print("Unavailable!")
|
|
20
|
+
else:
|
|
21
|
+
print(f"Error occurred! Reason: {result.get_reason()}")
|
|
22
|
+
|
|
File without changes
|
|
File without changes
|
|
@@ -1,8 +1,8 @@
|
|
|
1
|
-
from user_scanner.core.orchestrator import generic_validate
|
|
1
|
+
from user_scanner.core.orchestrator import generic_validate, status_validate
|
|
2
2
|
from user_scanner.core.result import Result
|
|
3
3
|
|
|
4
4
|
|
|
5
|
-
def validate_roblox(user):
|
|
5
|
+
def validate_roblox(user: str) -> Result:
|
|
6
6
|
# official api
|
|
7
7
|
url = f"https://users.roblox.com/v1/users/search?keyword={user}&limit=10"
|
|
8
8
|
|
|
@@ -13,12 +13,13 @@ def validate_roblox(user):
|
|
|
13
13
|
return Result.error("Too many requests")
|
|
14
14
|
|
|
15
15
|
if response.status_code == 400:
|
|
16
|
-
|
|
16
|
+
# Api states theres always an error
|
|
17
|
+
error = search_results["errors"][0]
|
|
17
18
|
if error["code"] == 6:
|
|
18
19
|
return Result.error("Username is too short")
|
|
19
20
|
if error["code"] == 5:
|
|
20
21
|
return Result.error("Username was filtered")
|
|
21
|
-
#Shouldn't be able to reach this
|
|
22
|
+
# Shouldn't be able to reach this
|
|
22
23
|
return Result.error("Invalid username")
|
|
23
24
|
|
|
24
25
|
# iterates through the entries in the search results
|
|
@@ -28,7 +29,16 @@ def validate_roblox(user):
|
|
|
28
29
|
return Result.taken()
|
|
29
30
|
return Result.available()
|
|
30
31
|
|
|
31
|
-
|
|
32
|
+
# First try: Using roblox's API
|
|
33
|
+
result = generic_validate(url, process, follow_redirects=True)
|
|
34
|
+
|
|
35
|
+
if result.get_reason() != "Too many requests":
|
|
36
|
+
return result
|
|
37
|
+
|
|
38
|
+
# If rate limited, uses a simple status validation
|
|
39
|
+
url = f"https://www.roblox.com/user.aspx?username={user}"
|
|
40
|
+
|
|
41
|
+
return status_validate(url, 404, [200, 302], follow_redirects=True)
|
|
32
42
|
|
|
33
43
|
|
|
34
44
|
if __name__ == "__main__":
|
user_scanner/version.json
CHANGED
|
@@ -0,0 +1,239 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: user-scanner
|
|
3
|
+
Version: 1.1.0.1
|
|
4
|
+
Summary: Check username availability across multiple popular platforms
|
|
5
|
+
Keywords: username,checker,availability,social,tech,python,user-scanner
|
|
6
|
+
Author-email: Kaif <kafcodec@gmail.com>
|
|
7
|
+
Requires-Python: >=3.10
|
|
8
|
+
Description-Content-Type: text/markdown
|
|
9
|
+
License-File: LICENSE
|
|
10
|
+
Requires-Dist: httpx[http2]>=0.27,<0.29
|
|
11
|
+
Requires-Dist: socksio>=1.0,<2
|
|
12
|
+
Requires-Dist: colorama>=0.4,<1
|
|
13
|
+
Project-URL: Homepage, https://github.com/kaifcodec/user-scanner
|
|
14
|
+
|
|
15
|
+
# User Scanner
|
|
16
|
+
|
|
17
|
+

|
|
18
|
+
<p align="center">
|
|
19
|
+
<img src="https://img.shields.io/badge/Version-1.1.0.1-blueviolet?style=for-the-badge&logo=github" />
|
|
20
|
+
<img src="https://img.shields.io/github/issues/kaifcodec/user-scanner?style=for-the-badge&logo=github" />
|
|
21
|
+
<img src="https://img.shields.io/badge/Tested%20on-Termux-black?style=for-the-badge&logo=termux" />
|
|
22
|
+
<img src="https://img.shields.io/badge/Tested%20on-Windows-cyan?style=for-the-badge&logo=Windows" />
|
|
23
|
+
<img src="https://img.shields.io/badge/Tested%20on-Linux-balck?style=for-the-badge&logo=Linux" />
|
|
24
|
+
<img src="https://img.shields.io/pepy/dt/user-scanner?style=for-the-badge" />
|
|
25
|
+
</p>
|
|
26
|
+
|
|
27
|
+
---
|
|
28
|
+
|
|
29
|
+
### ⚠️ Email OSINT mode had not been implemented yet, still in progress
|
|
30
|
+
|
|
31
|
+
A powerful *Email OSINT tool* that checks if a specific email is registered on various sites, combined with *username scanning* for branding or OSINT — 2-in-1 tool.
|
|
32
|
+
|
|
33
|
+
Perfect for fast, accurate and lightweight email OSINT
|
|
34
|
+
|
|
35
|
+
Perfect for finding a **unique username** across GitHub, Twitter, Reddit, Instagram, and more, all in a single command.
|
|
36
|
+
|
|
37
|
+
## Features
|
|
38
|
+
|
|
39
|
+
- ✅ Check an email across multiple sites to see if it’s registered.
|
|
40
|
+
- ✅ Scan usernames across **social networks**, **developer platforms**, **creator communities**, and more.
|
|
41
|
+
- ✅ Can be used purely as a username tool.
|
|
42
|
+
- ✅ Smart auto-update system detects new releases on PyPI and prompts the user to upgrade interactively.
|
|
43
|
+
- ✅ Clear `Registered` and `Not Registered` for email scanning `Available` / `Taken` / `Error` output for username scans
|
|
44
|
+
- ✅ Robust error handling: displays the exact reason a username or email cannot be used (e.g., underscores or hyphens at the start/end).
|
|
45
|
+
- ✅ Fully modular: easily add new platform modules.
|
|
46
|
+
- ✅ Wildcard-based username permutations for automatic variation generation using a provided suffix.
|
|
47
|
+
- ✅ Option to select results format (**JSON**, **CSV**, console).
|
|
48
|
+
- ✅ Save scanning and OSINT results in the preferred format and output file (ideal for power users).
|
|
49
|
+
- ✅ Command-line interface ready: works immediately after `pip install`.
|
|
50
|
+
- ✅ Lightweight with minimal dependencies; runs on any machine.
|
|
51
|
+
- ✅ **Proxy support** with round-robin rotation
|
|
52
|
+
- ✅ **Proxy validation** to test and filter working proxies before scanning
|
|
53
|
+
- ✅ **Bulk username scanning** from file support for checking multiple usernames at once
|
|
54
|
+
- ✅ **Bulk email scanning** from file support for checking multiple emails at once
|
|
55
|
+
---
|
|
56
|
+
|
|
57
|
+
## Installation
|
|
58
|
+
|
|
59
|
+
```bash
|
|
60
|
+
pip install user-scanner
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
---
|
|
64
|
+
|
|
65
|
+
## Important Flags
|
|
66
|
+
|
|
67
|
+
| Flag | Description |
|
|
68
|
+
|------|-------------|
|
|
69
|
+
| `-u, --username USERNAME` | Scan a single username across platforms |
|
|
70
|
+
| `-e, --email EMAIL` | Scan a single email across platforms |
|
|
71
|
+
| `-uf, --username-file FILE` | Scan multiple usernames from file (one per line) |
|
|
72
|
+
| `-ef, --email-file FILE` | Scan multiple emails from file (one per line) |
|
|
73
|
+
| `-c, --category CATEGORY` | Scan all platforms in a specific category |
|
|
74
|
+
| `-lu, --list-user` | List all available modules for username scanning |
|
|
75
|
+
| `-le, --list-email` | List all available modules for email scanning |
|
|
76
|
+
| `-m, --module MODULE` | Scan a single specific module |
|
|
77
|
+
| `-p, --permute PERMUTE` | Generate username permutations using a pattern/suffix |
|
|
78
|
+
| `-P, --proxy-file FILE` | Use proxies from file (one per line) |
|
|
79
|
+
| `--validate-proxies` | Validate proxies before scanning (tests against google.com) |
|
|
80
|
+
| `-s, --stop STOP` | Limit the number of permutations generated |
|
|
81
|
+
| `-d, --delay DELAY` | Delay (in seconds) between requests |
|
|
82
|
+
| `-f, --format {csv,json}` | Select output format |
|
|
83
|
+
| `-o, --output OUTPUT` | Save results to a file |
|
|
84
|
+
|
|
85
|
+
---
|
|
86
|
+
|
|
87
|
+
## Usage
|
|
88
|
+
|
|
89
|
+
### Basic username/email scan
|
|
90
|
+
|
|
91
|
+
Scan a single username across **all** available modules/platforms:
|
|
92
|
+
|
|
93
|
+
```bash
|
|
94
|
+
user-scanner -e john_doe@gmail.com
|
|
95
|
+
user-scanner --email john_doe@gmail.com # long version
|
|
96
|
+
|
|
97
|
+
user-scanner -u john_doe
|
|
98
|
+
user-scanner --username john_doe # long version
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
### Selective scanning
|
|
102
|
+
|
|
103
|
+
Scan only specific categories or single modules:
|
|
104
|
+
|
|
105
|
+
```bash
|
|
106
|
+
user-scanner -u john_doe -c dev # developer platforms only
|
|
107
|
+
user-scanner -u john_doe -m github # only GitHub
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
### Bulk username scanning
|
|
111
|
+
|
|
112
|
+
Scan multiple usernames from a file (one username per line):
|
|
113
|
+
- Can also be combined with categories or modules using `-c` and `-m` flags
|
|
114
|
+
|
|
115
|
+
```bash
|
|
116
|
+
user-scanner -uf usernames.txt
|
|
117
|
+
```
|
|
118
|
+
|
|
119
|
+
|
|
120
|
+
### Bulk email scanning
|
|
121
|
+
|
|
122
|
+
Scan multiple emails from a file (one email per line):
|
|
123
|
+
- Can also be combined with categories or modules using `-c` and `-m` flags
|
|
124
|
+
|
|
125
|
+
```bash
|
|
126
|
+
user-scanner -ef emails.txt
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
### Username/Email variations (suffix only)
|
|
130
|
+
|
|
131
|
+
Generate & check username variations using a permutation from the given suffix:
|
|
132
|
+
|
|
133
|
+
```bash
|
|
134
|
+
user-scanner -u john_ -p ab # john_a, ..., john_ab, john_ba
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
### Using Proxies
|
|
138
|
+
|
|
139
|
+
Route requests through proxy servers:
|
|
140
|
+
|
|
141
|
+
```bash
|
|
142
|
+
user-scanner -u john_doe -P proxies.txt
|
|
143
|
+
```
|
|
144
|
+
|
|
145
|
+
Validate proxies before scanning (tests each proxy against google.com):
|
|
146
|
+
|
|
147
|
+
```bash
|
|
148
|
+
user-scanner -u john_doe -P proxies.txt --validate-proxies # recommended
|
|
149
|
+
```
|
|
150
|
+
|
|
151
|
+
This will:
|
|
152
|
+
1. Test all proxies from the file
|
|
153
|
+
2. Filter out non-working proxies
|
|
154
|
+
3. Save working proxies to `validated_proxies.txt`
|
|
155
|
+
4. Use only validated proxies for scanning
|
|
156
|
+
|
|
157
|
+
---
|
|
158
|
+
|
|
159
|
+
### Update
|
|
160
|
+
|
|
161
|
+
Update the tool to the latest PyPI version:
|
|
162
|
+
|
|
163
|
+
```bash
|
|
164
|
+
user-scanner -U
|
|
165
|
+
```
|
|
166
|
+
---
|
|
167
|
+
|
|
168
|
+
## Screenshot:
|
|
169
|
+
|
|
170
|
+
- Note*: New modules are constantly getting added so this might have only limited, outdated output:
|
|
171
|
+
|
|
172
|
+
<img width="1072" height="848" alt="user-scanner's main usage screenshot" src="https://github.com/user-attachments/assets/34e44ca6-e314-419e-9035-d951b493b47f" />
|
|
173
|
+
|
|
174
|
+
|
|
175
|
+
|
|
176
|
+
---
|
|
177
|
+
|
|
178
|
+
<img width="1080" height="352" alt="user-scanner's wildcard username feature" src="https://github.com/user-attachments/assets/578b248c-2a05-4917-aab3-6372a7c28045" />
|
|
179
|
+
|
|
180
|
+
|
|
181
|
+
---
|
|
182
|
+
|
|
183
|
+
## Contributing
|
|
184
|
+
|
|
185
|
+
Modules are organized under `user_scanner/`:
|
|
186
|
+
|
|
187
|
+
```
|
|
188
|
+
user_scanner/
|
|
189
|
+
├── email_scan/ # Currently in development
|
|
190
|
+
│ ├── social/ # Social email scan modules (Instagram, Mastodon, X, etc.)
|
|
191
|
+
| ├── adult/ # Adult sites
|
|
192
|
+
| ... # New sites to be added soon
|
|
193
|
+
├── user_scan/
|
|
194
|
+
│ ├── dev/ # Developer platforms (GitHub, GitLab, npm, etc.)
|
|
195
|
+
│ ├── social/ # Social platforms (Twitter/X, Reddit, Instagram, Discord, etc.)
|
|
196
|
+
│ ├── creator/ # Creator platforms (Hashnode, Dev.to, Medium, Patreon, etc.)
|
|
197
|
+
│ ├── community/ # Community platforms (forums, StackOverflow, HackerNews, etc.)
|
|
198
|
+
│ ├── gaming/ # Gaming sites (chess.com, Lichess, Roblox, Minecraft, etc.)
|
|
199
|
+
│ └── donation/ # Donation platforms (BuyMeACoffee, Liberapay)
|
|
200
|
+
|...
|
|
201
|
+
```
|
|
202
|
+
|
|
203
|
+
**Module guidelines:**
|
|
204
|
+
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`).
|
|
205
|
+
|
|
206
|
+
Result semantics:
|
|
207
|
+
- Result.available() → `available`
|
|
208
|
+
- Result.taken() → `taken`
|
|
209
|
+
- Result.error(message: Optional[str]) → `error`, blocked, unknown, or request failure (include short diagnostic message when helpful)
|
|
210
|
+
|
|
211
|
+
Follow this document when adding or updating validators.
|
|
212
|
+
|
|
213
|
+
See [CONTRIBUTING.md](CONTRIBUTING.md) for examples.
|
|
214
|
+
|
|
215
|
+
---
|
|
216
|
+
|
|
217
|
+
## Dependencies:
|
|
218
|
+
- [httpx](https://pypi.org/project/httpx/)
|
|
219
|
+
- [colorama](https://pypi.org/project/colorama/)
|
|
220
|
+
|
|
221
|
+
---
|
|
222
|
+
|
|
223
|
+
## License
|
|
224
|
+
|
|
225
|
+
This project is licensed under the **MIT License**. See [LICENSE](LICENSE) for details.
|
|
226
|
+
|
|
227
|
+
|
|
228
|
+
---
|
|
229
|
+
|
|
230
|
+
## Star History
|
|
231
|
+
|
|
232
|
+
<a href="https://www.star-history.com/#kaifcodec/user-scanner&type=date&legend=top-left">
|
|
233
|
+
<picture>
|
|
234
|
+
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=kaifcodec/user-scanner&type=date&theme=dark&legend=top-left" />
|
|
235
|
+
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=kaifcodec/user-scanner&type=date&legend=top-left" />
|
|
236
|
+
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=kaifcodec/user-scanner&type=date&legend=top-left" />
|
|
237
|
+
</picture>
|
|
238
|
+
</a>
|
|
239
|
+
|
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
user_scanner/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
|
2
|
+
user_scanner/__main__.py,sha256=upuAt-VZO08YzaA4paD7ArUy2S2K12wdTqlNxn107eY,10762
|
|
3
|
+
user_scanner/config.json,sha256=WtVnrpPxhGUBmx_dBShO3R0NnipVBVz3BfzlEPO5Amc,28
|
|
4
|
+
user_scanner/version.json,sha256=qPO6w95jVdDx0X8YsZd9W4mBunJRM3ygchXw7ESU4VY,49
|
|
5
|
+
user_scanner/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
|
6
|
+
user_scanner/cli/banner.py,sha256=3b4PIggnJrmxF4DfbuPMqSavpwNl0m5uedaOL2SXN3o,766
|
|
7
|
+
user_scanner/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
|
8
|
+
user_scanner/core/email_orchestrator.py,sha256=EMQGqvk4GqaXQqCSTOYdveRuu63bLf71r6TTrfSrups,2368
|
|
9
|
+
user_scanner/core/formatter.py,sha256=CMwyR6PuP15HqyS6oWe40ye_4dne14lrIj7_5T7rla4,725
|
|
10
|
+
user_scanner/core/helpers.py,sha256=g_WMbEJvT98TA4Db9c-LPIDl6ExjLQ1dSE3cIyKRUos,6406
|
|
11
|
+
user_scanner/core/orchestrator.py,sha256=OLC4JmBJm1ZzwsDUt6Kqtcc2BENs3fP0iqbTT1nS3KU,4460
|
|
12
|
+
user_scanner/core/result.py,sha256=3jd3CNciuJCtdh9P3SL7WW3x7cuDoyJOlq7WhgRivJA,4751
|
|
13
|
+
user_scanner/core/version.py,sha256=k1_KTZdRLKBAxp8_PtOhTAtj8mBO_AUnUGdqI4epypY,855
|
|
14
|
+
user_scanner/email_scan/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
|
15
|
+
user_scanner/email_scan/adult/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
|
16
|
+
user_scanner/email_scan/adult/pornhub.py,sha256=8OF-0h_FntUv1Pi0eT801Bhn6Uhd1dh_fD4lfbKV6OY,2134
|
|
17
|
+
user_scanner/email_scan/adult/xnxx.py,sha256=WiKn4Vkc5FC1HXry9N8SN-dsTdm1qq0NS6KUcPRmMMY,1728
|
|
18
|
+
user_scanner/email_scan/adult/xvideos.py,sha256=tx0PZOZ66KHDmrnvd1RABCnqCUIdKfCPgAbogBtX69A,1769
|
|
19
|
+
user_scanner/email_scan/community/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
|
20
|
+
user_scanner/email_scan/community/stackoverflow.py,sha256=Eq3kTXohmp2XodVLaR8ujWWCTjkTm1HXy-Yew4LzOGA,1608
|
|
21
|
+
user_scanner/email_scan/creator/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
|
22
|
+
user_scanner/email_scan/creator/gumroad.py,sha256=wJfY_CPT2aiGShuL73XYPw_Oni7sEYn8nQ7avc0mrJg,3354
|
|
23
|
+
user_scanner/email_scan/creator/patreon.py,sha256=1A3tPNAyQ6WDLU_XY6PJUYe4FIVWzlALyEgOWzlZ-bE,1904
|
|
24
|
+
user_scanner/email_scan/dev/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
|
25
|
+
user_scanner/email_scan/dev/bitbucket.py,sha256=oR_fSug_Aft4fy8Lu8r0VO737b8ZlfcC_D3GMbcUF0k,1352
|
|
26
|
+
user_scanner/email_scan/dev/github.py,sha256=JBSSN9kv3IQxKG0tmemUdSHwfQDu53dHC4i9oCwDqow,3160
|
|
27
|
+
user_scanner/email_scan/dev/huggingface.py,sha256=GjFNkuVZ_8eFgs9OrFakhiEb8pVRwEJO-tyx32IQMns,1229
|
|
28
|
+
user_scanner/email_scan/gaming/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
|
29
|
+
user_scanner/email_scan/gaming/chess_com.py,sha256=EJF3OTxYtzDC-F4OAVfT0mRWUopmNZdwdYChw97VpE4,1841
|
|
30
|
+
user_scanner/email_scan/shopping/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
|
31
|
+
user_scanner/email_scan/shopping/flipkart.py,sha256=wMQJ1VIawhM6W0UQCThcIUtaYN7QeexvJSRSeXS4l04,1879
|
|
32
|
+
user_scanner/email_scan/social/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
|
33
|
+
user_scanner/email_scan/social/facebook.py,sha256=dnCDZfqRYLXDT7GjJQ-bSqGfC-rO8G9O7pu8dUse7Nw,4475
|
|
34
|
+
user_scanner/email_scan/social/instagram.py,sha256=qGDub3d4pSY_KW4aNYDQOGVNSrmWQkZWMHadCFkDa64,2022
|
|
35
|
+
user_scanner/email_scan/social/mastodon.py,sha256=F4E1kJ6148N3C66uFvJu_fhx7r7LcMau6wDIkdRbxlM,2294
|
|
36
|
+
user_scanner/email_scan/social/x.py,sha256=WoHaecbR1qGte-mwyODsY0YGNf-iRZyGS7s9fw0SQgg,1475
|
|
37
|
+
user_scanner/user_scan/community/__init__.py,sha256=5EzlM991pJqvqIRc05_QV5BureJZ7wiCRm1AyEY6pms,12
|
|
38
|
+
user_scanner/user_scan/community/coderlegion.py,sha256=W_bdjzdFPRgUrNFFlylvToSJ4AzaFCtTsUy_MRVDdSo,451
|
|
39
|
+
user_scanner/user_scan/community/hackernews.py,sha256=lKVuEVoGnXWYSANcuUyiSHzUr-VtcXHC7sEX1rxZi0Y,1068
|
|
40
|
+
user_scanner/user_scan/community/lemmy.py,sha256=IURvkdxbqt4riyGEFO2vC3RxcyyC2g1E8Gx-5GJJUaY,927
|
|
41
|
+
user_scanner/user_scan/community/stackoverflow.py,sha256=MTL8O0TLHkjVbugBh1pLxELJLU3hkX_YEHjGjaKTJi4,1007
|
|
42
|
+
user_scanner/user_scan/creator/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
|
43
|
+
user_scanner/user_scan/creator/devto.py,sha256=mIACmG1a4eoctywxb5p04sI0YVi3dsjCRw9YVOFBEKQ,435
|
|
44
|
+
user_scanner/user_scan/creator/gumroad.py,sha256=OA5IvzNQImcm4rDg8E_WLbrXarC0XBQLe60_1F05j5c,658
|
|
45
|
+
user_scanner/user_scan/creator/hashnode.py,sha256=3RRkVgU7t26-F4ZqjfnC_lwnP7DWwygq6kT2Q4kKw2M,1390
|
|
46
|
+
user_scanner/user_scan/creator/itch_io.py,sha256=2a8UVh-_OaWQPcSUHUuijDGpWDxsR8DoCcU1BdTRqqs,854
|
|
47
|
+
user_scanner/user_scan/creator/kaggle.py,sha256=QaXIG02OGxvQZEvwHm50RKNd7joxGOq0Ht3cFfrYEiU,445
|
|
48
|
+
user_scanner/user_scan/creator/medium.py,sha256=zHU5h2VQwde1P4XihQpV7ww2P_fgGKgWZ_S0_4TTyUI,1648
|
|
49
|
+
user_scanner/user_scan/creator/patreon.py,sha256=g-r85pxirf0ihK3STyGYPIzp59MB7JH64Opb4wq1fyU,461
|
|
50
|
+
user_scanner/user_scan/creator/producthunt.py,sha256=wb7b3hsa2Er-IQTfNFRBnU7KV5EqW_KRhL5pFvuCY88,1227
|
|
51
|
+
user_scanner/user_scan/creator/substack.py,sha256=tisTUQmauteYZOZ0tULp9GGUuf4ZBEcpqv4ZmEvjyK0,1288
|
|
52
|
+
user_scanner/user_scan/creator/twitch.py,sha256=blsh5sMT7miF5-xqVXYLieTILzkop2PsWqv9HhP8G40,2509
|
|
53
|
+
user_scanner/user_scan/dev/__init__.py,sha256=qUR0eLwN-gO6oKk-1cmCVT4G_AxUHHMgpV3wJ7URXi4,7
|
|
54
|
+
user_scanner/user_scan/dev/bitbucket.py,sha256=qAIlFCmMaNTUx2-a5wJKHjbQjERcJt0zKHJmjLAeXr4,876
|
|
55
|
+
user_scanner/user_scan/dev/codeberg.py,sha256=Z6nV0_8xZhMiCcNn9Hn79VVh6y0ar9fqL7KS2b7IaDo,447
|
|
56
|
+
user_scanner/user_scan/dev/cratesio.py,sha256=mJnlLJoMLlQ7f_95QD7LgH1xCj-e6FooOFkpYypBfG4,724
|
|
57
|
+
user_scanner/user_scan/dev/dockerhub.py,sha256=sPEnomGiPM2mKv2HsA-9WxaXHjzz21A6ox3IXK1etLc,643
|
|
58
|
+
user_scanner/user_scan/dev/github.py,sha256=9Q4G84WTAeWfNliApKdRFl1MJLfHvDPJ09mwr8P1ePo,1702
|
|
59
|
+
user_scanner/user_scan/dev/gitlab.py,sha256=kMDSd74XbofmJocfS4Fd9DxPryIHBMek3N_5c7Z_AJQ,1351
|
|
60
|
+
user_scanner/user_scan/dev/huggingface.py,sha256=hDanOZ45LeUg3hrN0CYrBnBnLqHCYtOWS0_HCvAbmDw,454
|
|
61
|
+
user_scanner/user_scan/dev/launchpad.py,sha256=N58ioX_dEHq2uwyyGrWnDKWwbqK9_RiuBQ1uWR5cDfg,799
|
|
62
|
+
user_scanner/user_scan/dev/leetcode.py,sha256=PTJcgp1W3fzLDK_Jy_VvRjKnLftLYMJaw3kfMjHqt9c,1246
|
|
63
|
+
user_scanner/user_scan/dev/npmjs.py,sha256=k-DhFqGJWDoQ79EzR8hmVrJk07AfJfPUWnIYuKc2G6w,713
|
|
64
|
+
user_scanner/user_scan/dev/replit.py,sha256=SI_i2l4w9tm2kBX4-cONBAT8dSynXoGEP4zcU8ngnh0,442
|
|
65
|
+
user_scanner/user_scan/dev/sourceforge.py,sha256=Kt8MmpCgB1tNwYRI9PYOZzIrL1VfnpzeNC43DcbZlbI,850
|
|
66
|
+
user_scanner/user_scan/donation/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
|
67
|
+
user_scanner/user_scan/donation/buymeacoffee.py,sha256=86LGyChv_UKQFp2D7nIoK1B-FCAAbbfabS8NA9yLp5k,459
|
|
68
|
+
user_scanner/user_scan/donation/liberapay.py,sha256=njClxpbRLZQ_L2-lUYCY6QFnF4IcwfCJPCIg1iEqo7M,1120
|
|
69
|
+
user_scanner/user_scan/gaming/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
|
70
|
+
user_scanner/user_scan/gaming/chess_com.py,sha256=74tMgukSUXwdmD9G7Jij_gudRlSfs46Xho5KNMVeyt4,1262
|
|
71
|
+
user_scanner/user_scan/gaming/lichess.py,sha256=8b7DNRENh2UwjbsJNXRs2HIwC80OwGe5D0y-96_xjzs,1324
|
|
72
|
+
user_scanner/user_scan/gaming/minecraft.py,sha256=7a9H9ebLlRzGB0SjxLmzqLiDPDBZAuuNq3KKe2DZAvo,481
|
|
73
|
+
user_scanner/user_scan/gaming/monkeytype.py,sha256=IWt_0sXPaiTfKVpYVNW9KLMGtDzU55P-SnBjVtSAsU0,1748
|
|
74
|
+
user_scanner/user_scan/gaming/osu.py,sha256=2Xs1iM0CJ-3dNHu4tyF50_s0Ei_1mA5Zd6D6M5RmiVg,448
|
|
75
|
+
user_scanner/user_scan/gaming/roblox.py,sha256=5q8vWlO5mdUZpQg_rx3ewBrDOHnLprSHJj7uEJ2S934,1813
|
|
76
|
+
user_scanner/user_scan/gaming/steam.py,sha256=l8xk_p9aiYQWCPoogQnO1iwkfojPhg6yd76OZHhKN50,740
|
|
77
|
+
user_scanner/user_scan/social/__init__.py,sha256=jaCkFwX1uYtF0ENifVwF8OfHrYYUTm64B9wlBq9BBfQ,9
|
|
78
|
+
user_scanner/user_scan/social/bluesky.py,sha256=11Y_vRj3txEDQqoD0iANgSWVSB8L87OotPQZquhneR0,1994
|
|
79
|
+
user_scanner/user_scan/social/discord.py,sha256=KA7Uw8RBuid-YZZglIKQwWbg8PIKdrMwXP3fKH3c-go,1180
|
|
80
|
+
user_scanner/user_scan/social/instagram.py,sha256=GgmKGvi3meKdZ_nQJbJSBZDJTEKSoE6Cn4_VARmo62I,953
|
|
81
|
+
user_scanner/user_scan/social/mastodon.py,sha256=bLZ2VR_ty4inY47ENSSt_021wEUEDKwvuE4EL7eLq2A,967
|
|
82
|
+
user_scanner/user_scan/social/pinterest.py,sha256=JIJ-HPtMoGvxW7NQzm02lChFKMmE6k6GxFoUZ6OvCec,784
|
|
83
|
+
user_scanner/user_scan/social/reddit.py,sha256=PJ46v8WpcUY1nNSbPhbiY6B9ynB9bcakcDjopXTX2ME,787
|
|
84
|
+
user_scanner/user_scan/social/snapchat.py,sha256=XEW_W4jEBX4AiHREcfHGstt97Ez3GI-3bKSzhtMyn28,1277
|
|
85
|
+
user_scanner/user_scan/social/soundcloud.py,sha256=rCXyOY1qXOW0iIAcgeyVEcv15ufWb18749PBvBnQWnU,1035
|
|
86
|
+
user_scanner/user_scan/social/telegram.py,sha256=CNhrUdOEaonOGswuGUn-_PgA1aoWvcXVACOC4qDY-vw,767
|
|
87
|
+
user_scanner/user_scan/social/threads.py,sha256=rK8Gm_riDdr0djo23tk38fNVVEBuC6nj2iTXvWrqXeE,951
|
|
88
|
+
user_scanner/user_scan/social/tiktok.py,sha256=y3KqIFIgeT8rk5bM_FirSgdAD2hFN-a_cVCB2S5amAc,1691
|
|
89
|
+
user_scanner/user_scan/social/x.py,sha256=sAnboHHZN2DWyKeds46GLZHxGG-G_bjzfVNIkblSHx8,1406
|
|
90
|
+
user_scanner/user_scan/social/youtube.py,sha256=UPu584teg75P7FT05RFG3nobbHgPmzjr-ZwyN2sw6gw,1980
|
|
91
|
+
user_scanner/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
|
92
|
+
user_scanner/utils/update.py,sha256=Rj3kLuUrQ-LlKGB7bkndqVjj0IUqugbDSj2SUrPRidE,936
|
|
93
|
+
user_scanner/utils/updater_logic.py,sha256=tl6kbKL02DrP-R1dkQWhHr12juVDgkJZZvKAfbI1ruU,2381
|
|
94
|
+
user_scanner-1.1.0.1.dist-info/entry_points.txt,sha256=XqU3kssYZ0vXaPy5qYUOTCu4u-48Xie7QWFpBCYc7Nc,59
|
|
95
|
+
user_scanner-1.1.0.1.dist-info/licenses/LICENSE,sha256=XH1QyQG68zo1opDIZHTHcTAbe9XMzewvTaFTukcN9vc,1061
|
|
96
|
+
user_scanner-1.1.0.1.dist-info/WHEEL,sha256=G2gURzTEtmeR8nrdXUJfNiB3VYVxigPQ-bEQujpNiNs,82
|
|
97
|
+
user_scanner-1.1.0.1.dist-info/METADATA,sha256=UhTN17ewVKkC7qZMXLMfR25uw5dGe1padSXC3BX3zcg,8620
|
|
98
|
+
user_scanner-1.1.0.1.dist-info/RECORD,,
|
user_scanner/cli/printer.py
DELETED
|
@@ -1,117 +0,0 @@
|
|
|
1
|
-
from colorama import Fore, Style
|
|
2
|
-
from typing import Literal
|
|
3
|
-
from user_scanner.core.result import Result, Status
|
|
4
|
-
|
|
5
|
-
INDENT = " "
|
|
6
|
-
CSV_HEADER = "username,category,site_name,status,url,reason"
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
def indentate(msg: str, indent: int):
|
|
10
|
-
if indent <= 0:
|
|
11
|
-
return msg
|
|
12
|
-
tabs = INDENT * indent
|
|
13
|
-
return "\n".join([f"{tabs}{line}" for line in msg.split("\n")])
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
class Printer:
|
|
17
|
-
def __init__(self, format: Literal["console", "csv", "json"]) -> None:
|
|
18
|
-
if format not in ["console", "csv", "json"]:
|
|
19
|
-
raise ValueError(f"Invalid output-format: {format}")
|
|
20
|
-
self.mode: str = format
|
|
21
|
-
self.indent: int = 0
|
|
22
|
-
|
|
23
|
-
@property
|
|
24
|
-
def is_console(self) -> bool:
|
|
25
|
-
return self.mode == "console"
|
|
26
|
-
|
|
27
|
-
@property
|
|
28
|
-
def is_csv(self) -> bool:
|
|
29
|
-
return self.mode == "csv"
|
|
30
|
-
|
|
31
|
-
@property
|
|
32
|
-
def is_json(self) -> bool:
|
|
33
|
-
return self.mode == "json"
|
|
34
|
-
|
|
35
|
-
def get_start(self, json_char: str = "[") -> str:
|
|
36
|
-
if self.is_json:
|
|
37
|
-
self.indent += 1
|
|
38
|
-
return indentate(json_char, self.indent - 1)
|
|
39
|
-
elif self.is_csv:
|
|
40
|
-
return CSV_HEADER
|
|
41
|
-
return ""
|
|
42
|
-
|
|
43
|
-
def get_end(self, json_char: str = "]") -> str:
|
|
44
|
-
if not self.is_json:
|
|
45
|
-
return ""
|
|
46
|
-
self.indent = max(self.indent - 1, 0)
|
|
47
|
-
return indentate(json_char, self.indent)
|
|
48
|
-
|
|
49
|
-
def get_result_output(self, result: Result) -> str:
|
|
50
|
-
#In principle result should always have this
|
|
51
|
-
site_name = result.site_name
|
|
52
|
-
username = result.username
|
|
53
|
-
|
|
54
|
-
match (result.status, self.mode):
|
|
55
|
-
case (Status.AVAILABLE, "console"):
|
|
56
|
-
return f"{INDENT}{Fore.GREEN}[✔] {site_name} ({username}): Available{Style.RESET_ALL}"
|
|
57
|
-
|
|
58
|
-
case (Status.TAKEN, "console"):
|
|
59
|
-
return f"{INDENT}{Fore.RED}[✘] {site_name} ({username}): Taken{Style.RESET_ALL}"
|
|
60
|
-
|
|
61
|
-
case (Status.ERROR, "console"):
|
|
62
|
-
reason = ""
|
|
63
|
-
if isinstance(result, Result) and result.has_reason():
|
|
64
|
-
reason = f" ({result.get_reason()})"
|
|
65
|
-
return f"{INDENT}{Fore.YELLOW}[!] {site_name} ({username}): Error{reason}{Style.RESET_ALL}"
|
|
66
|
-
|
|
67
|
-
case (_, "json"):
|
|
68
|
-
return indentate(result.to_json().replace("\t", INDENT), self.indent)
|
|
69
|
-
|
|
70
|
-
case (_, "csv"):
|
|
71
|
-
return result.to_csv()
|
|
72
|
-
|
|
73
|
-
return ""
|
|
74
|
-
|
|
75
|
-
def print_modules(self, category: str | None = None):
|
|
76
|
-
from user_scanner.core.orchestrator import load_categories, load_modules
|
|
77
|
-
categories = load_categories()
|
|
78
|
-
categories_to_list = [category] if category else categories.keys()
|
|
79
|
-
|
|
80
|
-
# Print the start
|
|
81
|
-
if self.is_json:
|
|
82
|
-
print(self.get_start("{"))
|
|
83
|
-
elif self.is_csv:
|
|
84
|
-
print("category,site_name")
|
|
85
|
-
|
|
86
|
-
for i, cat_name in enumerate(categories_to_list):
|
|
87
|
-
path = categories[cat_name]
|
|
88
|
-
modules = load_modules(path)
|
|
89
|
-
|
|
90
|
-
# Print for each category
|
|
91
|
-
match self.mode:
|
|
92
|
-
case "console":
|
|
93
|
-
print(Fore.MAGENTA +
|
|
94
|
-
f"\n== {cat_name.upper()} SITES =={Style.RESET_ALL}")
|
|
95
|
-
case "json":
|
|
96
|
-
print(self.get_start(f"\"{cat_name}\": ["))
|
|
97
|
-
|
|
98
|
-
for j, module in enumerate(modules):
|
|
99
|
-
is_last = j == len(modules) - 1
|
|
100
|
-
site_name = module.__name__.split(".")[-1].capitalize()
|
|
101
|
-
|
|
102
|
-
# Print for each site name
|
|
103
|
-
match self.mode:
|
|
104
|
-
case "console":
|
|
105
|
-
print(f"{INDENT}- {site_name}")
|
|
106
|
-
case "json":
|
|
107
|
-
msg = f"\"{site_name}\"" + ("" if is_last else ",")
|
|
108
|
-
print(indentate(msg, self.indent))
|
|
109
|
-
case "csv":
|
|
110
|
-
print(f"{cat_name},{site_name}")
|
|
111
|
-
|
|
112
|
-
if self.is_json:
|
|
113
|
-
is_last = i == len(categories_to_list) - 1
|
|
114
|
-
print(self.get_end("]" if is_last else "],"))
|
|
115
|
-
|
|
116
|
-
if self.is_json:
|
|
117
|
-
print(self.get_end("}"))
|