<p align="center">
<img src=".\media\banner.png" alt="banner">
</p>
<h3 align="center">A Google Dorking library & Command-Line Interface 👾</h3>
<p align="center">
<img alt="GitHub last commit" src="https://img.shields.io/github/last-commit/aaronlyy/ventus">
<img alt="GitHub release (latest by date)" src="https://img.shields.io/github/v/release/aaronlyy/ventus">
<img alt="GitHub" src="https://img.shields.io/github/license/aaronlyy/ventus">
</p>
## Installation
Install ventus with pip
```pip install ventus```
## Usage (command-line interface)
```txt
Usage: ventus [OPTIONS] QUERY
Options:
--help Show this message and exit
-p, --paste Search paste sites
-f, --files Search filesharing sites
-i, --index Search index of /
-d, --document Search for DOCX files
```
## Usage (library)
### Example 1: Search a string
```py
from ventus import search
results = search("test")
for r in results:
print(r)
```
### Example 2: Search a raw dork query
```py
from ventus import search
results = search("site:wikipedia.com mercedes")
for r in results:
print(r)
for r in results:
print(r)
```
### Example 3: Build and search a query using the query builder
```py
from ventus import search, Query
q = Query()
q.site("finance.yahoo.com")
q.intitle("AMD")
print(q) # site:finance.yahoo.com intitle:AMD
# search query
results = search(q)
for r in results:
print(r)
```
### Example 4: Add a keyword group to a query
```py
from ventus import search, Query, Filter
q = Query()
q.site("finance.yahoo.com")
q.intitle(["BMW", "Mercedes"], group_seperator=Filter.AND)
print(q) # site:finance.yahoo.com intitle:(BMW & Mercedes)
# search query
results = search(q)
for r in results:
print(r)
```
## Roadmap
- Move search wrapper directly into cli.py [DONE]
- Option to choose number of links to return
- Recode parts of the query builder
- More pre configured searches in CLI
- Option to use custom queries directly in the terminal
### About
Made with ♥ by [aaronlyy](https://github.com/aaronlyy)
Raw data
{
"_id": null,
"home_page": "https://github.com/aaronlyy/ventus",
"name": "ventus",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "dorking,google,scraping,google dorking,hacking,cracking",
"author": "aaronlyy (Aaron Levi)",
"author_email": "<aaronlevican@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/4a/5e/5212d03666021a3fe063ac6342028165ce988c1fbcba5f444bbcea2056ea/ventus-0.3.4.tar.gz",
"platform": null,
"description": "\r\n<p align=\"center\">\r\n <img src=\".\\media\\banner.png\" alt=\"banner\">\r\n</p>\r\n\r\n<h3 align=\"center\">A Google Dorking library & Command-Line Interface \u00f0\u0178\u2018\u00be</h3>\r\n\r\n<p align=\"center\">\r\n <img alt=\"GitHub last commit\" src=\"https://img.shields.io/github/last-commit/aaronlyy/ventus\">\r\n <img alt=\"GitHub release (latest by date)\" src=\"https://img.shields.io/github/v/release/aaronlyy/ventus\">\r\n <img alt=\"GitHub\" src=\"https://img.shields.io/github/license/aaronlyy/ventus\">\r\n</p>\r\n\r\n## Installation\r\n\r\nInstall ventus with pip\r\n\r\n```pip install ventus```\r\n\r\n## Usage (command-line interface)\r\n\r\n```txt\r\nUsage: ventus [OPTIONS] QUERY\r\n\r\nOptions:\r\n --help Show this message and exit\r\n -p, --paste Search paste sites\r\n -f, --files Search filesharing sites\r\n -i, --index Search index of /\r\n -d, --document Search for DOCX files\r\n```\r\n\r\n## Usage (library)\r\n\r\n### Example 1: Search a string\r\n\r\n```py\r\nfrom ventus import search\r\n\r\nresults = search(\"test\")\r\n\r\nfor r in results:\r\n print(r)\r\n```\r\n\r\n### Example 2: Search a raw dork query\r\n\r\n```py\r\nfrom ventus import search\r\n\r\nresults = search(\"site:wikipedia.com mercedes\")\r\n\r\nfor r in results:\r\n print(r)\r\n\r\nfor r in results:\r\n print(r)\r\n```\r\n\r\n### Example 3: Build and search a query using the query builder\r\n\r\n```py\r\nfrom ventus import search, Query\r\n\r\nq = Query()\r\nq.site(\"finance.yahoo.com\")\r\nq.intitle(\"AMD\")\r\n\r\nprint(q) # site:finance.yahoo.com intitle:AMD\r\n\r\n# search query\r\nresults = search(q)\r\n\r\nfor r in results:\r\n print(r)\r\n```\r\n\r\n### Example 4: Add a keyword group to a query\r\n\r\n```py\r\nfrom ventus import search, Query, Filter\r\n\r\nq = Query()\r\nq.site(\"finance.yahoo.com\")\r\nq.intitle([\"BMW\", \"Mercedes\"], group_seperator=Filter.AND)\r\n\r\nprint(q) # site:finance.yahoo.com intitle:(BMW & Mercedes)\r\n\r\n# search query\r\nresults = search(q)\r\n\r\nfor r in results:\r\n print(r)\r\n```\r\n\r\n## Roadmap\r\n\r\n- Move search wrapper directly into cli.py [DONE]\r\n- Option to choose number of links to return\r\n- Recode parts of the query builder\r\n- More pre configured searches in CLI\r\n- Option to use custom queries directly in the terminal\r\n\r\n### About\r\n\r\nMade with \u00e2\u2122\u00a5 by [aaronlyy](https://github.com/aaronlyy)\r\n",
"bugtrack_url": null,
"license": "",
"summary": "A google dorking library and cli.",
"version": "0.3.4",
"project_urls": {
"Homepage": "https://github.com/aaronlyy/ventus"
},
"split_keywords": [
"dorking",
"google",
"scraping",
"google dorking",
"hacking",
"cracking"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "cf447d77b7b3bc0ef3356fb7b1cf82697d919b93ce2ecc5847f434aaaab6dbdb",
"md5": "922c84bfeda96c39cb109222aa336f22",
"sha256": "3a07c48d73016a4928135faba2aed18b83c5d1152db82564b99f50e990e88f10"
},
"downloads": -1,
"filename": "ventus-0.3.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "922c84bfeda96c39cb109222aa336f22",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 20287,
"upload_time": "2023-06-04T20:43:36",
"upload_time_iso_8601": "2023-06-04T20:43:36.876369Z",
"url": "https://files.pythonhosted.org/packages/cf/44/7d77b7b3bc0ef3356fb7b1cf82697d919b93ce2ecc5847f434aaaab6dbdb/ventus-0.3.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "4a5e5212d03666021a3fe063ac6342028165ce988c1fbcba5f444bbcea2056ea",
"md5": "0fc0c5c46ae46c9ced373645353eb960",
"sha256": "41c8e9f7608c301a9f5277782ec505a0c50df02af6715863db916d174f53ff01"
},
"downloads": -1,
"filename": "ventus-0.3.4.tar.gz",
"has_sig": false,
"md5_digest": "0fc0c5c46ae46c9ced373645353eb960",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 20152,
"upload_time": "2023-06-04T20:43:38",
"upload_time_iso_8601": "2023-06-04T20:43:38.643138Z",
"url": "https://files.pythonhosted.org/packages/4a/5e/5212d03666021a3fe063ac6342028165ce988c1fbcba5f444bbcea2056ea/ventus-0.3.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-06-04 20:43:38",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "aaronlyy",
"github_project": "ventus",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "ventus"
}
JSON
