Metadata-Version: 2.1
Name: google-reverse-image-search
Version: 0.5.0
Summary: A package to scrape Google Images for image relating to a picture or query
Author-email: horse-3903 <horse3903410@gmail.com>
Project-URL: Homepage, https://github.com/horse-3903/google-reverse-image-search
Project-URL: Bug Tracker, https://github.com/horse-3903/google-reverse-image-search/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE

# Google Reverse Image Search

## Installation
Download the `src` folder or download from `pip` with the terminal command (below)

Run the command in your local terminal with a Virtual Environment (https://docs.python.org/3/library/venv.html#creating-virtual-environments)
```sh
> python -m venv your_venv_name

# Downloading from GitHub 
> pip install -r ./path/to/requirements.txt

# Downloading from pip
> pip install google-reverse-image-search

> playwright install chromium
```
Note : Only works for Chrome _(for now but likely won't change)_

## Usage

Import all functions from the file with 
```py
from google_reverse_image_search import google_reverse_search
```

Then start anywhere with the three basic functions

```py
print(google_reverse_search.search_with_query(query="your query"))
print(google_reverse_search.search_with_url(url="https://link/to/photo"),num=5)
print(google_reverse_search.search_with_file(file_path="C:/path/to/file",num=20))
```

## Examples
All three functions will return the images in a similar manner

### Code
```py
res:dict = google_reverse_search.search_with_query(query="boats",num=3)
print(res)
```

### Results
>Formatted for easier reading
```ps1
Connected...
Navigating...
Getting results...
Formatting results...
{'title': 'boats', 
    'data': [
        {'link': 'https://www.discoverboating.com/sites/default/files/small-boats_1.jpg', 'name': 'The Ultimate Guide to Small Boats | Discover Boating', 'dimensions': [1200, 795]}, 
        {'link': 'https://d1nkxkz7ge96ao.cloudfront.net/eyJidWNrZXQiOiJzbW4tbWFpbi1zaXRlLWJ1Y2tldCIsImtleSI6ImltYWdlc1wvaW1hZ2luXC9McktPcmhFcE5FN0FNV3lFQUxRMUpFOE0wTjVsc1VkekxsNU9ZcEZsLmpwZyIsImVkaXRzIjp7InJlc2l6ZSI6eyJ3aWR0aCI6MjYwMCwiaGVpZ2h0IjoxMzAwLCJmaXQiOiJjb3ZlciJ9fX0=', 'name': "Family-Friendly Offshore Center Consoles & Bay Boats from 20' to 35' |  Sportsman Boats", 'dimensions': [2600, 1300]}, 
        {'link': 'https://cdn.britannica.com/27/166127-050-5E3F9372/salmon-fishing-boat-Alaska.jpg', 'name': 'Boat | Definition, History, Types, & Facts | Britannica', 'dimensions': [1600, 1075]}
    ]
}
```

## Bugs and Issues
 Please raise any issues you have on the [Issues](https://github.com/horse-3903/google-reverse-image-search/issues) forum, and I'll take a look and fix it 🙏

