Filess
Simplify file management with file primitives.
Use filess as you would use String or Vec.
Each file format is now a separate type, if your function needs json, you can put filess::Json as file type, enforcing the proper path.
Filess simplifies saving and loading of data, with serde and image optional integration.
let file1: Json = new; // Create new Json file. Filess will ensure that it's a valid path
let data: = file1.load?; // Load data from a file
let model = file1.?; // `Serde` integration: load model from the file
let model: YourModel = file1.load_model?; // Or like this
file1.save?; // Save anything with `impl AsRef<[u8]>`
file1.save_model?; // `Serde` integration: save a model into file
let file2: Jpeg = new;
let image: DynamicImage = file2.load_image?; // `Image` integration: load image of jpeg format from file
file2.save_image?; // `Image` integration: save `DynamicImage` with default compression parameters
// `Image` integration: save `DynamicImage` with custom quality parameters (only available if supports quality settings)
file2.save_image_custom?;
// Each function have their async variants if `async` feature is on
let image2 = file2.load_image_async.await?;
new.save_image_async.await?;
Features
| Feature | Description |
|---|---|
all-files |
(Default) All currently supported files, includes all-text and all-images |
all-text |
All currently supported text files: Json, Toml, Md, Txt |
all-images |
All currently supported image files: Jpeg, Png, WebP, Avif, Tiff, Gif, Bmp, Exr, Ff, Hdr, Ico, Pnm, Qoi, Tga |
serde |
Serde integration, adds save_model and load_model for Json and Toml |
image |
Image integration, adds save_image and load_image to all image formats, and save_image_custom to formats where image supports custom quality |
image-nasm |
Turns on nasm feature of image |
async |
Add async versions of all methods. Uses minimal tokio for fs. Adds save_image_custom_async_offload to offload image encoding |
rayon |
(Default) Turns on all of rayon features in crates that support it. |
All files have their separate features. It is recommended to turn off default features and add only formats you use, if you wish to publish.