Adding rakismet 1.3.0

Antonio Terceiro
1 parent 53dfdbc8
Showing 21 changed files with 917 additions and 0 deletions Show diff stats
vendor/plugins/rakismet/CHANGELOG
vendor/plugins/rakismet/Gemfile
vendor/plugins/rakismet/MIT-LICENSE
vendor/plugins/rakismet/README.md
vendor/plugins/rakismet/Rakefile
vendor/plugins/rakismet/lib/rakismet.rb
vendor/plugins/rakismet/lib/rakismet/middleware.rb
vendor/plugins/rakismet/lib/rakismet/model.rb
vendor/plugins/rakismet/lib/rakismet/railtie.rb
vendor/plugins/rakismet/lib/rakismet/version.rb
vendor/plugins/rakismet/rakismet.gemspec
vendor/plugins/rakismet/spec/.rspec
vendor/plugins/rakismet/spec/models/block_params_spec.rb
vendor/plugins/rakismet/spec/models/custom_params_spec.rb
vendor/plugins/rakismet/spec/models/extended_params_spec.rb
vendor/plugins/rakismet/spec/models/rakismet_model_spec.rb
vendor/plugins/rakismet/spec/models/request_params_spec.rb
vendor/plugins/rakismet/spec/models/subclass_spec.rb
vendor/plugins/rakismet/spec/rakismet_middleware_spec.rb
vendor/plugins/rakismet/spec/rakismet_spec.rb
@@ -0,0 +1,35 @@
+* Clean up gemspec and load paths [Steven Harman]
+* Add Akismet is_test param [Steven Harman]
+* Add Akismet user_role attribute [Steven Harman]
+= 1.2.1
+* Fix deprecated usage of HTTPResponse for Ruby 1.9.3 [Leonid Shevtsov]
+= 1.2.0
+* Rakismet attribute mappings are now inheritable
+= 1.1.2
+* Explicitly load version
+= 1.1.1
+* Fix SafeBuffer error under Rails 3.0.8 and 3.0.9 [Brandon Ferguson]
+* Readme cleanup [Zeke Sikelianos]
+* Drop Jeweler in favor of Bundler's gem tasks
+= 1.1.0
+* Add HTTP Proxy support [Francisco Trindade]
+= 1.0.1
+* Fix hash access for Ruby 1.9 [Alex Crichton]
+= 1.0.0
+* Update for Rails 3
+* Remove filters and replace with middleware
+* Remove initializers and replace with Railtie
+= 0.4.0
+* Rakismet is no longer injected into ActiveRecord or ActionController
+* API changes to support newly decoupled modules
+* Use Jeweler to manage gemspec
+= 0.3.6
+* Allow attributes to fall through to methods or AR attributes
+= 0.3.5
+* Added gemspec and rails/init.rb so rakismet can work as a gem [Michael Air]
+* Added generator template and manifest [Michael Air]
+= 0.3.0
+* Abstract out Rakismet version string
+* Set default Akismet Host
+* Abstract out the Akismet host [Mike Burns]
+* Started keeping a changelog :P
@@ -0,0 +1,3 @@
+source "http://rubygems.org"
+
+gemspec
@@ -0,0 +1,20 @@
+Copyright (c) 2008 Josh French
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
@@ -0,0 +1,229 @@
+Rakismet
+========
+
+**Akismet** (<http://akismet.com/>) is a collaborative spam filtering service.
+**Rakismet** is easy Akismet integration with Rails and rack apps. TypePad's
+AntiSpam service and generic Akismet endpoints are supported.
+
+Compatibility
+=============
+
+**Rakismet >= 1.0.0** work with Rails 3 and other Rack-based frameworks.
+
+**Rakismet <= 0.4.2** is compatible with Rails 2.
+
+Getting Started
+===============
+
+Once you've installed the Rakismet gem and added it to your application's Gemfile,
+you'll need an API key. Head on over to http://akismet.com/signup/ and sign up
+for a new username.
+
+Configure the Rakismet key and the URL of your application by setting the following
+in application.rb:
+
+```ruby
+config.rakismet.key = 'your wordpress key'
+config.rakismet.url = 'http://yourdomain.com/'
+```
+
+or an initializer, for example `config/initializers/rakismet.rb`:
+
+```ruby
+YourApp::Application.config.rakismet.key = 'your wordpress key'
+YourApp::Application.config.rakismet.url = 'http://yourdomain.com/'
+```
+
+If you wish to use another Akismet-compatible API provider such as TypePad's
+antispam service, you'll also need to set `config.rakismet.host` to your service
+provider's endpoint.
+
+If you want to use a proxy to access akismet (i.e. your application is behind a
+firewall), set the proxy_host and proxy_port option.
+
+```ruby
+config.rakismet.proxy_host = 'http://yourdomain.com/'
+config.rakismet.proxy_port = '8080'
+```
+
+Checking For Spam
+-----------------
+
+First, introduce Rakismet to your model:
+
+```ruby
+class Comment
+  include Rakismet::Model
+end
+```
+
+With Rakismet mixed in to your model, you'll get three instance methods for interacting with
+Akismet:
+
+ * `spam?` submits the comment to Akismet and returns true if Akismet thinks the comment is spam, false if not.
+ * `ham!` resubmits a valid comment that Akismet erroneously marked as spam (marks it as a false positive.)
+ * `spam!` resubmits a spammy comment that Akismet missed (marks it as a false negative.)
+
+The `ham!` and `spam!` methods will change the value of `spam?` but their
+primary purpose is to send feedback to Akismet. The service works best when you
+help correct the rare mistake; please consider using these methods if you're
+moderating comments or otherwise reviewing the Akismet responses.
+
+Configuring Your Model
+----------------------
+
+Rakismet sends the following information to the spam-hungry robots at Akismet:
+
+    author        : name submitted with the comment
+    author_url    : URL submitted with the comment
+    author_email  : email submitted with the comment
+    comment_type  : Defaults to comment but you can set it to trackback, pingback, or something more appropriate
+    content       : the content submitted
+    permalink     : the permanent URL for the entry the comment belongs to
+    user_ip       : IP address used to submit this comment
+    user_agent    : user agent string
+    referrer      : referring URL (note the spelling)
+
+By default, Rakismet just looks for attributes or methods on your class that
+match these names. You don't have to have accessors that match these exactly,
+however. If yours differ, just tell Rakismet what to call them:
+
+```ruby
+class Comment
+  include Rakismet::Model
+  attr_accessor :commenter_name, :commenter_email
+  rakismet_attrs :author => :commenter_name, :author_email => :commenter_email
+end
+```
+
+Or you can pass in a proc, to access associations:
+
+```ruby
+class Comment < ActiveRecord::Base
+  include Rakismet::Model
+  belongs_to :author
+  rakismet_attrs  :author => proc { author.name },
+                  :author_email => proc { author.email }
+end
+```
+
+You can even hard-code specific fields:
+
+```ruby
+class Trackback
+  include Rakismet::Model
+  rakismet_attrs :comment_type => "trackback"
+end
+```
+
+Optional Request Variables
+--------------------------
+
+Akismet wants certain information about the request environment: remote IP, the
+user agent string, and the HTTP referer when available. Normally, Rakismet
+asks your model for these. Storing this information on your model allows you to
+call the `spam?` method at a later time. For instance, maybe you're storing your
+comments in an administrative queue or processing them with a background job.
+
+You don't need to have these three attributes on your model, however. If you
+choose to omit them, Rakismet will instead look at the current request (if one
+exists) and take the values from the request object instead.
+
+This means that if you are **not storing the request variables**, you must call
+`spam?` from within the controller action that handles comment submissions. That
+way the IP, user agent, and referer will belong to the person submitting the
+comment. If you're not storing the request variables and you call `spam?` at a
+later time, the request information will be missing or invalid and Akismet won't
+be able to do its job properly.
+
+If you've decided to handle the request variables yourself, you can disable the
+middleware responsible for tracking the request information by adding this to
+your app initialization:
+
+```ruby
+config.rakismet.use_middleware = false
+```
+
+Testing
+-------
+
+Rakismet can be configued to tell Akismet that it should operate in test mode -
+so Akismet will not change its behavior based on any test API calls, meaning
+they will have no training effect. That means your tests can be somewhat
+repeatable in the sense that one test won't influence subsequent calls.
+
+You can configure Rakismet for test mode via application.rb:
+
+```ruby
+config.rakismet.test = false # <- default
+config.rakismet.test = true
+```
+
+Or via an initializer:
+
+```ruby
+YourApp::Application.config.rakismet.test = false # <- default
+YourApp::Application.config.rakismet.test = true
+```
+
+**NOTE**: When running in Rails, Rakismet will run in test mode when your Rails
+environment is `test` or `development`, unless explictly configured otherwise.
+Outside of Rails Rakismet defaults to test mode turned **off**.
+
+
+Verifying Responses
+-------------------
+
+If you want to see what's happening behind the scenes, after you call one of
+`@comment.spam?`, `@comment.spam!` or `@comment.ham!` you can check
+`@comment.akismet_response`.
+
+This will contain the last response from the Akismet server. In the case of
+`spam?` it should be `true` or `false.` For `spam!` and `ham!` it should be
+`Feedback received.` If Akismet returned an error instead (e.g. if you left out
+some required information) this will contain the error message.
+
+FAQ
+===
+
+Why does Akismet think all of my test data is spam?
+---------------------------------------------------
+
+Akismet needs enough information to decide if your test data is spam or not.
+Try to supply as much as possible, especially the author name and request
+variables.
+
+How can I simulate a spam submission?
+-------------------------------------
+
+Most people have the opposite problem, where Akismet doesn't think anything is
+spam. The only guaranteed way to trigger a positive spam response is to set the
+comment author to "viagra-test-123".
+
+If you've done this and `spam?` is still returning false, you're probably
+missing the user IP or one of the key/url config variables. One way to check is
+to call `@comment.akismet_response`. If you are missing a required field or
+there was another error, this will hold the Akismet error message. If your comment
+was processed normally, this value will simply be `true` or `false`.
+
+Can I use Rakismet with a different ORM or framework?
+-----------------------------------------------------
+
+Sure. Rakismet doesn't care what your persistence layer is. It will work with
+Datamapper, a NoSQL store, or whatever next month's DB flavor is.
+
+Rakismet also has no dependencies on Rails or any of its components, and only
+uses a small Rack middleware object to do some of its magic. Depending on your
+framework, you may have to modify this slightly and/or manually place it in your
+stack.
+
+You'll also need to set a few config variables by hand. Instead of
+`config.rakismet.key`, `config.rakismet.url`, and `config.rakismet.host`, set
+these values directly with `Rakismet.key`, `Rakismet.url`, and `Rakismet.host`.
+
+---------------------------------------------------------------------------
+
+If you have any implementation or usage questions, don't hesitate to get in
+touch: josh@vitamin-j.com.
+
+Copyright (c) 2008 Josh French, released under the MIT license
@@ -0,0 +1,9 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new do |spec|
+  spec.rspec_opts = ["--color", "--format progress"]
+end
+
+task :default => :spec
 \ No newline at end of file
@@ -0,0 +1,88 @@
+require 'net/http'
+require 'uri'
+require 'cgi'
+require 'yaml'
+
+require 'rakismet/model'
+require 'rakismet/middleware'
+require 'rakismet/version'
+require 'rakismet/railtie.rb' if defined?(Rails)
+
+module Rakismet
+  Request = Struct.new(:user_ip, :user_agent, :referrer)
+  Undefined = Class.new(NameError)
+
+  class << self
+    attr_accessor :key, :url, :host, :proxy_host, :proxy_port, :test
+
+    def request
+      @request ||= Request.new
+    end
+
+    def set_request_vars(env)
+      request.user_ip, request.user_agent, request.referrer =
+        env['REMOTE_ADDR'], env['HTTP_USER_AGENT'], env['HTTP_REFERER']
+    end
+
+    def clear_request
+      @request = Request.new
+    end
+
+    def headers
+      @headers ||= begin
+        user_agent = "Rakismet/#{Rakismet::VERSION}"
+        user_agent = "Rails/#{Rails.version} | " + user_agent if defined?(Rails)
+        { 'User-Agent' => user_agent, 'Content-Type' => 'application/x-www-form-urlencoded' }
+      end
+    end
+
+    def validate_key
+      validate_config
+      akismet = URI.parse(verify_url)
+      response = Net::HTTP::Proxy(proxy_host, proxy_port).start(akismet.host) do |http|
+        data = "key=#{Rakismet.key}&blog=#{Rakismet.url}"
+        http.post(akismet.path, data, Rakismet.headers)
+      end
+      @valid_key = (response.body == 'valid')
+    end
+
+    def valid_key?
+      @valid_key == true
+    end
+
+    def akismet_call(function, args={})
+      validate_config
+      args.merge!(:blog => Rakismet.url, :is_test => Rakismet.test_mode)
+      akismet = URI.parse(call_url(function))
+      response = Net::HTTP::Proxy(proxy_host, proxy_port).start(akismet.host) do |http|
+        params = args.map do |k,v|
+          param = v.class < String ? v.to_str : v.to_s # for ActiveSupport::SafeBuffer and Nil, respectively
+          "#{k}=#{CGI.escape(param)}"
+        end
+        http.post(akismet.path, params.join('&'), Rakismet.headers)
+      end
+      response.body
+    end
+
+    protected
+
+    def verify_url
+      "http://#{Rakismet.host}/1.1/verify-key"
+    end
+
+    def call_url(function)
+      "http://#{Rakismet.key}.#{Rakismet.host}/1.1/#{function}"
+    end
+
+    def validate_config
+      raise Undefined, "Rakismet.key is not defined"  if Rakismet.key.nil? || Rakismet.key.empty?
+      raise Undefined, "Rakismet.url is not defined"  if Rakismet.url.nil? || Rakismet.url.empty?
+      raise Undefined, "Rakismet.host is not defined" if Rakismet.host.nil? || Rakismet.host.empty?
+    end
+
+    def test_mode
+      test ? 1 : 0
+    end
+  end
+
+end
@@ -0,0 +1,16 @@
+module Rakismet
+  class Middleware
+
+    def initialize(app)
+      @app = app
+    end
+
+    def call(env)
+      Rakismet.set_request_vars(env)
+      response = @app.call(env)
+      Rakismet.clear_request
+      response
+    end
+
+  end
+end
@@ -0,0 +1,86 @@
+module Rakismet
+  module Model
+
+    def self.included(base)
+      base.class_eval do
+        attr_accessor :akismet_response
+        class << self; attr_accessor :akismet_attrs; end
+        extend ClassMethods
+        include InstanceMethods
+        self.rakismet_attrs
+      end
+    end
+
+    module ClassMethods
+      def rakismet_attrs(args={})
+        self.akismet_attrs ||= {}
+        [:comment_type, :author, :author_url, :author_email, :content, :user_role].each do |field|
+          # clunky, but throwing around +type+ will break your heart
+          fieldname = field.to_s =~ %r(^comment_) ? field : "comment_#{field}".intern
+          self.akismet_attrs[fieldname] = args.delete(field) || field
+        end
+        [:user_ip, :user_agent, :referrer].each do |field|
+          self.akismet_attrs[field] = args.delete(field) || field
+        end
+        args.each_pair do |f,v|
+          self.akismet_attrs[f] = v
+        end
+      end
+
+      def inherited(subclass)
+        super
+        subclass.rakismet_attrs akismet_attrs.dup
+      end
+    end
+
+    module InstanceMethods
+      def spam?
+        if instance_variable_defined? :@_spam
+          @_spam
+        else
+          data = akismet_data
+          self.akismet_response = Rakismet.akismet_call('comment-check', data)
+          @_spam = self.akismet_response == 'true'
+        end
+      end
+
+      def spam!
+        Rakismet.akismet_call('submit-spam', akismet_data)
+        @_spam = true
+      end
+
+      def ham!
+        Rakismet.akismet_call('submit-ham', akismet_data)
+        @_spam = false
+      end
+
+      private
+
+        def akismet_data
+          akismet = self.class.akismet_attrs.keys.inject({}) do |data,attr|
+            mapped_field = self.class.akismet_attrs[attr]
+            data.merge attr =>  if mapped_field.is_a?(Proc)
+                                  instance_eval(&mapped_field)
+                                elsif !mapped_field.nil? && respond_to?(mapped_field)
+                                  send(mapped_field)
+                                elsif not [:comment_type, :author, :author_email,
+                                        :author_url, :content, :user_role,
+                                        :user_ip, :referrer,
+                                        :user_agent].include?(mapped_field)
+                                  # we've excluded any fields that appear to
+                                  # have their default unmapped values
+                                  mapped_field
+                                elsif respond_to?(attr)
+                                  send(attr)
+                                elsif Rakismet.request.respond_to?(attr)
+                                  Rakismet.request.send(attr)
+                                end
+          end
+          akismet.delete_if { |k,v| v.nil? || v.empty? }
+          akismet[:comment_type] ||= 'comment'
+          akismet
+        end
+    end
+
+  end
+end
@@ -0,0 +1,22 @@
+require 'rails'
+require 'rakismet'
+
+module Rakismet
+  class Railtie < Rails::Railtie
+
+      config.rakismet = ActiveSupport::OrderedOptions.new
+      config.rakismet.host = 'rest.akismet.com'
+      config.rakismet.use_middleware = true
+
+      initializer 'rakismet.setup', :after => :load_config_initializers do |app|
+        Rakismet.key = app.config.rakismet[:key]
+        Rakismet.url = app.config.rakismet[:url]
+        Rakismet.host = app.config.rakismet[:host]
+        Rakismet.proxy_host = app.config.rakismet[:proxy_host]
+        Rakismet.proxy_port = app.config.rakismet[:proxy_port]
+        Rakismet.test = app.config.rakismet.fetch(:test) { Rails.env.test? || Rails.env.development? }
+        app.middleware.use Rakismet::Middleware if app.config.rakismet.use_middleware
+      end
+
+  end
+end
@@ -0,0 +1,3 @@
+module Rakismet
+  VERSION = "1.2.1"
+end
@@ -0,0 +1,25 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/rakismet/version', __FILE__)
+
+Gem::Specification.new do |s|
+  s.name = "rakismet"
+  s.version = Rakismet::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors = ["Josh French"]
+  s.email = "josh@vitamin-j.com"
+  s.homepage = "http://github.com/joshfrench/rakismet"
+  s.summary = "Akismet and TypePad AntiSpam integration for Rails."
+  s.description = "Rakismet is the easiest way to integrate Akismet or TypePad's AntiSpam into your Rails app."
+  s.date = "2012-04-22"
+
+  s.rubyforge_project = "rakismet"
+  s.add_development_dependency "rake"
+  s.add_development_dependency "rspec", "~> 2.11"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+  s.extra_rdoc_files = ["README.md"]
+end
+
@@ -0,0 +1 @@
+--color
@@ -0,0 +1,25 @@
+require  'spec_helper'
+
+PROC = proc { author.reverse }
+
+class BlockAkismetModel
+  include Rakismet::Model
+  rakismet_attrs :author => PROC
+end
+
+describe BlockAkismetModel do
+
+  before do
+    @block = BlockAkismetModel.new
+    comment_attrs.each_pair { |k,v| @block.stub!(k).and_return(v) }
+  end
+
+  it "should accept a block" do
+    BlockAkismetModel.akismet_attrs[:comment_author].should eql(PROC)
+  end
+
+  it "should eval block with self = instance" do
+    data = @block.send(:akismet_data)
+    data[:comment_author].should eql(comment_attrs[:author].reverse)
+  end
+end
@@ -0,0 +1,20 @@
+require  'spec_helper'
+
+MAPPED_PARAMS = { :comment_type => :type2, :author => :author2, :content => :content2,
+                  :author_email => :author_email2, :author_url => :author_url2,
+                  :user_role => :user_role2 }
+
+class CustomAkismetModel
+  include Rakismet::Model
+  rakismet_attrs MAPPED_PARAMS.dup
+end
+
+
+describe CustomAkismetModel do
+  it "should override default mappings" do
+    [:comment_type, :author, :author_url, :author_email, :content, :user_role].each do |field|
+      fieldname = field.to_s =~ %r(^comment_) ? field : "comment_#{field}".intern
+       CustomAkismetModel.akismet_attrs[fieldname].should eql(MAPPED_PARAMS[field])
+     end
+  end
+end
@@ -0,0 +1,16 @@
+require  'spec_helper'
+
+EXTRA = { :extra => :extra, :another => lambda { } }
+
+class ExtendedAkismetModel
+  include Rakismet::Model
+  rakismet_attrs EXTRA.dup
+end
+
+describe ExtendedAkismetModel do
+  it "should include additional attributes" do
+    [:extra, :another].each do |field|
+      ExtendedAkismetModel.akismet_attrs[field].should eql(EXTRA[field])
+    end
+  end
+end
@@ -0,0 +1,98 @@
+require  'spec_helper'
+
+describe AkismetModel do
+
+  before do
+    @model = AkismetModel.new
+    comment_attrs.each_pair { |k,v| @model.stub!(k).and_return(v) }
+  end
+
+  it "should have default mappings" do
+    [:comment_type, :author, :author_email, :author_url, :content, :user_role].each do |field|
+      fieldname = field.to_s =~ %r(^comment_) ? field : "comment_#{field}".intern
+      AkismetModel.akismet_attrs[fieldname].should eql(field)
+     end
+  end
+
+  it "should have request mappings" do
+    [:user_ip, :user_agent, :referrer].each do |field|
+      AkismetModel.akismet_attrs[field].should eql(field)
+     end
+  end
+
+  it "should populate comment type" do
+    @model.send(:akismet_data)[:comment_type].should == comment_attrs[:comment_type]
+  end
+
+  describe ".spam?" do
+
+    it "should use request variables from Rakismet.request if absent in model" do
+      [:user_ip, :user_agent, :referrer].each do |field|
+        @model.should_not respond_to(:field)
+      end
+      Rakismet.stub!(:request).and_return(request)
+      Rakismet.should_receive(:akismet_call).
+                with('comment-check', akismet_attrs.merge(:user_ip => '127.0.0.1',
+                                                          :user_agent => 'RSpec',
+                                                          :referrer => 'http://test.host/referrer'))
+      @model.spam?
+    end
+
+    it "should cache result of #spam?" do
+      Rakismet.should_receive(:akismet_call).once
+      @model.spam?
+      @model.spam?
+    end
+
+    it "should be true if comment is spam" do
+      Rakismet.stub!(:akismet_call).and_return('true')
+      @model.should be_spam
+    end
+
+    it "should be false if comment is not spam" do
+      Rakismet.stub!(:akismet_call).and_return('false')
+      @model.should_not be_spam
+    end
+
+    it "should set akismet_response" do
+      Rakismet.stub!(:akismet_call).and_return('response')
+      @model.spam?
+      @model.akismet_response.should eql('response')
+    end
+
+    it "should not throw an error if request vars are missing" do
+      Rakismet.stub!(:request).and_return(empty_request)
+      lambda { @model.spam? }.should_not raise_error(NoMethodError)
+    end
+  end
+
+
+  describe ".spam!" do
+    it "should call Base.akismet_call with submit-spam" do
+      Rakismet.should_receive(:akismet_call).with('submit-spam', akismet_attrs)
+      @model.spam!
+    end
+
+    it "should mutate #spam?" do
+      Rakismet.stub!(:akismet_call)
+      @model.instance_variable_set(:@_spam, false)
+      @model.spam!
+      @model.should be_spam
+    end
+  end
+
+  describe ".ham!" do
+    it "should call Base.akismet_call with submit-ham" do
+      Rakismet.should_receive(:akismet_call).with('submit-ham', akismet_attrs)
+      @model.ham!
+    end
+
+    it "should mutate #spam?" do
+      Rakismet.stub!(:akismet_call)
+      @model.instance_variable_set(:@_spam, true)
+      @model.ham!
+      @model.should_not be_spam
+    end
+  end
+
+end
@@ -0,0 +1,23 @@
+require  'spec_helper'
+
+class RequestParams
+  include Rakismet::Model
+  attr_accessor :user_ip, :user_agent, :referrer
+end
+
+describe RequestParams do
+    before do
+      @model = RequestParams.new
+      attrs = comment_attrs(:user_ip => '192.168.0.1', :user_agent => 'Rakismet', :referrer => 'http://localhost/referrer')
+      attrs.each_pair { |k,v| @model.stub!(k).and_return(v) }
+    end
+
+  it "should use local values even if Rakismet.request is populated" do
+    Rakismet.stub(:request).and_return(request)
+    Rakismet.should_receive(:akismet_call).
+              with('comment-check', akismet_attrs.merge(:user_ip => '192.168.0.1',
+                                                        :user_agent => 'Rakismet',
+                                                        :referrer => 'http://localhost/referrer'))
+    @model.spam?
+  end
+end
@@ -0,0 +1,14 @@
+require  'spec_helper'
+
+class Subclass < AkismetModel
+end
+
+describe Subclass do
+  it "should inherit parent's rakismet attrs" do
+    Subclass.akismet_attrs.should eql AkismetModel.akismet_attrs # key/value equality
+  end
+
+  it "should get a new copy of parent's rakismet attrs" do
+    Subclass.akismet_attrs.should_not equal AkismetModel.akismet_attrs # object equality
+  end
+end
@@ -0,0 +1,27 @@
+require 'spec_helper'
+
+describe Rakismet::Middleware do
+
+  let(:env) { { 'REMOTE_ADDR' => '127.0.0.1', 'HTTP_USER_AGENT' => 'RSpec', 'HTTP_REFERER' => 'http://test.host/referrer' } }
+  let(:app) { double(:app, :call => nil) }
+  let(:request) { double(:request).as_null_object }
+
+  before do
+    @middleware = Rakismet::Middleware.new(app)
+  end
+
+  it "should set set Rakismet.request variables" do
+    Rakismet.stub(:request).and_return(request)
+    request.should_receive(:user_ip=).with('127.0.0.1')
+    request.should_receive(:user_agent=).with('RSpec')
+    request.should_receive(:referrer=).with('http://test.host/referrer')
+    @middleware.call(env)
+  end
+
+  it "should clear Rakismet.request after request is complete" do
+    @middleware.call(env)
+    Rakismet.request.user_ip.should be_nil
+    Rakismet.request.user_agent.should be_nil
+    Rakismet.request.referrer.should be_nil
+  end
+end
@@ -0,0 +1,123 @@
+require 'spec_helper'
+
+describe Rakismet do
+
+  def mock_response(body)
+    double(:response, :body => body)
+  end
+  let(:http) { double(:http, :post => mock_response('akismet response')) }
+
+  before do
+    Rakismet.key = 'dummy-key'
+    Rakismet.url = 'test.localhost'
+    Rakismet.host = 'endpoint.localhost'
+  end
+
+  describe "proxy host" do
+    it "should have proxy host and port as nil by default" do
+      Rakismet.proxy_host.should be_nil
+      Rakismet.proxy_port.should be_nil
+    end
+  end
+
+  describe ".validate_config" do
+    it "should raise an error if key is not found" do
+      Rakismet.key = ''
+      lambda { Rakismet.send(:validate_config) }.should raise_error(Rakismet::Undefined)
+    end
+
+    it "should raise an error if url is not found" do
+      Rakismet.url = ''
+      lambda { Rakismet.send(:validate_config) }.should raise_error(Rakismet::Undefined)
+    end
+
+    it "should raise an error if host is not found" do
+      Rakismet.host = ''
+      lambda { Rakismet.send(:validate_config) }.should raise_error(Rakismet::Undefined)
+    end
+  end
+
+  describe ".validate_key" do
+    before (:each) do
+      @proxy = mock(Net::HTTP)
+      Net::HTTP.stub!(:Proxy).and_return(@proxy)
+    end
+
+    it "should use proxy host and port" do
+      Rakismet.proxy_host = 'proxy_host'
+      Rakismet.proxy_port = 'proxy_port'
+      @proxy.stub!(:start).and_return(mock_response('valid'))
+      Net::HTTP.should_receive(:Proxy).with('proxy_host', 'proxy_port').and_return(@proxy)
+      Rakismet.validate_key
+    end
+
+    it "should set @@valid_key = true if key is valid" do
+      @proxy.stub!(:start).and_return(mock_response('valid'))
+      Rakismet.validate_key
+      Rakismet.valid_key?.should be_true
+    end
+
+    it "should set @@valid_key = false if key is invalid" do
+      @proxy.stub!(:start).and_return(mock_response('invalid'))
+      Rakismet.validate_key
+      Rakismet.valid_key?.should be_false
+    end
+
+    it "should build url with host" do
+      host = "api.antispam.typepad.com"
+      Rakismet.host = host
+      @proxy.should_receive(:start).with(host).and_yield(http)
+      Rakismet.validate_key
+    end
+  end
+
+  describe ".akismet_call" do
+    before do
+      @proxy = mock(Net::HTTP)
+      Net::HTTP.stub!(:Proxy).and_return(@proxy)
+      @proxy.stub(:start).and_yield(http)
+    end
+
+    it "should use proxy host and port" do
+      Rakismet.proxy_host = 'proxy_host'
+      Rakismet.proxy_port = 'proxy_port'
+      @proxy.stub!(:start).and_return(mock_response('valid'))
+      Net::HTTP.should_receive(:Proxy).with('proxy_host', 'proxy_port').and_return(@proxy)
+      Rakismet.send(:akismet_call, 'bogus-function')
+    end
+
+    it "should build url with API key for the correct host" do
+      host = 'api.antispam.typepad.com'
+      Rakismet.host = host
+      @proxy.should_receive(:start).with("#{Rakismet.key}.#{host}")
+      Rakismet.send(:akismet_call, 'bogus-function')
+    end
+
+    it "should post data to named function" do
+      http.should_receive(:post).with('/1.1/bogus-function', %r(foo=#{CGI.escape 'escape//this'}), Rakismet.headers)
+      Rakismet.send(:akismet_call, 'bogus-function', { :foo => 'escape//this' })
+    end
+
+    it "should default to not being in test mode" do
+      http.should_receive(:post).with(anything, %r(is_test=0), anything)
+      Rakismet.send(:akismet_call, 'bogus-function')
+    end
+
+    it "should be in test mode when configured" do
+      Rakismet.test = true
+      http.should_receive(:post).with(anything, %r(is_test=1), anything)
+      Rakismet.send(:akismet_call, 'bogus-function')
+    end
+
+    it "should return response.body" do
+      Rakismet.send(:akismet_call, 'bogus-function').should eql('akismet response')
+    end
+
+    it "should build query string when params are nil" do
+      lambda {
+        Rakismet.send(:akismet_call, 'bogus-function', { :nil_param => nil })
+      }.should_not raise_error(NoMethodError)
+    end
+  end
+
+end
@@ -0,0 +1,34 @@
+require File.expand_path "lib/rakismet"
+require 'ostruct'
+
+RSpec.configure do |config|
+  config.mock_with :rspec
+end
+
+class AkismetModel
+  include Rakismet::Model
+end
+
+def comment_attrs(attrs={})
+  { :comment_type => 'test', :author => 'Rails test',
+    :author_email => 'test@test.host', :author_url => 'test.host',
+    :content => 'comment content', :blog => Rakismet.url }.merge(attrs)
+end
+
+def akismet_attrs(attrs={})
+  { :comment_type => 'test', :comment_author_email => 'test@test.host',
+    :comment_author => 'Rails test', :comment_author_url => 'test.host',
+    :comment_content => 'comment content' }.merge(attrs)
+end
+
+def request
+  OpenStruct.new(:user_ip => '127.0.0.1',
+                 :user_agent => 'RSpec',
+                 :referrer => 'http://test.host/referrer')
+end
+
+def empty_request
+  OpenStruct.new(:user_ip => nil,
+                 :user_agent => nil,
+                 :referrer => nil)
+end
 \ No newline at end of file
@@ -0,0 +1,35 @@		@@ -0,0 +1,35 @@
	1	+* Clean up gemspec and load paths [Steven Harman]
	2	+* Add Akismet is_test param [Steven Harman]
	3	+* Add Akismet user_role attribute [Steven Harman]
	4	+= 1.2.1
	5	+* Fix deprecated usage of HTTPResponse for Ruby 1.9.3 [Leonid Shevtsov]
	6	+= 1.2.0
	7	+* Rakismet attribute mappings are now inheritable
	8	+= 1.1.2
	9	+* Explicitly load version
	10	+= 1.1.1
	11	+* Fix SafeBuffer error under Rails 3.0.8 and 3.0.9 [Brandon Ferguson]
	12	+* Readme cleanup [Zeke Sikelianos]
	13	+* Drop Jeweler in favor of Bundler's gem tasks
	14	+= 1.1.0
	15	+* Add HTTP Proxy support [Francisco Trindade]
	16	+= 1.0.1
	17	+* Fix hash access for Ruby 1.9 [Alex Crichton]
	18	+= 1.0.0
	19	+* Update for Rails 3
	20	+* Remove filters and replace with middleware
	21	+* Remove initializers and replace with Railtie
	22	+= 0.4.0
	23	+* Rakismet is no longer injected into ActiveRecord or ActionController
	24	+* API changes to support newly decoupled modules
	25	+* Use Jeweler to manage gemspec
	26	+= 0.3.6
	27	+* Allow attributes to fall through to methods or AR attributes
	28	+= 0.3.5
	29	+* Added gemspec and rails/init.rb so rakismet can work as a gem [Michael Air]
	30	+* Added generator template and manifest [Michael Air]
	31	+= 0.3.0
	32	+* Abstract out Rakismet version string
	33	+* Set default Akismet Host
	34	+* Abstract out the Akismet host [Mike Burns]
	35	+* Started keeping a changelog :P
@@ -0,0 +1,3 @@		@@ -0,0 +1,3 @@
	1	+source "http://rubygems.org"
	2	+
	3	+gemspec
@@ -0,0 +1,20 @@		@@ -0,0 +1,20 @@
	1	+Copyright (c) 2008 Josh French
	2	+
	3	+Permission is hereby granted, free of charge, to any person obtaining
	4	+a copy of this software and associated documentation files (the
	5	+"Software"), to deal in the Software without restriction, including
	6	+without limitation the rights to use, copy, modify, merge, publish,
	7	+distribute, sublicense, and/or sell copies of the Software, and to
	8	+permit persons to whom the Software is furnished to do so, subject to
	9	+the following conditions:
	10	+
	11	+The above copyright notice and this permission notice shall be
	12	+included in all copies or substantial portions of the Software.
	13	+
	14	+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
	15	+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
	16	+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
	17	+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
	18	+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
	19	+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
	20	+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
@@ -0,0 +1,229 @@		@@ -0,0 +1,229 @@
	1	+Rakismet
	2	+========
	3	+
	4	+Akismet (<http://akismet.com/>) is a collaborative spam filtering service.
	5	+Rakismet is easy Akismet integration with Rails and rack apps. TypePad's
	6	+AntiSpam service and generic Akismet endpoints are supported.
	7	+
	8	+Compatibility
	9	+=============
	10	+
	11	+Rakismet >= 1.0.0 work with Rails 3 and other Rack-based frameworks.
	12	+
	13	+Rakismet <= 0.4.2 is compatible with Rails 2.
	14	+
	15	+Getting Started
	16	+===============
	17	+
	18	+Once you've installed the Rakismet gem and added it to your application's Gemfile,
	19	+you'll need an API key. Head on over to http://akismet.com/signup/ and sign up
	20	+for a new username.
	21	+
	22	+Configure the Rakismet key and the URL of your application by setting the following
	23	+in application.rb:
	24	+
	25	+```ruby
	26	+config.rakismet.key = 'your wordpress key'
	27	+config.rakismet.url = 'http://yourdomain.com/'
	28	+```
	29	+
	30	+or an initializer, for example `config/initializers/rakismet.rb`:
	31	+
	32	+```ruby
	33	+YourApp::Application.config.rakismet.key = 'your wordpress key'
	34	+YourApp::Application.config.rakismet.url = 'http://yourdomain.com/'
	35	+```
	36	+
	37	+If you wish to use another Akismet-compatible API provider such as TypePad's
	38	+antispam service, you'll also need to set `config.rakismet.host` to your service
	39	+provider's endpoint.
	40	+
	41	+If you want to use a proxy to access akismet (i.e. your application is behind a
	42	+firewall), set the proxy_host and proxy_port option.
	43	+
	44	+```ruby
	45	+config.rakismet.proxy_host = 'http://yourdomain.com/'
	46	+config.rakismet.proxy_port = '8080'
	47	+```
	48	+
	49	+Checking For Spam
	50	+-----------------
	51	+
	52	+First, introduce Rakismet to your model:
	53	+
	54	+```ruby
	55	+class Comment
	56	+ include Rakismet::Model
	57	+end
	58	+```
	59	+
	60	+With Rakismet mixed in to your model, you'll get three instance methods for interacting with
	61	+Akismet:
	62	+
	63	+ * `spam?` submits the comment to Akismet and returns true if Akismet thinks the comment is spam, false if not.
	64	+ * `ham!` resubmits a valid comment that Akismet erroneously marked as spam (marks it as a false positive.)
	65	+ * `spam!` resubmits a spammy comment that Akismet missed (marks it as a false negative.)
	66	+
	67	+The `ham!` and `spam!` methods will change the value of `spam?` but their
	68	+primary purpose is to send feedback to Akismet. The service works best when you
	69	+help correct the rare mistake; please consider using these methods if you're
	70	+moderating comments or otherwise reviewing the Akismet responses.
	71	+
	72	+Configuring Your Model
	73	+----------------------
	74	+
	75	+Rakismet sends the following information to the spam-hungry robots at Akismet:
	76	+
	77	+ author : name submitted with the comment
	78	+ author_url : URL submitted with the comment
	79	+ author_email : email submitted with the comment
	80	+ comment_type : Defaults to comment but you can set it to trackback, pingback, or something more appropriate
	81	+ content : the content submitted
	82	+ permalink : the permanent URL for the entry the comment belongs to
	83	+ user_ip : IP address used to submit this comment
	84	+ user_agent : user agent string
	85	+ referrer : referring URL (note the spelling)
	86	+
	87	+By default, Rakismet just looks for attributes or methods on your class that
	88	+match these names. You don't have to have accessors that match these exactly,
	89	+however. If yours differ, just tell Rakismet what to call them:
	90	+
	91	+```ruby
	92	+class Comment
	93	+ include Rakismet::Model
	94	+ attr_accessor :commenter_name, :commenter_email
	95	+ rakismet_attrs :author => :commenter_name, :author_email => :commenter_email
	96	+end
	97	+```
	98	+
	99	+Or you can pass in a proc, to access associations:
	100	+
	101	+```ruby
	102	+class Comment < ActiveRecord::Base
	103	+ include Rakismet::Model
	104	+ belongs_to :author
	105	+ rakismet_attrs :author => proc { author.name },
	106	+ :author_email => proc { author.email }
	107	+end
	108	+```
	109	+
	110	+You can even hard-code specific fields:
	111	+
	112	+```ruby
	113	+class Trackback
	114	+ include Rakismet::Model
	115	+ rakismet_attrs :comment_type => "trackback"
	116	+end
	117	+```
	118	+
	119	+Optional Request Variables
	120	+--------------------------
	121	+
	122	+Akismet wants certain information about the request environment: remote IP, the
	123	+user agent string, and the HTTP referer when available. Normally, Rakismet
	124	+asks your model for these. Storing this information on your model allows you to
	125	+call the `spam?` method at a later time. For instance, maybe you're storing your
	126	+comments in an administrative queue or processing them with a background job.
	127	+
	128	+You don't need to have these three attributes on your model, however. If you
	129	+choose to omit them, Rakismet will instead look at the current request (if one
	130	+exists) and take the values from the request object instead.
	131	+
	132	+This means that if you are not storing the request variables, you must call
	133	+`spam?` from within the controller action that handles comment submissions. That
	134	+way the IP, user agent, and referer will belong to the person submitting the
	135	+comment. If you're not storing the request variables and you call `spam?` at a
	136	+later time, the request information will be missing or invalid and Akismet won't
	137	+be able to do its job properly.
	138	+
	139	+If you've decided to handle the request variables yourself, you can disable the
	140	+middleware responsible for tracking the request information by adding this to
	141	+your app initialization:
	142	+
	143	+```ruby
	144	+config.rakismet.use_middleware = false
	145	+```
	146	+
	147	+Testing
	148	+-------
	149	+
	150	+Rakismet can be configued to tell Akismet that it should operate in test mode -
	151	+so Akismet will not change its behavior based on any test API calls, meaning
	152	+they will have no training effect. That means your tests can be somewhat
	153	+repeatable in the sense that one test won't influence subsequent calls.
	154	+
	155	+You can configure Rakismet for test mode via application.rb:
	156	+
	157	+```ruby
	158	+config.rakismet.test = false # <- default
	159	+config.rakismet.test = true
	160	+```
	161	+
	162	+Or via an initializer:
	163	+
	164	+```ruby
	165	+YourApp::Application.config.rakismet.test = false # <- default
	166	+YourApp::Application.config.rakismet.test = true
	167	+```
	168	+
	169	+NOTE: When running in Rails, Rakismet will run in test mode when your Rails
	170	+environment is `test` or `development`, unless explictly configured otherwise.
	171	+Outside of Rails Rakismet defaults to test mode turned off.
	172	+
	173	+
	174	+Verifying Responses
	175	+-------------------
	176	+
	177	+If you want to see what's happening behind the scenes, after you call one of
	178	+`@comment.spam?`, `@comment.spam!` or `@comment.ham!` you can check
	179	+`@comment.akismet_response`.
	180	+
	181	+This will contain the last response from the Akismet server. In the case of
	182	+`spam?` it should be `true` or `false.` For `spam!` and `ham!` it should be
	183	+`Feedback received.` If Akismet returned an error instead (e.g. if you left out
	184	+some required information) this will contain the error message.
	185	+
	186	+FAQ
	187	+===
	188	+
	189	+Why does Akismet think all of my test data is spam?
	190	+---------------------------------------------------
	191	+
	192	+Akismet needs enough information to decide if your test data is spam or not.
	193	+Try to supply as much as possible, especially the author name and request
	194	+variables.
	195	+
	196	+How can I simulate a spam submission?
	197	+-------------------------------------
	198	+
	199	+Most people have the opposite problem, where Akismet doesn't think anything is
	200	+spam. The only guaranteed way to trigger a positive spam response is to set the
	201	+comment author to "viagra-test-123".
	202	+
	203	+If you've done this and `spam?` is still returning false, you're probably
	204	+missing the user IP or one of the key/url config variables. One way to check is
	205	+to call `@comment.akismet_response`. If you are missing a required field or
	206	+there was another error, this will hold the Akismet error message. If your comment
	207	+was processed normally, this value will simply be `true` or `false`.
	208	+
	209	+Can I use Rakismet with a different ORM or framework?
	210	+-----------------------------------------------------
	211	+
	212	+Sure. Rakismet doesn't care what your persistence layer is. It will work with
	213	+Datamapper, a NoSQL store, or whatever next month's DB flavor is.
	214	+
	215	+Rakismet also has no dependencies on Rails or any of its components, and only
	216	+uses a small Rack middleware object to do some of its magic. Depending on your
	217	+framework, you may have to modify this slightly and/or manually place it in your
	218	+stack.
	219	+
	220	+You'll also need to set a few config variables by hand. Instead of
	221	+`config.rakismet.key`, `config.rakismet.url`, and `config.rakismet.host`, set
	222	+these values directly with `Rakismet.key`, `Rakismet.url`, and `Rakismet.host`.
	223	+
	224	+---------------------------------------------------------------------------
	225	+
	226	+If you have any implementation or usage questions, don't hesitate to get in
	227	+touch: josh@vitamin-j.com.
	228	+
	229	+Copyright (c) 2008 Josh French, released under the MIT license
	@@ -0,0 +1,9 @@		@@ -0,0 +1,9 @@
		1	+require 'bundler'
		2	+Bundler::GemHelper.install_tasks
		3	+
		4	+require 'rspec/core/rake_task'
		5	+RSpec::Core::RakeTask.new do \|spec\|
		6	+ spec.rspec_opts = ["--color", "--format progress"]
		7	+end
		8	+
		9	+task :default => :spec
0	\ No newline at end of file	10	\ No newline at end of file
@@ -0,0 +1,88 @@		@@ -0,0 +1,88 @@
	1	+require 'net/http'
	2	+require 'uri'
	3	+require 'cgi'
	4	+require 'yaml'
	5	+
	6	+require 'rakismet/model'
	7	+require 'rakismet/middleware'
	8	+require 'rakismet/version'
	9	+require 'rakismet/railtie.rb' if defined?(Rails)
	10	+
	11	+module Rakismet
	12	+ Request = Struct.new(:user_ip, :user_agent, :referrer)
	13	+ Undefined = Class.new(NameError)
	14	+
	15	+ class << self
	16	+ attr_accessor :key, :url, :host, :proxy_host, :proxy_port, :test
	17	+
	18	+ def request
	19	+ @request \|\|= Request.new
	20	+ end
	21	+
	22	+ def set_request_vars(env)
	23	+ request.user_ip, request.user_agent, request.referrer =
	24	+ env['REMOTE_ADDR'], env['HTTP_USER_AGENT'], env['HTTP_REFERER']
	25	+ end
	26	+
	27	+ def clear_request
	28	+ @request = Request.new
	29	+ end
	30	+
	31	+ def headers
	32	+ @headers \|\|= begin
	33	+ user_agent = "Rakismet/#{Rakismet::VERSION}"
	34	+ user_agent = "Rails/#{Rails.version} \| " + user_agent if defined?(Rails)
	35	+ { 'User-Agent' => user_agent, 'Content-Type' => 'application/x-www-form-urlencoded' }
	36	+ end
	37	+ end
	38	+
	39	+ def validate_key
	40	+ validate_config
	41	+ akismet = URI.parse(verify_url)
	42	+ response = Net::HTTP::Proxy(proxy_host, proxy_port).start(akismet.host) do \|http\|
	43	+ data = "key=#{Rakismet.key}&blog=#{Rakismet.url}"
	44	+ http.post(akismet.path, data, Rakismet.headers)
	45	+ end
	46	+ @valid_key = (response.body == 'valid')
	47	+ end
	48	+
	49	+ def valid_key?
	50	+ @valid_key == true
	51	+ end
	52	+
	53	+ def akismet_call(function, args={})
	54	+ validate_config
	55	+ args.merge!(:blog => Rakismet.url, :is_test => Rakismet.test_mode)
	56	+ akismet = URI.parse(call_url(function))
	57	+ response = Net::HTTP::Proxy(proxy_host, proxy_port).start(akismet.host) do \|http\|
	58	+ params = args.map do \|k,v\|
	59	+ param = v.class < String ? v.to_str : v.to_s # for ActiveSupport::SafeBuffer and Nil, respectively
	60	+ "#{k}=#{CGI.escape(param)}"
	61	+ end
	62	+ http.post(akismet.path, params.join('&'), Rakismet.headers)
	63	+ end
	64	+ response.body
	65	+ end
	66	+
	67	+ protected
	68	+
	69	+ def verify_url
	70	+ "http://#{Rakismet.host}/1.1/verify-key"
	71	+ end
	72	+
	73	+ def call_url(function)
	74	+ "http://#{Rakismet.key}.#{Rakismet.host}/1.1/#{function}"
	75	+ end
	76	+
	77	+ def validate_config
	78	+ raise Undefined, "Rakismet.key is not defined" if Rakismet.key.nil? \|\| Rakismet.key.empty?
	79	+ raise Undefined, "Rakismet.url is not defined" if Rakismet.url.nil? \|\| Rakismet.url.empty?
	80	+ raise Undefined, "Rakismet.host is not defined" if Rakismet.host.nil? \|\| Rakismet.host.empty?
	81	+ end
	82	+
	83	+ def test_mode
	84	+ test ? 1 : 0
	85	+ end
	86	+ end
	87	+
	88	+end
@@ -0,0 +1,16 @@		@@ -0,0 +1,16 @@
	1	+module Rakismet
	2	+ class Middleware
	3	+
	4	+ def initialize(app)
	5	+ @app = app
	6	+ end
	7	+
	8	+ def call(env)
	9	+ Rakismet.set_request_vars(env)
	10	+ response = @app.call(env)
	11	+ Rakismet.clear_request
	12	+ response
	13	+ end
	14	+
	15	+ end
	16	+end
@@ -0,0 +1,86 @@		@@ -0,0 +1,86 @@
	1	+module Rakismet
	2	+ module Model
	3	+
	4	+ def self.included(base)
	5	+ base.class_eval do
	6	+ attr_accessor :akismet_response
	7	+ class << self; attr_accessor :akismet_attrs; end
	8	+ extend ClassMethods
	9	+ include InstanceMethods
	10	+ self.rakismet_attrs
	11	+ end
	12	+ end
	13	+
	14	+ module ClassMethods
	15	+ def rakismet_attrs(args={})
	16	+ self.akismet_attrs \|\|= {}
	17	+ [:comment_type, :author, :author_url, :author_email, :content, :user_role].each do \|field\|
	18	+ # clunky, but throwing around +type+ will break your heart
	19	+ fieldname = field.to_s =~ %r(^comment_) ? field : "comment_#{field}".intern
	20	+ self.akismet_attrs[fieldname] = args.delete(field) \|\| field
	21	+ end
	22	+ [:user_ip, :user_agent, :referrer].each do \|field\|
	23	+ self.akismet_attrs[field] = args.delete(field) \|\| field
	24	+ end
	25	+ args.each_pair do \|f,v\|
	26	+ self.akismet_attrs[f] = v
	27	+ end
	28	+ end
	29	+
	30	+ def inherited(subclass)
	31	+ super
	32	+ subclass.rakismet_attrs akismet_attrs.dup
	33	+ end
	34	+ end
	35	+
	36	+ module InstanceMethods
	37	+ def spam?
	38	+ if instance_variable_defined? :@_spam
	39	+ @_spam
	40	+ else
	41	+ data = akismet_data
	42	+ self.akismet_response = Rakismet.akismet_call('comment-check', data)
	43	+ @_spam = self.akismet_response == 'true'
	44	+ end
	45	+ end
	46	+
	47	+ def spam!
	48	+ Rakismet.akismet_call('submit-spam', akismet_data)
	49	+ @_spam = true
	50	+ end
	51	+
	52	+ def ham!
	53	+ Rakismet.akismet_call('submit-ham', akismet_data)
	54	+ @_spam = false
	55	+ end
	56	+
	57	+ private
	58	+
	59	+ def akismet_data
	60	+ akismet = self.class.akismet_attrs.keys.inject({}) do \|data,attr\|
	61	+ mapped_field = self.class.akismet_attrs[attr]
	62	+ data.merge attr => if mapped_field.is_a?(Proc)
	63	+ instance_eval(&mapped_field)
	64	+ elsif !mapped_field.nil? && respond_to?(mapped_field)
	65	+ send(mapped_field)
	66	+ elsif not [:comment_type, :author, :author_email,
	67	+ :author_url, :content, :user_role,
	68	+ :user_ip, :referrer,
	69	+ :user_agent].include?(mapped_field)
	70	+ # we've excluded any fields that appear to
	71	+ # have their default unmapped values
	72	+ mapped_field
	73	+ elsif respond_to?(attr)
	74	+ send(attr)
	75	+ elsif Rakismet.request.respond_to?(attr)
	76	+ Rakismet.request.send(attr)
	77	+ end
	78	+ end
	79	+ akismet.delete_if { \|k,v\| v.nil? \|\| v.empty? }
	80	+ akismet[:comment_type] \|\|= 'comment'
	81	+ akismet
	82	+ end
	83	+ end
	84	+
	85	+ end
	86	+end
@@ -0,0 +1,22 @@		@@ -0,0 +1,22 @@
	1	+require 'rails'
	2	+require 'rakismet'
	3	+
	4	+module Rakismet
	5	+ class Railtie < Rails::Railtie
	6	+
	7	+ config.rakismet = ActiveSupport::OrderedOptions.new
	8	+ config.rakismet.host = 'rest.akismet.com'
	9	+ config.rakismet.use_middleware = true
	10	+
	11	+ initializer 'rakismet.setup', :after => :load_config_initializers do \|app\|
	12	+ Rakismet.key = app.config.rakismet[:key]
	13	+ Rakismet.url = app.config.rakismet[:url]
	14	+ Rakismet.host = app.config.rakismet[:host]
	15	+ Rakismet.proxy_host = app.config.rakismet[:proxy_host]
	16	+ Rakismet.proxy_port = app.config.rakismet[:proxy_port]
	17	+ Rakismet.test = app.config.rakismet.fetch(:test) { Rails.env.test? \|\| Rails.env.development? }
	18	+ app.middleware.use Rakismet::Middleware if app.config.rakismet.use_middleware
	19	+ end
	20	+
	21	+ end
	22	+end
@@ -0,0 +1,25 @@		@@ -0,0 +1,25 @@
	1	+# -- encoding: utf-8 --
	2	+require File.expand_path('../lib/rakismet/version', __FILE__)
	3	+
	4	+Gem::Specification.new do \|s\|
	5	+ s.name = "rakismet"
	6	+ s.version = Rakismet::VERSION
	7	+ s.platform = Gem::Platform::RUBY
	8	+ s.authors = ["Josh French"]
	9	+ s.email = "josh@vitamin-j.com"
	10	+ s.homepage = "http://github.com/joshfrench/rakismet"
	11	+ s.summary = "Akismet and TypePad AntiSpam integration for Rails."
	12	+ s.description = "Rakismet is the easiest way to integrate Akismet or TypePad's AntiSpam into your Rails app."
	13	+ s.date = "2012-04-22"
	14	+
	15	+ s.rubyforge_project = "rakismet"
	16	+ s.add_development_dependency "rake"
	17	+ s.add_development_dependency "rspec", "~> 2.11"
	18	+
	19	+ s.files = `git ls-files`.split("\n")
	20	+ s.test_files = `git ls-files -- {test,spec,features}/*`.split("\n")
	21	+ s.executables = `git ls-files -- bin/*`.split("\n").map{ \|f\| File.basename(f) }
	22	+ s.require_paths = ["lib"]
	23	+ s.extra_rdoc_files = ["README.md"]
	24	+end
	25	+