| Latest release: | 1.0rc1 |
|---|---|
| Download: | http://pypi.python.org/pypi/recaptcha/ |
| Development: | https://github.com/2degrees/python-recaptcha |
| Author: | 2degrees Limited |
This is a pythonic and well-documented reCAPTCHA client that supports all the features of the remote API to generate and verify CAPTCHA challenges.
The library has been created using Python 2.7 but is expected to work in Python 2.6 as well.
Mailhide support is outside the scope of the project.
Firstly, you need to initialize the client:
from recaptcha import RecaptchaClient
recaptcha_client = RecaptchaClient('private key', 'public key')
The client is stateless, so it’s absolutely fine to create it once and reuse it as many times as you want, even across different threads.
For more information, read the documentation for RecaptchaClient.
To generate the markup to present a challenge, you need to use the RecaptchaClient.get_challenge_markup() method:
>>> print recaptcha_client.get_challenge_markup()
<script type="text/javascript">
var RecaptchaOptions = {};
</script>
<script
type="text/javascript"
src="http://www.google.com/recaptcha/api/challenge?k=public+key"
>
</script>
<noscript>
<iframe
src="http://www.google.com/recaptcha/api/noscript?k=public+key"
height="300"
width="500"
frameborder="0"
>
</iframe>
<br />
<textarea name="recaptcha_challenge_field" rows="3" cols="40"></textarea>
<input
type="hidden"
name="recaptcha_response_field"
value="manual_challenge"
/>
</noscript>
If the user failed to enter the correct solution and you need to redisplay the form with a different challenge, you need to call get_challenge_markup() with the argument was_previous_solution_incorrect set to True.
For more information, read the documentation for get_challenge_markup().
To verify the solution to a CAPTCHA challenge, you need to call the RecaptchaClient.is_solution_correct() method. For example:
try:
is_solution_correct = recaptcha_client.is_solution_correct(
'hello world',
'challenge',
'192.0.2.0',
)
except RecaptchaUnreachableError as exc:
disable_form(reason='reCAPTCHA is unreachable; please try again later')
except RecaptchaException as exc:
report_exception_to_developers(exc)
else:
if is_solution_correct:
accept_form_data()
else:
redisplay_form(error='Invalid solution to CAPTCHA challenge')
For more information, read the documentation for is_solution_correct().
Stateless reCAPTCHA client.
| Parameters: |
|
|---|
When verification_timeout is None, the default socket timeout will be used. See is_solution_correct().
Return the X/HTML code to present a challenge.
| Parameters: | use_ssl (bool) – Whether to generate the markup with HTTPS URLs instead of HTTP ones |
|---|---|
| Return type: | str |
This method does not communicate with the remote reCAPTCHA API.
Report whether the solution_text for challenge_id is correct.
| Parameters: |
|
|---|---|
| Return type: | bool |
| Raises: |
|
solution_text must be a string encoded in RECAPTCHA_CHARACTER_ENCODING.
This method communicates with the remote reCAPTCHA API and uses the verification_timeout set in the constructor.
The character encoding to be used when making requests to the remote API.
Keep in mind that an ASCII string is also a valid UTF-8 string. So applications which use ASCII exclusively don’t need to encode their strings to use this library.
This is not officially documented but can be inferred from the encoding used in the noscript challenge.
For general reCAPTCHA support, please visit the reCAPTCHA developers’ site.
For suggestions and questions about the library, please use our 2degrees-floss mailing list.