mongodb_meilisearch 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 90bfdb172f8ff15ffe0d490cbfc03939de3f3b05881b830f0515807f35882e96
-  data.tar.gz: 1c680831f8b35d5ee540fab9e7ec47b3b093f02a5be054a1b0c393597930e556
+  metadata.gz: 1d42d4314105bccabf3b1cc8dc49c1e7c578cc854d213f8fb73cde81aba26c03
+  data.tar.gz: 0dc187a25352ae68526a389d8e0deed4ba9772ff94a3a6fb2bf001e67f8ccbcb
 SHA512:
-  metadata.gz: f10fe61be5b67e4e5264abed8adabb41ecdb6a3e2cbdca2ae23f5979d552498a018bf327c682cc28e54b37ce16b9c50f74dca294eb55a0acbff5277a5f0389f0
-  data.tar.gz: 5d39d79ddf1bc213760959fdd4ebee1451cc2b2c1a6a48b1a24e6e74bd3dff688121e12d2dad8fc103c38db14d7766fdc2c6117b592cf2445eebfd2aaa6773b9
+  metadata.gz: 13f4ab53d0794010d49bcbdf325db757ceae92cbcce77c77c7dccc99fc4436312b9d786a79fe62609363a8f83372c025374f73cc967261cda231f9624b0e0672
+  data.tar.gz: ef36cb85710a0bcbe4c47747686aa19d0a7d6748000e4f8ed73e1682a01ec7c4166cffc7e0984faeb7d3b25f9c64288943a828888bcb161d24d2d2268ddf9974

data/.changelog_entries/1d952700c037533909615648b5f10582.json

@@ -0,0 +1 @@
+{"type":"Documented","tickets":[],"description":"README: improved example code.","tags":[]}

data/.changelog_entries/config.json

@@ -0,0 +1 @@
+{"git_add":true}

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    mongodb_meilisearch (1.0.0)
+    mongodb_meilisearch (1.0.1)
       meilisearch
       mongoid (~> 7.0)
       rails
@@ -131,6 +131,8 @@ GEM
     nio4r (2.5.9)
     nokogiri (1.15.3-arm64-darwin)
       racc (~> 1.4)
+    nokogiri (1.15.3-x86_64-linux)
+      racc (~> 1.4)
     parallel (1.23.0)
     parser (3.2.2.3)
       ast (~> 2.4.1)
@@ -220,6 +222,7 @@ GEM
 
 PLATFORMS
   arm64-darwin-22
+  x86_64-linux
 
 DEPENDENCIES
   debug

data/README.md

