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, CFB, XML and more.

It checks the signature of the file to determine its format. If the file format is not recognized by its signature, it checks if it is Plain Text. Otherwise, it returns the default file format which is Arbitrary Binary Data.

Examples

Determines from a file:

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

let format = FileFormat::fromfile("fixtures/application/sample.zip").unwrap(); asserteq!(format, FileFormat::Zip); asserteq!(format.name(), "ZIP"); asserteq!(format.mediatype(), "application/zip"); asserteq!(format.extension(), "zip"); assert_eq!(format.kind(), Kind::Application); ```

Determines from bytes:

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

let format = FileFormat::frombytes(&[0xFF, 0xD8, 0xFF, 0xEE]); asserteq!(format, FileFormat::JointPhotographicExpertsGroup); asserteq!(format.name(), "Joint Photographic Experts Group"); 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.12"

Features

All these features are disabled by default.

Supported formats

License

This project is licensed under either of: