Metadata-Version: 2.1
Name: Humanoid
Version: 0.0.1
Summary: An SDK for artificial-human interaction with websites, namely Google search and CAPTCHAs.
Maintainer-email: Michael Spece <Michael@Spece.AI>
License: 
        
        # Copyright Notices
        © 2023-2024 Spece.AI
        
        This project includes substantial portions of projects covered by MIT licenses;
        a combined MIT license encompassing this prior work can be found at GitHub.Com/ArtificialHumanoid/Humanoid.
        
        # Disclaimer
        This project's software is provided as is and without warranty of any kind.
        For example, there are no warranties of any of the following:
        - usability
        - merchantability
        - stability
        - predictability
        - fitness for any purpose
        - noninfringement
        - legality.
        
        In no event, shall any contributor or copyright holder be liable for any claims, damages, or other liability;
        whether in an action of contract, tort, or otherwise;
        arising from, out of, or in connection with the software, its use, or other dealings in the software.
        Without the owner of GitHub.Com/ArtificialHumanoid voluntarily modifying this license on the Humanoid project everywhere it exists;
        including GitHub.Com/ArtificialHumanoid/Humanoid;
        there can be no express or implied exceptions to any portion of this project's license.
        
Project-URL: Homepage, https://github.com/ArtificialHumanoid/Humanoid
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
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: License :: Other/Proprietary License
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Typing :: Typed
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE.md

# Installation
<!--
Run
```bash
pip install Humanoid
```

or, for the latest,
-->

```bash
pip install git+https://github.com/ArtificialHumanoid/Humanoid#subdirectory=build
```
.

# Issues, Pull Requests, and Commits
Issues and, of course, pull requests, are tracked via GitHub.  
Accordingly, all commit messages should be prefixed with “#” (followed by an issue or pull request numbered reference).

# `googlesearch`
googlesearch is a Python library for searching Google, easily. googlesearch uses requests and BeautifulSoup4 to scrape Google.


## Usage
To get results for a search term, simply use the search function in googlesearch. For example, to get results for "Google" in Google, just run the following program:
```python
googlesearch.search("Google")
```

## Additional options
By default, `googlesearch` returns 10 results. 
To get a 100 results on Google, for example:
```python
googlesearch.search("Google", num_results=100)
```
In addition, you can change the language Google searches in.
For example, to get results in French run the following program:
```python
googlesearch.search("Google", lang="fr")
```
To extract more information, such as the description or the result URL, use an advanced search:
```python
googlesearch.search("Google", advanced=True)
```
which returns `List[SearchResult]` with each result having the properties
- title
- url
- description.

If requesting more than 100 results, googlesearch will send multiple requests to go through the pages.
To increase the time between these requests, use sleep_interval:
```python
googlesearch.search("Google", sleep_interval=5, num_results=200)
```

# `captcha_solver`

[![Run-Time Status](https://GitHub.Com/ArtificialHumanoid/Humanoid/actions/workflows/Tests.yml/badge.svg)](https://GitHub.Com/ArtificialHumanoid/Humanoid/actions/workflows/Tests.yml/badge.svg)
[![Lint Status](https://GitHub.Com/ArtificialHumanoid/Humanoid/actions/workflows/Linters.yml/badge.svg)]((https://GitHub.Com/ArtificialHumanoid/Humanoid/actions/workflows/Linters.yml/badge.svg))
[![Documentation Status](https://readthedocs.org/projects/Humanoid/badge/?version=latest)](https://Humanoid.readthedocs.org)

Univeral API to work with captcha solving services.

## Twocaptcha Backend Example

Service website is https://2captcha.com

```python
from captcha_solver import CaptchaSolver

solver = CaptchaSolver('twocaptcha', api_key='2captcha.com API HERE')
raw_data = open('captcha.png', 'rb').read()
print(solver.solve_captcha(raw_data))
```

## Rucaptcha Backend Example

Service website is https://rucaptcha.com

```python
from captcha_solver import CaptchaSolver

solver = CaptchaSolver('rucaptcha', api_key='RUCAPTCHA_KEY')
raw_data = open('captcha.png', 'rb').read()
print(solver.solve_captcha(raw_data))
```

## Browser Backend Example
```python
from captcha_solver import CaptchaSolver

solver = CaptchaSolver('browser')
raw_data = open('captcha.png', 'rb').read()
print(solver.solve_captcha(raw_data))
```

## Antigate Backend Example

Service website is http://getcaptchasolution.com

```python
from captcha_solver import CaptchaSolver

solver = CaptchaSolver('antigate', api_key='ANTIGATE_KEY')
raw_data = open('captcha.png', 'rb').read()
print(solver.solve_captcha(raw_data))
```
