Welcome, guest | Sign In | My Account | Store | Cart

Notice! PyPM is being replaced with the ActiveState Platform, which enhances PyPM’s build and deploy capabilities. Create your free Platform account to download ActivePython or customize Python with the packages you require and get automatic updates.

Download
ActivePython
INSTALL>
pypm install wtforms-recaptcha

How to install wtforms-recaptcha

  1. Download and install ActivePython
  2. Open Command Prompt
  3. Type pypm install wtforms-recaptcha
 Python 2.7Python 3.2Python 3.3
Windows (32-bit)
0.2.0 Available View build log
0.1.0 Available View build log
Windows (64-bit)
0.2.0 Available View build log
0.1.0 Available View build log
Mac OS X (10.5+)
0.2.0 Available View build log
0.1.0 Available View build log
Linux (32-bit)
0.2.0 Available View build log
0.1.0 Available View build log
Linux (64-bit)
0.2.0 Available View build log
0.1.0 Available View build log
Web
 
License
BSD
Dependencies
Depended by
Imports
Lastest release
version 0.2.0 on Feb 5th, 2012

Overview

WTForms-reCaptcha is a convenient field for WTForms that transparently handles reCaptcha display and validation via corresponding widget and validator classes.

reCaptcha

To get an idea about reCaptcha see the docs.
To start working with it, first get reCaptcha keys here.

Installation

Get the distribution:

pip install wtforms-recaptcha

or if you want the latest:

pip install hg+http://bitbucket.org/excieve/wtforms-recaptcha#egg=wtforms-recaptcha

or get hg clone of the source code:

hg clone http://bitbucket.org/excieve/wtforms-recaptcha
cd wtforms-recaptcha
python setup.py install

Usage

It is mostly the usual WTForms field that needs some extra data and parameters. Here's a simple example:

from wtforms.form import Form
from wtfrecaptcha.fields import RecaptchaField


class CaptchaForm(Form):
    captcha = RecaptchaField(public_key=RECAPTCHA_PUB_KEY, private_key=RECAPTCHA_PRIV_KEY, secure=True)


form = CaptchaForm(request.POST, captcha={'ip_address': request.META['REMOTE_ADDR']})
if form.validate():
    print "Captcha response is correct"
else:
    print form.errors['captcha']

Some description of field's parameters:

public_key:Public key generated by reCaptcha service
private_key:Private key generated by reCaptcha service
secure:True if it should be served via HTTPS, False otherwise. Default: False.
http_proxy:URL of HTTP proxy for API calls

When form with RecaptchaField is instantiated with bound fields, it must include captcha keyword parameter with dict that has 'ip_address' element.

Other details

Accessing field as a string will get the widget code with URLs that depend on secure parameter passed to the field.

HTTP errors and errors that are indepentent of user input are logged. Others are handled as validation errors.

License

WTForms-reCaptcha is released under BSD license.
Copyright (c) 2010-2012 Artem Gluvchynsky <excieve@gmail.com> and contributors.

See LICENSE for full licensing information.

Subscribe to package updates

Last updated Feb 5th, 2012

Download Stats

Last month:1

What does the lock icon mean?

Builds marked with a lock icon are only available via PyPM to users with a current ActivePython Business Edition subscription.

Need custom builds or support?

ActivePython Enterprise Edition guarantees priority access to technical support, indemnification, expert consulting and quality-assured language builds.

Plan on re-distributing ActivePython?

Get re-distribution rights and eliminate legal risks with ActivePython OEM Edition.