Merge branch 'main' into add-method-to-get-the-raw-index-information

# Conflicts:
#	spec/meilisearch/client/indexes_spec.rb

Author: thicolares

.code-samples.meilisearch.yaml

@@ -123,11 +123,11 @@ update_ranking_rules_1: |-
 reset_ranking_rules_1: |-
   client.index('movies').reset_ranking_rules
 get_distinct_attribute_1: |-
-  client.index('movies').distinct_attribute
+  client.index('shoes').distinct_attribute
 update_distinct_attribute_1: |-
-  client.index('movies').update_distinct_attribute('movie_id')
+  client.index('shoes').update_distinct_attribute('skuid')
 reset_distinct_attribute_1: |-
-  client.index('movies').reset_distinct_attribute
+  client.index('shoes').reset_distinct_attribute
 get_searchable_attributes_1: |-
   client.index('movies').searchable_attributes
 update_searchable_attributes_1: |-

CONTRIBUTING.md

@@ -89,6 +89,26 @@ To update it, run the following command:
 bundle exec rubocop --auto-gen-config
 ```
 
+### Using Docker Compose <!-- omit in toc -->
+
+If you have Docker and Docker Compose installed, you can alternatively set up your local development environment following the steps below.
+
+```bash
+# Create/run the containers
+docker compose up -d
+# Run bash in meilisearch_ruby container
+docker compose exec meilisearch_ruby bash
+```
+
+You can now run the previous steps in the `meilisearc_ruby` container:
+
+```bash
+bundle install
+bundle exec rspec
+bundle exec rubocop lib/ spec/
+...
+```
+
 ### Want to debug? <!-- omit in toc -->
 
 You can use the [`byebug` gem](https://github.com/deivid-rodriguez/byebug).

README.md

@@ -152,6 +152,50 @@ JSON output:
 }
 ```
 
+#### Custom Search With Filters <!-- omit in toc -->
+
+If you want to enable filtering, you must add your attributes to the `filterableAttributes` index setting.
+
+```ruby
+index.update_filterable_attributes([
+  'id',
+  'genres'
+])
+```
+
+You only need to perform this operation once.
+
+Note that MeiliSearch will rebuild your index whenever you update `filterableAttributes`. Depending on the size of your dataset, this might take time. You can track the process using the [update status](https://docs.meilisearch.com/reference/api/updates.html#get-an-update-status).
+
+Then, you can perform the search:
+
+```ruby
+index.search('wonder', { filter: ['id > 1 AND genres = Action'] })
+```
+
+JSON output:
+
+```json
+{
+  "hits": [
+    {
+      "id": 2,
+      "title": "Wonder Woman",
+      "genres": [
+        "Action",
+        "Adventure"
+      ]
+    }
+  ],
+  "nbHits": 1,
+  "exhaustiveNbHits": false,
+  "query": "wonder",
+  "limit": 20,
+  "offset": 0,
+  "processingTimeMs": 0
+}
+```
+
 ## 🤖 Compatibility with MeiliSearch
 
 This package only guarantees the compatibility with the [version v0.23.0 of MeiliSearch](https://github.com/meilisearch/MeiliSearch/releases/tag/v0.23.0).

docker-compose.yml

@@ -0,0 +1,26 @@
+version: "3.7"
+
+services:
+  meilisearch_ruby:
+    image: ruby
+    tty: true
+    stdin_open: true
+    working_dir: /home/app
+    environment:
+      - MEILISEARCH_HOST=meilisearch
+      - MEILISEARCH_PORT=7700
+    ports:
+      - "3001:3000"
+    volumes:
+      - ./:/home/app
+
+  meilisearch:
+    image: getmeili/meilisearch:latest
+    tty: true
+    stdin_open: true
+    container_name: meilisearch
+    ports:
+      - "7700:7700"
+    # Uncomment this to run the test suite
+    # environment:
+    #   - MEILI_MASTER_KEY=masterKey

lib/meilisearch/client.rb

@@ -6,8 +6,14 @@ module MeiliSearch
   class Client < HTTPRequest
     ### INDEXES
 
+    def raw_indexes
+      http_get('/indexes')
+    end
+
     def indexes
-      http_get '/indexes'
+      raw_indexes.map do |index_hash|
+        index_object(index_hash['uid'], index_hash['primaryKey'])
+      end
     end
 
     # Usage:

lib/meilisearch/http_request.rb

@@ -17,47 +17,54 @@ def initialize(url, api_key = nil, options = {})
         'Content-Type' => 'application/json',
         'X-Meili-API-Key' => api_key
       }.compact
+      @headers_no_body = {
+        'X-Meili-API-Key' => api_key
+      }.compact
     end
 
     def http_get(relative_path = '', query_params = {})
       send_request(
         proc { |path, config| self.class.get(path, config) },
         relative_path,
-        query_params
+        query_params: query_params,
+        headers: @headers_no_body
       )
     end
 
     def http_post(relative_path = '', body = nil, query_params = nil)
       send_request(
         proc { |path, config| self.class.post(path, config) },
         relative_path,
-        query_params,
-        body
+        query_params: query_params,
+        body: body,
+        headers: @headers
       )
     end
 
     def http_put(relative_path = '', body = nil, query_params = nil)
       send_request(
         proc { |path, config| self.class.put(path, config) },
         relative_path,
-        query_params,
-        body
+        query_params: query_params,
+        body: body,
+        headers: @headers
       )
     end
 
     def http_delete(relative_path = '')
       send_request(
         proc { |path, config| self.class.delete(path, config) },
-        relative_path
+        relative_path,
+        headers: @headers_no_body
       )
     end
 
     private
 
     SNAKE_CASE = /[^a-zA-Z0-9]+(.)/.freeze
 
-    def send_request(http_method, relative_path, query_params = nil, body = nil)
-      config = http_config(query_params, body)
+    def send_request(http_method, relative_path, query_params: nil, body: nil, headers: nil)
+      config = http_config(query_params, body, headers)
       begin
         response = http_method.call(@base_url + relative_path, config)
       rescue Errno::ECONNREFUSED => e
@@ -66,11 +73,10 @@ def send_request(http_method, relative_path, query_params = nil, body = nil)
       validate(response)
     end
 
-    def http_config(query_params, body)
+    def http_config(query_params, body, headers)
       body = transform_attributes(body).to_json
-
       {
-        headers: @headers,
+        headers: headers,
         query: query_params,
         body: body,
         timeout: @options[:timeout] || 1,