usearch 2.7.0 → 2.7.1

package/.github/workflows/Dockerfile.libs

@@ -7,7 +7,7 @@ ARG docker_ip
 ARG user_pass
 
 RUN apt-get update && \
-    apt-get install -y --no-install-recommends cmake g++-12 build-essential libjemalloc-dev golang openssh-client sshpass && \
+    apt-get install -y --no-install-recommends cmake g++-12 libc++-dev build-essential libjemalloc-dev golang openssh-client sshpass && \
     apt-get clean && \
     rm -rf /var/lib/apt/lists/*
 

package/.github/workflows/release.yml

@@ -95,7 +95,7 @@ jobs:
         --build-arg docker_ip=${{ steps.dockerip.outputs.docker_ip }} \
         --build-arg user_pass=${{ steps.userpass.outputs.user_pass }} \
         --file .github/workflows/Dockerfile.libs \
-        --tag unum/ustore-deps:latest \
+        --tag unum/usearch-library:latest \
         --load .
     - name: Clear Docker buildx cache
       run: docker buildx prune --all --force

package/CITATION.cff

@@ -5,7 +5,7 @@ authors:
   given-names: "Ash"
   orcid: "https://orcid.org/0000-0002-4882-1815"
 title: "USearch by Unum Cloud"
-version: 2.7.0
+version: 2.7.1
 doi: 10.5281/zenodo.7949416
 date-released: 2022-06-12
 url: "https://github.com/unum-cloud/usearch"

package/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "usearch"
-version = "2.7.0"
+version = "2.7.1"
 authors = ["Ash Vardanian <1983160+ashvardanian@users.noreply.github.com>"]
 description = "Smaller & Faster Single-File Vector Search Engine from Unum"
 edition = "2021"

package/README.md

@@ -392,7 +392,7 @@ doi = {10.5281/zenodo.7949416},
 author = {Vardanian, Ash},
 title = {{USearch by Unum Cloud}},
 url = {https://github.com/unum-cloud/usearch},
-version = {2.7.0},
+version = {2.7.1},
 year = {2022},
 month = jun,
 }

package/conanfile.py

@@ -7,7 +7,7 @@ required_conan_version = ">=1.53.0"
 class USearchConan(ConanFile):
 
     name = "usearch"
-    version = '2.7.0'
+    version = '2.7.1'
     license = "Apache-2.0"
     description = "Smaller & Faster Single-File Vector Search Engine from Unum"
     homepage = "https://github.com/unum-cloud/usearch"

package/csharp/nuget/nuget-package.props

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <Project>
   <PropertyGroup>
-    <Version Condition="'$(Version)' == ''">2.7.0</Version>
+    <Version Condition="'$(Version)' == ''">2.7.1</Version>
 
     <Authors>Unum</Authors>
     <Company>Unum</Company>

package/include/usearch/index.hpp

@@ -11,7 +11,7 @@
 
 #define USEARCH_VERSION_MAJOR 2
 #define USEARCH_VERSION_MINOR 7
-#define USEARCH_VERSION_PATCH 0
+#define USEARCH_VERSION_PATCH 1
 
 // Inferring C++ version
 // https://stackoverflow.com/a/61552074

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "usearch",
-    "version": "2.7.0",
+    "version": "2.7.1",
     "description": "Smaller & Faster Single-File Vector Search Engine from Unum",
     "author": "Ash Vardanian (https://ashvardanian.com/)",
     "license": "Apache 2.0",

package/python/lib.cpp

@@ -373,8 +373,8 @@ static void search_typed(                                       //
                     atomic_error.store("Operation has been terminated");
                     return false;
                 }
-            return true;
         }
+        return true;
     });
 
     // At the end report the latest numbers, because the reporter thread may be finished earlier

package/python/scripts/test_tooling.py

@@ -118,5 +118,16 @@ def test_multi_index():
     index_b.add(43, vectors[1])
 
     indexes = Indexes([index_a, index_b])
+
+    # Search top 10 for 1
     matches = indexes.search(vectors[2], 10)
     assert len(matches) == 2
+
+    # Search top 1 for 1
+    matches = indexes.search(vectors[2], 1)
+    assert len(matches) == 1
+
+    # Search top 10 for 3
+    matches = indexes.search(vectors, 10)
+    assert len(matches) == 3
+    assert len(matches[0].keys) == 2

package/rust/lib.cpp

@@ -42,6 +42,11 @@ size_t NativeIndex::get_f32(key_t key, rust::Slice<float> vec) const { if (vec.s
 size_t NativeIndex::get_f64(key_t key, rust::Slice<double> vec) const { if (vec.size() % dimensions()) throw std::invalid_argument("Vector length must be a multiple of index dimensionality"); return index_->get(key, vec.data(), vec.size() / dimensions()); }
 // clang-format on
 
+size_t NativeIndex::expansion_add() const { return index_->expansion_add(); }
+size_t NativeIndex::expansion_search() const { return index_->expansion_search(); }
+void NativeIndex::change_expansion_add(size_t n) const { index_->change_expansion_add(n); }
+void NativeIndex::change_expansion_search(size_t n) const { index_->change_expansion_search(n); }
+
 size_t NativeIndex::remove(key_t key) const {
     labeling_result_t result = index_->remove(key);
     result.error.raise();

package/rust/lib.hpp

@@ -36,6 +36,11 @@ class NativeIndex {
     size_t get_f32(key_t key, rust::Slice<float> vector) const;
     size_t get_f64(key_t key, rust::Slice<double> vector) const;
 
+    size_t expansion_add() const;
+    size_t expansion_search() const;
+    void change_expansion_add(size_t n) const;
+    void change_expansion_search(size_t n) const;
+
     size_t count(key_t key) const;
     size_t remove(key_t key) const;
     size_t rename(key_t from, key_t to) const;

package/rust/lib.rs

@@ -46,6 +46,11 @@ pub mod ffi {
         /// Low-level C++ interface that is further wrapped into the high-level `Index`
         type NativeIndex;
 
+        pub fn expansion_add(self: &NativeIndex) -> usize;
+        pub fn expansion_search(self: &NativeIndex) -> usize;
+        pub fn change_expansion_add(self: &NativeIndex, n: usize) -> Result<()>;
+        pub fn change_expansion_search(self: &NativeIndex, n: usize) -> Result<()>;
+
         pub fn new_native_index(options: &IndexOptions) -> Result<UniquePtr<NativeIndex>>;
         pub fn reserve(self: &NativeIndex, capacity: usize) -> Result<()>;
         pub fn dimensions(self: &NativeIndex) -> usize;
@@ -176,6 +181,26 @@ impl Index {
         }
     }
 
+    /// Retrieves the expansion value used during index creation.
+    pub fn expansion_add(self: &Index) -> usize {
+        self.inner.expansion_add()
+    }
+
+    /// Retrieves the expansion value used during search.
+    pub fn expansion_search(self: &Index) -> usize {
+        self.inner.expansion_search()
+    }
+
+    /// Updates the expansion value used during index creation. Rarely used.
+    pub fn change_expansion_add(self: &Index, n: usize) -> Result<(), cxx::Exception> {
+        self.inner.change_expansion_add(n)
+    }
+
+    /// Updates the expansion value used during search operations.
+    pub fn change_expansion_search(self: &Index, n: usize) -> Result<(), cxx::Exception> {
+        self.inner.change_expansion_search(n)
+    }
+
     /// Performs k-Approximate Nearest Neighbors (kANN) Search for closest vectors to the provided query.
     ///
     /// # Arguments
@@ -204,10 +229,10 @@ impl Index {
         T::add(self, key, vector)
     }
 
-    /// Extracts one or more vectors matching specified key.
-    /// The `vector` slice must be a multiple number of dimensions in the index.
-    /// After the execution return the number `X` of vectors found.
-    /// The first `X * dimensions` elements of the vector slice will be filled.
+    /// Extracts one or more vectors matching the specified key.
+    /// The `vector` slice must be a multiple of the number of dimensions in the index.
+    /// After the execution, return the number `X` of vectors found.
+    /// The vector slice's first `X * dimensions` elements will be filled.
     ///
     /// If you are a novice user, consider `export`.
     ///
@@ -224,7 +249,7 @@ impl Index {
     }
 
     /// Extracts one or more vectors matching specified key into supplied resizable vector.
-    /// The `vector` is resized to a multiple number of dimensions in the index.
+    /// The `vector` is resized to a multiple of the number of dimensions in the index.
     ///
     /// # Arguments
     ///
@@ -448,6 +473,9 @@ mod tests {
 
         let index = Index::new(&options).unwrap();
 
+        assert!(index.expansion_add() > 0);
+        assert!(index.expansion_search() > 0);
+
         assert!(index.reserve(10).is_ok());
         assert!(index.capacity() >= 10);
         assert!(index.connectivity() != 0);
@@ -464,7 +492,11 @@ mod tests {
             index.memory_usage(),
             index.capacity(),
         );
+        assert!(index.change_expansion_add(10).is_ok());
+        assert_eq!(index.expansion_add(), 10);
         assert!(index.add(42, &first).is_ok());
+        assert!(index.change_expansion_add(12).is_ok());
+        assert_eq!(index.expansion_add(), 12);
         assert!(index.add(43, &second).is_ok());
         assert_eq!(index.size(), 2);
         println!(
@@ -475,11 +507,19 @@ mod tests {
             index.capacity(),
         );
 
+        assert!(index.change_expansion_search(10).is_ok());
+        assert_eq!(index.expansion_search(), 10);
         // Read back the tags
         let results = index.search(&first, 10).unwrap();
         println!("{:?}", results);
         assert_eq!(results.keys.len(), 2);
 
+        assert!(index.change_expansion_search(12).is_ok());
+        assert_eq!(index.expansion_search(), 12);
+        let results = index.search(&first, 10).unwrap();
+        println!("{:?}", results);
+        assert_eq!(results.keys.len(), 2);
+
         // Validate serialization
         assert!(index.save("index.rust.usearch").is_ok());
         assert!(index.load("index.rust.usearch").is_ok());

package/wasmer.toml

@@ -1,6 +1,6 @@
 [package]
 name="unum/usearch"
-version="2.7.0"
+version="2.7.1"
 description="Smaller & Faster Single-File Vector Search Engine from Unum"
 license="Apache-2.0"
 readme="README.md"