Commits

Lynn Rees committed cb499fb

- cleanup

Comments (0)

Files changed (14)

branches/0.1/trunk/ez_setup.py

-#!python
-"""Bootstrap setuptools installation
-
-If you want to use setuptools in your package's setup.py, just include this
-file in the same directory with it, and add this to the top of your setup.py::
-
-    from ez_setup import use_setuptools
-    use_setuptools()
-
-If you want to require a specific version of setuptools, set a download
-mirror, or use an alternate download directory, you can do so by supplying
-the appropriate options to ``use_setuptools()``.
-
-This file can also be run as a script to install or upgrade setuptools.
-"""
-import sys
-DEFAULT_VERSION = "0.6a9"
-DEFAULT_URL     = "http://cheeseshop.python.org/packages/%s/s/setuptools/" % sys.version[:3]
-
-md5_data = {
-    'setuptools-0.5a13-py2.3.egg': '85edcf0ef39bab66e130d3f38f578c86',
-    'setuptools-0.5a13-py2.4.egg': 'ede4be600e3890e06d4ee5e0148e092a',
-    'setuptools-0.6a1-py2.3.egg': 'ee819a13b924d9696b0d6ca6d1c5833d',
-    'setuptools-0.6a1-py2.4.egg': '8256b5f1cd9e348ea6877b5ddd56257d',
-    'setuptools-0.6a2-py2.3.egg': 'b98da449da411267c37a738f0ab625ba',
-    'setuptools-0.6a2-py2.4.egg': 'be5b88bc30aed63fdefd2683be135c3b',
-    'setuptools-0.6a3-py2.3.egg': 'ee0e325de78f23aab79d33106dc2a8c8',
-    'setuptools-0.6a3-py2.4.egg': 'd95453d525a456d6c23e7a5eea89a063',
-    'setuptools-0.6a4-py2.3.egg': 'e958cbed4623bbf47dd1f268b99d7784',
-    'setuptools-0.6a4-py2.4.egg': '7f33c3ac2ef1296f0ab4fac1de4767d8',
-    'setuptools-0.6a5-py2.3.egg': '748408389c49bcd2d84f6ae0b01695b1',
-    'setuptools-0.6a5-py2.4.egg': '999bacde623f4284bfb3ea77941d2627',
-    'setuptools-0.6a6-py2.3.egg': '7858139f06ed0600b0d9383f36aca24c',
-    'setuptools-0.6a6-py2.4.egg': 'c10d20d29acebce0dc76219dc578d058',
-    'setuptools-0.6a7-py2.3.egg': 'cfc4125ddb95c07f9500adc5d6abef6f',
-    'setuptools-0.6a7-py2.4.egg': 'c6d62dab4461f71aed943caea89e6f20',
-    'setuptools-0.6a8-py2.3.egg': '2f18eaaa3f544f5543ead4a68f3b2e1a',
-    'setuptools-0.6a8-py2.4.egg': '799018f2894f14c9f8bcb2b34e69b391',
-    'setuptools-0.6a9-py2.3.egg': '8e438ad70438b07b0d8f82cae42b278f',
-    'setuptools-0.6a9-py2.4.egg': '8f6e01fc12fb1cd006dc0d6c04327ec1',
-}
-
-import sys, os
-
-def _validate_md5(egg_name, data):
-    if egg_name in md5_data:
-        from md5 import md5
-        digest = md5(data).hexdigest()
-        if digest != md5_data[egg_name]:
-            print >>sys.stderr, (
-                "md5 validation of %s failed!  (Possible download problem?)"
-                % egg_name
-            )
-            sys.exit(2)
-    return data    
-
-
-def use_setuptools(
-    version=DEFAULT_VERSION, download_base=DEFAULT_URL, to_dir=os.curdir,
-    download_delay=15
-):
-    """Automatically find/download setuptools and make it available on sys.path
-
-    `version` should be a valid setuptools version number that is available
-    as an egg for download under the `download_base` URL (which should end with
-    a '/').  `to_dir` is the directory where setuptools will be downloaded, if
-    it is not already available.  If `download_delay` is specified, it should
-    be the number of seconds that will be paused before initiating a download,
-    should one be required.  If an older version of setuptools is installed,
-    this routine will print a message to ``sys.stderr`` and raise SystemExit in
-    an attempt to abort the calling script.  
-    """
-    try:
-        import setuptools
-        if setuptools.__version__ == '0.0.1':
-            print >>sys.stderr, (
-            "You have an obsolete version of setuptools installed.  Please\n"
-            "remove it from your system entirely before rerunning this script."
-            )
-            sys.exit(2)
-    except ImportError:
-        egg = download_setuptools(version, download_base, to_dir, download_delay)
-        sys.path.insert(0, egg)
-        import setuptools; setuptools.bootstrap_install_from = egg
-
-    import pkg_resources
-    try:
-        pkg_resources.require("setuptools>="+version)
-
-    except pkg_resources.VersionConflict:
-        # XXX could we install in a subprocess here?
-        print >>sys.stderr, (
-            "The required version of setuptools (>=%s) is not available, and\n"
-            "can't be installed while this script is running. Please install\n"
-            " a more recent version first."
-        ) % version
-        sys.exit(2)
-
-def download_setuptools(
-    version=DEFAULT_VERSION, download_base=DEFAULT_URL, to_dir=os.curdir,
-    delay = 15
-):
-    """Download setuptools from a specified location and return its filename
-
-    `version` should be a valid setuptools version number that is available
-    as an egg for download under the `download_base` URL (which should end
-    with a '/'). `to_dir` is the directory where the egg will be downloaded.
-    `delay` is the number of seconds to pause before an actual download attempt.
-    """
-    import urllib2, shutil
-    egg_name = "setuptools-%s-py%s.egg" % (version,sys.version[:3])
-    url = download_base + egg_name
-    saveto = os.path.join(to_dir, egg_name)
-    src = dst = None
-    if not os.path.exists(saveto):  # Avoid repeated downloads
-        try:
-            from distutils import log
-            if delay:
-                log.warn("""
----------------------------------------------------------------------------
-This script requires setuptools version %s to run (even to display
-help).  I will attempt to download it for you (from
-%s), but
-you may need to enable firewall access for this script first.
-I will start the download in %d seconds.
----------------------------------------------------------------------------""",
-                    version, download_base, delay
-                ); from time import sleep; sleep(delay)
-            log.warn("Downloading %s", url)
-            src = urllib2.urlopen(url)
-            # Read/write all in one block, so we don't create a corrupt file
-            # if the download is interrupted.
-            data = _validate_md5(egg_name, src.read())
-            dst = open(saveto,"wb"); dst.write(data)
-        finally:
-            if src: src.close()
-            if dst: dst.close()
-    return os.path.realpath(saveto)
-
-def main(argv, version=DEFAULT_VERSION):
-    """Install or upgrade setuptools and EasyInstall"""
-
-    try:
-        import setuptools
-    except ImportError:
-        import tempfile, shutil
-        tmpdir = tempfile.mkdtemp(prefix="easy_install-")
-        try:
-            egg = download_setuptools(version, to_dir=tmpdir, delay=0)
-            sys.path.insert(0,egg)
-            from setuptools.command.easy_install import main
-            main(list(argv)+[egg])
-        finally:
-            shutil.rmtree(tmpdir)
-    else:
-        if setuptools.__version__ == '0.0.1':
-            # tell the user to uninstall obsolete version
-            use_setuptools(version)
-
-    req = "setuptools>="+version
-    import pkg_resources
-    try:
-        pkg_resources.require(req)
-    except pkg_resources.VersionConflict:
-        try:
-            from setuptools.command.easy_install import main
-        except ImportError:
-            from easy_install import main
-        main(list(argv)+[download_setuptools(delay=0)])
-        sys.exit(0) # try to force an exit
-    else:
-        if argv:
-            from setuptools.command.easy_install import main
-            main(argv)
-        else:
-            print "Setuptools version",version,"or greater has been installed."
-            print '(Run "ez_setup.py -U setuptools" to reinstall or upgrade.)'
-
-
-            
-def update_md5(filenames):
-    """Update our built-in md5 registry"""
-
-    import re
-    from md5 import md5
-
-    for name in filenames:
-        base = os.path.basename(name)
-        f = open(name,'rb')       
-        md5_data[base] = md5(f.read()).hexdigest()
-        f.close()
-
-    data = ["    %r: %r,\n" % it for it in md5_data.items()]
-    data.sort()
-    repl = "".join(data)
-
-    import inspect
-    srcfile = inspect.getsourcefile(sys.modules[__name__])
-    f = open(srcfile, 'rb'); src = f.read(); f.close()
-
-    match = re.search("\nmd5_data = {\n([^}]+)}", src)
-    if not match:
-        print >>sys.stderr, "Internal error!"
-        sys.exit(2)
-
-    src = src[:match.start(1)] + repl + src[match.end(1):]
-    f = open(srcfile,'w')
-    f.write(src)
-    f.close()
-
-
-if __name__=='__main__':
-    if len(sys.argv)>2 and sys.argv[1]=='--md5update':
-        update_md5(sys.argv[2:])
-    else:
-        main(sys.argv[1:])
-

