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 = Json::new("path/to/file.json");   // Create new Json file. Filess will ensure that it's a valid path
let data: Vec<u8> = file1.load()?;                  // Load data from a file
let model = file1.load_model::<YourModel>()?;       // `Serde` integration: load model from the file
let model: YourModel = file1.load_model()?;         // Or like this
file1.save(&data)?;                                 // Save anything with `impl AsRef<[u8]>`
file1.save_model(&model)?;                          // `Serde` integration: save a model into file

let file2: Jpeg = Jpeg::new("path/to/image.jpeg");
let image: DynamicImage = file2.load_image()?;      // `Image` integration: load image of jpeg format from file
file2.save_image(&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(&image, JpegConfig { quality: 40 })?;

// Each function have their async variants if `async` feature is on
let image2 = file2.load_image_async().await?;
Jpeg::new("another/path/image.jpeg").save_image_async(&image2).await?;

Features

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.

[!NOTE] In beta, adding new file formats is a bit bothersome