10 releases (stable)

1.3.1 Sep 19, 2022
1.3.0 Sep 21, 2021
1.2.1 Jul 20, 2021
1.1.1 Dec 18, 2020
0.1.1 Jun 9, 2020

#233 in GUI

Download history 127/week @ 2023-12-06 62/week @ 2023-12-13 52/week @ 2023-12-20 145/week @ 2023-12-27 100/week @ 2024-01-03 135/week @ 2024-01-10 166/week @ 2024-01-17 168/week @ 2024-01-24 38/week @ 2024-01-31 54/week @ 2024-02-07 217/week @ 2024-02-14 47/week @ 2024-02-21 178/week @ 2024-02-28 106/week @ 2024-03-06 82/week @ 2024-03-13 279/week @ 2024-03-20

653 downloads per month

MIT license

23KB
307 lines

Rust Clippy check Security audit Docs Coverage Status Crates.io

rs-complete

rs-completion is a library to use when you want to implement tab-completion (or similar) in your project.

rs-completion is mainly built for memory efficiency. Completions are stored in binary trees where each node holds a number of characters. The characters in turn link to new nodes. Similar words will thusly share memory.

Visual example

//                          'c' - 'a' - 'v' - 'e'
//                         /
//    root - 'b' - 'a' - 't' - 'm' - 'a' - 'n'
//                               \
//                                'o' - 'b' - 'i' - 'l' - 'e'

This means that a worst case scenario you could have 25^25 nodes in memory where 25 is the size of your alphabet. But this would mean that you are holding every thinkable combination of characters in memory with no regards for consonant or verb rules. If this is what you need then you don't need a library for it.

I can't argue if this solution is fast or efficient. It has worked to solve the problem I intended to solve when I created the library. If you have ideas for extensions or improvements I'm happy to see them.

Example

extern crate rs_completion;
use rs_completion::CompletionTree;

let mut completions = CompletionTree::default();

completions.insert("large bunch of words that bungalow we want to be bundesliga able to complete");
assert_eq!(
    completions.complete("bun"),
    Some(vec!["bunch", "bundesliga", "bungalow"].iter().map(|s| s.to_string()).collect()));

Dependencies

~125KB