rust-autocomplete-api

fastest* autocomplete API written in rust 🦀

_{_*probably}

Run it locally

cargo build --release
./target/release/autocomplete-api-poc

Run it in Docker

docker build -f Dockerfile . -t rust-autocomplete:latest
docker run -d -p 0.0.0.0:3030:3030 --name rust-autocomplete-api rust-autocomplete

Curl example:

curl  --location --request POST 'localhost:3030/autocomplete/v1' \
--header 'Content-Type: application/json' \
--header 'Content-Type: text/plain' \
--data-raw '{
    "term": "sug"
}'

>>["sugar", "sugarfree", "suggest", "suggested", "suggests", "suggestions", "suggestion", "sugars", "sugared", "sugary"]

How does it work?

You can read about HashMap-based autocomplete implementation here, where I've made terminal version of the same autocomplete as a proof of concept.

Performance:

I used hey to measure response time:

Summary:
  Total:	0.9591 secs
  Slowest:	0.0960 secs
  Fastest:	0.0018 secs
  Average:	0.0185 secs
  Requests/sec:	10426.6399

More details

command:

hey -n 10000 -c 200 http://0.0.0.0:3030/autocomplete/v1 -H "Content-Type: application/json" -X POST -d '{"term":"ap"}'

output:

Summary:
  Total:	0.9591 secs
  Slowest:	0.0960 secs
  Fastest:	0.0018 secs
  Average:	0.0185 secs
  Requests/sec:	10426.6399

  Total data:	230000 bytes
  Size/request:	23 bytes

Response time histogram:
  0.002 [1]	|
  0.011 [2222]	|■■■■■■■■■■■■■■■■■■■
  0.021 [4684]	|■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■■
  0.030 [2032]	|■■■■■■■■■■■■■■■■■
  0.039 [717]	|■■■■■■
  0.049 [169]	|■
  0.058 [26]	|
  0.068 [43]	|
  0.077 [74]	|■
  0.087 [25]	|
  0.096 [7]	|


Latency distribution:
  10% in 0.0085 secs
  25% in 0.0119 secs
  50% in 0.0163 secs
  75% in 0.0222 secs
  90% in 0.0306 secs
  95% in 0.0360 secs
  99% in 0.0705 secs

Details (average, fastest, slowest):
  DNS+dialup:	0.0001 secs, 0.0018 secs, 0.0960 secs
  DNS-lookup:	0.0000 secs, 0.0000 secs, 0.0000 secs
  req write:	0.0001 secs, 0.0000 secs, 0.0149 secs
  resp wait:	0.0180 secs, 0.0018 secs, 0.0763 secs
  resp read:	0.0001 secs, 0.0000 secs, 0.0126 secs

Status code distribution:
  [405]	10000 responses

Also:

Take a look at the same api but in scala + comparison with WFST

Rust HTTP API Template using PostgreSQL, Redis, RabbitMQ, and Hexagonal Architecture

Rust Template HTTP API Rust API Template using PostgreSQL, Redis, RabbitMQ, and Hexagonal Architecture The following template provides a basic structu

7 Jun 9, 2023

This is a simple Api template for Rust ( Axum framework )

Axum-Rust-Rest-Api-Template This project is an open source Rest Api Template built with Rust's Axum framework. Why this project? I have been learning

20 Jun 16, 2023

An API project using Rust, Actix Web and JWT. WIP

Actix-web REST API with JWT (WIP) A simple CRUD backend app using Actix-web, Diesel and JWT Require Rust Stable Postgres Or using Docker How to run Ma

4 Sep 21, 2023

Rust Open Source Login/Register API

Actix Web API with Rustls (OpenSSL available/Without SSL/TLS too) This API uses Actix Web to serve secure HTTP endpoints, utilizing Rustls for TLS enc

4 Sep 27, 2023

Grape is a REST-like API framework for Ruby

Grape is a REST-like API framework for Ruby. It's designed to run on Rack or complement existing web application frameworks such as Rails and Sinatra by providing a simple DSL to easily develop RESTful APIs. It has built-in support for common conventions, including multiple formats, subdomain/prefix restriction, content negotiation, versioning and much more.