file-format

Build Crates.io Docs Rust License

Crate for determining the file format of a given file or stream.

It provides a variety of functions for identifying a wide range of file formats, including ZIP, Compound File Binary (CFB), Extensible Markup Language (XML) and more.

It checks the signature of the file to determine its format. If it is not recognized by its signature, it returns the default file format which is Arbitrary Binary Data (BIN).

Examples

Determines from a file:

```rust use file_format::{FileFormat, Kind};

let format = FileFormat::fromfile("fixtures/application/sample.pdf")?; asserteq!(format, FileFormat::PortableDocumentFormat); asserteq!(format.name(), "Portable Document Format"); asserteq!(format.shortname(), "PDF"); asserteq!(format.mediatype(), "application/pdf"); asserteq!(format.extension(), "pdf"); assert_eq!(format.kind(), Kind::Application); ```

Determines from bytes:

```rust use file_format::{FileFormat, Kind};

let format = FileFormat::frombytes(&[0xFF, 0xD8, 0xFF]); asserteq!(format, FileFormat::JointPhotographicExpertsGroup); asserteq!(format.name(), "Joint Photographic Experts Group"); asserteq!(format.shortname(), "JPEG"); asserteq!(format.mediatype(), "image/jpeg"); asserteq!(format.extension(), "jpg"); assert_eq!(format.kind(), Kind::Image); ```

Usage

Add this to your Cargo.toml:

toml [dependencies] file-format = "0.16"

Supported file formats

License

This project is licensed under either of: