Skip to content

Blightmud/rs-complete

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

40 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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()));

About

A simple tab completion library written in rust

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages