pyramid-captcha 1.0.0

Usage

To generate a captcha, you have to import the class Captcha.

from pyramid_captcha import Captcha

The simplest solution is to use this class directly in your view definition.

config.add_route('captcha_generate', '/captcha')
config.add_view(
    Captcha,
    attr='generate',
    route_name='captcha_generate',
    request_method='GET'
)

In this case, the route /captcha will return a captcha image with the default length of 6 characters. If you want to adjust the captcha properties, you have to wrap it into a view callable, for example to change the number of characters.

def generate(request):
    return Captcha(request, length=4).generate()

The generated captcha value is stored in the current session. It can be checked against a submitted form value using the validate() method.

try:
    Captcha(request).validate()
except CaptchaError as e:
    raise HTTPForbidden(e)

Demo

You can check out the code and run a little demo by calling make serve.