Metadata-Version: 2.1
Name: ventus
Version: 0.3.4
Summary: A google dorking library and cli.
Home-page: https://github.com/aaronlyy/ventus
Author: aaronlyy (Aaron Levi)
Author-email: <aaronlevican@gmail.com>
Keywords: dorking,google,scraping,google dorking,hacking,cracking
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development :: Libraries
Classifier: Operating System :: Unix
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests
Requires-Dist: beautifulsoup4
Requires-Dist: click


<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)
