Metadata-Version: 2.3
Name: pygsearch
Version: 0.6.0
Summary: Python library to get google search results
License: MIT
Keywords: search,google,query,python
Author: atbuy
Author-email: buy@atbuy.dev
Requires-Python: >=3.9,<4.0
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Requires-Dist: beautifulsoup4 (>=4,<5)
Requires-Dist: lxml (>=5,<6)
Requires-Dist: requests (>=2.32.3,<3.0.0)
Project-URL: Bug Tracker, https://github.com/atbuy/pygsearch/issues
Project-URL: CI/CD, https://github.com/atbuy/pygsearch/actions
Project-URL: Homepage, https://github.com/atbuy/pygsearch
Project-URL: Repository, https://github.com/atbuy/pygsearch
Project-URL: Source Code, https://github.com/atbuy/pygsearch
Description-Content-Type: text/markdown

# pygsearch

![pypi version info](https://img.shields.io/pypi/v/pygsearch.svg)
![python version support](https://img.shields.io/pypi/pyversions/pygsearch.svg)


`pygsearch` is a python library that let's you use google search.
Right now you can't search for images. Image support might be added later. PRs are welcome.


Installing
-----------

**Python 3.6.0 or higher is required**

To install the library you can run the following command:

```sh
# Linux/MacOS
python3 -m pip install --upgrade pygsearch

# Windows
py -3 -m pip install --upgrade pygsearch
```

Quickstart
----------

You can make a simple search query like this:

```py
from pygsearch import gsearch

search = gsearch("github")
print(search.results)
```

Or you can iterate over the results:

```py
from pygsearch import gsearch

results = gsearch("github")
for result in results:
    print(result)
```

You can also change how many results you want, pass your own headers, use proxies or even change the language:

```py
from pygsearch import gsearch

proxies = {
    "http": "proxy_http",
    "https": "proxy_https",
    "ftp": "proxy_ftp"
}

headers = {
    "key1": "val1",
    "key2": "val2",
    "key3": "val3",
}

language = "en"
search = gsearch("github", 20, language, headers, proxies)
print(search.results)
```

