Metadata-Version: 2.1
Name: azcaptchaapi
Version: 0.3.1
Summary: Python API implementation for AZCaptcha.com
Home-page: https://github.com/azcaptcha/azcaptchaapi
Author: AZCaptcha by Joel Höner (athre0z)
Author-email: mail@azcaptcha.com
License: MIT
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown

<<<<<<< HEAD
# AZCaptcha.com Python API

This library implements a simple to use wrapper around the AZCaptcha.com API.

### Installation
From PyPi
```
pip install azcaptchaapi
```

From source
```
git clone https://github.com/azcaptcha/azcaptchaapi.git
cd azcaptchaapi
python setup.py install
```

### Examples

#### Initializing the API
```python
from azcaptchaapi import AZCaptchaApi
api = AZCaptchaApi('<API KEY>')
```

#### Solving a captcha blocking
```python
with open('/my/captcha/path.png', 'rb') as captcha_file:
    captcha = api.solve(captcha_file)

print(captcha.await_result())
```
Waits until the captcha is either solved or an error occurred (indicated through an exception).

#### Solve captcha "non-blocking"
```python
captcha = api.solve(captcha_file)
print(captcha.try_get_result())
```
If already available, prints the captcha text, else `None`. Please note that while this code doesn't repeatedly ask the API if the captcha was solved, the HTTP request is still sent synchronously, so this method isn't *really* non-blocking.

#### Reporting a bad captcha
```python
result = captcha.await_result()
if use_captcha_code(result) == 'failed':
    captcha.report_bad()
```

#### Query account balance
```python
print(api.get_balance())
```

### Compatibilty
This library was successfully tested on Python 2.7 and 3.5. Python versions < 2.7 are *not* officially supported.

### License
This code is released under MIT license. Dependencies are under their respective licenses.

*This project is _not_ affiliated with, maintained, authorized, endorsed or sponsored by AZCaptcha.com or any of its affiliates.*
=======
# azcaptchaapi
python api upload image captcha to azcaptcha.com


