zvec 0.0.1 → 0.0.3

data/lib/zvec/collection.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Zvec
   module CollectionConvenience
     # Convenience: build a VectorQuery and execute it
@@ -22,10 +24,8 @@ module Zvec
   # Block-form open: yields the collection and flushes on block exit
   def self.open_collection(path, options: nil)
     col = Collection.open(path, options)
-    begin
-      yield col
-    ensure
-      col.flush
-    end
+    yield col
+  ensure
+    col&.flush
   end
 end

data/lib/zvec/doc.rb

@@ -1,6 +1,10 @@
+# frozen_string_literal: true
+
 module Zvec
   class Doc
-    # Convert doc fields to a Ruby Hash using a CollectionSchema for type dispatch
+    # Convert doc fields to a Ruby Hash. The schema parameter is required because
+    # the C++ layer stores fields as type-erased values — the FieldSchema's data_type
+    # selects the correct deserialization path (get_field dispatches on it).
     def to_h(schema)
       result = {"pk" => pk, "score" => score}
       field_names.each do |name|

data/lib/zvec/version.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Zvec
-  VERSION = "0.0.1"
+  VERSION = "0.0.3"
 end

data/lib/zvec.rb

@@ -1,14 +1,25 @@
+# frozen_string_literal: true
+
 require_relative "zvec/version"
 require "zvec_ext"
 require_relative "zvec/collection"
 require_relative "zvec/doc"
 
-# Rice wraps shared_ptr<Collection> as Std::SharedPtr<zvec::Collection>,
-# which delegates C++ methods via method_missing. Ruby convenience methods
-# must be included into this wrapper class, not Zvec::Collection itself.
-# We discover the wrapper class by checking known Std:: classes.
-ObjectSpace.each_object(Class) do |klass|
-  if klass.name&.start_with?("Std::SharedPtr") && klass.name&.include?("Collection")
-    klass.include(Zvec::CollectionConvenience)
+module Zvec
+  # Rice wraps shared_ptr<Collection> as Std::SharedPtr<zvec::Collection>,
+  # a proxy class that delegates C++ methods via method_missing. Ruby
+  # convenience methods must be included into this wrapper class, not
+  # Zvec::Collection itself. We cannot use const_get because the wrapper
+  # class name contains C++ mangled type parameters (e.g. angle brackets).
+  def self.patch_shared_ptr_wrapper!
+    ObjectSpace.each_object(Class) do |klass|
+      if klass.name&.start_with?("Std::SharedPtr") && klass.name&.include?("Collection")
+        klass.include(Zvec::CollectionConvenience)
+        return klass
+      end
+    end
+    nil
   end
 end
+
+Zvec.patch_shared_ptr_wrapper!

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: zvec
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.3
 platform: ruby
 authors:
 - Dewayne VanHoozer
@@ -38539,6 +38539,12 @@ metadata:
   homepage_uri: https://github.com/MadBomber/zvec
   source_code_uri: https://github.com/MadBomber/zvec
   changelog_uri: https://github.com/MadBomber/zvec/blob/main/CHANGELOG.md
+post_install_message: |
+  zvec installed successfully!
+
+  Tip: For faster future installs, pre-build the C++ library with Homebrew:
+    brew tap madbomber/zvec https://github.com/MadBomber/zvec-ruby.git
+    brew install madbomber/zvec/zvec
 rdoc_options: []
 require_paths:
 - lib
@@ -38546,14 +38552,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.2.0
+      version: '4.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.6
+rubygems_version: 4.0.7
 specification_version: 4
 summary: EXPERIMENTAL - DO NOT INSTALL - Ruby bindings for Alibaba zvec vector database
 test_files: []