Simplify API: move setup/client_for from Rspamd::Rails to Rspamd module

The Rails module name was misleading since this code works outside Rails.
Moving it to the top-level Rspamd module simplifies the API:

  Rspamd.setup(config)
  Rspamd.client_for(:outbound)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: rosa

lib/rspamd-ruby.rb

@@ -1,5 +1,37 @@
+require "active_support/core_ext/hash/keys"
 require "rspamd/client"
 require "rspamd/client_stub"
 require "rspamd/errors"
-require "rspamd/rails"
 require "rspamd/railtie" if defined?(::Rails::Railtie)
+
+module Rspamd
+  class << self
+    def setup(config)
+      @config = config.deep_symbolize_keys
+      @clients = {}
+    end
+
+    def client_for(name)
+      clients[name] ||= enabled? ? build_client(name) : ClientStub.new
+    end
+
+    def reset!
+      @config = nil
+      @clients = {}
+    end
+
+    private
+      def clients
+        @clients ||= {}
+      end
+
+      def enabled?
+        @config&.dig(:enabled)
+      end
+
+      def build_client(name)
+        settings = @config.fetch(name) { raise ArgumentError, "No rspamd configuration for #{name.inspect}" }
+        Client.new(**settings.slice(:host, :port, :password))
+      end
+  end
+end

lib/rspamd/rails.rb

@@ -1,12 +1,10 @@
-require "rspamd/rails"
-
 module Rspamd
   class Railtie < ::Rails::Railtie
     initializer "rspamd.setup" do
       config_path = ::Rails.root.join("config/rspamd.yml")
 
       if config_path.exist?
-        Rspamd::Rails.setup(::Rails.application.config_for(:rspamd))
+        Rspamd.setup(::Rails.application.config_for(:rspamd))
       end
     end
   end

lib/rspamd/railtie.rb

@@ -0,0 +1,64 @@
+require "test_helper"
+
+class Rspamd::SetupTest < Minitest::Test
+  def teardown
+    Rspamd.reset!
+  end
+
+  def test_returns_stub_when_disabled
+    Rspamd.setup("enabled" => false, "outbound" => { "host" => "localhost", "port" => 11334 })
+
+    client = Rspamd.client_for(:outbound)
+    assert_instance_of Rspamd::ClientStub, client
+  end
+
+  def test_returns_client_when_enabled
+    Rspamd.setup("enabled" => true, "outbound" => { "host" => "rspamd.example.com", "port" => 11334 })
+
+    client = Rspamd.client_for(:outbound)
+    assert_instance_of Rspamd::Client, client
+  end
+
+  def test_caches_client_instances
+    Rspamd.setup("enabled" => true, "outbound" => { "host" => "localhost", "port" => 11334 })
+
+    client1 = Rspamd.client_for(:outbound)
+    client2 = Rspamd.client_for(:outbound)
+    assert_same client1, client2
+  end
+
+  def test_returns_stub_when_not_configured
+    client = Rspamd.client_for(:outbound)
+    assert_instance_of Rspamd::ClientStub, client
+  end
+
+  def test_raises_for_unknown_client_name
+    Rspamd.setup("enabled" => true, "outbound" => { "host" => "localhost", "port" => 11334 })
+
+    assert_raises(ArgumentError) { Rspamd.client_for(:nonexistent) }
+  end
+
+  def test_reset_clears_config_and_clients
+    Rspamd.setup("enabled" => true, "outbound" => { "host" => "localhost", "port" => 11334 })
+    Rspamd.client_for(:outbound)
+    Rspamd.reset!
+
+    # After reset, should return stub (no config = disabled)
+    client = Rspamd.client_for(:outbound)
+    assert_instance_of Rspamd::ClientStub, client
+  end
+
+  def test_accepts_symbol_keys
+    Rspamd.setup(enabled: true, outbound: { host: "localhost", port: 11334 })
+
+    client = Rspamd.client_for(:outbound)
+    assert_instance_of Rspamd::Client, client
+  end
+
+  def test_passes_password_to_client
+    Rspamd.setup("enabled" => true, "outbound" => { "host" => "localhost", "port" => 11334, "password" => "secret" })
+
+    client = Rspamd.client_for(:outbound)
+    assert_equal "secret", client.configuration.password
+  end
+end