# subweb
**subweb** is a Python package designed for finding subdomains of a given domain. It allows you to load subdomains from a file and check if they exist for a specific domain.
## Features
- Load subdomains from a text file.
- Check if subdomains exist for a given domain.
- Print only valid subdomains or handle both valid and invalid ones.
- Easy to use and install.
## Installation
```bash
pip install subweb
```
This will install the package along with the required dependencies.
## Usage
You can use `subweb` in your Python scripts after installation.
### Example 1: Print valid or wrong subdomains
This example checks subdomains for a domain and prints whether they are valid or wrong:
```python
import subweb
# Load subdomains from a file
subdomains = subweb.load_subdomains('subdomains.txt')
# Find subdomains for the given domain
scanning_result = subweb.find_subdomains('example.com', subdomains)
# Loop through results and print valid or wrong subdomain URLs
for subdomain_url, result in scanning_result.items():
if result == 'valid':
print(f"found_subdomain: {subdomain_url}")
else:
print(f"wrong subdomain: {subdomain_url}")
```
### Example 2: Print only valid subdomains
This example checks subdomains for a domain and prints only the valid ones:
```python
import subweb
# Load subdomains from a file
subdomains = subweb.load_subdomains('subdomains.txt')
# Find subdomains for the given domain
scanning_result = subweb.find_subdomains('example.com', subdomains)
# Loop through results and print only valid subdomain URLs
for subdomain_url, result in scanning_result.items():
if result == 'valid':
print(f"found_subdomains: {subdomain_url}")
```
### Example 3: Custom subdomain list in the code
If you prefer, you can also define the subdomains directly in your script instead of loading them from a file:
```python
import subweb
# Define subdomains directly
subdomains = ['www', 'mail', 'dev', 'help']
# Find subdomains for the given domain
scanning_result = subweb.find_subdomains('example.com', subdomains)
# Print the results
for subdomain_url, result in scanning_result.items():
if result == 'valid':
print(f"found_subdomains: {subdomain_url}")
else:
print(f"wrong subdomain: {subdomain_url}")
```
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more details.
---
Made with ❤️ by [Fidal](https://github.com/mr-fidal) and [ByteBreach](https://github.com/ByteBreach).
Raw data
{
"_id": null,
"home_page": "https://github.com/ByteBreach/subweb",
"name": "subweb",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "subdomain scanning web scraping information",
"author": "MrFidal",
"author_email": "mrfidal@proton.me",
"download_url": "https://files.pythonhosted.org/packages/a6/f0/dcbc1afaa43bbbce576d39dc088c6d9ae68690ed0a293be25566ab2b6de8/subweb-2.0.1.tar.gz",
"platform": null,
"description": "# subweb\r\n\r\n**subweb** is a Python package designed for finding subdomains of a given domain. It allows you to load subdomains from a file and check if they exist for a specific domain.\r\n\r\n## Features\r\n\r\n- Load subdomains from a text file.\r\n- Check if subdomains exist for a given domain.\r\n- Print only valid subdomains or handle both valid and invalid ones.\r\n- Easy to use and install.\r\n\r\n## Installation\r\n\r\n```bash\r\npip install subweb\r\n```\r\n\r\nThis will install the package along with the required dependencies.\r\n\r\n## Usage\r\n\r\nYou can use `subweb` in your Python scripts after installation.\r\n\r\n### Example 1: Print valid or wrong subdomains\r\n\r\nThis example checks subdomains for a domain and prints whether they are valid or wrong:\r\n\r\n```python\r\nimport subweb\r\n\r\n# Load subdomains from a file\r\nsubdomains = subweb.load_subdomains('subdomains.txt')\r\n\r\n# Find subdomains for the given domain\r\nscanning_result = subweb.find_subdomains('example.com', subdomains)\r\n\r\n# Loop through results and print valid or wrong subdomain URLs\r\nfor subdomain_url, result in scanning_result.items():\r\n if result == 'valid':\r\n print(f\"found_subdomain: {subdomain_url}\")\r\n else:\r\n print(f\"wrong subdomain: {subdomain_url}\")\r\n```\r\n\r\n### Example 2: Print only valid subdomains\r\n\r\nThis example checks subdomains for a domain and prints only the valid ones:\r\n\r\n```python\r\nimport subweb\r\n\r\n# Load subdomains from a file\r\nsubdomains = subweb.load_subdomains('subdomains.txt')\r\n\r\n# Find subdomains for the given domain\r\nscanning_result = subweb.find_subdomains('example.com', subdomains)\r\n\r\n# Loop through results and print only valid subdomain URLs\r\nfor subdomain_url, result in scanning_result.items():\r\n if result == 'valid':\r\n print(f\"found_subdomains: {subdomain_url}\")\r\n```\r\n\r\n### Example 3: Custom subdomain list in the code\r\n\r\nIf you prefer, you can also define the subdomains directly in your script instead of loading them from a file:\r\n\r\n```python\r\nimport subweb\r\n\r\n# Define subdomains directly\r\nsubdomains = ['www', 'mail', 'dev', 'help']\r\n\r\n# Find subdomains for the given domain\r\nscanning_result = subweb.find_subdomains('example.com', subdomains)\r\n\r\n# Print the results\r\nfor subdomain_url, result in scanning_result.items():\r\n if result == 'valid':\r\n print(f\"found_subdomains: {subdomain_url}\")\r\n else:\r\n print(f\"wrong subdomain: {subdomain_url}\")\r\n```\r\n\r\n## License\r\n\r\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more details.\r\n\r\n---\r\n\r\nMade with \u2764\ufe0f by [Fidal](https://github.com/mr-fidal) and [ByteBreach](https://github.com/ByteBreach).\r\n",
"bugtrack_url": null,
"license": null,
"summary": "A package for scanning subdomains and collecting website information.",
"version": "2.0.1",
"project_urls": {
"Homepage": "https://github.com/ByteBreach/subweb"
},
"split_keywords": [
"subdomain",
"scanning",
"web",
"scraping",
"information"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e5e85605bea29eda3db18e108cab775d8acf8a2cfd695684efd23f0bcaf00f5e",
"md5": "70c032a677d2a0ed3ee3bdc940431847",
"sha256": "85d4198a8c7c40b629ce396cd19aac155380e2009186b143a0efc8a6ffffb86e"
},
"downloads": -1,
"filename": "subweb-2.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "70c032a677d2a0ed3ee3bdc940431847",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 2653,
"upload_time": "2024-10-16T17:26:44",
"upload_time_iso_8601": "2024-10-16T17:26:44.875577Z",
"url": "https://files.pythonhosted.org/packages/e5/e8/5605bea29eda3db18e108cab775d8acf8a2cfd695684efd23f0bcaf00f5e/subweb-2.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "a6f0dcbc1afaa43bbbce576d39dc088c6d9ae68690ed0a293be25566ab2b6de8",
"md5": "5b6b40bde924af1b03e82f55a2799dd3",
"sha256": "61d7b9cdcf3ebc02791b1375e721760c839762b3ca9de8c190644afb832f3ada"
},
"downloads": -1,
"filename": "subweb-2.0.1.tar.gz",
"has_sig": false,
"md5_digest": "5b6b40bde924af1b03e82f55a2799dd3",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 2594,
"upload_time": "2024-10-16T17:26:46",
"upload_time_iso_8601": "2024-10-16T17:26:46.396039Z",
"url": "https://files.pythonhosted.org/packages/a6/f0/dcbc1afaa43bbbce576d39dc088c6d9ae68690ed0a293be25566ab2b6de8/subweb-2.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-16 17:26:46",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ByteBreach",
"github_project": "subweb",
"github_not_found": true,
"lcname": "subweb"
}
JSON
