commit 32194b8575b6a0781a164d0c9527a025a754f0ce Author: Isis Lovecruft isis@torproject.org Date: Wed Mar 25 01:22:51 2015 +0000

Add a module docstring to bridgedb.txrecaptcha. --- lib/bridgedb/txrecaptcha.py | 14 ++++++++++++++ 1 file changed, 14 insertions(+)

diff --git a/lib/bridgedb/txrecaptcha.py b/lib/bridgedb/txrecaptcha.py index 477e112..96b288c 100644 --- a/lib/bridgedb/txrecaptcha.py +++ b/lib/bridgedb/txrecaptcha.py @@ -7,6 +7,20 @@ # (c) 2007-2015, The Tor Project, Inc. # :license: 3-Clause BSD, see LICENSE for licensing information

+"""Twisted-based reCAPTCHA client. + +This client *always* uses TLS with strict hostname checking, unlike the +official Google Python recaptcha-client_, which is harcoded_ to use plaintext +HTTP. + +Small portions of this code were taken from the official Google Python +recaptcha-client_ module, version 1.0.6. Those portions are +:class:`RecaptchaResponse`, :data:`API_SERVER`, They total 5 lines of code, +which are copyright the authors of the recaptcha-client_ package. + +.. _hardcoded: https://code.google.com/p/recaptcha/source/browse/trunk/recaptcha-plugins/py... +.. _recaptcha-client: https://pypi.python.org/pypi/recaptcha-client/1.0.6 +"""

import logging import urllib