usearch 0.18.8 → 0.19.1

package/c/usearch.h

@@ -1,14 +1,18 @@
 #ifndef UNUM_USEARCH_H
 #define UNUM_USEARCH_H
-
-#include <stdint.h> // `size_t`
+// in case the header is included from cpp code
+#ifdef __cplusplus
+extern "C" {
+#endif
+#include <stdbool.h> // `bool`
+#include <stdint.h>  // `size_t`
 
 typedef void* usearch_index_t;
 typedef uint32_t usearch_label_t;
 typedef float usearch_distance_t;
 typedef char const* usearch_error_t;
 
-typedef usearch_distance_t (*)(void const*, void const*) usearch_metric_t;
+typedef usearch_distance_t (*usearch_metric_t)(void const*, void const*);
 
 typedef enum usearch_metric_kind_t {
     usearch_metric_ip_k = 0,
@@ -39,13 +43,12 @@ typedef struct usearch_init_options_t {
 
     usearch_scalar_kind_t quantization;
     size_t dimensions;
-    size_t capacity;
     size_t connectivity;
     size_t expansion_add;
     size_t expansion_search;
 } usearch_init_options_t;
 
-void usearch_init(usearch_init_options_t*, usearch_index_t*, usearch_error_t*);
+usearch_index_t usearch_init(usearch_init_options_t*, usearch_error_t*);
 void usearch_free(usearch_index_t, usearch_error_t*);
 
 void usearch_save(usearch_index_t, char const* path, usearch_error_t*);
@@ -79,4 +82,7 @@ bool usearch_get(                     //
 
 void usearch_remove(usearch_index_t, usearch_label_t, usearch_error_t*);
 
+#ifdef __cplusplus
+}
+#endif
 #endif

package/conanfile.py

@@ -4,7 +4,7 @@ from conans import ConanFile
 class USearchConan(ConanFile):
 
     name = 'USearch'
-    version = '0.18.8'
+    version = '0.19.1'
     license = 'Apache 2.0'
     url = 'https://github.com/unum-cloud/usearch'
     description = 'Smaller & Faster Single-File Vector Search Engine from Unum'

package/cpp/bench.cpp

@@ -71,7 +71,7 @@ struct alignas(32) persisted_matrix_gt {
     persisted_matrix_gt(char const* path) noexcept(false) {
         if (!path || !std::strlen(path))
             throw std::invalid_argument("The file path is empty");
-#if defined(WINDOWS)
+#if defined(USEARCH_DEFINED_WINDOWS)
 
         HANDLE file_handle =
             CreateFileA(path, GENERIC_READ, FILE_SHARE_READ, nullptr, OPEN_EXISTING, FILE_ATTRIBUTE_NORMAL, nullptr);
@@ -117,7 +117,7 @@ struct alignas(32) persisted_matrix_gt {
 
     ~persisted_matrix_gt() {
         if (raw_handle != nullptr)
-#if defined(WINDOWS)
+#if defined(USEARCH_DEFINED_WINDOWS)
             UnmapViewOfFile(raw_handle);
 #else
             munmap((void*)raw_handle, raw_length);
@@ -377,7 +377,7 @@ void handler(int sig) {
     size_t size;
 
     // get void*'s for all entries on the stack
-#if defined(WINDOWS)
+#if defined(USEARCH_DEFINED_WINDOWS)
     size = CaptureStackBackTrace(0, 10, array, NULL);
 #else
     size = backtrace(array, 10);
@@ -386,7 +386,7 @@ void handler(int sig) {
     // print out all the frames to stderr
     fprintf(stderr, "Error: signal %d:\n", sig);
 
-#if defined(WINDOWS)
+#if defined(USEARCH_DEFINED_WINDOWS)
     SYMBOL_INFO* symbol = (SYMBOL_INFO*)calloc(sizeof(SYMBOL_INFO) + 256 * sizeof(char), 1);
     symbol->MaxNameLen = 255;
     symbol->SizeOfStruct = sizeof(SYMBOL_INFO);
@@ -483,7 +483,7 @@ void run_punned(dataset_at& dataset, args_t const& args, index_config_t config,
 
     index_at index = index_at::make(dataset.dimensions(), kind, config, accuracy);
     index.reserve(limits);
-    std::printf("-- Hardware acceleration: %s\n", isa_name(index.isa()));
+    std::printf("-- Hardware acceleration: %s\n", isa_name(index.metric().isa_));
     std::printf("Will benchmark in-memory\n");
 
     single_shot(dataset, index, true);
@@ -535,7 +535,7 @@ void run_big_or_small(dataset_at& dataset, args_t const& args, index_config_t co
 
 void report_alternative_setups() {
     using set_member_t = std::uint32_t;
-    using sets_index_t = index_gt<jaccard_gt<set_member_t>, std::size_t, std::uint32_t, set_member_t>;
+    using sets_index_t = index_gt<jaccard_gt<set_member_t>, std::size_t, std::uint32_t>;
     set_member_t set_a[] = {10, 12, 15};
     set_member_t set_b[] = {11, 12, 15, 16};
     sets_index_t index;

package/cpp/test.cpp

@@ -20,7 +20,8 @@ template <typename scalar_at, typename index_at> void test3d(index_at&& index) {
 
     using scalar_t = scalar_at;
     using view_t = span_gt<scalar_t const>;
-    using distance_t = typename index_at::distance_t;
+    using index_t = typename std::remove_reference<index_at>::type;
+    using distance_t = typename index_t::distance_t;
 
     scalar_t vec[3] = {10, 20, 15};
     scalar_t vec_a[3] = {15, 16, 17};
@@ -67,6 +68,7 @@ template <typename scalar_at, typename index_at> void test3d(index_at&& index) {
     expect(std::abs(matched_distances[0]) < 0.01);
 
     // Search again over mapped index
+    index_metadata("tmp.usearch");
     index.view("tmp.usearch");
     matched_count = index.search(view_t{&vec[0], 3ul}, 5).dump_to(matched_labels, matched_distances);
     expect(matched_count == 3);
@@ -144,11 +146,11 @@ int main(int, char**) {
     // static_assert(!std::is_same<index_gt<pearson_correlation_gt<>>::value_type, std::true_type>());
     // static_assert(!std::is_same<index_gt<haversine_gt<>>::value_type, std::true_type>());
 
-    test3d<float>(index_gt<cos_gt<float>, point_id_t, std::uint32_t, float>{});
-    test3d<float>(index_gt<l2sq_gt<float>, point_id_t, std::uint32_t, float>{});
+    test3d<float>(index_gt<cos_gt<float>, point_id_t, std::uint32_t>{});
+    test3d<float>(index_gt<l2sq_gt<float>, point_id_t, std::uint32_t>{});
 
-    test3d<double>(index_gt<cos_gt<double>, point_id_t, std::uint32_t, double>{});
-    test3d<double>(index_gt<l2sq_gt<double>, point_id_t, std::uint32_t, double>{});
+    test3d<double>(index_gt<cos_gt<double>, point_id_t, std::uint32_t>{});
+    test3d<double>(index_gt<l2sq_gt<double>, point_id_t, std::uint32_t>{});
 
     test3d<float>(punned_small_t::make(3, metric_kind_t::cos_k));
     test3d<float>(punned_small_t::make(3, metric_kind_t::l2sq_k));
@@ -159,11 +161,11 @@ int main(int, char**) {
     test3d_punned<float>(punned_small_t::make(3, metric_kind_t::cos_k));
     test3d_punned<float>(punned_small_t::make(3, metric_kind_t::l2sq_k));
 
-    test_sets(index_gt<jaccard_gt<std::int32_t, float>, point_id_t, std::uint32_t, std::int32_t>{});
-    test_sets(index_gt<jaccard_gt<std::int64_t, float>, point_id_t, std::uint32_t, std::int64_t>{});
+    test_sets(index_gt<jaccard_gt<std::int32_t, float>, point_id_t, std::uint32_t>{});
+    test_sets(index_gt<jaccard_gt<std::int64_t, float>, point_id_t, std::uint32_t>{});
 
-    test_sets_moved<index_gt<jaccard_gt<std::int32_t, float>, point_id_t, std::uint32_t, std::int32_t>>();
-    test_sets_moved<index_gt<jaccard_gt<std::int64_t, float>, point_id_t, std::uint32_t, std::int64_t>>();
+    test_sets_moved<index_gt<jaccard_gt<std::int32_t, float>, point_id_t, std::uint32_t>>();
+    test_sets_moved<index_gt<jaccard_gt<std::int64_t, float>, point_id_t, std::uint32_t>>();
 
     return 0;
 }

package/docs/compilation.md

@@ -173,6 +173,7 @@ go test -v
 
 ```sh
 swift build
+swift test -v
 ```
 
 ## C