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.
Files changed (92) hide show
  1. user_scanner/__main__.py +241 -129
  2. user_scanner/core/email_orchestrator.py +78 -0
  3. user_scanner/core/formatter.py +27 -0
  4. user_scanner/core/helpers.py +194 -2
  5. user_scanner/core/orchestrator.py +24 -112
  6. user_scanner/core/result.py +51 -18
  7. user_scanner/email_scan/adult/pornhub.py +62 -0
  8. user_scanner/email_scan/adult/xnxx.py +46 -0
  9. user_scanner/email_scan/adult/xvideos.py +50 -0
  10. user_scanner/email_scan/community/stackoverflow.py +40 -0
  11. user_scanner/email_scan/creator/__init__.py +0 -0
  12. user_scanner/email_scan/creator/gumroad.py +82 -0
  13. user_scanner/email_scan/creator/patreon.py +58 -0
  14. user_scanner/email_scan/dev/__init__.py +0 -0
  15. user_scanner/email_scan/dev/bitbucket.py +33 -0
  16. user_scanner/email_scan/dev/github.py +72 -0
  17. user_scanner/email_scan/dev/huggingface.py +37 -0
  18. user_scanner/email_scan/gaming/__init__.py +0 -0
  19. user_scanner/email_scan/gaming/chess_com.py +47 -0
  20. user_scanner/email_scan/shopping/__init__.py +0 -0
  21. user_scanner/email_scan/shopping/flipkart.py +52 -0
  22. user_scanner/email_scan/social/__init__.py +0 -0
  23. user_scanner/email_scan/social/facebook.py +96 -0
  24. user_scanner/email_scan/social/instagram.py +48 -0
  25. user_scanner/email_scan/social/mastodon.py +57 -0
  26. user_scanner/email_scan/social/x.py +41 -0
  27. user_scanner/user_scan/community/lemmy.py +30 -0
  28. user_scanner/user_scan/creator/__init__.py +0 -0
  29. user_scanner/user_scan/creator/gumroad.py +22 -0
  30. user_scanner/user_scan/donation/__init__.py +0 -0
  31. user_scanner/user_scan/gaming/__init__.py +0 -0
  32. user_scanner/{gaming → user_scan/gaming}/roblox.py +15 -5
  33. user_scanner/version.json +1 -1
  34. user_scanner-1.1.0.1.dist-info/METADATA +239 -0
  35. user_scanner-1.1.0.1.dist-info/RECORD +98 -0
  36. user_scanner/cli/printer.py +0 -117
  37. user_scanner-1.0.10.3.dist-info/METADATA +0 -172
  38. user_scanner-1.0.10.3.dist-info/RECORD +0 -72
  39. /user_scanner/{creator → email_scan}/__init__.py +0 -0
  40. /user_scanner/{donation → email_scan/adult}/__init__.py +0 -0
  41. /user_scanner/{gaming → email_scan/community}/__init__.py +0 -0
  42. /user_scanner/{community → user_scan/community}/__init__.py +0 -0
  43. /user_scanner/{community → user_scan/community}/coderlegion.py +0 -0
  44. /user_scanner/{community → user_scan/community}/hackernews.py +0 -0
  45. /user_scanner/{community → user_scan/community}/stackoverflow.py +0 -0
  46. /user_scanner/{creator → user_scan/creator}/devto.py +0 -0
  47. /user_scanner/{creator → user_scan/creator}/hashnode.py +0 -0
  48. /user_scanner/{creator → user_scan/creator}/itch_io.py +0 -0
  49. /user_scanner/{creator → user_scan/creator}/kaggle.py +0 -0
  50. /user_scanner/{creator → user_scan/creator}/medium.py +0 -0
  51. /user_scanner/{creator → user_scan/creator}/patreon.py +0 -0
  52. /user_scanner/{creator → user_scan/creator}/producthunt.py +0 -0
  53. /user_scanner/{creator → user_scan/creator}/substack.py +0 -0
  54. /user_scanner/{creator → user_scan/creator}/twitch.py +0 -0
  55. /user_scanner/{dev → user_scan/dev}/__init__.py +0 -0
  56. /user_scanner/{dev → user_scan/dev}/bitbucket.py +0 -0
  57. /user_scanner/{dev → user_scan/dev}/codeberg.py +0 -0
  58. /user_scanner/{dev → user_scan/dev}/cratesio.py +0 -0
  59. /user_scanner/{dev → user_scan/dev}/dockerhub.py +0 -0
  60. /user_scanner/{dev → user_scan/dev}/github.py +0 -0
  61. /user_scanner/{dev → user_scan/dev}/gitlab.py +0 -0
  62. /user_scanner/{dev → user_scan/dev}/huggingface.py +0 -0
  63. /user_scanner/{dev → user_scan/dev}/launchpad.py +0 -0
  64. /user_scanner/{dev → user_scan/dev}/leetcode.py +0 -0
  65. /user_scanner/{dev → user_scan/dev}/npmjs.py +0 -0
  66. /user_scanner/{dev → user_scan/dev}/replit.py +0 -0
  67. /user_scanner/{dev → user_scan/dev}/sourceforge.py +0 -0
  68. /user_scanner/{donation → user_scan/donation}/buymeacoffee.py +0 -0
  69. /user_scanner/{donation → user_scan/donation}/liberapay.py +0 -0
  70. /user_scanner/{gaming → user_scan/gaming}/chess_com.py +0 -0
  71. /user_scanner/{gaming → user_scan/gaming}/lichess.py +0 -0
  72. /user_scanner/{gaming → user_scan/gaming}/minecraft.py +0 -0
  73. /user_scanner/{gaming → user_scan/gaming}/monkeytype.py +0 -0
  74. /user_scanner/{gaming → user_scan/gaming}/osu.py +0 -0
  75. /user_scanner/{gaming → user_scan/gaming}/steam.py +0 -0
  76. /user_scanner/{social → user_scan/social}/__init__.py +0 -0
  77. /user_scanner/{social → user_scan/social}/bluesky.py +0 -0
  78. /user_scanner/{social → user_scan/social}/discord.py +0 -0
  79. /user_scanner/{social → user_scan/social}/instagram.py +0 -0
  80. /user_scanner/{social → user_scan/social}/mastodon.py +0 -0
  81. /user_scanner/{social → user_scan/social}/pinterest.py +0 -0
  82. /user_scanner/{social → user_scan/social}/reddit.py +0 -0
  83. /user_scanner/{social → user_scan/social}/snapchat.py +0 -0
  84. /user_scanner/{social → user_scan/social}/soundcloud.py +0 -0
  85. /user_scanner/{social → user_scan/social}/telegram.py +0 -0
  86. /user_scanner/{social → user_scan/social}/threads.py +0 -0
  87. /user_scanner/{social → user_scan/social}/tiktok.py +0 -0
  88. /user_scanner/{social → user_scan/social}/x.py +0 -0
  89. /user_scanner/{social → user_scan/social}/youtube.py +0 -0
  90. {user_scanner-1.0.10.3.dist-info → user_scanner-1.1.0.1.dist-info}/WHEEL +0 -0
  91. {user_scanner-1.0.10.3.dist-info → user_scanner-1.1.0.1.dist-info}/entry_points.txt +0 -0
  92. {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
- error = search_results["errors"][0] #Api states theres always an error
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
- return generic_validate(url, process, follow_redirects=True)
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
@@ -1,4 +1,4 @@
1
1
  {
2
- "version": "1.0.10.3",
2
+ "version": "1.1.0.1",
3
3
  "version_type": "pypi"
4
4
  }
@@ -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
+ ![User Scanner Logo](https://github.com/user-attachments/assets/49ec8d24-665b-4115-8525-01a8d0ca2ef4)
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,,
@@ -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("}"))