recaptcha-client-1.0.6-ssl - 源码 - 源码 - 免费下载

recaptcha-client-1.0.6-ssl

文件大小： unknow

源码售价： 5 个金币积分规则积分充值

资源说明：reCAPTCHA API for Python 2. Improved version of Python's recaptcha-client-1.0.6, adding full SSL support, a timeout setting, and more.

# Overview #

**recaptcha-client-1.0.6-ssl** is a Python 2.x module that interfaces with reCAPTCHA and reCAPTCHA Mailhide. It generates HTML to let you display reCAPTCHA on your website, and to submit reCAPTCHA attempts to the reCAPTCHA server.

- **reCAPTCHA** is generally used inside HTML forms. Users must solve a reCAPTCHA to submit a form successfully.
- **reCAPTCHA Mailhide** masks email addresses, and requires a user to solve a reCAPTCHA to reveal the full email address.

This code is forked from the original Python [recaptcha-client 1.0.6](http://pypi.python.org/pypi/recaptcha-client "recaptcha-client 1.0.6"), and is fully backwards compatible with it (no code changes are necessary to implement). It has all of the features of **recaptcha-client 1.0.6**, plus the following new ones:

- SSL support for submit() in captcha.py.
- SSL support for asurl() and ashtml() in mailhide.py.
- Timeout variable for submit().
- Exception handling for urllib2.urlopen in submit().
- Lots of comments.
- Code tidying.

This code falls under its original MIT/X11 license. The author of this fork is not associated or affiliated with reCAPTCHA in any way.

More information about reCAPTCHA and reCAPTCHA Mailhide: http://www.google.com/recaptcha

# Installation #

### Dependencies: ###

If you wish to use **reCAPTCHA Mailhide** (recaptcha.client.mailhide), you must also install the Python Crypto library. This is not required if you only use **reCAPTCHA** (recaptcha.client.captcha). The easiest way to install this is with pip:

    $ sudo pip install pycrypto
    $ python
    >>> import Crypto
    >>> Crypto
    

### Download and Install: ###

Make sure to uninstall any old versions of recaptcha-client first.

    $ git clone git://github.com/dave-gallagher/recaptcha-client-1.0.6-ssl.git
    $ cd .../recaptcha-client-1.0.6-ssl
    $ sudo python setup.py install

### Test Installation: ###

    $ python
    >>> import recaptcha
    >>> recaptcha
    

### Uninstallation: ###
    
    $ python -c "from distutils.sysconfig import get_python_lib; print get_python_lib()"
    .../site-packages
    $ sudo rm -r .../site-packages/recaptcha_client-1.0.6_ssl*.egg

# reCAPTCHA Usage #

- You must have both a Public and Private **reCAPTCHA** API Key.
- These keys are different than **reCAPTCHA Mailhide** API Keys.
- Register for free keys here: http://www.google.com/recaptcha/whyrecaptcha
- Note: A *global key* is not needed for local development (127.0.0.1).

### Generate reCAPTCHA HTML: ###

Place the generated HTML inside your form code, and render it to a webpage as a HTTP Response.

    >>> from recaptcha.client.captcha import displayhtml
    >>> 
    >>> PUBLIC_KEY = "YOUR_PUBLIC_RECAPTCHA_KEY"
    >>> 
    >>> html = displayhtml(public_key=PUBLIC_KEY, use_ssl=True, error=None)
    >>> print html
    

### Validate: ###

After receiving an HTTP POST Request from a submitted form, extract both **recaptcha_challenge_field** and **recaptcha_response_field** from the POST. You should also extract the clients IP address (see your API/webserver for details on how to do this).

    >>> from recaptcha.client.captcha import submit
    >>> 
    >>> recaptcha_challenge_field = http_request_post.get("recaptcha_challenge_field", None)   # Psuedo-code
    >>> recaptcha_response_field = http_request_post.get("recaptcha_response_field", None)     # Psuedo-code
    >>> client_ip_address = ...
    >>> PRIVATE_KEY = "YOUR_PRIVATE_RECAPTCHA_KEY"
    >>> 
    >>> recaptcha_response = submit(recaptcha_challenge_field, recaptcha_response_field, PRIVATE_KEY, client_ip_address, use_ssl=True, timeout_seconds=60)
    >>> if recaptcha_response.is_valid:
    ...    print "reCAPTCHA was solved successfully"
    ... else:
    ...    print "reCAPTCHA failed with error: %s" % recaptcha_response.error_code

# reCAPTCHA Mailhide Usage #

- You must have both a Public and Private **reCAPTCHA Mailhide** API Key.
- These keys are different than **reCAPTCHA** API Keys.
- Register for a free keys here: http://www.google.com/recaptcha/mailhide/
- You MUST install Python's Crypto library to use this. Otherwise an exception will be raised. See **Installation** for details.

### Generate reCAPTCHA Mailhide HTML: ###

Place this HTML inside your webpage. The email address will be abridged. To reveal the full email address, the user clicks on a link to open a pop-up window containing a reCAPTCHA. After solving the reCAPTCHA, the full email address is displayed.

    >>> from recaptcha.client.mailhide import ashtml
    >>> 
    >>> EMAIL = "susan_smith@example.com"
    >>> PUBLIC_MAILHIDE_KEY = "YOUR_PUBLIC_RECAPTCHA_MAILHIDE_KEY"
    >>> PRIVATE_MAILHIDE_KEY = "YOUR_PRIVATE_RECAPTCHA_MAILHIDE_KEY"
    >>> 
    >>> html = ashtml(EMAIL, PUBLIC_MAILHIDE_KEY, PRIVATE_MAILHIDE_KEY, use_ssl=True)
    >>> print html
    susa...@example.com

部分文件列表（点击文件名可查看文件内容）

					
									本源码包内暂不包含可直接显示的源代码文件，请下载源码包。