@@ -1,3 +1,14 @@
+# <!-- :TOC: -->
+- [MongodbMeilisearch](#mongodbmeilisearch)
+  - [Installation](#installation)
+  - [Usage](#usage)
+  - [Model Integration](#model-integration)
+  - [Indexes](#indexes)
+  - [Searching](#searching)
+  - [Development](#development)
+  - [License](#license)
+  - [Code of Conduct](#code-of-conduct)
+
 # MongodbMeilisearch
 
 A simple gem for integrating [Meilisearch](https://www.meilisearch.com) into Ruby† applications that are backed by [MongoDB](https://www.mongodb.com/).
@@ -35,7 +46,10 @@ SEARCH_ENABLED=true
 MEILISEARCH_API_KEY=<your api key here>
 MEILISEARCH_URL=http://127.0.0.1:7700
 
-# optional configuration
+```
+
+Optional configuration
+```bash
 MEILISEARCH_TIMEOUT=10
 MEILISEARCH_MAX_RETRIES=2
 ```
@@ -46,8 +60,8 @@ Add the following near the top of your model. Only the `extend` and `include` li
 This assumes your model also includes `Mongoid::Document`
 
 ```ruby
-  extend Search::ClassMethods
   include Search::InstanceMethods
+  extend Search::ClassMethods
 ```
 
 If you want Rails to automatically add, update, and delete records from the index, add the following to your model. 
@@ -65,19 +79,46 @@ You can override these methods if needed, but you're unlikely to want to.
 
 Assuming you've done the above a new index will be created with a name that
 corresponds to your model's  name, only in snake case. All of your models
-attributes will be indexed and [filterable](https://www.meilisearch.com/docs/learn/fine_tuning_results/filtering).
+fields will be indexed and [filterable](https://www.meilisearch.com/docs/learn/fine_tuning_results/filtering).
+
+
+### Example Rails Model
+
+Here's what it looks like when you put it all 
+together in a Rails model with the default behavior.
+
+```ruby
+class Person
+  include Mongoid::Document
+  extend Search::ClassMethods
+
+  if Search::Client.instance.enabled?
+    after_create  :add_to_search
+    after_update  :update_in_search
+    after_destroy :remove_from_search
+  end
 
+  # normal Mongoid attributes
+  field :name, type: String
+  field :description, type: String
+  field :age, type: Integer
+end
+```
+
+Note that that _unless you configure it otherwise_ the ids of `belongs_to` objects 
+will not be searchable. This is because they're random strings that no human's ever
+going to be searching for, and we don't want to waste RAM or storage.
 
 ### Going Beyond The Defaults 
 This module strives for sensible defaults, but you can override them with the
 following optional constants:
 
-* `PRIMARY_SEARCH_KEY` - a Symbol matching one of your model's attributes 
+- `PRIMARY_SEARCH_KEY` - a Symbol matching one of your model's attributes 
   that is guaranteed unique. This defaults to `_id`
-* `SEARCH_INDEX_NAME` - a String - useful if you want to have records from
+- `SEARCH_INDEX_NAME` - a String - useful if you want to have records from
   multiple classes come back in the same search results. This defaults to the
   underscored form of the current class name.
-* `SEARCH_OPTIONS` - a hash of key value pairs in JS style
+- `SEARCH_OPTIONS` - a hash of key value pairs in JS style
     - See  the [meilisearch search parameter docs](https://www.meilisearch.com/docs/reference/api/search#search-parameters) for details.
     - example from [meliesearch's `multi_param_spec`](https://github.com/meilisearch/meilisearch-ruby/blob/main/spec/meilisearch/index/search/multi_params_spec.rb)
   ```ruby
@@ -89,7 +130,7 @@ following optional constants:
         limit: 2
       }
     ```
-* `SEARCH_RANKING_RULES` - an array of strings that correspond to meilisearch rules
+- `SEARCH_RANKING_RULES` - an array of strings that correspond to meilisearch rules
   see [meilisearch ranking rules docs](https://www.meilisearch.com/docs/learn/core_concepts/relevancy#ranking-rules)
 You probably don't want to change this.
 
@@ -126,7 +167,7 @@ as `original_document_id`. This is useful if you want to be able to retrieve the
 You probably don't want to index _all_ the fields. For example, 
 unless you intend to allow users to sort by when a record was created, 
 there's no point in recording it's `created_at` in the search index. 
-It'll just waste bandwidth, memory, and disk space.
+It'll just waste bandwidth, memory, and disk space. 
 
 Define a `SEARCHABLE_ATTRIBUTES` constant with an array of strings to limit things. 
 By default these will _also_ be the fields you can filter on. Note that 
@@ -142,6 +183,15 @@ document's `BSON::ObjectId`.
   SEARCHABLE_ATTRIBUTES = searchable_attributes - [:created_at]
 ```
 
+#### Including Foreign Key data
+If, for example, your `Person` `belongs_to: group` 
+and you wanted that group's id to be searchable you would include `group_id`
+in the list. 
+
+If you don't specify any `SEARCHABLE_ATTRIBUTES`, the default list will
+exclude any fields that are `Mongoid::Fields::ForeignKey` objects.
+
+
 #### Getting Extra Specific
 If your searchable data needs to by dynamically generated instead of 
 just taken directly from the `Mongoid::Document`'s attributes you can
@@ -150,8 +200,8 @@ must return a hash, and that hash must include the following keys:
 - `"id"` - a string that uniquely identifies the record
 - `"object_class"` the name of the class that this record corresponds to.
 
-The value of `"object_class"` is usually just `self.class.name`. Additionally,
-this is something specific to this gem, and not Meilisearch itself.
+The value of `"object_class"` is usually just `self.class.name`. 
+This is something specific to this gem, and not Meilisearch itself.
 
 See `InstanceMethods#search_indexable_hash` for an example. 
 
@@ -200,7 +250,12 @@ is potentially problematic for your users, and thus noted with a bang.
 For example: 
 ```ruby
 MyModel.reindex  # runs asyncronously
-# vs 
+
+```
+
+vs 
+
+```ruby
 MyModel.reindex! # runs synchronously
 ```
 
@@ -303,8 +358,7 @@ E.g. `MyModel.search("search term", include_metadata: false)`
 Search results, ids only, for a class where `CLASS_PREFIXED_SEARCH_IDS=false`. 
 
 ```ruby
-Note.search('foo', ids_only: true)
-# returns 
+Note.search('foo', ids_only: true) # => returns 
 { 
   "matches" =>  [
     "64274a5d906b1d7d02c1fcc7",
@@ -328,8 +382,7 @@ Without `ids_only` you get full objects in a `matches` array.
 
 
 ```ruby
-Note.search('foo') # or Note.search('foo', ids_only: false)
-# returns 
+Note.search('foo') # or Note.search('foo', ids_only: false) # => returns 
 { 
   "matches" => [
     #<Note _id: 64274a5d906b1d7d02c1fcc7, created_at: 2023-03-15 00:00:00 UTC, updated_at: 2023-03-31 21:02:21.108 UTC, title: "A note from the past", body: "a body", type: "misc", context: "dachary">,
@@ -348,8 +401,7 @@ Note.search('foo') # or Note.search('foo', ids_only: false)
 If `Note` records shared an index with `Task` and they both had `CLASS_PREFIXED_SEARCH_ID=true` you'd get a result like this.
 
 ```ruby
-Note.search('foo')
-# returns 
+Note.search('foo') #=> returns 
 { 
   "matches" => [
       #<Note _id: 64274a5d906b1d7d02c1fcc7, created_at: 2023-03-15 00:00:00 UTC, updated_at: 2023-03-31 21:02:21.108 UTC, title: "A note from the past", body: "a body", type: "misc", context: "dachary">,

data/lib/mongodb_meilisearch/version.rb

@@ -5,5 +5,5 @@ module MongodbMeilisearch
   # @note This library will adhere to strict semantic versioning.
   # See https://semver.org/
   #
-  VERSION = "1.0.0"
+  VERSION = "1.0.1"
 end

data/lib/search/class_methods.rb

@@ -339,7 +339,12 @@ module Search
     # Please don't override this. Define SEARCHABLE_ATTRIBUTES instead.
     # @return [Array[Symbol]] an array of attribute names as symbols
     def default_searchable_attributes
-      attribute_names.map { |n| n.to_sym }
+      good_fields = []
+      fields.each { |name, obj|
+        next if name == "_type"
+        good_fields.push(name.to_sym) unless obj.is_a? Mongoid::Fields::ForeignKey
+      }
+      good_fields
     end
 
     # This returns the list from SEARCHABLE_ATTRIBUTES if defined,

data/lib/search/client.rb

@@ -13,8 +13,8 @@ module Search
         max_retries = ENV.fetch("MEILISEARCH_MAX_RETRIES", 2).to_i
         if url.present? && api_key.present?
           @client = MeiliSearch::Client.new(url, api_key,
-            timeout: timeout,
-            max_retries: max_retries)
+                                            timeout: timeout,
+                                            max_retries: max_retries)
         else
           Rails.logger.warn("UNABLE TO CONFIGURE SEARCH. Check env vars.")
           @client = nil

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mongodb_meilisearch
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
 platform: ruby
 authors:
 - masukomi
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-07-22 00:00:00.000000000 Z
+date: 2023-09-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -143,6 +143,8 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".changelog_entries/1d952700c037533909615648b5f10582.json"
+- ".changelog_entries/config.json"
 - ".env"
 - ".idea/.gitignore"
 - ".idea/modules.xml"