- Notifications
You must be signed in to change notification settings - Fork15
Blazingly fast file search library built in Rust
License
ParthJadhav/Rust_Search
Folders and files
| Name | Name | Last commit message | Last commit date | |
|---|---|---|---|---|
Repository files navigation
Blazingly fast file search crate built in Rust 🔥
Please report any problems you encounter when using rust search here:Issues
Addrust_search = "2.0.0" in Cargo.toml.
[dependencies]rust_search ="2.0.0"
- General use
use rust_search::SearchBuilder;fnmain(){let search:Vec<String> =SearchBuilder::default().location("~/path/to/directory").search_input("what to search").more_locations(vec!["/anotherPath/to/search","/keepAddingIfYouWant/"]).limit(1000)// results to return.ext("extension").strict().depth(1).ignore_case().hidden().build().collect();for pathin search{println!("{}", path);}}
- Sort the output by similarity with the input
use rust_search::{SearchBuilder, similarity_sort};fnmain(){let search_input ="fly";letmut search:Vec<String> =SearchBuilder::default().location("~/Desktop/").search_input(search_input).depth(1).ignore_case().build().collect();similarity_sort(&mut search,&search_input);for pathin search{println!("{:?}", path);}}
searchwithout similarity sort
["afly.txt", "bfly.txt", "flyer.txt", "fly.txt"]
searchwith similarity sort
["fly.txt", "flyer.txt", "afly.txt", "bfly.txt",]
- To get all the files with a specific extension in a directory, use:
use rust_search::SearchBuilder;let files:Vec<String> =SearchBuilder::default().location("/path/to/directory").ext("file_extension").build().collect();
- To get all the files in a directory, use:
use rust_search::SearchBuilder;let files:Vec<String> =SearchBuilder::default().location("/path/to/directory").depth(1).build().collect();
To filter files by date_created, date_modified, file_size and/or custom_filter, use:
use rust_search::{FileSize,FilterExt,SearchBuilder};use std::time::{Duration,SystemTime};let search:Vec<String> =SearchBuilder::default().location("~/path/to/directory").file_size_greater(FileSize::Kilobyte(200.0)).file_size_smaller(FileSize::Megabyte(10.0)).created_after(SystemTime::now() -Duration::from_secs(3600*24*10)).created_before(SystemTime::now()).modified_after(SystemTime::now() -Duration::from_secs(3600*24*5)).custom_filter(|dir| dir.metadata().unwrap().is_file()).custom_filter(|dir| !dir.metadata().unwrap().permissions().readonly()).build().collect();
👉 For more examples, please refer to theDocumentation
The difference in sample size is due to the fact that fd and glob are different tools and have different use cases. fd is a command line tool that searches for files and directories. glob is a library that can be used to search for files and directories. The benchmark is done on a MacBook Air M2, 16 GB Unified memory.
Benchmarks are done usinghyperfine,Benchmarks files are available in thebenchmarks drive folder.
The benchmark was done on a directories containing 300K files.
| Command / Library | Mean [s] | Min [s] | Max [s] | Relative |
|---|---|---|---|---|
rust_search | 1.317 ± 0.002 | 1.314 | 1.320 | 1.00 |
glob | 22.728 ± 0.023 | 22.690 | 22.746 | 17.25 ± 0.03 |
The benchmark was done on a directories containing 45K files.
| Command / Library | Mean [ms] | Min [ms] | Max [ms] | Relative |
|---|---|---|---|---|
rust_search | 680.5 ± 2.1 | 678.3 | 683.6 | 1.00 |
fd -e .js | 738.7 ± 10.2 | 720.8 | 746.7 | 1.09 ± 0.02 |
+ rust_search is 17.25 times faster than Glob.+ rust_search** is 1.09 times faster than FD.
Any contributions would be greatly valued as this library is still in its early stages.
- Documentation
- Benchmarks
- Implementation guidelines
- Code Improvement
If you want to contribute to this project, please follow the steps below:
- Fork the project
- Clone the forked repository
- Create a feature branch
- Make changes to the code
- Commit the changes
- Push the changes to the forked repository
- Create a pull request
- Wait for the pull request to be reviewed and merged (if approved)
This project is licensed under the terms of the MIT license.
Click the button below to join the discord server or Linkedin
About
Blazingly fast file search library built in Rust