usearch 2.8.2 → 2.8.4

package/simsimd/package.json

@@ -1,14 +1,14 @@
 {
   "name": "simsimd",
-  "version": "3.3.0",
+  "version": "3.5.3",
   "description": "Vector Similarity Functions 3x-200x Faster than SciPy and NumPy",
   "author": "Ash Vardanian",
   "license": "Apache 2.0",
   "main": "javascript/simsimd.js",
   "type": "module",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/ashvardanian/simsimd.git"
+  "scripts": {
+    "test": "node --test ./javascript/test",
+    "bench": "node ./javascript/bench.js"
   },
   "gypfile": true,
   "engines": {
@@ -19,10 +19,6 @@
     "bindings": "~1.2.1",
     "node-addon-api": "^3.0.0"
   },
-  "scripts": {
-    "test": "node --test ./javascript/test.js",
-    "bench": "node ./javascript/bench.js"
-  },
   "devDependencies": {
     "benchmark": "^2.1.4",
     "mathjs": "^11.11.2",

package/simsimd/setup.py

@@ -27,6 +27,9 @@ if sys.platform == "linux":
     compile_args.append("-fopenmp")
     link_args.append("-lgomp")
 
+    # Add vectorized `logf` implementation from the `glibc`
+    link_args.append("-lm")
+
 if sys.platform == "darwin":
     compile_args.append("-std=c11")
     compile_args.append("-O3")

package/wasmer.toml

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

package/docs/compilation.md

@@ -1,215 +0,0 @@
-# Compiling USearch
-
-This document describes the workflow for advanced USearch users and enthusiasts willing to contribute to the project.
-Before building the first time, please pull submodules.
-
-```sh
-git submodule update --init --recursive
-```
-
-## C++11
-
-Linux:
-
-```sh
-sudo apt-get update
-sudo apt-get install cmake build-essential libjemalloc-dev
-cmake -B ./build_release \
-    -DCMAKE_BUILD_TYPE=Release \
-    -DUSEARCH_USE_OPENMP=1 \
-    -DUSEARCH_USE_SIMSIMD=1 \
-    -DUSEARCH_USE_JEMALLOC=1 \
-    -DUSEARCH_BUILD_TEST_CPP=1 \
-    -DUSEARCH_BUILD_BENCH_CPP=1 \
-    -DUSEARCH_BUILD_LIB_C=1 \
-    -DUSEARCH_BUILD_TEST_C=1 \
-    -DUSEARCH_USE_NATIVE_F16=1 \
-    && \
-    make -C ./build_release -j
-```
-
-MacOS:
-
-```sh
-brew install libomp llvm
-cmake -B ./build_release \
-    -DCMAKE_C_COMPILER="/opt/homebrew/opt/llvm/bin/clang" \
-    -DCMAKE_CXX_COMPILER="/opt/homebrew/opt/llvm/bin/clang++" \
-    -DUSEARCH_USE_OPENMP=1 \
-    -DUSEARCH_USE_SIMSIMD=1 \
-    -DUSEARCH_BUILD_BENCH_CPP=1 \
-    -DUSEARCH_BUILD_TEST_CPP=1 \
-    && \
-    make -C ./build_release -j
-```
-
-Linting:
-
-```sh
-cppcheck --enable=all --force --suppress=cstyleCast --suppress=unusedFunction \
-    include/usearch/index.hpp \
-    include/index_dense.hpp \
-    include/index_plugins.hpp
-```
-
-Testing:
-
-```sh
-cmake -DUSEARCH_BUILD_TEST_CPP=1 -B ./build_debug
-cmake --build ./build_debug --config Debug
-./build_debug/test_cpp
-```
-
-## Python 3
-
-Use PyTest to validate the build.
-The `-s` option will disable capturing the logs.
-The `-x` option will exit after first failure to simplify debugging.
-
-```sh
-pip install -e . && pytest python/scripts/ -s -x
-```
-
-Linting:
-
-```sh
-pip install ruff
-ruff --format=github --select=E9,F63,F7,F82 --target-version=py37 python
-```
-
-Testing wheel builds locally:
-
-```sh
-pip install cibuildwheel
-cibuildwheel --platform linux
-```
-
-## JavaScript
-
-Node.JS:
-
-```sh
-npm install && node --test ./javascript/usearch.test.js
-npm publish
-```
-
-WebAssembly:
-
-```sh
-emcmake cmake -B ./build -DCMAKE_CXX_FLAGS="${CMAKE_CXX_FLAGS} -s TOTAL_MEMORY=64MB" && emmake make -C ./build
-node ./build/usearch.test.js
-```
-
-If you don't yet have `emcmake` installed:
-
-```sh
-git clone https://github.com/emscripten-core/emsdk.git && ./emsdk/emsdk install latest && ./emsdk/emsdk activate latest && source ./emsdk/emsdk_env.sh
-```
-
-## Rust
-
-```sh
-cargo test -p usearch
-cargo publish
-```
-
-## Java
-
-```sh
-gradle clean build
-java -cp . -Djava.library.path="$(pwd)/build/libs/usearch/shared" java/cloud/unum/usearch/Index.java
-```
-
-Or step by-step:
-
-```sh
-cs java/unum/cloud/usearch
-javac -h . Index.java
-
-# Ubuntu:
-g++ -c -fPIC -I${JAVA_HOME}/include -I${JAVA_HOME}/include/linux cloud_unum_usearch_Index.cpp -o cloud_unum_usearch_Index.o
-g++ -shared -fPIC -o libusearch_c.so cloud_unum_usearch_Index.o -lc
-
-# Windows
-g++ -c -I%JAVA_HOME%\include -I%JAVA_HOME%\include\win32 cloud_unum_usearch_Index.cpp -o cloud_unum_usearch_Index.o
-g++ -shared -o USearchJNI.dll cloud_unum_usearch_Index.o -Wl,--add-stdcall-alias
-
-# MacOS
-g++ -std=c++11 -c -fPIC \
-    -I../../../../include \
-    -I../../../../fp16/include \
-    -I../../../../simsimd/include \
-    -I${JAVA_HOME}/include -I${JAVA_HOME}/include/darwin cloud_unum_usearch_Index.cpp -o cloud_unum_usearch_Index.o
-g++ -dynamiclib -o libusearch.dylib cloud_unum_usearch_Index.o -lc
-# Run linking to that directory
-java -cp . -Djava.library.path="$(pwd)/java/cloud/unum/usearch/" Index.java
-java -cp . -Djava.library.path="$(pwd)/java" cloud.unum.usearch.Index
-```
-
-## Objective-C and Swift
-
-```sh
-swift build
-swift test -v
-```
-
-## C 99
-
-There are a few ways to compile the C 99 USearch SDK.
-Using the Makefile, specifying the targets you need:
-
-```sh
-cmake -B ./build_release -DUSEARCH_BUILD_LIB_C=1 -DUSEARCH_BUILD_TEST_C=1 -DUSEARCH_USE_OPENMP=1 -DUSEARCH_USE_SIMSIMD=1 
-cmake --build ./build_release --config Release -j
-./build_release/test_c
-# On Windows:
-.\build_release\test_c.exe
-```
-
-## GoLang
-
-GoLang bindings are based on C.
-So one should first compile the C library, link it with GoLang, and only then run tests.
-
-```sh
-cmake -B ./build_release -DUSEARCH_BUILD_LIB_C=1 -DUSEARCH_BUILD_TEST_C=1 -DUSEARCH_USE_OPENMP=1 -DUSEARCH_USE_SIMSIMD=1 
-cmake --build ./build_release --config Release -j
-mv ./c/libusearch_c.so ./golang/
-cp ./c/usearch.h ./golang/
-cd golang && go test -v ; cd ..
-```
-
-## Wolfram
-
-```sh
-brew install --cask wolfram-engine
-```
-
-## Docker
-
-```sh
-docker build -t unum/usearch . && docker run unum/usearch
-```
-
-For multi-architecture builds and publications:
-
-```sh
-version=$(cat VERSION)
-docker buildx create --use &&
-    docker login &&
-    docker buildx build \
-        --platform "linux/amd64,linux/arm64" \
-        --build-arg version=$version \
-        --file Dockerfile \
-        --tag unum/usearch:$version \
-        --tag unum/usearch:latest \
-        --push .
-```
-
-## Sub-Modules
-
-Extending metrics in SimSIMD:
-
-```sh
-git push --set-upstream https://github.com/ashvardanian/simsimd.git HEAD:main
-```

package/simsimd/.clang-format

@@ -1,10 +0,0 @@
-Language: Cpp
-BasedOnStyle:  LLVM
-IndentWidth: 4
-TabWidth: 4
-NamespaceIndentation: None
-ColumnLimit: 120
-ReflowComments: true
-UseTab: Never
-PointerAlignment: Left
-AllowShortCaseLabelsOnASingleLine: true

package/simsimd/.github/workflows/prerelease.yml

@@ -1,89 +0,0 @@
-name: Pre-Release
-
-on:
-  push:
-    branches: ["main-dev"]
-  pull_request:
-    branches: ["main-dev"]
-
-env:
-  BUILD_TYPE: Release
-  GH_TOKEN: ${{ secrets.SEMANTIC_RELEASE_TOKEN }}
-  PYTHONUTF8: 1
-
-# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
-permissions:
-  contents: read
-
-jobs:
-  test_python:
-    name: Test Python ${{ matrix.python-version }} on ${{ matrix.architecture }} ${{ matrix.os }}
-    runs-on: ${{ matrix.os }}
-    strategy:
-      fail-fast: false
-      matrix:
-        os: [ubuntu-22.04, macOS-11, windows-2022]
-        python-version: ["3.12", "3.8"]
-        architecture: [x64, arm64]
-
-    steps:
-      - uses: actions/checkout@v3
-      - run: git submodule update --init --recursive
-      - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v4
-        with:
-          python-version: ${{ matrix.python-version }}
-
-      - name: Install dependencies
-        run: |
-          python -m pip install --no-cache-dir --upgrade pip
-          pip install --no-cache-dir pytest numpy scipy py-cpuinfo pytest-repeat
-          python -c "from cpuinfo import get_cpu_info; print(get_cpu_info())"
-
-      - name: Build locally on Ubuntu
-        run: |
-          sudo apt-get update
-          sudo apt-get install gcc-12 -y
-          sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-12 12
-          sudo update-alternatives --config gcc
-          gcc --version
-          python -m pip install .
-        if: ${{ matrix.os == 'ubuntu-22.04' }}
-
-      - name: Build locally on other OS
-        run: python -m pip install .
-        if: ${{ matrix.os != 'ubuntu-22.04' }}
-
-      - name: Test with PyTest
-        run: |
-          python -c "import simsimd; print(simsimd.get_capabilities())"
-          pytest python/test.py -s -x -v
-
-  test_javascript:
-    name: Test JavaScript
-    runs-on: ubuntu-22.04
-    env:
-      CC: gcc-12
-      CXX: g++-12
-
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          ref: "main"
-      - run: git submodule update --init --recursive
-
-      - name: Update compilers
-        run: |
-          sudo apt update
-          sudo apt install -y cmake build-essential libjemalloc-dev libomp-dev gcc-12 g++-12
-
-      - name: Set up Node.js
-        uses: actions/setup-node@v3
-        with:
-          node-version: 18
-
-      - name: Build and Test
-        run: |
-          npm install
-          npm ci
-          npm test

package/simsimd/.github/workflows/release.yml

@@ -1,141 +0,0 @@
-name: Release
-
-on:
-  push:
-    branches: ["main"]
-
-env:
-  BUILD_TYPE: Release
-  GH_TOKEN: ${{ secrets.SEMANTIC_RELEASE_TOKEN }}
-  PYTHONUTF8: 1
-
-# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
-permissions:
-  contents: write
-  pages: write
-  id-token: write
-
-jobs:
-  versioning:
-    name: Semantic Release
-    runs-on: ubuntu-22.04
-    steps:
-      - uses: actions/checkout@v3
-        with:
-          persist-credentials: false
-      - uses: actions/setup-node@v3
-      - run: npm install --save-dev --prefix ./package-ci @semantic-release/exec @semantic-release/git conventional-changelog-eslint semantic-release && npx --prefix ./package-ci semantic-release
-
-  rebase:
-    name: Rebase Dev. Branch
-    needs: versioning
-    runs-on: ubuntu-22.04
-    steps:
-      - name: Checkout the latest code
-        uses: actions/checkout@v3
-        with:
-          fetch-depth: 0
-
-      - name: Perform rebase
-        run: |
-          git fetch origin main
-          git checkout main-dev
-          git rebase origin/main
-
-      - name: Push changes
-        uses: CasperWA/push-protected@v2
-        with:
-          token: ${{ secrets.SEMANTIC_REBASE_TOKEN }}
-          branch: main-dev
-          unprotect_reviews: True
-          force: True
-
-  build_wheels:
-    name: Build Wheels for ${{ matrix.os }}
-    runs-on: ${{ matrix.os }}
-    needs: versioning
-    strategy:
-      fail-fast: false
-      matrix:
-        os: [ubuntu-22.04, macOS-11, windows-2022]
-    steps:
-      - uses: actions/checkout@v3
-        with:
-          ref: "main"
-      - uses: actions/setup-python@v3
-
-      - name: Setup Docker
-        if: matrix.os == 'ubuntu-22.04'
-        uses: docker-practice/actions-setup-docker@master
-
-      - name: Setup QEMU
-        if: matrix.os == 'ubuntu-22.04'
-        uses: docker/setup-qemu-action@v2.1.0
-
-      - name: Install CIBuildWheel
-        run: python -m pip install --no-cache-dir cibuildwheel
-
-      - name: Build wheels
-        run: python -m cibuildwheel
-
-      - uses: actions/upload-artifact@v3
-        with:
-          path: ./wheelhouse/*.whl
-
-  publish_python:
-    name: Publish Python
-    needs: build_wheels
-    runs-on: ubuntu-22.04
-    environment:
-      name: pypi
-      url: https://pypi.org/p/simsimd
-    permissions:
-      id-token: write
-
-    steps:
-      - name: Download artifacts
-        uses: actions/download-artifact@v3.0.2
-        with:
-          path: ./dist/
-
-      - name: Publish to PyPi
-        uses: pypa/gh-action-pypi-publish@release/v1
-        with:
-          packages-dir: ./dist/artifact
-          verbose: true
-          print-hash: true
-
-  publish_javascript:
-    name: Publish JavaScript
-    needs: versioning
-    runs-on: ubuntu-22.04
-    env:
-      CC: gcc-12
-      CXX: g++-12
-
-    steps:
-      - uses: actions/checkout@v3
-        with:
-          ref: "main"
-      - run: git submodule update --init --recursive
-
-      - name: Update compilers
-        run: |
-          sudo apt update
-          sudo apt install -y cmake build-essential libjemalloc-dev libomp-dev gcc-12 g++-12
-
-      - name: Set up Node.js
-        uses: actions/setup-node@v3
-        with:
-          node-version: 18
-
-      - name: Build and Test
-        run: |
-          npm install
-          npm ci
-          npm test
-
-      - name: Publish
-        uses: JS-DevTools/npm-publish@v2
-        with:
-          token: ${{ secrets.NPM_TOKEN }}

package/simsimd/.github/workflows/update_version.sh

@@ -1,5 +0,0 @@
-#!/bin/sh
-
-echo $1 > VERSION && \
-    sed -i "s/\"version\": \".*\"/\"version\": \"$1\"/" package.json && \
-    sed -i "s/\"__version__\", \".*\"/\"__version__\", \"$1\"/" python/lib.c

package/simsimd/.vscode/launch.json

@@ -1,53 +0,0 @@
-{
-    // Use IntelliSense to learn about possible attributes.
-    // Hover to view descriptions of existing attributes.
-    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
-    "version": "0.2.0",
-    "configurations": [
-        {
-            "name": "Debug Benchmark",
-            "type": "cppdbg",
-            "request": "launch",
-            "program": "${workspaceFolder}/build_debug/simsimd_bench",
-            "cwd": "${workspaceFolder}",
-            "args": [
-                "--benchmark_filter=i8_cos"
-            ],
-            "environment": [
-                {
-                    "name": "ASAN_OPTIONS",
-                    "value": "detect_leaks=0:atexit=1:strict_init_order=1:strict_string_checks=1"
-                }
-            ],
-            "stopAtEntry": false,
-            "preLaunchTask": "Build Benchmark: Debug",
-            "linux": {
-                "MIMode": "gdb",
-            },
-            "osx": {
-                "MIMode": "lldb"
-            }
-        },
-        {
-            "name": "Debug Test",
-            "type": "cppdbg",
-            "request": "launch",
-            "program": "${workspaceFolder}/build/test",
-            "cwd": "${workspaceFolder}",
-            "environment": [
-                {
-                    "name": "ASAN_OPTIONS",
-                    "value": "detect_leaks=0:atexit=1:strict_init_order=1:strict_string_checks=1"
-                }
-            ],
-            "stopAtEntry": false,
-            "preLaunchTask": "Build Test: Debug",
-            "linux": {
-                "MIMode": "gdb"
-            },
-            "osx": {
-                "MIMode": "lldb"
-            }
-        }
-    ]
-}

package/simsimd/.vscode/settings.json

@@ -1,114 +0,0 @@
-{
-    "files.associations": {
-        "array": "cpp",
-        "string_view": "cpp",
-        "random": "cpp",
-        "atomic": "cpp",
-        "bit": "cpp",
-        "*.tcc": "cpp",
-        "bitset": "cpp",
-        "cctype": "cpp",
-        "chrono": "cpp",
-        "cinttypes": "cpp",
-        "clocale": "cpp",
-        "cmath": "cpp",
-        "codecvt": "cpp",
-        "compare": "cpp",
-        "concepts": "cpp",
-        "condition_variable": "cpp",
-        "cstdarg": "cpp",
-        "cstddef": "cpp",
-        "cstdint": "cpp",
-        "cstdio": "cpp",
-        "cstdlib": "cpp",
-        "cstring": "cpp",
-        "ctime": "cpp",
-        "cwchar": "cpp",
-        "cwctype": "cpp",
-        "deque": "cpp",
-        "list": "cpp",
-        "map": "cpp",
-        "set": "cpp",
-        "string": "cpp",
-        "unordered_map": "cpp",
-        "vector": "cpp",
-        "exception": "cpp",
-        "algorithm": "cpp",
-        "functional": "cpp",
-        "iterator": "cpp",
-        "memory": "cpp",
-        "memory_resource": "cpp",
-        "numeric": "cpp",
-        "ratio": "cpp",
-        "regex": "cpp",
-        "system_error": "cpp",
-        "tuple": "cpp",
-        "type_traits": "cpp",
-        "utility": "cpp",
-        "fstream": "cpp",
-        "initializer_list": "cpp",
-        "iomanip": "cpp",
-        "iosfwd": "cpp",
-        "iostream": "cpp",
-        "istream": "cpp",
-        "limits": "cpp",
-        "mutex": "cpp",
-        "new": "cpp",
-        "numbers": "cpp",
-        "ostream": "cpp",
-        "semaphore": "cpp",
-        "sstream": "cpp",
-        "stdexcept": "cpp",
-        "stop_token": "cpp",
-        "streambuf": "cpp",
-        "thread": "cpp",
-        "typeinfo": "cpp",
-        "complex": "cpp",
-        "immintrin.h": "c",
-        "__bit_reference": "cpp",
-        "__bits": "cpp",
-        "__config": "cpp",
-        "__debug": "cpp",
-        "__errc": "cpp",
-        "__hash_table": "cpp",
-        "__locale": "cpp",
-        "__mutex_base": "cpp",
-        "__node_handle": "cpp",
-        "__split_buffer": "cpp",
-        "__threading_support": "cpp",
-        "__tuple": "cpp",
-        "__verbose_abort": "cpp",
-        "charconv": "cpp",
-        "ios": "cpp",
-        "locale": "cpp",
-        "optional": "cpp",
-        "variant": "cpp",
-        "__nullptr": "cpp",
-        "unordered_set": "cpp",
-        "span": "cpp",
-        "arm_neon.h": "c",
-        "__tree": "cpp",
-        "filesystem": "cpp"
-    },
-    "cSpell.words": [
-        "castsi",
-        "dtype",
-        "dtypes",
-        "jaccard",
-        "kann",
-        "Kullback",
-        "Leibler",
-        "loadu",
-        "maccs",
-        "maskz",
-        "napi",
-        "simd",
-        "simsimd",
-        "sqeuclidean",
-        "tanimoto",
-        "typedarray",
-        "unsw",
-        "Vardanian",
-        "vpopcntdq"
-    ]
-}