Skip to main content

Django recaptcha form field/widget app.

Project description

Django reCAPTCHA form field/widget integration app.

https://travis-ci.org/EnTeQuAk/nobot.svg?branch=master https://badge.fury.io/py/nobot.png https://pypip.in/d/nobot/badge.png

Installation

  1. Install or add nobot to your Python path.

  2. Add nobot to your INSTALLED_APPS setting.

  3. Add a NOBOT_RECAPTCHA_PUBLIC_KEY setting to the project’s settings.py file. This is your public API key as provided by reCAPTCHA, i.e.:

    NOBOT_RECAPTCHA_PUBLIC_KEY = '76wtgdfsjhsydt7r5FFGFhgsdfytd656sad75fgh'
    

    This can be seperately specified at runtime by passing a public_key parameter when constructing the ReCaptchaField, see field usage below.

  4. Add a NOBOT_RECAPTCHA_PRIVATE_KEY setting to the project’s settings.py file. This is your private API key as provided by reCAPTCHA, i.e.:

    NOBOT_RECAPTCHA_PRIVATE_KEY = '98dfg6df7g56df6gdfgdfg65JHJH656565GFGFGs'
    

    This can be seperately specified at runtime by passing a private_key parameter when constructing the ReCaptchaField, see field usage below.

Usage

Field

The quickest way to add reCAPTHCA to a form is to use the included ReCaptchaField field type. A ReCaptcha widget will be rendered with the field validating itself without any further action required from you. For example:

from django import forms
from nobot.fields import ReCaptchaField

class FormWithCaptcha(forms.Form):
    captcha = ReCaptchaField()

The reCAPTCHA widget supports several Javascript options variables customizing the behaviour of the widget, such as theme and lang. You can forward these options to the widget by passing an attr parameter containing a dictionary of options to ReCaptchaField, i.e.:

captcha = ReCaptchaField(attrs={'theme' : 'clean'})

The captcha client takes the key/value pairs and writes out the RecaptchaOptions value in JavaScript.

Testing

To obtain a valid form containing a reCAPTCHA field offline one can mock the verify method of ReCaptchaClient or HumanCaptchaClient, i.e.:

import mock
from nobot.client import RecaptchaResponse

class MyTestClass:

    @mock.patch('nobot.client.HumanCaptchaClient.verify')
    def test_with_valid_form(self, nobot_mock):
        nobot_mock.return_value = RecaptchaResponse(is_valid=True, error_code=None)

        # ...
        # Test your form or view
        # recaptcha won't 'spoil' test validation offline now

Credits

Originally developed under the name django-recaptcha by Praekelt Consulting. Forked for better testability and extensibility. Authors =======

nobot was previously developed under the name django-recaptcha and under the Copyright of Praekelt Foundation. The following copyright notice holds true for releases before the renaming: “Copyright (c) by Praekelt Foundation

Package Maintainer

  • Christopher Grebs

Praekelt Consulting

  • Shaun Sephton
  • Peter Pistorius
  • Hedley Roos

bTaylor Design

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for nobot, version 0.5
Filename, size & hash File type Python version Upload date
nobot-0.5-py2.py3-none-any.whl (12.5 kB) View hashes Wheel 3.6
nobot-0.5.tar.gz (9.6 kB) View hashes Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page