examples added.

Author: dapper91

Cargo.toml

@@ -4,7 +4,9 @@ version = "0.1.0"
 edition = "2021"
 
 [dependencies]
+bytesize = { version = "^1.1", optional = true }
 deepsize = { version = "^0.2", optional = true }
+env_logger = { version = "^0.9", optional = true}
 log = "0.4"
 rayon = "^1.5"
 rmp-serde = "^0.15"
@@ -17,3 +19,7 @@ rand = "^0.8"
 
 [features]
 memory-limit = ["deepsize"]
+
+[[example]]
+name = "quickstart"
+required-features = ["bytesize", "env_logger"]

examples/quickstart.rs

@@ -0,0 +1,30 @@
+use std::fs;
+use std::io::{self, prelude::*};
+use std::path;
+
+use bytesize::MB;
+use env_logger;
+use log;
+
+use ext_sort::buffer::mem::MemoryLimitedBufferBuilder;
+use ext_sort::{ExternalSorter, ExternalSorterBuilder};
+
+fn main() {
+    env_logger::Builder::new().filter_level(log::LevelFilter::Debug).init();
+
+    let input_reader = io::BufReader::new(fs::File::open("input.txt").unwrap());
+    let mut output_writer = io::BufWriter::new(fs::File::create("output.txt").unwrap());
+
+    let sorter: ExternalSorter<String, MemoryLimitedBufferBuilder> = ExternalSorterBuilder::new()
+        .with_tmp_dir(path::Path::new("tmp"))
+        .with_buffer(MemoryLimitedBufferBuilder::new(50 * MB))
+        .build()
+        .unwrap();
+
+    let sorted = sorter.sort(input_reader.lines()).unwrap();
+
+    for item in sorted.map(Result::unwrap) {
+        output_writer.write_all(format!("{}\n", item).as_bytes()).unwrap();
+    }
+    output_writer.flush().unwrap();
+}