E57 Rust Library

Build Status Crates.io Documentation No Unsafe License: MIT Dependencies

A pure Rust library for reading E57 files. No unsafe code, no bloaty dependencies.

The scope is for now limited to reading E57 files, but this might change in the future.

Check out the tools folder for some code examples that show how to use the library.

Please report incompatible files!

If you found an E57 file that works with other software but produces an error with this crate, please let me know and create an issue on Github. I want this library to work with as many files as possible.

Ideally, you can provide a link to the file itself. If that is not possible, please include the full error message and the name of the software that produced the file. If possible, please also include the XML section of the file.

Motivation

The E57 file format is well established for exchanging data produced by terrestrial lasers scanners. However, there are not many implementations that can read and write this file format. Most applications use the original C++ reference implementation (see http://www.libe57.org/) or the well maintained fork from Andy Maloney (see https://github.com/asmaloney/libE57Format).

I thought it would be nice to have a pure Rust solution without any unsafe code. In my oppinion Rust is an excellent choice for parsers of untrusted data, especially if you plan to use the code in something like a cloud backend.

When you want to handle E57 files inside a Rust project this crate will also avoid all the issues that come with integrating C++ code.

Code Coverage

The Visual Studio Code tasks included in this repository contain some tasks for code coverage measurement. To be able to run them, you need to install grcov with the command cargo install grcov and the LLVM tools by running rustup component add llvm-tools.