Java Properties for Rust

This is a library for reading and writing Java properties in Rust.

• support UTF-8 and ISO 8859-1 encoding, including mixed (for reading).
• without any dependence, which also means no other encoding support, simple but enough.
• 100% compatible with java.
• almost 100% unit testing (not covered for some error code).
• support fuzz testing

Examples

use properties::Properties;

fn main() {
    let buff = "hello=\\u4f60\\u597d\\u00a9\\ud83c\\udf10\nhey=你好🌐\n".as_bytes();

    let mut prop = Properties::new();
    match prop.load(buff) {
        Ok(_) => {
            println!("hello={}", prop.get("hello").unwrap());
            println!("hey={}", prop.get("hey").unwrap());
        }
        Err(e) => println!("Load properties failed, {}", e),
    }
}

And more examples under examples directory, you could simply run with cargo run --example store command.

Encoding/Decoding

Java has different implements for OutputStream and Writer, which could test from the following code.

import java.io.FileWriter;
import java.io.IOException;
import java.util.Properties;

public class Example {
    public static void main(String[] args) throws IOException {
        Properties p = new Properties();
        p.setProperty("hello", "你好🌐");

        // OutputStream(ISO 8859-1 encoding), hello=\u4F60\u597D\uD83C\uDF10
        p.store(System.out, null);

        // Writer(UTF-8 encoding), hello=你好🌐
        FileWriter w = new FileWriter("/tmp/test.properties");
        p.store(w, null);
        w.close();
    }
}

For OutputStream, the properties is encoded in ISO 8859-1 character encoding. Characters that cannot be directly represented in this encoding can be written using Unicode escapes.

And for Writer, it's determined by the file encoding or -Dfile.encoding=xxx argument when start your program. In most case, it will be UTF-8.

So, in this library, support UTF-8 which is the encoding for Rust. And also support ISO 8859-1 with the escape_unicode option.

License

Apache 2.0 @ GoHalo