activerecord-mysql-search 0.2.1 → 0.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bf223abbfa9e47d49642b4f8f52d05eb60256749f6f1ca22b40f9a17db7aad57
-  data.tar.gz: 197c6c7c9c15de41a0ed7bd3578a988be3beb366acac94f249e1aa0315747728
+  metadata.gz: 19cb0101f1cfe861ccdf0defa71c17f4608e17e99e7428f5e5ad00aa2a646be5
+  data.tar.gz: 758c80b143460cc517d826af5fd701d19adbe46dddbec49aa1e245cf48f37201
 SHA512:
-  metadata.gz: 225730631d733499a6fe947fc8c90ed27f61441939206516f54b5bc951c520130692ffdab155ca072a2986fc9c6d6e2f4bd6e1d10f302be15aca133402dd2d5e
-  data.tar.gz: 5475a8bd4aaf08b71c694814abcee48ca74bbf28514e20085ab34cf12ae4f1418e0dee2b57578a97134de1d687d7efd6d79f004bc429b2c2fe7dabc01b6f30de
+  metadata.gz: 5c0d1de1bdcf4d17b6b30826fcd7f38eb6f81410fe8d27794379e71d7b67cadb7d5c78f465ecc143bc0b7a23dbea022edefb44f90cf558e61791180b336aaf1d
+  data.tar.gz: 8c70d839e870efe25a3525baa34053e0b951bdb32b12ebc8c0e84fbc8ab52ca9a8658d68a4a4c9ddc6fcbff0a533b096745ed0ea9fd6aade945c30090d4cca5c

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 ## [Unreleased]
 
+## [0.2.3] - 2026-09-11
+
+- Adds the `boolean_full_text_search` scope for MySQL boolean full-text queries
+- Adds integration coverage for required (`+`) and excluded (`-`) search terms
+
 ## [0.2.1] - 2026-07-15
 
 - Adds automatic loading of source classes on Rails startup via new `autoload_sources` configuration option (default: true)

data/README.md

@@ -121,6 +121,24 @@ This command populates the `search_indices` table with existing data from your m
 results = Article.full_text_search("Ruby on Rails")
 ```
 
+`full_text_search` uses MySQL's natural-language full-text search. Use
+`boolean_full_text_search` when you need operators such as `+` for required
+terms, `-` for excluded terms, or quotes and wildcards supported by MySQL's
+boolean full-text syntax:
+
+```ruby
+results = Article.boolean_full_text_search("+Ruby +Rails -legacy")
+```
+
+Both scopes support searching one or more search-index columns:
+
+```ruby
+results = Product.boolean_full_text_search(
+  "+Ruby +Rails",
+  search_column: %i[content seller_extra]
+)
+```
+
 **That’s it!** Users now get fast, scalable, and relevant search—no complex SQL, external services, or maintenance headaches.
 
 ## Advanced Scenarios: Multi-Column Search for Roles and Contexts
@@ -247,7 +265,7 @@ end
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update `spec.version` in `activerecord-mysql-search.gemspec`, commit the change, and then run `bundle exec rake release`. This creates a git tag for the version, pushes the commit and tag, and pushes the `.gem` file to [rubygems.org](https://rubygems.org).
 
 ## Contributing
 

data/activerecord-mysql-search.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |spec|
   spec.name = 'activerecord-mysql-search'
-  spec.version = '0.2.1'
+  spec.version = '0.2.3'
   spec.authors = ['Daydream Unicorn GmbH & Co. KG']
   spec.email = ['hello@daydreamunicorn.com']
 

data/lib/mysql/search/extensions/arel_against.rb

@@ -8,7 +8,9 @@ module Arel
     class MySQL
       def visit_Arel_Nodes_Against(node, collector) # rubocop:disable Naming/MethodName
         visit(node.left, collector) << ' AGAINST ('
-        visit(node.right, collector) << ')'
+        visit(node.right, collector)
+        collector << ' IN BOOLEAN MODE' if node.boolean_mode?
+        collector << ')'
       end
     end
   end
@@ -16,13 +18,21 @@ module Arel
   module Nodes
     # Represents the `AGAINST` clause used in MySQL full-text search queries.
     class Against < Arel::Nodes::Matches
+      def initialize(left, right, boolean_mode: false)
+        super(left, right)
+        @boolean_mode = boolean_mode
+      end
+
+      def boolean_mode?
+        @boolean_mode
+      end
     end
   end
 
   # Adds a method to the `Arel::Nodes::Node` class to allow for full-text search queries.
   module Predications
-    def against(other)
-      Arel::Nodes::Against.new(self, quoted_node(other))
+    def against(other, boolean_mode: false)
+      Arel::Nodes::Against.new(self, quoted_node(other), boolean_mode: boolean_mode)
     end
   end
 end

data/lib/mysql/search/queries/boolean_full_text_search_query.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require_relative 'full_text_search_query'
+
+module MySQL
+  module Search
+    module Queries
+      # BooleanFullTextSearchQuery builds MySQL boolean full-text search queries.
+      class BooleanFullTextSearchQuery < FullTextSearchQuery
+        private
+
+        def search_expression(search_term, search_column)
+          search_indices = ::MySQL::Search.search_index_class_name.constantize.arel_table
+          search_columns = Array.wrap(search_column).map { |col| search_indices[col] }
+
+          Arel::Nodes::NamedFunction.new('MATCH', search_columns).against(search_term, boolean_mode: true)
+        end
+      end
+    end
+  end
+end

data/lib/mysql/search/searchable.rb

@@ -18,6 +18,10 @@ module MySQL
         scope :full_text_search, lambda { |search_term, search_column: :content|
           ::MySQL::Search::Queries::FullTextSearchQuery.new(self).call(search_term, search_column: search_column)
         }
+
+        scope :boolean_full_text_search, lambda { |search_term, search_column: :content|
+          ::MySQL::Search::Queries::BooleanFullTextSearchQuery.new(self).call(search_term, search_column: search_column)
+        }
       end
     end
   end

data/lib/mysql/search.rb

@@ -7,6 +7,7 @@ require_relative 'search/searchable'
 require_relative 'search/source'
 require_relative 'search/queries/updated_sources_query'
 require_relative 'search/queries/full_text_search_query'
+require_relative 'search/queries/boolean_full_text_search_query'
 require_relative 'search/updater'
 require_relative 'search/utils'
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: activerecord-mysql-search
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.3
 platform: ruby
 authors:
 - Daydream Unicorn GmbH & Co. KG
@@ -48,6 +48,7 @@ files:
 - lib/mysql/search/jobs.rb
 - lib/mysql/search/jobs/scheduled_updater_job.rb
 - lib/mysql/search/jobs/updater_job.rb
+- lib/mysql/search/queries/boolean_full_text_search_query.rb
 - lib/mysql/search/queries/full_text_search_query.rb
 - lib/mysql/search/queries/updated_sources_query.rb
 - lib/mysql/search/railtie.rb