pgvector 0.3.2 → 0.3.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fbdde0af357aaae0f727dff71e8678c705b1b347ecca7b49a8ca097189b42db0
-  data.tar.gz: d9d8bee13760ca165905f888e79507350565425ae819c452bf723ff775899235
+  metadata.gz: 7238af114feedc000b706855f9af446a583455a94771ece1e90c3e3082e63c44
+  data.tar.gz: f926141da347dc8bc1f3663e271cf3efa6b73b7c84c11e17db92f0d32af1a47c
 SHA512:
-  metadata.gz: '04629b78419ba4fd5325792d2b47f60a6a42fe2e5f8c681bcbd53d2f769b0c8db74ba7e53b9ef84c579b1c98ded45b51e3fe58347394b5f7b707efc81a6500f3'
-  data.tar.gz: 995963de5eb7bd7587bff1f70a709cb9b4e7f0791ef6f23b6930104c5a0ba61514a684b2dbf784b2e5b62464e84f5c6edbf569681578d75c5db860500c46bbae
+  metadata.gz: 6351a9f10f989fb92e8b5f5edea1d66dcf5110b65b748fef654faa9bfe189af64a095dd263be03af8513f552063b828730bbc09b3545f3ccf25bc7b3aef9f47a
+  data.tar.gz: 86d146518d40c9af209e9a671db10c024df4c256271de7062c4de657404508d2c0aef599cb5a9a29c6b0190f40b2bedfb91dbb41c6a31bb40b0e0b7242d4957b

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 0.3.3 (2026-03-18)
+
+- Fixed error with `nil` values for Sequel
+
 ## 0.3.2 (2024-07-17)
 
 - Added `to_binary` method to `Vector`, `Bit`, and `SparseVector`

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2022-2024 Andrew Kane
+Copyright (c) 2022-2025 Andrew Kane
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -23,11 +23,17 @@ And follow the instructions for your database library:
 
 Or check out some examples:
 
-- [Embeddings](examples/openai_embeddings.rb) with OpenAI
-- [Binary embeddings](examples/cohere_embeddings.rb) with Cohere
-- [User-based recommendations](examples/disco_user_recs.rb) with Disco
-- [Item-based recommendations](examples/disco_item_recs.rb) with Disco
-- [Bulk loading](examples/bulk_loading.rb) with `COPY`
+- [Embeddings](examples/openai/example.rb) with OpenAI
+- [Binary embeddings](examples/cohere/example.rb) with Cohere
+- [Sentence embeddings](examples/informers/example.rb) with Informers
+- [Hybrid search](examples/hybrid/example.rb) with Informers (Reciprocal Rank Fusion)
+- [Sparse search](examples/sparse/example.rb) with Transformers.rb
+- [Morgan fingerprints](examples/rdkit/example.rb) with RDKit.rb
+- [Topic modeling](examples/tomoto/example.rb) with tomoto.rb
+- [User-based recommendations](examples/disco/user_recs.rb) with Disco
+- [Item-based recommendations](examples/disco/item_recs.rb) with Disco
+- [Horizontal scaling](examples/citus/example.rb) with Citus
+- [Bulk loading](examples/loading/example.rb) with `COPY`
 
 ## pg
 
@@ -127,6 +133,48 @@ DB.add_index :items, :embedding, type: "hnsw", opclass: "vector_l2_ops"
 
 Use `vector_ip_ops` for inner product and `vector_cosine_ops` for cosine distance
 
+## Reference
+
+### Sparse Vectors
+
+Create a sparse vector from an array
+
+```ruby
+vec = Pgvector::SparseVector.new([1, 0, 2, 0, 3, 0])
+```
+
+Or a hash of non-zero elements
+
+```ruby
+vec = Pgvector::SparseVector.new({0 => 1, 2 => 2, 4 => 3}, 6)
+```
+
+Note: Indices start at 0
+
+Get the number of dimensions
+
+```ruby
+dim = vec.dimensions
+```
+
+Get the indices of non-zero elements
+
+```ruby
+indices = vec.indices
+```
+
+Get the values of non-zero elements
+
+```ruby
+values = vec.values
+```
+
+Get an array
+
+```ruby
+arr = vec.to_a
+```
+
 ## History
 
 View the [changelog](https://github.com/pgvector/pgvector-ruby/blob/master/CHANGELOG.md)
@@ -149,3 +197,12 @@ createdb pgvector_ruby_test
 bundle install
 bundle exec rake test
 ```
+
+To run an example:
+
+```sh
+cd examples/loading
+bundle install
+createdb pgvector_example
+bundle exec ruby example.rb
+```

data/lib/pgvector/vector.rb

@@ -30,7 +30,7 @@ module Pgvector
 
     def to_binary
       if numo?(@data)
-        [@data.shape[0], 0].pack("s>s>") + @data.to_network.to_binary
+        [@data.shape[0], 0].pack("s>s>") + @data.to_network.to_binary.force_encoding(Encoding::BINARY)
       else
         buffer = [@data.size, 0].pack("s>s>")
         @data.pack("g*", buffer: buffer)

data/lib/pgvector/version.rb

@@ -1,3 +1,3 @@
 module Pgvector
-  VERSION = "0.3.2"
+  VERSION = "0.3.3"
 end

data/lib/sequel/plugins/pgvector.rb

@@ -10,6 +10,7 @@ module Sequel
 
       module DatasetMethods
         def nearest_neighbors(column, value, distance:)
+          return extension(:null_dataset).nullify if value.nil?
           value = ::Pgvector.encode(value) unless value.is_a?(String)
           quoted_column = quote_identifier(column)
           distance = distance.to_s
@@ -67,7 +68,7 @@ module Sequel
         end
 
         def []=(k, v)
-          if self.class.vector_columns.key?(k.to_sym) && !v.is_a?(String)
+          if self.class.vector_columns.key?(k.to_sym) && !v.is_a?(String) && !v.nil?
             super(k, ::Pgvector.encode(v))
           else
             super
@@ -75,10 +76,12 @@ module Sequel
         end
 
         def [](k)
-          if self.class.vector_columns.key?(k.to_sym)
-            ::Pgvector.decode(super)
+          v = super
+          if self.class.vector_columns.key?(k.to_sym) && !v.nil?
+            # to_s needed for JRuby
+            ::Pgvector.decode(v.to_s)
           else
-            super
+            v
           end
         end
       end

metadata

@@ -1,16 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pgvector
 version: !ruby/object:Gem::Version
-  version: 0.3.2
+  version: 0.3.3
 platform: ruby
 authors:
 - Andrew Kane
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-07-17 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
-description:
 email: andrew@ankane.org
 executables: []
 extensions: []
@@ -32,7 +30,6 @@ homepage: https://github.com/pgvector/pgvector-ruby
 licenses:
 - MIT
 metadata: {}
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -47,8 +44,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.11
-signing_key:
+rubygems_version: 4.0.3
 specification_version: 4
 summary: pgvector support for Ruby
 test_files: []