file-format

Build Crates.io Docs Rust License

Crate for determining binary-based file formats.

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.9"

Features

All these features are disabled by default.

Supported formats

Compound File Binary: - Microsoft Excel Spreadsheet - xls - Microsoft PowerPoint Presentation - ppt - Microsoft Project Plan - mpp - Microsoft Publisher Document - pub - Microsoft Software Installer - msi - Microsoft Visio Drawing - vsd - Microsoft Word Document - doc

ZIP: - 3D Manufacturing Format - 3mf - Android Package - apk - Circuit Diagram Document - cddx - Design Web Format XPS - dwfx - Electronic Publication - epub - Enterprise Application Archive - ear - Java Archive - jar - Keyhole Markup Language Zipped - kmz - Microsoft Visual Studio Extension - vsix - Office Open XML Document - docx - Office Open XML Drawing - vsdx - Office Open XML Presentation - pptx - Office Open XML Spreadsheet - xlsx - OpenDocument Graphics - odg - OpenDocument Presentation - odp - OpenDocument Spreadsheet - ods - OpenDocument Text - odt - Web Application Archive - war - Windows App Package - appx - XAP - xap - XPInstall - xpi - iOS App Store Package - ipa

License

This project is licensed under either of Apache License, Version 2.0 or MIT license at your option.