qdrant-ruby 0.9.10 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6269ed0349b2612a9221b36a181df8c4126e4542685b313dcf839cfc5a91314a
-  data.tar.gz: 660452185073d98c71d11ebe68b18dd5c0b16ee96085d830896529a618f473e9
+  metadata.gz: 6899d046fe093cba0a8f390313bba21f2febb5319984fa516b99d2d3a825af17
+  data.tar.gz: e99fb180f6d3adca5f91133d5b88869a11fb5b004147c3ddb0987428b479713d
 SHA512:
-  metadata.gz: 7b4b80c0d1867ca65b7710974f6c13dd5e885b84b8ded38a2c34499ecff63ed3fdf782fa35a892ea32a110b3448a3b49b61e8f5e1dd7cd2f3ff946065c7ea80a
-  data.tar.gz: 8c4957ff10a42198a4f0a133323c99d197eec8177e5c3daec7b1d708255ce101c1b5e4b9e3a70b0fc7e11ac7bda2da15b15a312932875ba36d556468e08527ad
+  metadata.gz: 619eb3d6fa73efb8bc57351418c6db3824f9b2fa416911be4555278944489d29cebf9892f26c23ff7406b631450a992059e8c84f05f64845a3d45799f9844fe5
+  data.tar.gz: c336aa478ac184ce7c70543bd5faaa15ce3d3340a77862ef3d0ccbbcfbe80430348ca0977f83591ace3309d18d108140e3e7e304e3d037c81711fec1939a35f9

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 ## [Unreleased]
 
+## [0.11.0] - 2026-10-21
+- Fix `collections.restore_snapshot` to use PUT (POST always returned 404)
+- Fix `clusters.remove_peer` to call `DELETE /cluster/peer/{peer_id}` instead of `POST /cluster/recover`
+- `client.aliases` no longer caches the first response
+- `points.list` now requires `ids:` (the API always required it)
+- Deprecation warnings for `points.search`, `batch_search`, `recommend`, `batch_recommend` (use `points.query`), the lock API and `init_from:` (both removed in Qdrant 1.16)
+- README: fix inaccurate examples and remove the nonexistent `backups` section
+
+## [0.10.0] - 2026-08-12
+- Drop Faraday dependency
+
+## [0.9.10] - 2025-11-23
+
 ## [0.9.9] - 2024-04-11
 - Allow sparse_vectors to be passed to collections.create
 - Support query endpoint
@@ -14,7 +27,8 @@
 - Updated Points#delete() method: Removed the requirement to specify points: in parameters. Now generates an error if neither points: nor filters: are provided, aligning with delete_points documentation standards.
 
 ## [0.9.5] - 2024-01-12
-- Bugfix: ArgumentError for filter in points delete 
+- Bugfix: ArgumentError for filter in points delete
+
 ## [0.9.4] - 2023-08-31
 - Introduce `Points#get_all()` method
 

data/Gemfile

@@ -5,7 +5,7 @@ source "https://rubygems.org"
 # Specify your gem's dependencies in qdrant.gemspec
 gemspec
 
-gem "rake", "~> 13.3"
+gem "rake", "~> 13.4"
 
 gem "rspec", "~> 3.13"
-gem "standard", "~> 1.28.5"
+gem "standard", "~> 1.57.0"

data/Gemfile.lock

@@ -1,41 +1,41 @@
 PATH
   remote: .
   specs:
-    qdrant-ruby (0.9.10)
-      faraday (>= 2.0.1, < 3)
+    qdrant-ruby (0.11.0)
+      logger
 
 GEM
   remote: https://rubygems.org/
   specs:
-    ast (2.4.2)
-    base64 (0.2.0)
-    byebug (11.1.3)
+    ast (2.4.3)
+    byebug (13.0.0)
+      reline (>= 0.6.0)
     coderay (1.1.3)
     diff-lcs (1.6.2)
-    faraday (2.8.1)
-      base64
-      faraday-net_http (>= 2.0, < 3.1)
-      ruby2_keywords (>= 0.0.4)
-    faraday-net_http (3.0.2)
-    json (2.7.4)
-    language_server-protocol (3.17.0.3)
+    io-console (0.9.2)
+    json (3.1.0)
+    language_server-protocol (3.17.0.6)
     lint_roller (1.1.0)
-    method_source (1.0.0)
-    parallel (1.24.0)
-    parser (3.3.5.0)
+    logger (1.7.0)
+    method_source (1.1.0)
+    parallel (2.3.0)
+    parser (3.3.12.0)
       ast (~> 2.4.1)
       racc
-    pry (0.14.2)
+    prism (1.9.0)
+    pry (0.16.0)
       coderay (~> 1.1)
       method_source (~> 1.0)
-    pry-byebug (3.10.1)
-      byebug (~> 11.0)
-      pry (>= 0.13, < 0.15)
+      reline (>= 0.6.0)
+    pry-byebug (3.12.0)
+      byebug (~> 13.0)
+      pry (>= 0.13, < 0.17)
     racc (1.8.1)
     rainbow (3.1.1)
-    rake (13.3.1)
-    regexp_parser (2.9.2)
-    rexml (3.4.2)
+    rake (13.4.2)
+    regexp_parser (2.13.1)
+    reline (0.7.0)
+      io-console (~> 0.5)
     rspec (3.13.2)
       rspec-core (~> 3.13.0)
       rspec-expectations (~> 3.13.0)
@@ -45,40 +45,44 @@ GEM
     rspec-expectations (3.13.5)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
-    rspec-mocks (3.13.6)
+    rspec-mocks (3.13.8)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
-    rspec-support (3.13.6)
-    rubocop (1.50.2)
-      json (~> 2.3)
-      parallel (~> 1.10)
-      parser (>= 3.2.0.0)
+    rspec-support (3.13.7)
+    rubocop (1.91.0)
+      json (>= 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (>= 1.10)
+      parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
-      regexp_parser (>= 1.8, < 3.0)
-      rexml (>= 3.2.5, < 4.0)
-      rubocop-ast (>= 1.28.0, < 2.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.49.0, < 2.0)
       ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 2.4.0, < 3.0)
-    rubocop-ast (1.30.0)
-      parser (>= 3.2.1.0)
-    rubocop-performance (1.16.0)
-      rubocop (>= 1.7.0, < 2.0)
-      rubocop-ast (>= 0.4.0)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.50.0)
+      parser (>= 3.3.7.2)
+      prism (~> 1.7)
+    rubocop-performance (1.26.1)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.75.0, < 2.0)
+      rubocop-ast (>= 1.47.1, < 2.0)
     ruby-progressbar (1.13.0)
-    ruby2_keywords (0.0.5)
-    standard (1.28.5)
+    standard (1.57.0)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.0)
-      rubocop (~> 1.50.2)
+      rubocop (~> 1.91.0)
       standard-custom (~> 1.0.0)
-      standard-performance (~> 1.0.1)
+      standard-performance (~> 1.8)
     standard-custom (1.0.2)
       lint_roller (~> 1.0)
       rubocop (~> 1.50)
-    standard-performance (1.0.1)
-      lint_roller (~> 1.0)
-      rubocop-performance (~> 1.16.0)
-    unicode-display_width (2.6.0)
+    standard-performance (1.9.0)
+      lint_roller (~> 1.1)
+      rubocop-performance (~> 1.26.0)
+    unicode-display_width (3.3.0)
+      unicode-emoji (~> 4.3)
+    unicode-emoji (4.3.0)
 
 PLATFORMS
   arm64-darwin-23
@@ -90,9 +94,9 @@ PLATFORMS
 DEPENDENCIES
   pry-byebug (~> 3.9)
   qdrant-ruby!
-  rake (~> 13.3)
+  rake (~> 13.4)
   rspec (~> 3.13)
-  standard (~> 1.28.5)
+  standard (~> 1.57.0)
 
 BUNDLED WITH
-   2.4.0
+   2.5.3

data/README.md

@@ -1,7 +1,7 @@
 # Qdrant
 
 <p>
-    <img alt='Qdrant logo' src='https://qdrant.tech/images/logo_with_text.svg' height='50' />
+    <img alt='Qdrant logo' src='https://qdrant.tech/img/brand-resources-logos/qdrant-brandmark-red.svg' height='50' />
     &nbsp;&nbsp;+&nbsp;&nbsp;
     <img alt='Ruby logo' src='https://user-images.githubusercontent.com/541665/230231593-43861278-4550-421d-a543-fd3553aac4f6.png' height='40' />
 </p>