branches/0.1/trunk/setup.py

-# Copyright (c) 2006 L. C. Rees.  All rights reserved.
-#
-# Redistribution and use in source and binary forms, with or without
-# modification, are permitted provided that the following conditions are met:
-#
-# 1.  Redistributions of source code must retain the above copyright notice,
-# this list of conditions and the following disclaimer.
-# 2.  Redistributions in binary form must reproduce the above copyright
-# notice, this list of conditions and the following disclaimer in the
-# documentation and/or other materials provided with the distribution.
-# 3.  Neither the name of the Portable Site Information Project nor the names
-# of its contributors may be used to endorse or promote products derived from
-# this software without specific prior written permission.
-#
-# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
-# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
-# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
-# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
-# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
-# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
-# POSSIBILITY OF SUCH DAMAGE.
-
-'''setup - setuptools based setup for wsgiakismet.'''
-
-import ez_setup
-ez_setup.use_setuptools()
-
-try:
-    from setuptools import setup
-except:
-    from distutils.core import setup
-
-setup(name='wsgiakismet',
-      version='0.1',
-      description='''Akismet SPAM blocking WSGI middleware.''',
-      long_description='''Validates form submissions against the Akismet service
-to verify that they are not spam.
-
-Simple usage example:
-
-import cgi
-from wsgiakismet import akismet
-
-# Wordpress API Key and website name are required arguments
-@akisimet('3489012ab121', 'http://blog.example.com/')
-def app(env, start_response):
-    usersub = cgi.parse(fp=env['wsgi.input'], environ=env)
-    start_response('200 OK', [('Content-type', 'text/plain')])
-    return ['Comment is %s' % usersub['comment'][0]]
-''',
-      author='L. C. Rees',
-      author_email='lcrees@gmail.com',
-      license='BSD',
-      py_modules=['wsgiakismet'],
-      packages = ['tests'],
-      zip_safe = True,
-      keywords='WSGI comment spam blocking blog middleware web HTTP',
-      classifiers=['Development Status :: 4 - Beta',
-                    'Environment :: Web Environment',
-                    'License :: OSI Approved :: BSD License',
-                    'Natural Language :: English',
-                    'Operating System :: OS Independent',
-                    'Programming Language :: Python',
-                    'Topic :: Internet :: WWW/HTTP :: WSGI :: Middleware'])

branches/0.1/trunk/test_wsgiakismet.py

-#! /usr/bin/env python
-
-# Copyright (c) 2006 L. C. Rees.  All rights reserved.
-#
-# Redistribution and use in source and binary forms, with or without
-# modification, are permitted provided that the following conditions are met:
-#
-# 1.  Redistributions of source code must retain the above copyright notice,
-# this list of conditions and the following disclaimer.
-# 2.  Redistributions in binary form must reproduce the above copyright
-# notice, this list of conditions and the following disclaimer in the
-# documentation and/or other materials provided with the distribution.
-# 3.  Neither the name of the Portable Site Information Project nor the names
-# of its contributors may be used to endorse or promote products derived from
-# this software without specific prior written permission.
-#
-# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
-# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
-# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
-# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
-# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
-# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
-# POSSIBILITY OF SUCH DAMAGE.
-
-import unittest
-import wsgiakismet
-from StringIO import StringIO 
-from urllib import urlencode
-
-# Put valid Wordpress API key here to test
-key = '707659935d35'
-blog = 'http://www.example.com/'
-
-
-class TestWsgiAkisimet(unittest.TestCase):
-
-    def dummy_sr(self, status, headers, exc_info=None):
-        pass
-
-    def test_negative(self):
-        env = {
-        'HTTP_METHOD':'POST',
-        'wsgi.input':StringIO(''),
-        'QUERY_STRING':urlencode({'comment_author':'Bob Saunders',
-            'comment_author_email':'bob@saunders.net', 'comment_author_url':'',
-            'comment':'The post was informative.'}),
-        'REMOTE_ADDR':'207.89.134.5',
-        'HTTP_USER_AGENT':'Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 5.1; YPC 3.0.1; .NET CLR 1.1.4322; .NET CLR 2.0.50727)'
-        }
-        @wsgiakismet.akismet(key, blog)
-        def test(environ, start_response):
-            start_response('200 OK', [('Content-type', 'text/plain')])
-            return ['Good']
-        response = test(env, self.dummy_sr)
-        self.assertEqual(response[0], 'Good')
-
-    def test_positive(self):
-        env = {
-        'HTTP_METHOD':'POST',
-        'wsgi.input':StringIO(''),
-        'QUERY_STRING':urlencode({'comment_author':'viagra-test-123',
-            'comment_author_email':'viagra@viagraoffer.net', 'comment_author_url':'',
-            'comment':'VIAGRA! LOTS OF VIAGRA!'}),
-        'REMOTE_ADDR':'10.9.4.59',
-        'HTTP_USER_AGENT':'Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 5.1; YPC 3.0.1; .NET CLR 1.1.4322; .NET CLR 2.0.50727)'
-        }
-        @wsgiakismet.akismet(key, blog)
-        def test(environ, start_response):
-            start_response('200 OK', [('Content-type', 'text/plain')])
-            return ['Good']
-        response = test(env, self.dummy_sr)
-        self.assertEqual(response[0], 'Comment was spam.')          
-
-
-if __name__ == '__main__': unittest.main()
-       

branches/0.1/trunk/tests/test_wsgiakismet.py

-#! /usr/bin/env python
-
-# Copyright (c) 2006 L. C. Rees.  All rights reserved.
-#
-# Redistribution and use in source and binary forms, with or without
-# modification, are permitted provided that the following conditions are met:
-#
-# 1.  Redistributions of source code must retain the above copyright notice,
-# this list of conditions and the following disclaimer.
-# 2.  Redistributions in binary form must reproduce the above copyright
-# notice, this list of conditions and the following disclaimer in the
-# documentation and/or other materials provided with the distribution.
-# 3.  Neither the name of the Portable Site Information Project nor the names
-# of its contributors may be used to endorse or promote products derived from
-# this software without specific prior written permission.
-#
-# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
-# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
-# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
-# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
-# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
-# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
-# POSSIBILITY OF SUCH DAMAGE.
-
-import unittest
-import wsgiakismet
-from StringIO import StringIO 
-from urllib import urlencode
-
-# Put valid Wordpress API key here to test
-key = ''
-blog = 'http://www.example.com/'
-
-
-class TestWsgiAkisimet(unittest.TestCase):
-
-    def dummy_sr(self, status, headers, exc_info=None):
-        pass
-
-    def test_negative(self):
-        env = {
-        'HTTP_METHOD':'POST',
-        'wsgi.input':StringIO(''),
-        'QUERY_STRING':urlencode({'comment_author':'Bob Saunders',
-            'comment_author_email':'bob@saunders.net', 'comment_author_url':'',
-            'comment':'The post was informative.'}),
-        'REMOTE_ADDR':'207.89.134.5',
-        'HTTP_USER_AGENT':'Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 5.1; YPC 3.0.1; .NET CLR 1.1.4322; .NET CLR 2.0.50727)'
-        }
-        @wsgiakismet.akismet(key, blog)
-        def test(environ, start_response):
-            start_response('200 OK', [('Content-type', 'text/plain')])
-            return ['Good']
-        response = test(env, self.dummy_sr)
-        self.assertEqual(response[0], 'Good')
-
-    def test_positive(self):
-        env = {
-        'HTTP_METHOD':'POST',
-        'wsgi.input':StringIO(''),
-        'QUERY_STRING':urlencode({'comment_author':'viagra-test-123',
-            'comment_author_email':'viagra@viagraoffer.net', 'comment_author_url':'',
-            'comment':'VIAGRA! LOTS OF VIAGRA!'}),
-        'REMOTE_ADDR':'10.9.4.59',
-        'HTTP_USER_AGENT':'Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 5.1; YPC 3.0.1; .NET CLR 1.1.4322; .NET CLR 2.0.50727)'
-        }
-        @wsgiakismet.akismet(key, blog)
-        def test(environ, start_response):
-            start_response('200 OK', [('Content-type', 'text/plain')])
-            return ['Good']
-        response = test(env, self.dummy_sr)
-        self.assertEqual(response[0], 'Comment was spam.')          
-
-
-if __name__ == '__main__': unittest.main()
-       

