user-scanner 1.0.10.3__py3-none-any.whl → 1.1.0__py3-none-any.whl

user_scanner-1.1.0.dist-info/METADATA

@@ -0,0 +1,239 @@
+Metadata-Version: 2.4
+Name: user-scanner
+Version: 1.1.0
+Summary: Check username availability across multiple popular platforms
+Keywords: username,checker,availability,social,tech,python,user-scanner
+Author-email: Kaif <kafcodec@gmail.com>
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx[http2]>=0.27,<0.29
+Requires-Dist: socksio>=1.0,<2
+Requires-Dist: colorama>=0.4,<1
+Project-URL: Homepage, https://github.com/kaifcodec/user-scanner
+
+# User Scanner
+
+![User Scanner Logo](https://github.com/user-attachments/assets/49ec8d24-665b-4115-8525-01a8d0ca2ef4)
+<p align="center">
+  <img src="https://img.shields.io/badge/Version-1.0.10.1-blueviolet?style=for-the-badge&logo=github" />
+  <img src="https://img.shields.io/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" />
+  <img src="https://img.shields.io/badge/Tested%20on-Linux-balck?style=for-the-badge&logo=Linux" />
+  <img src="https://img.shields.io/pepy/dt/user-scanner?style=for-the-badge" />
+</p>
+
+---
+
+### ⚠️ Email OSINT mode had not been implemented yet, still in progress 
+
+A powerful *Email OSINT tool* that checks if a specific email is registered on various sites, combined with *username scanning* — 2-in-1 solution.  
+
+Perfect for fast, accurate and lightweight email OSINT
+
+Perfect for finding a **unique username** across GitHub, Twitter, Reddit, Instagram, and more, all in a single command.  
+
+## 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
+---
+
+## Installation
+
+```bash
+pip install user-scanner
+```
+
+---
+
+## Important Flags
+
+| Flag | Description |
+|------|-------------|
+| `-u, --username USERNAME` | Scan a single username across platforms |
+| `-e, --email EMAIL`       | Scan a single email across platforms |
+| `-uf, --username-file FILE` | Scan multiple usernames from file (one per line) |
+| `-ef, --email-file FILE`  | Scan multiple emails from file (one per line) |
+| `-c, --category CATEGORY` | Scan all platforms in a specific category |
+| `-lu, --list-user` | List all available modules for username scanning |
+| `-le, --list-email` | List all available modules for email scanning |
+| `-m, --module MODULE`     | Scan a single specific module |
+| `-p, --permute PERMUTE`   | Generate username permutations using a pattern/suffix |
+| `-P, --proxy-file FILE`   | Use proxies from file (one per line) |
+| `--validate-proxies`      | Validate proxies before scanning (tests against google.com) |
+| `-s, --stop STOP`         | Limit the number of permutations generated |
+| `-d, --delay DELAY`       | Delay (in seconds) between requests |
+| `-f, --format {csv,json}` | Select output format |
+| `-o, --output OUTPUT`     | Save results to a file |
+
+---
+
+## Usage
+
+### Basic username/email scan
+
+Scan a single 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
+```
+
+### Selective scanning
+
+Scan only specific categories or single modules:
+
+```bash
+user-scanner -u john_doe -c dev # developer platforms only
+user-scanner -u john_doe -m github # only GitHub
+```
+
+### Bulk 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
+
+```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
+```
+
+### Username/Email variations (suffix only)
+
+Generate & check username variations using a permutation from the given suffix:
+
+```bash
+user-scanner -u john_ -p ab # john_a, ..., john_ab, john_ba
+```
+
+### Using Proxies
+
+Route requests through proxy servers:
+
+```bash
+user-scanner -u john_doe -P proxies.txt
+```
+
+Validate proxies before scanning (tests each proxy against google.com):
+
+```bash
+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:
+
+```bash
+user-scanner -U
+```
+---
+
+## Screenshot: 
+
+- Note*: New modules are constantly getting added so this might have only limited, outdated output:
+
+<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
+
+Modules are organized under `user_scanner/`:
+
+```
+user_scanner/
+├── email_scan/       # Currently in development
+│   ├── social/       # Social email scan modules (Instagram, Mastodon, X, etc.)
+|   ├── adult/        # Adult sites 
+|    ...               # New sites to be added soon
+├── user_scan/
+│   ├── dev/          # Developer platforms (GitHub, GitLab, npm, etc.)
+│   ├── social/       # Social platforms (Twitter/X, Reddit, Instagram, Discord, etc.)
+│   ├── 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:**
+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`).
+
+Result semantics:
+- Result.available() → `available`
+- Result.taken() → `taken`
+- Result.error(message: Optional[str]) → `error`, blocked, unknown, or request failure (include short diagnostic message when helpful)
+
+Follow this document when adding or updating validators.
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for examples.
+
+---
+
+## Dependencies: 
+- [httpx](https://pypi.org/project/httpx/)
+- [colorama](https://pypi.org/project/colorama/)
+
+---
+
+## License
+
+This project is licensed under the **MIT License**. See [LICENSE](LICENSE) for details.
+
+
+---
+
+## Star History
+
+<a href="https://www.star-history.com/#kaifcodec/user-scanner&type=date&legend=top-left">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=kaifcodec/user-scanner&type=date&theme=dark&legend=top-left" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=kaifcodec/user-scanner&type=date&legend=top-left" />
+   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=kaifcodec/user-scanner&type=date&legend=top-left" />
+ </picture>
+</a>
+

user_scanner-1.1.0.dist-info/RECORD

@@ -0,0 +1,94 @@
+user_scanner/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+user_scanner/__main__.py,sha256=upuAt-VZO08YzaA4paD7ArUy2S2K12wdTqlNxn107eY,10762
+user_scanner/version.json,sha256=oTUn4qlwwbH4RAqsIExmaGV6igJwBW8xmvRpphKh6Bc,47
+user_scanner/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+user_scanner/cli/banner.py,sha256=3b4PIggnJrmxF4DfbuPMqSavpwNl0m5uedaOL2SXN3o,766
+user_scanner/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+user_scanner/core/email_orchestrator.py,sha256=EMQGqvk4GqaXQqCSTOYdveRuu63bLf71r6TTrfSrups,2368
+user_scanner/core/formatter.py,sha256=CMwyR6PuP15HqyS6oWe40ye_4dne14lrIj7_5T7rla4,725
+user_scanner/core/helpers.py,sha256=g_WMbEJvT98TA4Db9c-LPIDl6ExjLQ1dSE3cIyKRUos,6406
+user_scanner/core/orchestrator.py,sha256=OLC4JmBJm1ZzwsDUt6Kqtcc2BENs3fP0iqbTT1nS3KU,4460
+user_scanner/core/result.py,sha256=HxzsaQrfvZ-PxDJknAENIaF-BekfyAAV2Mf8J382zjg,4597
+user_scanner/core/version.py,sha256=k1_KTZdRLKBAxp8_PtOhTAtj8mBO_AUnUGdqI4epypY,855
+user_scanner/email_scan/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+user_scanner/email_scan/adult/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+user_scanner/email_scan/adult/pornhub.py,sha256=cc_G5bclFl8QWU43ohM7SgilWk0RYmpUC7NHsw9Z0Bs,2135
+user_scanner/email_scan/adult/xnxx.py,sha256=WiKn4Vkc5FC1HXry9N8SN-dsTdm1qq0NS6KUcPRmMMY,1728
+user_scanner/email_scan/adult/xvideos.py,sha256=tx0PZOZ66KHDmrnvd1RABCnqCUIdKfCPgAbogBtX69A,1769
+user_scanner/email_scan/dev/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+user_scanner/email_scan/dev/bitbucket.py,sha256=oR_fSug_Aft4fy8Lu8r0VO737b8ZlfcC_D3GMbcUF0k,1352
+user_scanner/email_scan/dev/github.py,sha256=JBSSN9kv3IQxKG0tmemUdSHwfQDu53dHC4i9oCwDqow,3160
+user_scanner/email_scan/dev/huggingface.py,sha256=GjFNkuVZ_8eFgs9OrFakhiEb8pVRwEJO-tyx32IQMns,1229
+user_scanner/email_scan/dev/.ruff_cache/.gitignore,sha256=njpg8ebsSuYCFcEdVLFxOSdF7CXp3e1DPVvZITY68xY,35
+user_scanner/email_scan/dev/.ruff_cache/CACHEDIR.TAG,sha256=WVMVbX4MVkpCclExbq8m-IcOZIOuIZf5FrYw5Pk-Ma4,43
+user_scanner/email_scan/dev/.ruff_cache/0.14.10/10328336453267387919,sha256=LEcpRIkQ-C6pcMhwLtJIv41263y2EjXHzr0r530xCtc,250
+user_scanner/email_scan/shopping/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+user_scanner/email_scan/shopping/ebay.py.lock,sha256=UTvqqwdIPPp3Pt8NCwNwHC3xNghexQc1HcNLXf9s4wQ,4326
+user_scanner/email_scan/shopping/flipkart.py,sha256=wMQJ1VIawhM6W0UQCThcIUtaYN7QeexvJSRSeXS4l04,1879
+user_scanner/email_scan/social/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+user_scanner/email_scan/social/facebook.py,sha256=dnCDZfqRYLXDT7GjJQ-bSqGfC-rO8G9O7pu8dUse7Nw,4475
+user_scanner/email_scan/social/instagram.py,sha256=qGDub3d4pSY_KW4aNYDQOGVNSrmWQkZWMHadCFkDa64,2022
+user_scanner/email_scan/social/mastodon.py,sha256=F4E1kJ6148N3C66uFvJu_fhx7r7LcMau6wDIkdRbxlM,2294
+user_scanner/email_scan/social/x.py,sha256=WoHaecbR1qGte-mwyODsY0YGNf-iRZyGS7s9fw0SQgg,1475
+user_scanner/user_scan/community/__init__.py,sha256=5EzlM991pJqvqIRc05_QV5BureJZ7wiCRm1AyEY6pms,12
+user_scanner/user_scan/community/coderlegion.py,sha256=W_bdjzdFPRgUrNFFlylvToSJ4AzaFCtTsUy_MRVDdSo,451
+user_scanner/user_scan/community/hackernews.py,sha256=lKVuEVoGnXWYSANcuUyiSHzUr-VtcXHC7sEX1rxZi0Y,1068
+user_scanner/user_scan/community/lemmy.py,sha256=IURvkdxbqt4riyGEFO2vC3RxcyyC2g1E8Gx-5GJJUaY,927
+user_scanner/user_scan/community/stackoverflow.py,sha256=MTL8O0TLHkjVbugBh1pLxELJLU3hkX_YEHjGjaKTJi4,1007
+user_scanner/user_scan/creator/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+user_scanner/user_scan/creator/devto.py,sha256=mIACmG1a4eoctywxb5p04sI0YVi3dsjCRw9YVOFBEKQ,435
+user_scanner/user_scan/creator/gumroad.py,sha256=OA5IvzNQImcm4rDg8E_WLbrXarC0XBQLe60_1F05j5c,658
+user_scanner/user_scan/creator/hashnode.py,sha256=3RRkVgU7t26-F4ZqjfnC_lwnP7DWwygq6kT2Q4kKw2M,1390
+user_scanner/user_scan/creator/itch_io.py,sha256=2a8UVh-_OaWQPcSUHUuijDGpWDxsR8DoCcU1BdTRqqs,854
+user_scanner/user_scan/creator/kaggle.py,sha256=QaXIG02OGxvQZEvwHm50RKNd7joxGOq0Ht3cFfrYEiU,445
+user_scanner/user_scan/creator/medium.py,sha256=zHU5h2VQwde1P4XihQpV7ww2P_fgGKgWZ_S0_4TTyUI,1648
+user_scanner/user_scan/creator/patreon.py,sha256=g-r85pxirf0ihK3STyGYPIzp59MB7JH64Opb4wq1fyU,461
+user_scanner/user_scan/creator/producthunt.py,sha256=wb7b3hsa2Er-IQTfNFRBnU7KV5EqW_KRhL5pFvuCY88,1227
+user_scanner/user_scan/creator/substack.py,sha256=tisTUQmauteYZOZ0tULp9GGUuf4ZBEcpqv4ZmEvjyK0,1288
+user_scanner/user_scan/creator/twitch.py,sha256=blsh5sMT7miF5-xqVXYLieTILzkop2PsWqv9HhP8G40,2509
+user_scanner/user_scan/dev/__init__.py,sha256=qUR0eLwN-gO6oKk-1cmCVT4G_AxUHHMgpV3wJ7URXi4,7
+user_scanner/user_scan/dev/bitbucket.py,sha256=qAIlFCmMaNTUx2-a5wJKHjbQjERcJt0zKHJmjLAeXr4,876
+user_scanner/user_scan/dev/codeberg.py,sha256=Z6nV0_8xZhMiCcNn9Hn79VVh6y0ar9fqL7KS2b7IaDo,447
+user_scanner/user_scan/dev/cratesio.py,sha256=mJnlLJoMLlQ7f_95QD7LgH1xCj-e6FooOFkpYypBfG4,724
+user_scanner/user_scan/dev/dockerhub.py,sha256=sPEnomGiPM2mKv2HsA-9WxaXHjzz21A6ox3IXK1etLc,643
+user_scanner/user_scan/dev/github.py,sha256=9Q4G84WTAeWfNliApKdRFl1MJLfHvDPJ09mwr8P1ePo,1702
+user_scanner/user_scan/dev/gitlab.py,sha256=kMDSd74XbofmJocfS4Fd9DxPryIHBMek3N_5c7Z_AJQ,1351
+user_scanner/user_scan/dev/huggingface.py,sha256=hDanOZ45LeUg3hrN0CYrBnBnLqHCYtOWS0_HCvAbmDw,454
+user_scanner/user_scan/dev/launchpad.py,sha256=N58ioX_dEHq2uwyyGrWnDKWwbqK9_RiuBQ1uWR5cDfg,799
+user_scanner/user_scan/dev/leetcode.py,sha256=PTJcgp1W3fzLDK_Jy_VvRjKnLftLYMJaw3kfMjHqt9c,1246
+user_scanner/user_scan/dev/npmjs.py,sha256=k-DhFqGJWDoQ79EzR8hmVrJk07AfJfPUWnIYuKc2G6w,713
+user_scanner/user_scan/dev/replit.py,sha256=SI_i2l4w9tm2kBX4-cONBAT8dSynXoGEP4zcU8ngnh0,442
+user_scanner/user_scan/dev/sourceforge.py,sha256=Kt8MmpCgB1tNwYRI9PYOZzIrL1VfnpzeNC43DcbZlbI,850
+user_scanner/user_scan/donation/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+user_scanner/user_scan/donation/buymeacoffee.py,sha256=86LGyChv_UKQFp2D7nIoK1B-FCAAbbfabS8NA9yLp5k,459
+user_scanner/user_scan/donation/liberapay.py,sha256=njClxpbRLZQ_L2-lUYCY6QFnF4IcwfCJPCIg1iEqo7M,1120
+user_scanner/user_scan/gaming/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+user_scanner/user_scan/gaming/chess_com.py,sha256=74tMgukSUXwdmD9G7Jij_gudRlSfs46Xho5KNMVeyt4,1262
+user_scanner/user_scan/gaming/lichess.py,sha256=8b7DNRENh2UwjbsJNXRs2HIwC80OwGe5D0y-96_xjzs,1324
+user_scanner/user_scan/gaming/minecraft.py,sha256=7a9H9ebLlRzGB0SjxLmzqLiDPDBZAuuNq3KKe2DZAvo,481
+user_scanner/user_scan/gaming/monkeytype.py,sha256=IWt_0sXPaiTfKVpYVNW9KLMGtDzU55P-SnBjVtSAsU0,1748
+user_scanner/user_scan/gaming/osu.py,sha256=2Xs1iM0CJ-3dNHu4tyF50_s0Ei_1mA5Zd6D6M5RmiVg,448
+user_scanner/user_scan/gaming/roblox.py,sha256=5q8vWlO5mdUZpQg_rx3ewBrDOHnLprSHJj7uEJ2S934,1813
+user_scanner/user_scan/gaming/steam.py,sha256=l8xk_p9aiYQWCPoogQnO1iwkfojPhg6yd76OZHhKN50,740
+user_scanner/user_scan/social/__init__.py,sha256=jaCkFwX1uYtF0ENifVwF8OfHrYYUTm64B9wlBq9BBfQ,9
+user_scanner/user_scan/social/bluesky.py,sha256=11Y_vRj3txEDQqoD0iANgSWVSB8L87OotPQZquhneR0,1994
+user_scanner/user_scan/social/discord.py,sha256=KA7Uw8RBuid-YZZglIKQwWbg8PIKdrMwXP3fKH3c-go,1180
+user_scanner/user_scan/social/instagram.py,sha256=GgmKGvi3meKdZ_nQJbJSBZDJTEKSoE6Cn4_VARmo62I,953
+user_scanner/user_scan/social/mastodon.py,sha256=bLZ2VR_ty4inY47ENSSt_021wEUEDKwvuE4EL7eLq2A,967
+user_scanner/user_scan/social/pinterest.py,sha256=JIJ-HPtMoGvxW7NQzm02lChFKMmE6k6GxFoUZ6OvCec,784
+user_scanner/user_scan/social/reddit.py,sha256=PJ46v8WpcUY1nNSbPhbiY6B9ynB9bcakcDjopXTX2ME,787
+user_scanner/user_scan/social/snapchat.py,sha256=XEW_W4jEBX4AiHREcfHGstt97Ez3GI-3bKSzhtMyn28,1277
+user_scanner/user_scan/social/soundcloud.py,sha256=rCXyOY1qXOW0iIAcgeyVEcv15ufWb18749PBvBnQWnU,1035
+user_scanner/user_scan/social/telegram.py,sha256=CNhrUdOEaonOGswuGUn-_PgA1aoWvcXVACOC4qDY-vw,767
+user_scanner/user_scan/social/threads.py,sha256=rK8Gm_riDdr0djo23tk38fNVVEBuC6nj2iTXvWrqXeE,951
+user_scanner/user_scan/social/tiktok.py,sha256=y3KqIFIgeT8rk5bM_FirSgdAD2hFN-a_cVCB2S5amAc,1691
+user_scanner/user_scan/social/x.py,sha256=sAnboHHZN2DWyKeds46GLZHxGG-G_bjzfVNIkblSHx8,1406
+user_scanner/user_scan/social/youtube.py,sha256=UPu584teg75P7FT05RFG3nobbHgPmzjr-ZwyN2sw6gw,1980
+user_scanner/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+user_scanner/utils/update.py,sha256=Rj3kLuUrQ-LlKGB7bkndqVjj0IUqugbDSj2SUrPRidE,936
+user_scanner/utils/updater_logic.py,sha256=tl6kbKL02DrP-R1dkQWhHr12juVDgkJZZvKAfbI1ruU,2381
+user_scanner-1.1.0.dist-info/entry_points.txt,sha256=XqU3kssYZ0vXaPy5qYUOTCu4u-48Xie7QWFpBCYc7Nc,59
+user_scanner-1.1.0.dist-info/licenses/LICENSE,sha256=XH1QyQG68zo1opDIZHTHcTAbe9XMzewvTaFTukcN9vc,1061
+user_scanner-1.1.0.dist-info/WHEEL,sha256=G2gURzTEtmeR8nrdXUJfNiB3VYVxigPQ-bEQujpNiNs,82
+user_scanner-1.1.0.dist-info/METADATA,sha256=eHPKnr6zczLO7pagkzEm0LFxyveyfSR3a9RVbIULioA,8601
+user_scanner-1.1.0.dist-info/RECORD,,

user_scanner/cli/printer.py

@@ -1,117 +0,0 @@
-from colorama import Fore, Style
-from typing import Literal
-from user_scanner.core.result import Result, Status
-
-INDENT = "  "
-CSV_HEADER = "username,category,site_name,status,url,reason"
-
-
-def indentate(msg: str, indent: int):
-    if indent <= 0:
-        return msg
-    tabs = INDENT * indent
-    return "\n".join([f"{tabs}{line}" for line in msg.split("\n")])
-
-
-class Printer:
-    def __init__(self, format: Literal["console", "csv", "json"]) -> None:
-        if format not in ["console", "csv", "json"]:
-            raise ValueError(f"Invalid output-format: {format}")
-        self.mode: str = format
-        self.indent: int = 0
-
-    @property
-    def is_console(self) -> bool:
-        return self.mode == "console"
-
-    @property
-    def is_csv(self) -> bool:
-        return self.mode == "csv"
-
-    @property
-    def is_json(self) -> bool:
-        return self.mode == "json"
-
-    def get_start(self, json_char: str = "[") -> str:
-        if self.is_json:
-            self.indent += 1
-            return indentate(json_char, self.indent - 1)
-        elif self.is_csv:
-            return CSV_HEADER
-        return ""
-
-    def get_end(self, json_char: str = "]") -> str:
-        if not self.is_json:
-            return ""
-        self.indent = max(self.indent - 1, 0)
-        return indentate(json_char, self.indent)
-
-    def get_result_output(self, result: Result) -> str:
-        #In principle result should always have this
-        site_name = result.site_name
-        username = result.username
-
-        match (result.status, self.mode):
-            case (Status.AVAILABLE, "console"):
-                return f"{INDENT}{Fore.GREEN}[✔] {site_name} ({username}): Available{Style.RESET_ALL}"
-
-            case (Status.TAKEN, "console"):
-                return f"{INDENT}{Fore.RED}[✘] {site_name} ({username}): Taken{Style.RESET_ALL}"
-
-            case (Status.ERROR, "console"):
-                reason = ""
-                if isinstance(result, Result) and result.has_reason():
-                    reason = f" ({result.get_reason()})"
-                return f"{INDENT}{Fore.YELLOW}[!] {site_name} ({username}): Error{reason}{Style.RESET_ALL}"
-
-            case (_, "json"):
-                return indentate(result.to_json().replace("\t", INDENT), self.indent)
-
-            case (_, "csv"):
-                return result.to_csv()
-
-        return ""
-
-    def print_modules(self, category: str | None = None):
-        from user_scanner.core.orchestrator import load_categories, load_modules
-        categories = load_categories()
-        categories_to_list = [category] if category else categories.keys()
-
-        # Print the start
-        if self.is_json:
-            print(self.get_start("{"))
-        elif self.is_csv:
-            print("category,site_name")
-
-        for i, cat_name in enumerate(categories_to_list):
-            path = categories[cat_name]
-            modules = load_modules(path)
-
-            # Print for each category
-            match self.mode:
-                case "console":
-                    print(Fore.MAGENTA +
-                          f"\n== {cat_name.upper()} SITES =={Style.RESET_ALL}")
-                case "json":
-                    print(self.get_start(f"\"{cat_name}\": ["))
-
-            for j, module in enumerate(modules):
-                is_last = j == len(modules) - 1
-                site_name = module.__name__.split(".")[-1].capitalize()
-
-                # Print for each site name
-                match self.mode:
-                    case "console":
-                        print(f"{INDENT}- {site_name}")
-                    case "json":
-                        msg = f"\"{site_name}\"" + ("" if is_last else ",")
-                        print(indentate(msg, self.indent))
-                    case "csv":
-                        print(f"{cat_name},{site_name}")
-
-            if self.is_json:
-                is_last = i == len(categories_to_list) - 1
-                print(self.get_end("]" if is_last else "],"))
-
-        if self.is_json:
-            print(self.get_end("}"))

user_scanner/config.json

@@ -1 +0,0 @@
-{"auto_update_status": true}

user_scanner-1.0.10.3.dist-info/METADATA

@@ -1,172 +0,0 @@
-Metadata-Version: 2.4
-Name: user-scanner
-Version: 1.0.10.3
-Summary: Check username availability across multiple popular platforms
-Keywords: username,checker,availability,social,tech,python,user-scanner
-Author-email: Kaif <kafcodec@gmail.com>
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: httpx
-Requires-Dist: colorama
-Project-URL: Homepage, https://github.com/kaifcodec/user-scanner
-
-# User Scanner
-
-![User Scanner Logo](https://github.com/user-attachments/assets/49ec8d24-665b-4115-8525-01a8d0ca2ef4)
-<p align="center">
-  <img src="https://img.shields.io/badge/Version-1.0.10.3-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" />
-  <img src="https://img.shields.io/badge/Tested%20on-Linux-balck?style=for-the-badge&logo=Linux" />
-  <img src="https://img.shields.io/pepy/dt/user-scanner?style=for-the-badge" />
-</p>
-
----
-
-Scan a username across multiple social, developer, and creator platforms to see if it’s available.  
-Perfect for finding a **unique username** across GitHub, Twitter, Reddit, Instagram, and more, all in one command.
-
-
-### Features
-
-- ✅ Check usernames across **social networks**, **developer platforms**, and **creator communities**
-- ✅ Can be used as a username OSINT tool
-- ✅ Smart auto-update system, Detects new releases on PyPI and interactively prompts the user to upgrade.
-- ✅ Clear **Available / Taken / Error** output for each platform
-- ✅ Robust error handling: It prints the exact reason (e.g. Cannot use underscores, hyphens at the start/end)
-- ✅ Fully modular: add new platform modules easily
-- ✅ Wildcard-based username permutations for automatic variation generation using provided suffix
-- ✅ Selection of results format (e.g. json, csv, console (default))
-- ✅ Get the scanning results in preferred format (json/csv) in specified output file (suitable for power users)
-- ✅ Command-line interface ready: works directly after `pip install`
-- ✅ Very low and lightweight dependencies, can be run on any machine
----
-
-### Installation
-
-```bash
-pip install user-scanner
-```
-
----
-
-### Usage
-
-Scan a username across all platforms:
-
-```bash
-user-scanner -u <username>
-```
-Optionally, scan a specific category or single module:
-
-```bash
-user-scanner -u <username> -c dev
-user-scanner -l # Lists all available modules
-user-scanner -u <username> -m github
-```
-
-Also, the output file and format can be specified: <br>
-
-```bash
-user-scanner -u <username> -f console #Default format
-user-scanner -u <username> -f csv
-user-scanner -u <username> -f json
-user-scanner -u <username> -f <format> -o <output-file>
-```
-
-Generate multiple username variations by appending a suffix:
-
-```bash
-user-scanner -u <username> -p <suffix>
-```
-Optionally, scan a specific category or single module with limit:
-
-```bash
-user-scanner -u <username> -p <suffix> -c dev
-user-scanner -u <username> -p <suffix> -m github
-user-scanner -u <username> -p <suffix> -s <number> # limit generation of usernames
-user-scanner -u <username> -p <suffix> -d <seconds> # delay to avoid rate-limits (can be 0s-1s)
-```
----
-
-### Update
-
-Update the tool to the latest PyPI version:
-
-```bash
-user-scanner -U
-
-```
-
----
-
-### Screenshot: 
-
-- Note*: New modules are constantly getting added so this might have only limited, outdated output:
-
-
-<img width="1080" height="770" alt="1000140392" src="https://github.com/user-attachments/assets/4638c8f6-40c6-46f8-ae17-ac65cd199d81" />
-
-
----
-
-<img width="1080" height="352" alt="1000140393" src="https://github.com/user-attachments/assets/578b248c-2a05-4917-aab3-6372a7c28045" />
-
----
-
-<img width="992" height="556" alt="1000141265" src="https://github.com/user-attachments/assets/9babb19f-bc87-4e7b-abe5-c52b8b1b672c" />
-
-
-### Contributing: 
-
-Modules are organized by category:
-
-```
-user_scanner/
-├── dev/        # Developer platforms (GitHub, GitLab, etc.)
-├── social/     # Social platforms (Twitter/X, Reddit, Instagram, etc.)
-├── creator/    # Creator platforms (Hashnode, Dev.to, Medium, etc.)
-├── community/  # Community platforms (forums, niche sites)
-├── gaming/     # Gaming sites (chess.com, roblox, monkeytype etc.)
-├── donation/   # Donation taking sites (buymeacoffe.com, similar...)
-```
-
-**Module guidelines:**
-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`).
-
-Result semantics:
-- Result.available() → `available`
-- Result.taken() → `taken`
-- Result.error(message: Optional[str]) → `error`, blocked, unknown, or request failure (include short diagnostic message when helpful)
-
-Follow this document when adding or updating validators.
-
-See [CONTRIBUTING.md](CONTRIBUTING.md) for examples.
-
----
-
-### Dependencies: 
-- [httpx](https://pypi.org/project/httpx/)
-- [colorama](https://pypi.org/project/colorama/)
-
----
-
-### License
-
-This project is licensed under the **MIT License**. See [LICENSE](LICENSE) for details.
-
-
----
-
-### Star History
-
-<a href="https://www.star-history.com/#kaifcodec/user-scanner&type=date&legend=top-left">
- <picture>
-   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=kaifcodec/user-scanner&type=date&theme=dark&legend=top-left" />
-   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=kaifcodec/user-scanner&type=date&legend=top-left" />
-   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=kaifcodec/user-scanner&type=date&legend=top-left" />
- </picture>
-</a>
-