@@ -13,7 +13,7 @@ Part of the [Langchain.rb](https://github.com/andreibondarev/langchainrb) stack.
 ![Tests status](https://github.com/andreibondarev/qdrant-ruby/actions/workflows/ci.yml/badge.svg)
 [![Gem Version](https://badge.fury.io/rb/qdrant-ruby.svg)](https://badge.fury.io/rb/qdrant-ruby)
 [![Docs](http://img.shields.io/badge/yard-docs-blue.svg)](http://rubydoc.info/gems/qdrant-ruby)
-[![License](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/andreibondarev/qdrant-ruby/blob/main/LICENSE.txt)
+[![License](https://img.shields.io/badge/license-Apache2.0-green.svg)](https://github.com/andreibondarev/qdrant-ruby/blob/main/LICENSE.txt)
 [![](https://dcbadge.vercel.app/api/server/WDARp7J2n8?compact=true&style=flat)](https://discord.gg/WDARp7J2n8)
 
 ## Installation
@@ -52,6 +52,7 @@ client.collections.get(collection_name: "string")
 client.collections.create(
     collection_name: "string",     # required
     vectors: {},                   # required
+    sparse_vectors: nil,
     shard_number: nil,
     replication_factor: nil,
     write_consistency_factor: nil,
@@ -59,7 +60,6 @@ client.collections.create(
     hnsw_config: nil,
     wal_config: nil,
     optimizers_config: nil,
-    init_from: nil,
     quantization_config: nil
 )
 
@@ -73,11 +73,14 @@ client.collections.update(
 # Drop collection and all associated data
 client.collections.delete(collection_name: "string")
 
-# Get list of all aliases (for a collection)
+# Get list of all aliases for a collection
 client.collections.aliases(
-    collection_name: "string" # optional
+    collection_name: "string" # required
 )
 
+# Get list of all aliases across all collections
+client.aliases
+
 # Update aliases of the collections
 client.collections.update_aliases(
     actions: [{
@@ -101,9 +104,7 @@ client.collections.create_index(
 # Delete field index for collection
 client.collections.delete_index(
     collection_name: "string", # required
-    field_name: "string",      # required
-    wait: "boolean",
-    ordering: "ordering"
+    field_name: "string"       # required
 )
 
 # Get cluster information for a collection
@@ -118,8 +119,7 @@ client.collections.update_cluster(
         shard_id: "int",
         to_peer_id: "int",
         from_peer_id: "int"
-    },
-    timeout: "int"
+    }
 )
 
 # Create new snapshot for a collection
@@ -167,28 +167,57 @@ client.points.get(
 client.points.get_all(
     collection_name: "string", # required
     ids: "[int]",              # required
-    with_payload: "boolean"
-    with_vector: "boolean"
+    with_payload: "boolean",
+    with_vector: "boolean",
+    consistency: "int/string"
 )
 
-# Lists all data objects in reverse order of creation. The data will be returned as an array of objects.
+# Retrieve full information of points by ids. Same as `get_all`.
 client.points.list(
     collection_name: "string", # required
     ids: "[int/string]",       # required
     with_payload: nil,
     with_vector: nil,
     consistency: nil
-
 )
 
-# Get a single data object.
+# Insert or update points. Either `points:` or `batch:` is required.
 client.points.upsert(
     collection_name: "string", # required
-    batch: {},                 # required
+    points: [],                # record-oriented: array of point hashes
+    batch: {},                 # column-oriented: hash of parallel arrays
     wait: "boolean",
     ordering: "string"
 )
 
+# Record-oriented upsert: each point is a hash with its own id, vector and payload
+client.points.upsert(
+    collection_name: "my_collection",
+    points: [
+        {id: 1, vector: [0.9, 0.1, 0.1], payload: {color: "red"}},
+        {id: 2, vector: [0.1, 0.9, 0.1], payload: {color: "green"}},
+        {id: 3, vector: [0.1, 0.1, 0.9], payload: {color: "blue"}}
+    ]
+)
+
+# Column-oriented (batch) upsert: ids, vectors and payloads are passed as parallel arrays
+client.points.upsert(
+    collection_name: "my_collection",
+    batch: {
+        ids: [1, 2, 3],
+        vectors: [
+            [0.9, 0.1, 0.1],
+            [0.1, 0.9, 0.1],
+            [0.1, 0.1, 0.9]
+        ],
+        payloads: [
+            {color: "red"},
+            {color: "green"},
+            {color: "blue"}
+        ]
+    }
+)
+
 # Delete points
 client.points.delete(
     collection_name: "string", # required
@@ -249,6 +278,28 @@ client.points.scroll(
     consistency: "int/string"
 )
 
+# Universally query points: covers search, recommend and discover, plus hybrid and multi-stage queries
+client.points.query(
+    collection_name: "string", # required
+    query: "[float]/{}",       # a vector, a point ID, or a query object such as {recommend: {positive: [1]}}
+    using: "string",
+    prefetch: {},
+    filter: {},
+    params: {},
+    score_threshold: "float",
+    limit: "int",
+    offset: "int",
+    with_payload: "boolean",
+    with_vector: "boolean",
+    lookup_from: {},
+    shard_key: "string",
+    consistency: "int/string",
+    timeout: "int"
+)
+
+# DEPRECATED (since Qdrant 1.13): `search`, `batch_search`, `recommend` and `batch_recommend`
+# still work but are no longer documented by Qdrant and will be removed. Use `points.query` instead.
+
 # Retrieve closest points based on vector similarity and given filtering conditions
 client.points.search(
     collection_name: "string", # required
@@ -281,9 +332,9 @@ client.points.recommend(
     offset: "int",
     with_payload: "boolean",
     with_vector: "boolean",
-    score_threshold: "float"
+    score_threshold: "float",
     using: "string",
-    lookup_from: {},
+    lookup_from: {}
 )
 
 # Look for the points which are closer to stored positive examples and at the same time further to negative examples.
@@ -304,58 +355,33 @@ client.points.count(
 ### Snapshots
 ```ruby
 # Get list of snapshots of the whole storage
-client.snapshots.list(
-    collection_name: "string" # optional
-)
+client.snapshots.list
 
 # Create new snapshot of the whole storage
-client.snapshots.create(
-    collection_name: "string" # required
-)
+client.snapshots.create
 
 # Delete snapshot of the whole storage
 client.snapshots.delete(
-    collection_name: "string", # required
-    snapshot_name: "string"    # required
+    snapshot_name: "string" # required
 )
 
 # Download specified snapshot of the whole storage as a file
 client.snapshots.download(
-    collection_name: "string", # required
-    snapshot_name: "string"    # required
-    filepath: "~/Downloads/backup.txt" # required
-)
-
-
-# Get the backup
-client.backups.get(
-    backend: "filesystem",
-    id: "my-first-backup"
-)
-
-# Restore backup
-client.backups.restore(
-    backend: "filesystem",
-    id: "my-first-backup"
-)
-
-# Check the backup restore status
-client.backups.restore_status(
-    backend: "filesystem",
-    id: "my-first-backup"
+    snapshot_name: "string",                # required
+    filepath: "~/Downloads/backup.snapshot" # required
 )
 ```
 
 ### Cluster
 ```ruby
 # Get information about the current state and composition of the cluster
-client.cluster.info
+client.clusters.info
 
 # Tries to recover current peer Raft state.
-client.cluster.recover
+client.clusters.recover
 
 # Tries to remove peer from the cluster. Will return an error if peer has shards on it.
-client.cluster.remove_peer(
+client.clusters.remove_peer(
     peer_id: "int",  # required
     force: "boolean"
 )
@@ -373,12 +399,14 @@ client.metrics(
     anonymize: "boolean" # optional
 )
 
+# DEPRECATED: the lock API was removed in Qdrant 1.16. These only work against older servers.
+
 # Get lock options. If write is locked, all write operations and collection creation are forbidden
 client.locks
 
 # Set lock options. If write is locked, all write operations and collection creation are forbidden. Returns previous lock options
 client.set_lock(
-    write: "boolean" # required
+    write: "boolean", # required
     error_message: "string"
 )
 ```
@@ -387,6 +415,16 @@ client.set_lock(
 
 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.
 
+The default `bundle exec rake` task runs `lint` (standardrb auto-format), `spec`, and `e2e` (a hosted end-to-end smoke test against a real Qdrant deployment) in sequence. Because the E2E step needs real credentials, run it with your hosted endpoint and API key exported:
+
+```sh
+export QDRANT_URL="https://<hosted-qdrant-endpoint>"
+export QDRANT_API_KEY="<project-api-key>"
+bundle exec rake
+```
+
+The individual steps are also available as `bundle exec rake lint`, `bundle exec rake spec`, and `bundle exec rake e2e`. Run the hosted check against an isolated or disposable project, since it creates and deletes a temporary collection.
+
 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).
 
 ## Contributing

data/Rakefile

@@ -1,8 +1,19 @@
 # frozen_string_literal: true
 
 require "bundler/gem_tasks"
+require "rbconfig"
 require "rspec/core/rake_task"
 
 RSpec::Core::RakeTask.new(:spec)
 
-task default: :spec
+desc "Run the standardrb linter (auto-fix)"
+task :lint do
+  sh "bundle exec standardrb --fix"
+end
+
+desc "Run the hosted Qdrant API end-to-end smoke test"
+task :e2e do
+  exec RbConfig.ruby, File.expand_path("script/e2e.rb", __dir__)
+end
+
+task default: %i[lint spec e2e]

data/lib/qdrant/base.rb

@@ -7,5 +7,13 @@ module Qdrant
     def initialize(client:)
       @client = client
     end
+
+    private
+
+    # Point the warning at the caller's code, skipping frames inside the gem and Forwardable.
+    def deprecation_warning(message)
+      uplevel = caller_locations.index { |loc| !loc.path.start_with?(__dir__) && !loc.path.end_with?("/forwardable.rb") }
+      warn("[DEPRECATION] Qdrant: #{message}", uplevel: uplevel + 1)
+    end
   end
 end

data/lib/qdrant/client/connection.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require "net/http"
+
+require_relative "request"
+require_relative "response"
+
+module Qdrant
+  class Client
+    class Connection
+      def initialize(url:, api_key:, raise_error:, logger:)
+        @uri = url
+        @api_key = api_key
+        @raise_error = raise_error
+        @logger = logger
+      end
+
+      def get(path, &block)
+        execute(Net::HTTP::Get, path, &block)
+      end
+
+      def post(path, &block)
+        execute(Net::HTTP::Post, path, &block)
+      end
+
+      def put(path, &block)
+        execute(Net::HTTP::Put, path, &block)
+      end
+
+      def patch(path, &block)
+        execute(Net::HTTP::Patch, path, &block)
+      end
+
+      def delete(path, &block)
+        execute(Net::HTTP::Delete, path, &block)
+      end
+
+      private
+
+      def execute(verb, path, &block)
+        response = RequestBuilder
+          .new(verb, @uri, path, @api_key, @logger)
+          .tap(&block)
+          .build
+          .perform(@raise_error)
+
+        ResponseBuilder.new(response).build
+      end
+    end
+  end
+end

data/lib/qdrant/client/request.rb

@@ -0,0 +1,95 @@
+# frozen_string_literal: true
+
+require "json"
+require "net/http"
+require "uri"
+
+module Qdrant
+  class Client
+    RequestData = Struct.new(:params, :body)
+
+    class RequestBuilder
+      def initialize(verb, base_url, path, api_key, logger)
+        raise ArgumentError, "unsupported HTTP verb" unless verb < Net::HTTPRequest
+
+        @verb = verb
+        @base_url = base_url
+        @path = path
+        @api_key = api_key
+        @logger = logger
+
+        @request = RequestData.new({}, nil)
+      end
+
+      def tap
+        yield @request if block_given?
+        self
+      end
+
+      def build
+        Request.new build_uri, @verb, @request.body, @api_key, @logger
+      end
+
+      private
+
+      def build_uri
+        path, query = @path.to_s.split("?", 2)
+
+        URI.join(@base_url, path).tap do |uri|
+          if (query_pairs = URI.decode_www_form(query.to_s) + @request.params.to_a).any?
+            uri.query = URI.encode_www_form(query_pairs)
+          end
+        end
+      end
+    end
+
+    class Request
+      def initialize(uri, verb, body, api_key, logger)
+        @logger = logger
+        @uri = uri
+        @verb = verb
+
+        @data = verb.new(uri.request_uri).tap do |request|
+          request["api-key"] = api_key if api_key
+
+          if body
+            request.body = JSON.generate(body)
+            request["Content-Type"] = request["Accept"] = "application/json"
+          end
+        end
+
+        logger.info("#{verb_name} #{uri}")
+        logger.info("Request headers: #{redacted_headers.inspect}")
+        logger.info("Request body: #{@data.body}") if @data.body
+      end
+
+      def perform(raise_error)
+        @logger.info("Performing Request: #{verb_name} #{@uri}")
+
+        response = Net::HTTP.new(@uri.host, @uri.port).tap do |h|
+          h.use_ssl = true if @uri.scheme == "https"
+        end.request(@data)
+
+        response.value if raise_error
+
+        @logger.info("Response status: #{response.code}")
+        response
+      rescue => e
+        @logger.error("#{verb_name} #{@uri} failed: #{e.class}: #{e.message}")
+        raise
+      end
+
+      private
+
+      def verb_name
+        @verb.name.split("::").last.upcase
+      end
+
+      def redacted_headers
+        @data.to_hash.tap do |headers|
+          headers["api-key"] = "[FILTERED]" if headers.key?("api-key")
+        end
+      end
+    end
+  end
+end

data/lib/qdrant/client/response.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require "json"
+
+module Qdrant
+  class Client
+    Response = Struct.new(:status, :headers, :body)
+
+    class ResponseBuilder
+      JSON_CONTENT_TYPE_REGEX = /\bjson\z/
+
+      def initialize(response)
+        @response = response
+      end
+
+      def build
+        Response.new(@response.code.to_i, @response.to_hash, parse_body)
+      end
+
+      private
+
+      def parse_body
+        body = @response.body
+        return body unless !body.nil? && !body.empty? && json_response?
+
+        JSON.parse(body)
+      rescue JSON::ParserError
+        # Fallback to raw body if JSON parsing fails unexpectedly
+        body
+      end
+
+      def json_response?
+        content_type = @response["Content-Type"]
+        return false if content_type.nil?
+
+        media_type = content_type.split(";").first.to_s.strip
+        media_type.match?(JSON_CONTENT_TYPE_REGEX)
+      end
+    end
+  end
+end

data/lib/qdrant/client.rb

@@ -1,8 +1,10 @@
 # frozen_string_literal: true
 
-require "faraday"
+require "logger"
 require "forwardable"
 
+require_relative "client/connection"
+
 module Qdrant
   class Client
     extend Forwardable
@@ -14,11 +16,11 @@ module Qdrant
     def initialize(
       url:,
       api_key: nil,
-      adapter: Faraday.default_adapter,
       raise_error: false,
-      logger: nil
+      logger: nil,
+      adapter: nil # Deprecated. Doesn't select the transport. Should be removed in subsequent releases
     )
-      @url = url
+      @url = normalize_url(url)
       @api_key = api_key
       @adapter = adapter
       @raise_error = raise_error
@@ -26,20 +28,16 @@ module Qdrant
     end
 
     def connection
-      @connection ||= Faraday.new(url: url) do |faraday|
-        if api_key
-          faraday.headers["api-key"] = api_key
-        end
-        faraday.request :json
-        faraday.response :logger, @logger, {headers: true, bodies: true, errors: true}
-        faraday.response :raise_error if raise_error
-        faraday.response :json, content_type: /\bjson$/
-        faraday.adapter adapter
-      end
+      @connection ||= Connection.new(
+        url: url,
+        api_key: api_key,
+        raise_error: raise_error,
+        logger: logger
+      )
     end
 
     def aliases
-      @aliases ||= Qdrant::Aliases.new(client: self).list
+      Qdrant::Aliases.new(client: self).list
     end
 
     def collections
@@ -61,5 +59,14 @@ module Qdrant
     def points
       @points ||= Qdrant::Points.new(client: self)
     end
+
+    private
+
+    def normalize_url(url)
+      raise ArgumentError, "url must be a String" unless url.is_a?(String)
+      return url if url.start_with?("http://", "https://")
+
+      "https://#{url}"
+    end
   end
 end

data/lib/qdrant/clusters.rb

@@ -21,7 +21,7 @@ module Qdrant
       peer_id:,
       force: nil
     )
-      response = client.connection.post("#{PATH}/recover") do |req|
+      response = client.connection.delete("#{PATH}/peer/#{peer_id}") do |req|
         req.params["force"] = force if force
       end
       response.body

data/lib/qdrant/collections.rb

@@ -31,6 +31,8 @@ module Qdrant
       init_from: nil,
       quantization_config: nil
     )
+      deprecation_warning("`init_from:` was removed in Qdrant 1.16 and is ignored by the server.") unless init_from.nil?
+
       response = client.connection.put("#{PATH}/#{collection_name}") do |req|
         req.body = {}
         req.body["vectors"] = vectors
@@ -176,7 +178,7 @@ module Qdrant
       priority: nil,
       wait: nil
     )
-      response = client.connection.post("#{PATH}/#{collection_name}/snapshots/recover") do |req|
+      response = client.connection.put("#{PATH}/#{collection_name}/snapshots/recover") do |req|
         req.params["wait"] = wait unless wait.nil?
 
         req.body = {

data/lib/qdrant/points.rb

@@ -4,10 +4,10 @@ module Qdrant
   class Points < Base
     PATH = "points"
 
-    # Lists all data objects in reverse order of creation. The data will be returned as an array of objects.
+    # Retrieve full information of points by ids. Same as `get_all`.
     def list(
       collection_name:,
-      ids: nil,
+      ids:,
       with_payload: nil,
       with_vector: nil,
       consistency: nil
@@ -51,7 +51,6 @@ module Qdrant
       ordering: nil,
       filter: nil
     )
-
       raise ArgumentError, "Either points or filter should be provided" if points.nil? && filter.nil?
 
       response = client.connection.post("collections/#{collection_name}/#{PATH}/delete") do |req|
@@ -213,6 +212,8 @@ module Qdrant
       score_threshold: nil,
       consistency: nil
     )
+      deprecation_warning("`points.search` is deprecated since Qdrant 1.13 and will be removed from the server; use `points.query` instead.")
+
       response = client.connection.post("collections/#{collection_name}/#{PATH}/search") do |req|
         req.params["consistency"] = consistency unless consistency.nil?
 
@@ -235,6 +236,8 @@ module Qdrant
       searches:,
       consistency: nil
     )
+      deprecation_warning("`points.batch_search` is deprecated since Qdrant 1.13 and will be removed from the server; use `points.query` instead.")
+
       response = client.connection.post("collections/#{collection_name}/#{PATH}/search/batch") do |req|
         req.params["consistency"] = consistency unless consistency.nil?
 
@@ -260,6 +263,8 @@ module Qdrant
       lookup_from: nil,
       consistency: nil
     )
+      deprecation_warning("`points.recommend` is deprecated since Qdrant 1.13 and will be removed from the server; use `points.query` instead.")
+
       response = client.connection.post("collections/#{collection_name}/#{PATH}/recommend") do |req|
         req.params["consistency"] = consistency unless consistency.nil?
 
@@ -285,6 +290,8 @@ module Qdrant
       searches:,
       consistency: nil
     )
+      deprecation_warning("`points.batch_recommend` is deprecated since Qdrant 1.13 and will be removed from the server; use `points.query` instead.")
+
       response = client.connection.post("collections/#{collection_name}/#{PATH}/recommend/batch") do |req|
         req.params["consistency"] = consistency unless consistency.nil?
 

data/lib/qdrant/service.rb

@@ -27,6 +27,8 @@ module Qdrant
       write:,
       error_message: nil
     )
+      deprecation_warning("the lock API was removed in Qdrant 1.16; `set_lock` only works against older servers.")
+
       response = client.connection.post("locks") do |req|
         req.body = {
           write: write
@@ -38,6 +40,8 @@ module Qdrant
 
     # Get lock options. If write is locked, all write operations and collection creation are forbidden
     def locks
+      deprecation_warning("the lock API was removed in Qdrant 1.16; `locks` only works against older servers.")
+
       response = client.connection.get("locks")
       response.body
     end

data/lib/qdrant/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Qdrant
-  VERSION = "0.9.10"
+  VERSION = "0.11.0"
 end

data/script/e2e.rb

@@ -0,0 +1,130 @@
+# frozen_string_literal: true
+
+require "bundler/setup"
+require "logger"
+require "securerandom"
+require "qdrant"
+
+def assert!(condition, message)
+  raise "e2e assertion failed: #{message}" unless condition
+end
+
+def ok_body!(body, operation)
+  assert!(body.is_a?(Hash), "#{operation} returned #{body.class}, expected Hash")
+  assert!(body["status"] == "ok", "#{operation} returned status #{body["status"].inspect}")
+  body
+end
+
+url = ENV.fetch("QDRANT_URL", "").strip
+api_key = ENV.fetch("QDRANT_API_KEY", "").strip
+
+abort "QDRANT_URL must be set to an https:// hosted endpoint" if url.empty? || !url.start_with?("https://")
+abort "QDRANT_API_KEY must be set" if api_key.empty?
+
+logger = Logger.new($stderr)
+logger.level = Logger::WARN
+
+client = Qdrant::Client.new(
+  url: url,
+  api_key: api_key,
+  raise_error: true,
+  logger: logger
+)
+
+collection_name = "qdrant_ruby_e2e_#{Process.pid}_#{Time.now.utc.strftime("%Y%m%d%H%M%S")}_#{SecureRandom.hex(4)}"
+collection_created = false
+failure = nil
+
+begin
+  body = ok_body!(client.collections.list, "collections.list")
+  assert!(body.dig("result", "collections").is_a?(Array), "collections.list result is not an Array")
+  puts "e2e: connection and authentication passed"
+
+  body = client.collections.create(
+    collection_name: collection_name,
+    vectors: {size: 3, distance: "Cosine"}
+  )
+  collection_created = true
+  ok_body!(body, "collections.create")
+  assert!(body["result"] == true, "collections.create did not return result=true")
+  puts "e2e: collection created (#{collection_name})"
+
+  body = ok_body!(client.collections.get(collection_name: collection_name), "collections.get")
+  status = body.dig("result", "status")
+  assert!(%w[green yellow].include?(status), "collection status was #{status.inspect}")
+
+  points = [
+    {id: 1, vector: [1.0, 0.0, 0.0], payload: {"source" => "hosted-e2e", "rank" => 1}},
+    {id: 2, vector: [0.0, 1.0, 0.0], payload: {"source" => "hosted-e2e", "rank" => 2}}
+  ]
+
+  body = ok_body!(
+    client.points.upsert(collection_name: collection_name, wait: true, points: points),
+    "points.upsert"
+  )
+  assert!(body.dig("result", "status") == "completed", "points.upsert did not return a completed status")
+
+  body = ok_body!(client.points.get(collection_name: collection_name, id: 1), "points.get")
+  assert!(body.dig("result", "id") == 1, "points.get returned the wrong point")
+
+  body = ok_body!(
+    client.points.get_all(
+      collection_name: collection_name,
+      ids: [1, 2],
+      with_payload: true,
+      with_vector: true
+    ),
+    "points.get_all"
+  )
+  results = body.fetch("result")
+  assert!(results.is_a?(Array) && results.length == 2, "points.get_all did not return two points")
+  assert!(results.map { |point| point["id"] }.sort == [1, 2], "points.get_all returned unexpected IDs")
+  assert!(results.find do |point|
+    point["id"] == 1
+  end.dig("payload", "source") == "hosted-e2e", "point payload was not persisted")
+  puts "e2e: point write and read round trip passed"
+
+  body = ok_body!(
+    client.points.query(
+      collection_name: collection_name,
+      query: [1.0, 0.0, 0.0],
+      limit: 1,
+      with_payload: true,
+      with_vector: false
+    ),
+    "points.query"
+  )
+  hit = body.dig("result", "points").first
+  assert!(hit && hit["id"] == 1, "points.query did not return point 1 first")
+  assert!(hit["score"].to_f > 0.99, "points.query score was #{hit["score"].inspect}")
+
+  body = ok_body!(client.points.count(collection_name: collection_name, exact: true), "points.count")
+  assert!(body.dig("result", "count") == 2, "points.count did not return 2")
+  puts "e2e: query and count passed"
+
+  body = ok_body!(client.points.delete(collection_name: collection_name, points: [1, 2], wait: true), "points.delete")
+  assert!(body.dig("result", "status") == "completed", "points.delete did not return a completed status")
+  body = ok_body!(client.points.count(collection_name: collection_name, exact: true), "points.count after delete")
+  assert!(body.dig("result", "count") == 0, "points.count after delete did not return 0")
+  puts "e2e: point deletion passed"
+rescue => e
+  failure = e
+  warn "e2e failed: #{e.class}: #{e.message}"
+ensure
+  if collection_created
+    begin
+      body = ok_body!(client.collections.delete(collection_name: collection_name), "collections.delete cleanup")
+      assert!(body["result"] == true, "collections.delete cleanup did not return result=true")
+      puts "e2e: temporary collection deleted"
+    rescue => e
+      failure ||= e
+      warn "e2e cleanup failed: #{e.class}: #{e.message}"
+    end
+  end
+end
+
+if failure
+  exit 1
+else
+  puts "e2e passed"
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: qdrant-ruby
 version: !ruby/object:Gem::Version
-  version: 0.9.10
+  version: 0.11.0
 platform: ruby
 authors:
 - Andrei Bondarev
@@ -10,25 +10,19 @@ cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: faraday
+  name: logger
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.1
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '3'
+        version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.1
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '3'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: pry-byebug
   requirement: !ruby/object:Gem::Requirement
@@ -63,6 +57,9 @@ files:
 - lib/qdrant/aliases.rb
 - lib/qdrant/base.rb
 - lib/qdrant/client.rb
+- lib/qdrant/client/connection.rb
+- lib/qdrant/client/request.rb
+- lib/qdrant/client/response.rb
 - lib/qdrant/clusters.rb
 - lib/qdrant/collections.rb
 - lib/qdrant/error.rb
@@ -70,6 +67,7 @@ files:
 - lib/qdrant/service.rb
 - lib/qdrant/snapshots.rb
 - lib/qdrant/version.rb
+- script/e2e.rb
 - sig/qdrant.rbs
 homepage: https://github.com/andreibondarev/qdrant-ruby
 licenses:
@@ -85,7 +83,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.6.0
+      version: '3.3'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="