adumbidiot / lz-str-rs

A port of lz-string to Rust

lz-str-rs

A port of lz-string to Rust.

Installing

Add the following to your Cargo.toml file:

[dependencies]
lz-str = "0.2.1"

Getting Started

// The demonstrated functions correspond with `LZString.compress` and `LZString.decompress` from the JS version.
fn main() {
    let data = "The quick brown fox jumps over the lazy dog";

    // Compress the data. This cannot fail.
    let compressed_data = lz_str::compress(data);

    // Decompress the data.
    // This may return `Option::None` if it fails.
    // Make sure to do error-checking in a real application to prevent crashes!
    let decompressed_data =
        lz_str::decompress(compressed_data).expect("`compressed_data` is invalid");

    // The decompressed_data should be the same as data, except encoded as UTF16.
    // We undo that here.
    // In a real application,
    // you will want to do error checking to prevent users from causing crashes with invalid data.
    let decompressed_data =
        String::from_utf16(&decompressed_data).expect("`decompressed_data` is not valid UTF16");

    assert!(data == decompressed_data);
}

See the examples directory for more examples.

Features

rustc-hash: This feature will replace some internal maps' hashers with rustc-hash, boosting performance at the cost of not using a DOS-resistant hasher.

Testing

cargo test

Benching

cargo bench

Bindings

• WebAssembly
• Python

Authors

adumbidiot (Nathaniel Daniel)

License

Licensed under either of

• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Contributing

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

lz-str-rs's Issues

Can we get a new release on crates.io?

Hi! We need the code in the master branch quite urgently, would you be so kind to release a new version on crates.io?

Thanks,
Johannes

Got arguments error with demo code and decompress with javascript lz-string

How do I handle the error ?

expect() will cause the whole service shut down (but I don't want that), how do I handle it like this:

fn main() {
    let f = File::open("hello.txt");
    match f {
        Ok(file) => {
            println!("File opened successfully.");
        },
        Err(err) => {
            println!("Failed to open the file.");
        }
    }
}

// or
if err {
   ....
}

decompress return Option not Result:

why is compress_uri returning an option

compress returns a String but compress_uri returns an Option, even though the code always resolves to a Some and there are no obvious None cases that might appear in the future

any reason behind using an Option?