branches/0.1/trunk/wsgiakismet.py

-# Copyright Michael Foord 2005 & 2006
-# Copyright L.C. Rees 2006
-#
-# WSGI interface to the Akismet API
-# http://akismet.com
-#
-# Released subject to the BSD License
-# Please see http://www.voidspace.org.uk/python/license.shtml
-
-'''WSGI middleware implementing the Akismet Application Programmers Interface.
-This is a web service for blocking SPAM comments to blogs - or other online
-services. Based on akismet 0.1.3.
-
-You will need a Wordpress API key, from http://wordpress.com/.
-
-You should pass in the keyword argument 'agent' to the name of your program,
-when you create an Akismet instance. This sets the ``user-agent`` to a useful
-value. The default is:
-
-    Python Interface by Fuzzyman | wsgiakismet.py/0.1
-
-Whatever you pass in, will replace the *Python Interface by Fuzzyman* part.
-'''
-
-import cgi
-import urllib2
-import socket
-from urllib import urlencode
-from StringIO import StringIO
-
-__all__ = ['__version__', 'WsgiAkismet', 'akismet']
-__version__ = '0.1'
-__author__ = 'L.C. Rees <lcrees@gmail.com?'
-user_agent = '%s | wsgiakismet.py/%s'
-DEFAULTAGENT = 'Python Interface by Fuzzyman/%s'
-
-if hasattr(socket, 'setdefaulttimeout'):
-    # Set the default timeout on sockets to 5 seconds
-    socket.setdefaulttimeout(5)
-
-def formparse(env):
-    '''Extracts data from form submissions.
-
-    @param environ Environment dictionary
-    @param strict Stops on errors (default: False)
-    '''
-    winput = env['wsgi.input']
-    # Non-destructively retrieve string
-    if hasattr(winput, 'getvalue'):
-        tinput = winput.getvalue()
-    # Recreate wsgi.input as fallback
-    else:
-        tinput = winput.read()
-        env['wsgi.input'] = StringIO(tinput)
-    # Parse form submission
-    qdict = cgi.parse(fp=StringIO(tinput), environ=env)
-    # Remove invididual entries from list and store as naked string
-    for key, value in qdict.iteritems():
-        if len(value) == 1: qdict[key] = value[0]
-    return qdict
-
-def _handler(environ, start_response):
-    '''Replace this default handler.'''
-    start_response('200 OK', [('Content-type', 'text/plain')])
-    return ['Comment was spam.']
-
-def akismet(key, blog_url, **kw):
-    '''Decorator for Akismet.'''
-    def decorator(application):
-        return WsgiAkismet(application, key, blog_url, **kw)
-    return decorator
-
-
-class WsgiAkismet(object):
-    
-    '''WSGI middleware for working with the akismet API'''
-
-    # Central Akismet server
-    baseurl = 'rest.akismet.com/1.1/'
-    # Needed form values
-    vals = set(['comment_type', 'comment_author', 'comment_author_email',
-            'comment_author_url', 'permalink'])
-
-    def __init__(self, application, key, blog_url, **kw):
-        self.application = application
-        self.key, self.blog_url = key, blog_url           
-        agent = kw.get('agent', DEFAULTAGENT % __version__)
-        self.user_agent = user_agent % (agent, __version__)
-        # Verify key if assertions enabled     
-        self.verify = kw.get('verify', False)
-        # Form key for comment 
-        self.comment_key = kw.get('comment', 'comment')
-        # Stub handler -- change
-        self.handler = kw.get('handler', _handler)        
-
-    def __call__(self, environ, start_response):
-        formdata = formparse(environ)
-        # Get comment
-        comment = formdata[self.comment_key]
-        # Fetch any corresponding values from the form submission
-        data = self._getvalues(formdata)
-        # Return handler if comment is spam
-        if self.iscomment(environ, comment, data):
-            return self.handler(environ, start_response)
-        return self.application(environ, start_response)        
-
-    def _getvalues(self, data):
-        '''Gets any form values corresponding to Akismet request.'''
-        return dict((k, data[k]) for k in data if k in self.vals)
-
-    def _build_data(self, environ, comment, data):
-        '''This function builds the data structure required by ``iscomment``.
-        
-        It modifies the ``data`` dictionary you give it in place. (and so
-        doesn't return anything)
-        '''
-        # Add comment
-        data['comment_content'] = comment
-        data['user_ip'] = environ.get('REMOTE_ADDR', '')
-        data['user_agent'] = environ.get('HTTP_USER_AGENT', '')
-        # Note the spelling 'referrer'. This is a required value by the
-        # akismet api - however, referrer information is not always
-        # supplied by the browser or server. In fact the HTTP protocol
-        # forbids relying on referrer information for functionality in 
-        # programs.
-        data['referrer'] = environ.get('HTTP_REFERER', 'unknown')
-        data.setdefault('permalink', '')
-        # The `API docs <http://akismet.com/development/api/>`_ state that this
-        # value can be '*blank, comment, trackback, pingback, or a made up value*
-        # *like 'registration'* '.
-        data.setdefault('comment_type', 'comment')
-        data.setdefault('comment_author', '')
-        data.setdefault('comment_author_email', '')
-        data.setdefault('comment_author_url', '')
-        data['SERVER_ADDR'] = environ.get('SERVER_ADDR', '')
-        data['SERVER_ADMIN'] = environ.get('SERVER_ADMIN', '')
-        data['SERVER_NAME'] = environ.get('SERVER_NAME', '')
-        data['SERVER_PORT'] = environ.get('SERVER_PORT', '')
-        data['SERVER_SIGNATURE'] = environ.get('SERVER_SIGNATURE', '')
-        data['SERVER_SOFTWARE'] = environ.get('SERVER_SOFTWARE', '')
-        data['HTTP_ACCEPT'] = environ.get('HTTP_ACCEPT', '')
-        data['blog'] = self.blog_url
-
-    def isvalidkey(self):
-        '''This equates to the ``verify-key`` call against the akismet API.
-        
-        It returns ``True`` if the key is valid.
-        
-        The docs state that you *ought* to call this at the start of the
-        transaction.'''        
-        data = {'key':self.key, 'blog':self.blog_url}
-        # this function *doesn't* use the key as part of the URL
-        url = 'http://%sverify-key' % self.baseurl
-        headers = {'User-Agent':self.user_agent}        
-        req = urllib2.Request(url, urlencode(data), headers)
-        try:
-            if urllib2.urlopen(req).read().lower() == 'valid': return True
-            return False
-        # Errors pass silently
-        except:
-            return False        
-
-    def iscomment(self, environ, comment, data):
-        '''This is the function that checks comments.
-        
-        It returns ``True`` for spam and ``False`` for ham.
-        
-        As a minimum it requires the environ and the body of the comment.
-        This is the ``comment`` argument.
-        
-        Akismet requires some other arguments, and allows some optional ones.
-        The more information you give it, the more likely it is to be able to
-        make an accurate diagnosise. You supply these values using a mapping
-        object (dictionary) as the ``data`` argument.
-        '''
-        # Verify API key if required
-        if self.verify and not self.isvalidkey(): return False
-        self._build_data(environ, comment, data)
-        url = '%scomment-check' % ('http://%s.%s' % (self.key, self.baseurl))
-        headers = {'User-Agent':self.user_agent}
-        req = urllib2.Request(url, urlencode(data), headers)
-        try:
-            if urllib2.urlopen(req).read().lower() == 'true': return True
-            return False
-        # Errors pass silently
-        except:
-            return True
+# Copyright (c) 2006 L. C. Rees.  All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#
+# 1.  Redistributions of source code must retain the above copyright notice,
+# this list of conditions and the following disclaimer.
+# 2.  Redistributions in binary form must reproduce the above copyright
+# notice, this list of conditions and the following disclaimer in the
+# documentation and/or other materials provided with the distribution.
+# 3.  Neither the name of the Portable Site Information Project nor the names
+# of its contributors may be used to endorse or promote products derived from
+# this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+
+'''setup - setuptools based setup for wsgiakismet.'''
+
+import ez_setup
+ez_setup.use_setuptools()
+
+try:
+    from setuptools import setup
+except:
+    from distutils.core import setup
+
+setup(name='wsgiakismet',
+      version='0.1',
+      description='''Akismet SPAM blocking WSGI middleware.''',
+      long_description='''Validates form submissions against the Akismet service
+to verify that they are not spam.
+
+Simple usage example:
+
+import cgi
+from wsgiakismet import akismet
+
+# Wordpress API Key and website name are required arguments
+@akisimet('3489012ab121', 'http://blog.example.com/')
+def app(env, start_response):
+    usersub = cgi.parse(fp=env['wsgi.input'], environ=env)
+    start_response('200 OK', [('Content-type', 'text/plain')])
+    return ['Comment is %s' % usersub['comment'][0]]
+''',
+      author='L. C. Rees',
+      author_email='lcrees@gmail.com',
+      license='BSD',
+      py_modules=['wsgiakismet'],
+      packages = ['tests'],
+      zip_safe = True,
+      keywords='WSGI comment spam blocking blog middleware web HTTP',
+      classifiers=['Development Status :: 4 - Beta',
+                    'Environment :: Web Environment',
+                    'License :: OSI Approved :: BSD License',
+                    'Natural Language :: English',
+                    'Operating System :: OS Independent',
+                    'Programming Language :: Python',
+                    'Topic :: Internet :: WWW/HTTP :: WSGI :: Middleware'])
+#! /usr/bin/env python
+
+# Copyright (c) 2006 L. C. Rees.  All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#
+# 1.  Redistributions of source code must retain the above copyright notice,
+# this list of conditions and the following disclaimer.
+# 2.  Redistributions in binary form must reproduce the above copyright
+# notice, this list of conditions and the following disclaimer in the
+# documentation and/or other materials provided with the distribution.
+# 3.  Neither the name of the Portable Site Information Project nor the names
+# of its contributors may be used to endorse or promote products derived from
+# this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+
+import unittest
+import wsgiakismet
+from StringIO import StringIO 
+from urllib import urlencode
+
+# Put valid Wordpress API key here to test
+key = '707659935d35'
+blog = 'http://www.example.com/'
+
+
+class TestWsgiAkisimet(unittest.TestCase):
+
+    def dummy_sr(self, status, headers, exc_info=None):
+        pass
+
+    def test_negative(self):
+        env = {
+        'HTTP_METHOD':'POST',
+        'wsgi.input':StringIO(''),
+        'QUERY_STRING':urlencode({'comment_author':'Bob Saunders',
+            'comment_author_email':'bob@saunders.net', 'comment_author_url':'',
+            'comment':'The post was informative.'}),
+        'REMOTE_ADDR':'207.89.134.5',
+        'HTTP_USER_AGENT':'Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 5.1; YPC 3.0.1; .NET CLR 1.1.4322; .NET CLR 2.0.50727)'
+        }
+        @wsgiakismet.akismet(key, blog)
+        def test(environ, start_response):
+            start_response('200 OK', [('Content-type', 'text/plain')])
+            return ['Good']
+        response = test(env, self.dummy_sr)
+        self.assertEqual(response[0], 'Good')
+
+    def test_positive(self):
+        env = {
+        'HTTP_METHOD':'POST',
+        'wsgi.input':StringIO(''),
+        'QUERY_STRING':urlencode({'comment_author':'viagra-test-123',
+            'comment_author_email':'viagra@viagraoffer.net', 'comment_author_url':'',
+            'comment':'VIAGRA! LOTS OF VIAGRA!'}),
+        'REMOTE_ADDR':'10.9.4.59',
+        'HTTP_USER_AGENT':'Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 5.1; YPC 3.0.1; .NET CLR 1.1.4322; .NET CLR 2.0.50727)'
+        }
+        @wsgiakismet.akismet(key, blog)
+        def test(environ, start_response):
+            start_response('200 OK', [('Content-type', 'text/plain')])
+            return ['Good']
+        response = test(env, self.dummy_sr)
+        self.assertEqual(response[0], 'Comment was spam.')          
+
+
+if __name__ == '__main__': unittest.main()
+       

tests/test_wsgiakismet.py

+#! /usr/bin/env python
+
+# Copyright (c) 2006 L. C. Rees.  All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are met:
+#
+# 1.  Redistributions of source code must retain the above copyright notice,
+# this list of conditions and the following disclaimer.
+# 2.  Redistributions in binary form must reproduce the above copyright
+# notice, this list of conditions and the following disclaimer in the
+# documentation and/or other materials provided with the distribution.
+# 3.  Neither the name of the Portable Site Information Project nor the names
+# of its contributors may be used to endorse or promote products derived from
+# this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+# POSSIBILITY OF SUCH DAMAGE.
+
+import unittest
+import wsgiakismet
+from StringIO import StringIO 
+from urllib import urlencode
+
+# Put valid Wordpress API key here to test
+key = ''
+blog = 'http://www.example.com/'
+
+
+class TestWsgiAkisimet(unittest.TestCase):
+
+    def dummy_sr(self, status, headers, exc_info=None):
+        pass
+
+    def test_negative(self):
+        env = {
+        'HTTP_METHOD':'POST',
+        'wsgi.input':StringIO(''),
+        'QUERY_STRING':urlencode({'comment_author':'Bob Saunders',
+            'comment_author_email':'bob@saunders.net', 'comment_author_url':'',
+            'comment':'The post was informative.'}),
+        'REMOTE_ADDR':'207.89.134.5',
+        'HTTP_USER_AGENT':'Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 5.1; YPC 3.0.1; .NET CLR 1.1.4322; .NET CLR 2.0.50727)'
+        }
+        @wsgiakismet.akismet(key, blog)
+        def test(environ, start_response):
+            start_response('200 OK', [('Content-type', 'text/plain')])
+            return ['Good']
+        response = test(env, self.dummy_sr)
+        self.assertEqual(response[0], 'Good')
+
+    def test_positive(self):
+        env = {
+        'HTTP_METHOD':'POST',
+        'wsgi.input':StringIO(''),
+        'QUERY_STRING':urlencode({'comment_author':'viagra-test-123',
+            'comment_author_email':'viagra@viagraoffer.net', 'comment_author_url':'',
+            'comment':'VIAGRA! LOTS OF VIAGRA!'}),
+        'REMOTE_ADDR':'10.9.4.59',
+        'HTTP_USER_AGENT':'Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 5.1; YPC 3.0.1; .NET CLR 1.1.4322; .NET CLR 2.0.50727)'
+        }
+        @wsgiakismet.akismet(key, blog)
+        def test(environ, start_response):
+            start_response('200 OK', [('Content-type', 'text/plain')])
+            return ['Good']
+        response = test(env, self.dummy_sr)
+        self.assertEqual(response[0], 'Comment was spam.')          
+
+
+if __name__ == '__main__': unittest.main()
+       

trunk/ez_setup.py

-#!python
-"""Bootstrap setuptools installation
-
-If you want to use setuptools in your package's setup.py, just include this
-file in the same directory with it, and add this to the top of your setup.py::
-
-    from ez_setup import use_setuptools
-    use_setuptools()
-
-If you want to require a specific version of setuptools, set a download
-mirror, or use an alternate download directory, you can do so by supplying
-the appropriate options to ``use_setuptools()``.
-
-This file can also be run as a script to install or upgrade setuptools.
-"""
-import sys
-DEFAULT_VERSION = "0.6a9"
-DEFAULT_URL     = "http://cheeseshop.python.org/packages/%s/s/setuptools/" % sys.version[:3]
-
-md5_data = {
-    'setuptools-0.5a13-py2.3.egg': '85edcf0ef39bab66e130d3f38f578c86',
-    'setuptools-0.5a13-py2.4.egg': 'ede4be600e3890e06d4ee5e0148e092a',
-    'setuptools-0.6a1-py2.3.egg': 'ee819a13b924d9696b0d6ca6d1c5833d',
-    'setuptools-0.6a1-py2.4.egg': '8256b5f1cd9e348ea6877b5ddd56257d',
-    'setuptools-0.6a2-py2.3.egg': 'b98da449da411267c37a738f0ab625ba',
-    'setuptools-0.6a2-py2.4.egg': 'be5b88bc30aed63fdefd2683be135c3b',
-    'setuptools-0.6a3-py2.3.egg': 'ee0e325de78f23aab79d33106dc2a8c8',
-    'setuptools-0.6a3-py2.4.egg': 'd95453d525a456d6c23e7a5eea89a063',
-    'setuptools-0.6a4-py2.3.egg': 'e958cbed4623bbf47dd1f268b99d7784',
-    'setuptools-0.6a4-py2.4.egg': '7f33c3ac2ef1296f0ab4fac1de4767d8',
-    'setuptools-0.6a5-py2.3.egg': '748408389c49bcd2d84f6ae0b01695b1',
-    'setuptools-0.6a5-py2.4.egg': '999bacde623f4284bfb3ea77941d2627',
-    'setuptools-0.6a6-py2.3.egg': '7858139f06ed0600b0d9383f36aca24c',
-    'setuptools-0.6a6-py2.4.egg': 'c10d20d29acebce0dc76219dc578d058',
-    'setuptools-0.6a7-py2.3.egg': 'cfc4125ddb95c07f9500adc5d6abef6f',
-    'setuptools-0.6a7-py2.4.egg': 'c6d62dab4461f71aed943caea89e6f20',
-    'setuptools-0.6a8-py2.3.egg': '2f18eaaa3f544f5543ead4a68f3b2e1a',
-    'setuptools-0.6a8-py2.4.egg': '799018f2894f14c9f8bcb2b34e69b391',
-    'setuptools-0.6a9-py2.3.egg': '8e438ad70438b07b0d8f82cae42b278f',
-    'setuptools-0.6a9-py2.4.egg': '8f6e01fc12fb1cd006dc0d6c04327ec1',
-}
-
-import sys, os
-
-def _validate_md5(egg_name, data):
-    if egg_name in md5_data:
-        from md5 import md5
-        digest = md5(data).hexdigest()
-        if digest != md5_data[egg_name]:
-            print >>sys.stderr, (
-                "md5 validation of %s failed!  (Possible download problem?)"
-                % egg_name
-            )
-            sys.exit(2)
-    return data    
-
-
-def use_setuptools(
-    version=DEFAULT_VERSION, download_base=DEFAULT_URL, to_dir=os.curdir,
-    download_delay=15
-):
-    """Automatically find/download setuptools and make it available on sys.path
-
-    `version` should be a valid setuptools version number that is available
-    as an egg for download under the `download_base` URL (which should end with
-    a '/').  `to_dir` is the directory where setuptools will be downloaded, if
-    it is not already available.  If `download_delay` is specified, it should
-    be the number of seconds that will be paused before initiating a download,
-    should one be required.  If an older version of setuptools is installed,
-    this routine will print a message to ``sys.stderr`` and raise SystemExit in
-    an attempt to abort the calling script.  
-    """
-    try:
-        import setuptools
-        if setuptools.__version__ == '0.0.1':
-            print >>sys.stderr, (
-            "You have an obsolete version of setuptools installed.  Please\n"
-            "remove it from your system entirely before rerunning this script."
-            )
-            sys.exit(2)
-    except ImportError:
-        egg = download_setuptools(version, download_base, to_dir, download_delay)
-        sys.path.insert(0, egg)
-        import setuptools; setuptools.bootstrap_install_from = egg
-
-    import pkg_resources
-    try:
-        pkg_resources.require("setuptools>="+version)
-
-    except pkg_resources.VersionConflict:
-        # XXX could we install in a subprocess here?
-        print >>sys.stderr, (
-            "The required version of setuptools (>=%s) is not available, and\n"
-            "can't be installed while this script is running. Please install\n"
-            " a more recent version first."
-        ) % version
-        sys.exit(2)
-
-def download_setuptools(
-    version=DEFAULT_VERSION, download_base=DEFAULT_URL, to_dir=os.curdir,
-    delay = 15
-):
-    """Download setuptools from a specified location and return its filename
-
-    `version` should be a valid setuptools version number that is available
-    as an egg for download under the `download_base` URL (which should end
-    with a '/'). `to_dir` is the directory where the egg will be downloaded.
-    `delay` is the number of seconds to pause before an actual download attempt.
-    """
-    import urllib2, shutil
-    egg_name = "setuptools-%s-py%s.egg" % (version,sys.version[:3])
-    url = download_base + egg_name
-    saveto = os.path.join(to_dir, egg_name)
-    src = dst = None
-    if not os.path.exists(saveto):  # Avoid repeated downloads
-        try:
-            from distutils import log
-            if delay:
-                log.warn("""
----------------------------------------------------------------------------
-This script requires setuptools version %s to run (even to display
-help).  I will attempt to download it for you (from
-%s), but
-you may need to enable firewall access for this script first.
-I will start the download in %d seconds.
----------------------------------------------------------------------------""",
-                    version, download_base, delay
-                ); from time import sleep; sleep(delay)
-            log.warn("Downloading %s", url)
-            src = urllib2.urlopen(url)
-            # Read/write all in one block, so we don't create a corrupt file
-            # if the download is interrupted.
-            data = _validate_md5(egg_name, src.read())
-            dst = open(saveto,"wb"); dst.write(data)
-        finally:
-            if src: src.close()
-            if dst: dst.close()
-    return os.path.realpath(saveto)
-
-def main(argv, version=DEFAULT_VERSION):
-    """Install or upgrade setuptools and EasyInstall"""
-
-    try:
-        import setuptools
-    except ImportError:
-        import tempfile, shutil
-        tmpdir = tempfile.mkdtemp(prefix="easy_install-")
-        try:
-            egg = download_setuptools(version, to_dir=tmpdir, delay=0)
-            sys.path.insert(0,egg)
-            from setuptools.command.easy_install import main
-            main(list(argv)+[egg])
-        finally:
-            shutil.rmtree(tmpdir)
-    else:
-        if setuptools.__version__ == '0.0.1':
-            # tell the user to uninstall obsolete version
-            use_setuptools(version)
-
-    req = "setuptools>="+version
-    import pkg_resources
-    try:
-        pkg_resources.require(req)
-    except pkg_resources.VersionConflict:
-        try:
-            from setuptools.command.easy_install import main
-        except ImportError:
-            from easy_install import main
-        main(list(argv)+[download_setuptools(delay=0)])
-        sys.exit(0) # try to force an exit
-    else:
-        if argv:
-            from setuptools.command.easy_install import main
-            main(argv)
-        else:
-            print "Setuptools version",version,"or greater has been installed."
-            print '(Run "ez_setup.py -U setuptools" to reinstall or upgrade.)'
-
-
-            
-def update_md5(filenames):
-    """Update our built-in md5 registry"""
-
-    import re
-    from md5 import md5
-
-    for name in filenames:
-        base = os.path.basename(name)
-        f = open(name,'rb')       
-        md5_data[base] = md5(f.read()).hexdigest()
-        f.close()
-
-    data = ["    %r: %r,\n" % it for it in md5_data.items()]
-    data.sort()
-    repl = "".join(data)
-
-    import inspect
-    srcfile = inspect.getsourcefile(sys.modules[__name__])
-    f = open(srcfile, 'rb'); src = f.read(); f.close()
-
-    match = re.search("\nmd5_data = {\n([^}]+)}", src)
-    if not match:
-        print >>sys.stderr, "Internal error!"
-        sys.exit(2)
-
-    src = src[:match.start(1)] + repl + src[match.end(1):]
-    f = open(srcfile,'w')
-    f.write(src)
-    f.close()
-
-
-if __name__=='__main__':
-    if len(sys.argv)>2 and sys.argv[1]=='--md5update':
-        update_md5(sys.argv[2:])
-    else:
-        main(sys.argv[1:])
-

trunk/setup.py

-# Copyright (c) 2006 L. C. Rees.  All rights reserved.
-#
-# Redistribution and use in source and binary forms, with or without
-# modification, are permitted provided that the following conditions are met:
-#
-# 1.  Redistributions of source code must retain the above copyright notice,
-# this list of conditions and the following disclaimer.
-# 2.  Redistributions in binary form must reproduce the above copyright
-# notice, this list of conditions and the following disclaimer in the
-# documentation and/or other materials provided with the distribution.
-# 3.  Neither the name of the Portable Site Information Project nor the names
-# of its contributors may be used to endorse or promote products derived from
-# this software without specific prior written permission.
-#
-# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
-# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
-# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
-# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
-# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
-# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
-# POSSIBILITY OF SUCH DAMAGE.
-
-'''setup - setuptools based setup for wsgiakismet.'''
-
-import ez_setup
-ez_setup.use_setuptools()
-
-try:
-    from setuptools import setup
-except:
-    from distutils.core import setup
-
-setup(name='wsgiakismet',
-      version='0.1',
-      description='''Akismet SPAM blocking WSGI middleware.''',
-      long_description='''Validates form submissions against the Akismet service
-to verify that they are not spam.
-
-Simple usage example:
-
-import cgi
-from wsgiakismet import akismet
-
-# Wordpress API Key and website name are required arguments
-@akisimet('3489012ab121', 'http://blog.example.com/')
-def app(env, start_response):
-    usersub = cgi.parse(fp=env['wsgi.input'], environ=env)
-    start_response('200 OK', [('Content-type', 'text/plain')])
-    return ['Comment is %s' % usersub['comment'][0]]
-''',
-      author='L. C. Rees',
-      author_email='lcrees@gmail.com',
-      license='BSD',
-      py_modules=['wsgiakismet'],
-      packages = ['tests'],
-      zip_safe = True,
-      keywords='WSGI comment spam blocking blog middleware web HTTP',
-      classifiers=['Development Status :: 4 - Beta',
-                    'Environment :: Web Environment',
-                    'License :: OSI Approved :: BSD License',
-                    'Natural Language :: English',
-                    'Operating System :: OS Independent',
-                    'Programming Language :: Python',
-                    'Topic :: Internet :: WWW/HTTP :: WSGI :: Middleware'])

trunk/test_wsgiakismet.py

-#! /usr/bin/env python
-
-# Copyright (c) 2006 L. C. Rees.  All rights reserved.
-#
-# Redistribution and use in source and binary forms, with or without
-# modification, are permitted provided that the following conditions are met:
-#
-# 1.  Redistributions of source code must retain the above copyright notice,
-# this list of conditions and the following disclaimer.
-# 2.  Redistributions in binary form must reproduce the above copyright
-# notice, this list of conditions and the following disclaimer in the
-# documentation and/or other materials provided with the distribution.
-# 3.  Neither the name of the Portable Site Information Project nor the names
-# of its contributors may be used to endorse or promote products derived from
-# this software without specific prior written permission.
-#
-# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
-# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
-# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
-# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
-# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
-# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
-# POSSIBILITY OF SUCH DAMAGE.
-
-import unittest
-import wsgiakismet
-from StringIO import StringIO 
-from urllib import urlencode
-
-# Put valid Wordpress API key here to test
-key = '707659935d35'
-blog = 'http://www.example.com/'
-
-
-class TestWsgiAkisimet(unittest.TestCase):
-
-    def dummy_sr(self, status, headers, exc_info=None):
-        pass
-
-    def test_negative(self):
-        env = {
-        'HTTP_METHOD':'POST',
-        'wsgi.input':StringIO(''),
-        'QUERY_STRING':urlencode({'comment_author':'Bob Saunders',
-            'comment_author_email':'bob@saunders.net', 'comment_author_url':'',
-            'comment':'The post was informative.'}),
-        'REMOTE_ADDR':'207.89.134.5',
-        'HTTP_USER_AGENT':'Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 5.1; YPC 3.0.1; .NET CLR 1.1.4322; .NET CLR 2.0.50727)'
-        }
-        @wsgiakismet.akismet(key, blog)
-        def test(environ, start_response):
-            start_response('200 OK', [('Content-type', 'text/plain')])
-            return ['Good']
-        response = test(env, self.dummy_sr)
-        self.assertEqual(response[0], 'Good')
-
-    def test_positive(self):
-        env = {
-        'HTTP_METHOD':'POST',
-        'wsgi.input':StringIO(''),
-        'QUERY_STRING':urlencode({'comment_author':'viagra-test-123',
-            'comment_author_email':'viagra@viagraoffer.net', 'comment_author_url':'',
-            'comment':'VIAGRA! LOTS OF VIAGRA!'}),
-        'REMOTE_ADDR':'10.9.4.59',
-        'HTTP_USER_AGENT':'Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 5.1; YPC 3.0.1; .NET CLR 1.1.4322; .NET CLR 2.0.50727)'
-        }
-        @wsgiakismet.akismet(key, blog)
-        def test(environ, start_response):
-            start_response('200 OK', [('Content-type', 'text/plain')])
-            return ['Good']
-        response = test(env, self.dummy_sr)
-        self.assertEqual(response[0], 'Comment was spam.')          
-
-
-if __name__ == '__main__': unittest.main()
-       

trunk/tests/test_wsgiakismet.py

-#! /usr/bin/env python
-
-# Copyright (c) 2006 L. C. Rees.  All rights reserved.
-#
-# Redistribution and use in source and binary forms, with or without
-# modification, are permitted provided that the following conditions are met:
-#
-# 1.  Redistributions of source code must retain the above copyright notice,
-# this list of conditions and the following disclaimer.
-# 2.  Redistributions in binary form must reproduce the above copyright
-# notice, this list of conditions and the following disclaimer in the
-# documentation and/or other materials provided with the distribution.
-# 3.  Neither the name of the Portable Site Information Project nor the names
-# of its contributors may be used to endorse or promote products derived from
-# this software without specific prior written permission.
-#
-# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
-# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
-# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
-# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
-# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
-# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
-# POSSIBILITY OF SUCH DAMAGE.
-
-import unittest
-import wsgiakismet
-from StringIO import StringIO 
-from urllib import urlencode
-
-# Put valid Wordpress API key here to test
-key = ''
-blog = 'http://www.example.com/'
-
-
-class TestWsgiAkisimet(unittest.TestCase):
-
-    def dummy_sr(self, status, headers, exc_info=None):
-        pass
-
-    def test_negative(self):
-        env = {
-        'HTTP_METHOD':'POST',
-        'wsgi.input':StringIO(''),
-        'QUERY_STRING':urlencode({'comment_author':'Bob Saunders',
-            'comment_author_email':'bob@saunders.net', 'comment_author_url':'',
-            'comment':'The post was informative.'}),
-        'REMOTE_ADDR':'207.89.134.5',
-        'HTTP_USER_AGENT':'Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 5.1; YPC 3.0.1; .NET CLR 1.1.4322; .NET CLR 2.0.50727)'
-        }
-        @wsgiakismet.akismet(key, blog)
-        def test(environ, start_response):
-            start_response('200 OK', [('Content-type', 'text/plain')])
-            return ['Good']
-        response = test(env, self.dummy_sr)
-        self.assertEqual(response[0], 'Good')
-
-    def test_positive(self):
-        env = {
-        'HTTP_METHOD':'POST',
-        'wsgi.input':StringIO(''),
-        'QUERY_STRING':urlencode({'comment_author':'viagra-test-123',
-            'comment_author_email':'viagra@viagraoffer.net', 'comment_author_url':'',
-            'comment':'VIAGRA! LOTS OF VIAGRA!'}),
-        'REMOTE_ADDR':'10.9.4.59',
-        'HTTP_USER_AGENT':'Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 5.1; YPC 3.0.1; .NET CLR 1.1.4322; .NET CLR 2.0.50727)'
-        }
-        @wsgiakismet.akismet(key, blog)
-        def test(environ, start_response):
-            start_response('200 OK', [('Content-type', 'text/plain')])
-            return ['Good']
-        response = test(env, self.dummy_sr)
-        self.assertEqual(response[0], 'Comment was spam.')          
-
-
-if __name__ == '__main__': unittest.main()
-       

trunk/wsgiakismet.py

-# Copyright Michael Foord 2005 & 2006
-# Copyright L.C. Rees 2006
-#
-# WSGI interface to the Akismet API
-# http://akismet.com
-#
-# Released subject to the BSD License
-# Please see http://www.voidspace.org.uk/python/license.shtml
-
-'''WSGI middleware implementing the Akismet Application Programmers Interface.
-This is a web service for blocking SPAM comments to blogs - or other online
-services. Based on akismet 0.1.3.
-
-You will need a Wordpress API key, from http://wordpress.com/.
-
-You should pass in the keyword argument 'agent' to the name of your program,
-when you create an Akismet instance. This sets the ``user-agent`` to a useful
-value. The default is:
-
-    Python Interface by Fuzzyman | wsgiakismet.py/0.1
-
-Whatever you pass in, will replace the *Python Interface by Fuzzyman* part.
-'''
-
-import cgi
-import urllib2
-import socket
-from urllib import urlencode
-from StringIO import StringIO
-
-__all__ = ['__version__', 'WsgiAkismet', 'akismet']
-__version__ = '0.1'
-__author__ = 'L.C. Rees <lcrees@gmail.com?'
-user_agent = '%s | wsgiakismet.py/%s'
-DEFAULTAGENT = 'Python Interface by Fuzzyman/%s'
-
-if hasattr(socket, 'setdefaulttimeout'):
-    # Set the default timeout on sockets to 5 seconds
-    socket.setdefaulttimeout(5)
-
-def formparse(env):
-    '''Extracts data from form submissions.
-
-    @param environ Environment dictionary
-    @param strict Stops on errors (default: False)
-    '''
-    winput = env['wsgi.input']
-    # Non-destructively retrieve string
-    if hasattr(winput, 'getvalue'):
-        tinput = winput.getvalue()
-    # Recreate wsgi.input as fallback
-    else:
-        tinput = winput.read()
-        env['wsgi.input'] = StringIO(tinput)
-    # Parse form submission
-    qdict = cgi.parse(fp=StringIO(tinput), environ=env)
-    # Remove invididual entries from list and store as naked string
-    for key, value in qdict.iteritems():
-        if len(value) == 1: qdict[key] = value[0]
-    return qdict
-
-def _handler(environ, start_response):
-    '''Replace this default handler.'''
-    start_response('200 OK', [('Content-type', 'text/plain')])
-    return ['Comment was spam.']
-
-def akismet(key, blog_url, **kw):
-    '''Decorator for Akismet.'''
-    def decorator(application):
-        return WsgiAkismet(application, key, blog_url, **kw)
-    return decorator
-
-
-class WsgiAkismet(object):
-    
-    '''WSGI middleware for working with the akismet API'''
-
-    # Central Akismet server
-    baseurl = 'rest.akismet.com/1.1/'
-    # Needed form values
-    vals = set(['comment_type', 'comment_author', 'comment_author_email',
-            'comment_author_url', 'permalink'])
-
-    def __init__(self, application, key, blog_url, **kw):
-        self.application = application
-        self.key, self.blog_url = key, blog_url           
-        agent = kw.get('agent', DEFAULTAGENT % __version__)
-        self.user_agent = user_agent % (agent, __version__)
-        # Verify key if assertions enabled     
-        self.verify = kw.get('verify', False)
-        # Form key for comment 
-        self.comment_key = kw.get('comment', 'comment')
-        # Stub handler -- change
-        self.handler = kw.get('handler', _handler)        
-
-    def __call__(self, environ, start_response):
-        formdata = formparse(environ)
-        # Get comment
-        comment = formdata[self.comment_key]
-        # Fetch any corresponding values from the form submission
-        data = self._getvalues(formdata)
-        # Return handler if comment is spam
-        if self.iscomment(environ, comment, data):
-            return self.handler(environ, start_response)
-        return self.application(environ, start_response)        
-
-    def _getvalues(self, data):
-        '''Gets any form values corresponding to Akismet request.'''
-        return dict((k, data[k]) for k in data if k in self.vals)
-
-    def _build_data(self, environ, comment, data):
-        '''This function builds the data structure required by ``iscomment``.
-        
-        It modifies the ``data`` dictionary you give it in place. (and so
-        doesn't return anything)
-        '''
-        # Add comment
-        data['comment_content'] = comment
-        data['user_ip'] = environ.get('REMOTE_ADDR', '')
-        data['user_agent'] = environ.get('HTTP_USER_AGENT', '')
-        # Note the spelling 'referrer'. This is a required value by the
-        # akismet api - however, referrer information is not always
-        # supplied by the browser or server. In fact the HTTP protocol
-        # forbids relying on referrer information for functionality in 
-        # programs.
-        data['referrer'] = environ.get('HTTP_REFERER', 'unknown')
-        data.setdefault('permalink', '')
-        # The `API docs <http://akismet.com/development/api/>`_ state that this
-        # value can be '*blank, comment, trackback, pingback, or a made up value*
-        # *like 'registration'* '.
-        data.setdefault('comment_type', 'comment')
-        data.setdefault('comment_author', '')
-        data.setdefault('comment_author_email', '')
-        data.setdefault('comment_author_url', '')
-        data['SERVER_ADDR'] = environ.get('SERVER_ADDR', '')
-        data['SERVER_ADMIN'] = environ.get('SERVER_ADMIN', '')
-        data['SERVER_NAME'] = environ.get('SERVER_NAME', '')
-        data['SERVER_PORT'] = environ.get('SERVER_PORT', '')
-        data['SERVER_SIGNATURE'] = environ.get('SERVER_SIGNATURE', '')
-        data['SERVER_SOFTWARE'] = environ.get('SERVER_SOFTWARE', '')
-        data['HTTP_ACCEPT'] = environ.get('HTTP_ACCEPT', '')
-        data['blog'] = self.blog_url
-
-    def isvalidkey(self):
-        '''This equates to the ``verify-key`` call against the akismet API.
-        
-        It returns ``True`` if the key is valid.
-        
-        The docs state that you *ought* to call this at the start of the
-        transaction.'''        
-        data = {'key':self.key, 'blog':self.blog_url}
-        # this function *doesn't* use the key as part of the URL
-        url = 'http://%sverify-key' % self.baseurl
-        headers = {'User-Agent':self.user_agent}        
-        req = urllib2.Request(url, urlencode(data), headers)
-        try:
-            if urllib2.urlopen(req).read().lower() == 'valid': return True
-            return False
-        # Errors pass silently
-        except:
-            return False        
-
-    def iscomment(self, environ, comment, data):
-        '''This is the function that checks comments.
-        
-        It returns ``True`` for spam and ``False`` for ham.
-        
-        As a minimum it requires the environ and the body of the comment.
-        This is the ``comment`` argument.
-        
-        Akismet requires some other arguments, and allows some optional ones.
-        The more information you give it, the more likely it is to be able to
-        make an accurate diagnosise. You supply these values using a mapping
-        object (dictionary) as the ``data`` argument.
-        '''
-        # Verify API key if required
-        if self.verify and not self.isvalidkey(): return False
-        self._build_data(environ, comment, data)
-        url = '%scomment-check' % ('http://%s.%s' % (self.key, self.baseurl))
-        headers = {'User-Agent':self.user_agent}
-        req = urllib2.Request(url, urlencode(data), headers)
-        try:
-            if urllib2.urlopen(req).read().lower() == 'true': return True
-            return False
-        # Errors pass silently
-        except:
-            return True
+# Copyright Michael Foord 2005 & 2006
+# Copyright L.C. Rees 2006
+#
+# WSGI interface to the Akismet API
+# http://akismet.com
+#
+# Released subject to the BSD License
+# Please see http://www.voidspace.org.uk/python/license.shtml
+
+'''WSGI middleware implementing the Akismet Application Programmers Interface.
+This is a web service for blocking SPAM comments to blogs - or other online
+services. Based on akismet 0.1.3.
+
+You will need a Wordpress API key, from http://wordpress.com/.
+
+You should pass in the keyword argument 'agent' to the name of your program,
+when you create an Akismet instance. This sets the ``user-agent`` to a useful
+value. The default is:
+
+    Python Interface by Fuzzyman | wsgiakismet.py/0.1
+
+Whatever you pass in, will replace the *Python Interface by Fuzzyman* part.
+'''
+
+import cgi
+import urllib2
+import socket
+from urllib import urlencode
+from StringIO import StringIO
+
+__all__ = ['__version__', 'WsgiAkismet', 'akismet']
+__version__ = '0.1'
+__author__ = 'L.C. Rees <lcrees@gmail.com?'
+user_agent = '%s | wsgiakismet.py/%s'
+DEFAULTAGENT = 'Python Interface by Fuzzyman/%s'
+
+if hasattr(socket, 'setdefaulttimeout'):
+    # Set the default timeout on sockets to 5 seconds
+    socket.setdefaulttimeout(5)
+
+def formparse(env):
+    '''Extracts data from form submissions.
+
+    @param environ Environment dictionary
+    @param strict Stops on errors (default: False)
+    '''
+    winput = env['wsgi.input']
+    # Non-destructively retrieve string
+    if hasattr(winput, 'getvalue'):
+        tinput = winput.getvalue()
+    # Recreate wsgi.input as fallback
+    else:
+        tinput = winput.read()
+        env['wsgi.input'] = StringIO(tinput)
+    # Parse form submission
+    qdict = cgi.parse(fp=StringIO(tinput), environ=env)
+    # Remove invididual entries from list and store as naked string
+    for key, value in qdict.iteritems():
+        if len(value) == 1: qdict[key] = value[0]
+    return qdict
+
+def _handler(environ, start_response):
+    '''Replace this default handler.'''
+    start_response('200 OK', [('Content-type', 'text/plain')])
+    return ['Comment was spam.']
+
+def akismet(key, blog_url, **kw):
+    '''Decorator for Akismet.'''
+    def decorator(application):
+        return WsgiAkismet(application, key, blog_url, **kw)
+    return decorator
+
+
+class WsgiAkismet(object):
+    
+    '''WSGI middleware for working with the akismet API'''
+
+    # Central Akismet server
+    baseurl = 'rest.akismet.com/1.1/'
+    # Needed form values
+    vals = set(['comment_type', 'comment_author', 'comment_author_email',
+            'comment_author_url', 'permalink'])
+
+    def __init__(self, application, key, blog_url, **kw):
+        self.application = application
+        self.key, self.blog_url = key, blog_url           
+        agent = kw.get('agent', DEFAULTAGENT % __version__)
+        self.user_agent = user_agent % (agent, __version__)
+        # Verify key if assertions enabled     
+        self.verify = kw.get('verify', False)
+        # Form key for comment 
+        self.comment_key = kw.get('comment', 'comment')
+        # Stub handler -- change
+        self.handler = kw.get('handler', _handler)        
+
+    def __call__(self, environ, start_response):
+        formdata = formparse(environ)
+        # Get comment
+        comment = formdata[self.comment_key]
+        # Fetch any corresponding values from the form submission
+        data = self._getvalues(formdata)
+        # Return handler if comment is spam
+        if self.iscomment(environ, comment, data):
+            return self.handler(environ, start_response)
+        return self.application(environ, start_response)        
+
+    def _getvalues(self, data):
+        '''Gets any form values corresponding to Akismet request.'''
+        return dict((k, data[k]) for k in data if k in self.vals)
+
+    def _build_data(self, environ, comment, data):
+        '''This function builds the data structure required by ``iscomment``.
+        
+        It modifies the ``data`` dictionary you give it in place. (and so
+        doesn't return anything)
+        '''
+        # Add comment
+        data['comment_content'] = comment
+        data['user_ip'] = environ.get('REMOTE_ADDR', '')
+        data['user_agent'] = environ.get('HTTP_USER_AGENT', '')
+        # Note the spelling 'referrer'. This is a required value by the
+        # akismet api - however, referrer information is not always
+        # supplied by the browser or server. In fact the HTTP protocol
+        # forbids relying on referrer information for functionality in 
+        # programs.
+        data['referrer'] = environ.get('HTTP_REFERER', 'unknown')
+        data.setdefault('permalink', '')
+        # The `API docs <http://akismet.com/development/api/>`_ state that this
+        # value can be '*blank, comment, trackback, pingback, or a made up value*
+        # *like 'registration'* '.
+        data.setdefault('comment_type', 'comment')
+        data.setdefault('comment_author', '')
+        data.setdefault('comment_author_email', '')
+        data.setdefault('comment_author_url', '')
+        data['SERVER_ADDR'] = environ.get('SERVER_ADDR', '')
+        data['SERVER_ADMIN'] = environ.get('SERVER_ADMIN', '')
+        data['SERVER_NAME'] = environ.get('SERVER_NAME', '')
+        data['SERVER_PORT'] = environ.get('SERVER_PORT', '')
+        data['SERVER_SIGNATURE'] = environ.get('SERVER_SIGNATURE', '')
+        data['SERVER_SOFTWARE'] = environ.get('SERVER_SOFTWARE', '')
+        data['HTTP_ACCEPT'] = environ.get('HTTP_ACCEPT', '')
+        data['blog'] = self.blog_url
+
+    def isvalidkey(self):
+        '''This equates to the ``verify-key`` call against the akismet API.
+        
+        It returns ``True`` if the key is valid.
+        
+        The docs state that you *ought* to call this at the start of the
+        transaction.'''        
+        data = {'key':self.key, 'blog':self.blog_url}
+        # this function *doesn't* use the key as part of the URL
+        url = 'http://%sverify-key' % self.baseurl
+        headers = {'User-Agent':self.user_agent}        
+        req = urllib2.Request(url, urlencode(data), headers)
+        try:
+            if urllib2.urlopen(req).read().lower() == 'valid': return True
+            return False
+        # Errors pass silently
+        except:
+            return False        
+
+    def iscomment(self, environ, comment, data):
+        '''This is the function that checks comments.
+        
+        It returns ``True`` for spam and ``False`` for ham.
+        
+        As a minimum it requires the environ and the body of the comment.
+        This is the ``comment`` argument.
+        
+        Akismet requires some other arguments, and allows some optional ones.
+        The more information you give it, the more likely it is to be able to
+        make an accurate diagnosise. You supply these values using a mapping
+        object (dictionary) as the ``data`` argument.
+        '''
+        # Verify API key if required
+        if self.verify and not self.isvalidkey(): return False
+        self._build_data(environ, comment, data)
+        url = '%scomment-check' % ('http://%s.%s' % (self.key, self.baseurl))
+        headers = {'User-Agent':self.user_agent}
+        req = urllib2.Request(url, urlencode(data), headers)
+        try:
+            if urllib2.urlopen(req).read().lower() == 'true': return True
+            return False
+        # Errors pass silently
+        except:
+            return True